Soul Engine | FAQ
Your most common Soul Engine questions answered: licensing, setup, updates, permissions, performance, and troubleshooting.
Quick answers
| Question | Answer |
|---|---|
| How do I activate my license? | Run /soulengine key <license> in game after installing. |
| Supported servers? | Paper / Spigot / Folia, MC 1.20 → 1.21+. |
| Config location? | plugins/SoulEngine/config.yml and license-data.yml. |
| Need help? | Use Troubleshooting or contact Sergeant Fuzzy. |
FAQ details
How do I install and enable Soul Engine?
Drop the Soul Engine .jar into /plugins, start the server once, then activate with /soulengine 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 Soul Engine safely?
- Stop the server.
- Replace only the Soul Engine .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 Soul Engine Permissions. If using wildcards, ensure your plugin supports them; otherwise assign explicit nodes.
Does Soul Engine impact performance?
Soul Engine 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 Soul Engine stores data locally in its plugin folder. Back up the entire plugins/SoulEngine directory before migrations or major server changes.
Activation or lockout issues
Steps:
- Confirm license-data.yml exists and is readable.
- Re-run /soulengine 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 Soul Engine compatible with other storage plugins?
Soul Engine is designed to coexist with common storage/claim plugins. If you use region protection, allow Soul Engine 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)
- Soul Engine version/build
- Logs or error excerpts
- Steps to reproduce