ChestLink | FAQ
Your most common ChestLink questions answered: licensing, setup, updates, permissions, performance, and troubleshooting.
Quick answers
| Question | Answer |
|---|---|
| How do I activate my license? | Run /chestlink key <license> in game after installing. |
| Supported servers? | Paper / Spigot / Folia, MC 1.20 → 1.21+. |
| Config location? | plugins/ChestLink/config.yml and license-data.yml. |
| Need help? | Use Troubleshooting or contact Sergeant Fuzzy. |
FAQ details
How do I install and enable ChestLink?
Drop the ChestLink .jar into /plugins, start the server once, then activate with /chestlink key <license>. Keep config.yml and license-data.yml intact when updating.
My license key isn’t working. What should I check?
- Confirm there are no extra spaces when pasting the key.
- Verify the key matches the server you intend to bind.
- Ensure license-data.yml was not deleted.
- If still failing, contact Sergeant Fuzzy with your server ID and key.
How do I update ChestLink safely?
- Stop the server.
- Replace only the ChestLink .jar.
- Do not delete config.yml or license-data.yml.
- Start the server; activation will validate automatically.
Why are players missing permissions?
Check your permissions plugin and apply the proper nodes from ChestLink Permissions. If using wildcards, ensure your plugin supports them; otherwise assign explicit nodes.
Does ChestLink impact performance?
ChestLink is optimized for async operations. If you see lag spikes, verify:
- Timings/profiler to confirm another plugin isn’t interfering.
- Disk isn’t saturated and TPS is stable.
- Config uses recommended async storage settings.
Where is data stored?
By default ChestLink stores data locally in its plugin folder. Back up the entire plugins/ChestLink directory before migrations or major server changes.
Activation or lockout issues
Steps:
- Confirm license-data.yml exists and is readable.
- Re-run /chestlink key <license> if prompted.
- Review console for any HTTP/SSL or firewall errors blocking validation.
Why do some commands say “unknown”?
Ensure the plugin loaded correctly (no red errors on startup) and that you’re using the proper syntax from Commands. Also confirm your permissions provider applies the nodes after reload.
Is ChestLink compatible with other storage plugins?
ChestLink is designed to coexist with common storage/claim plugins. If you use region protection, allow ChestLink interactions where needed. Report conflicts with plugin names and versions.
How do I get support?
Open a ticket via your usual channel (Discord/email). Include:
- Server version (e.g., Paper 1.21.x)
- ChestLink version/build
- Logs or error excerpts
- Steps to reproduce