Troubleshooting
- Latest version
- 3.6.0
- Minecraft
- 1.21.4 - 26.3
- Platforms
- Spigot, Paper, Folia, Purpur
- Minimum Java version
- 21+
This article was written for 3.5.5. The latest stable release is 3.6.0; use the current requirements above.
Troubleshooting
Command missing or handled by another plugin: check CommandRegistration, restart after changes, and try a listed alias or a namespaced command. The command catalogue lists the exact syntax for this version.
No permission: check the correct category and .tool/.command context. For an action on another player, a self-tool permission is insufficient. Test without OP, root, category or base grants that would bypass a narrower restriction.
Player not found or offline: live tools require a player who is online. Known offline entries do not turn inventory, EnderChest or XP tools into offline editors. A ban target must have a known player record; unban also requires an existing profile ban.
Flag seems ineffective: use /fastflags list global and /fastflags list world, then inspect world overrides. Reset a world override to inherit global values. Other protection plugins and native world settings can still block an action when a Fast Flag allows it.
World operation unsupported: runtime world lifecycle changes are disabled on Folia. Use an appropriate server/world management workflow outside these tools; retrying the GUI action does not schedule the operation for restart.
Database error: read the startup log, check driver availability, MySQL credentials/connectivity and SQLite folder permissions. Verify whether YAML fallback was activated before editing data. Changing the storage type requires a restart; database mode does not synchronize live inventories.
Restart script not found: check settings.restart-script in spigot.yml and that the script exists at the resolved path. Reload/stop/restart commands require the literal confirm argument. Restart support also depends on the server's restart command.
Messages or effects do not appear: check MESSAGE_OPTION, PREFIX_OPTION, the correct MESSAGES key, permissions and the server version. Preserve placeholders and YAML quoting. Unsupported effects or attributes cannot be enabled by translating their label.
Command missing or handled by another plugin: check CommandRegistration, restart after changes, and try a listed alias or a namespaced command. The command catalogue lists the exact syntax for this version.
No permission: check the correct category and .tool/.command context. For an action on another player, a self-tool permission is insufficient. Test without OP, root, category or base grants that would bypass a narrower restriction.
Player not found or offline: live tools require a player who is online. Known offline entries do not turn inventory, EnderChest or XP tools into offline editors. A ban target must have a known player record; unban also requires an existing profile ban.
Flag seems ineffective: use /fastflags list global and /fastflags list world, then inspect world overrides. Reset a world override to inherit global values. Other protection plugins and native world settings can still block an action when a Fast Flag allows it.
World operation unsupported: runtime world lifecycle changes are disabled on Folia. Use an appropriate server/world management workflow outside these tools; retrying the GUI action does not schedule the operation for restart.
Database error: read the startup log, check driver availability, MySQL credentials/connectivity and SQLite folder permissions. Verify whether YAML fallback was activated before editing data. Changing the storage type requires a restart; database mode does not synchronize live inventories.
Restart script not found: check settings.restart-script in spigot.yml and that the script exists at the resolved path. Reload/stop/restart commands require the literal confirm argument. Restart support also depends on the server's restart command.
Messages or effects do not appear: check MESSAGE_OPTION, PREFIX_OPTION, the correct MESSAGES key, permissions and the server version. Preserve placeholders and YAML quoting. Unsupported effects or attributes cannot be enabled by translating their label.