Troubleshooting
- Latest version
- 9.0.16
- Minecraft
- 1.21.4 - 26.3
- Platforms
- Spigot, Paper, Folia, Purpur
- Minimum Java version
- 21+
Troubleshooting
The plugin does not start
Check the first GUIAdminToolsPremium error in the startup log. Verify Java 25, the JAR's Minecraft target and that only one edition/copy is installed. Use the distribution JAR containing its platform components. A source ZIP is not an installable plugin. Correct any YAML error at the reported line, then restart fully.
A command is missing or another plugin responds
Check
A menu opens but an action is denied
Menu access and action permissions are separate. For example,
Protection or teleportation behaves unexpectedly
Check global FastFlags, every overlapping region, game rules and other protection plugins. Local allows do not override global blocks. Check
Folia world operations are unavailable
This edition blocks world creation/loading/unloading/renaming at runtime on Folia. It also blocks
Economy, LuckPerms or WorldGuard menus are unavailable
Economy needs Vault plus a provider. Keep EconomyProvider: false to use your existing provider, or enable the built-in provider intentionally. The LuckPerms interface requires LuckPerms.
A kit, message or join effect does not work
Check
An update check fails or an error continues
A message such as Unable to check for updates means the version lookup failed; check the host's outbound HTTPS access and retry later. For a reproducible plugin fault, include the plugin version, server type/build, Java version, complete error and steps to reproduce. Remove private data from configuration excerpts before sharing them.
The plugin does not start
Check the first GUIAdminToolsPremium error in the startup log. Verify Java 25, the JAR's Minecraft target and that only one edition/copy is installed. Use the distribution JAR containing its platform components. A source ZIP is not an installable plugin. Correct any YAML error at the reported line, then restart fully.
A command is missing or another plugin responds
Check
Commands.<name>.Status, the configured aliases and your permissions. Use a configured distinctive alias such as /atfly or /atwhitelist to identify conflicts. Reload statuses with /servermanager reloadcommands; restart after alias changes. A global/region command_use block or a player's command restriction can also prevent execution.A menu opens but an action is denied
Menu access and action permissions are separate. For example,
admintools.player.maingui opens Player Manager, while admintools.player.heal allows healing another player. Own-player permissions do not automatically grant target-player actions. Test using the same permissions and account type as the affected user.Protection or teleportation behaves unexpectedly
Check global FastFlags, every overlapping region, game rules and other protection plugins. Local allows do not override global blocks. Check
teleport at both endpoints and entry/exit across boundaries. For a missing region, verify both corners, its world and its Y range. To recover from a global command lock, stop the server through the host console, set FLAGS.COMMAND_USE: true in Config.yml, then start it again; review region flags too.Folia world operations are unavailable
This edition blocks world creation/loading/unloading/renaming at runtime on Folia. It also blocks
/servermanager reload and /servermanager saveworld. Use a full server stop/start and the platform's supported world setup. This version does not queue these operations for the next restart. Other world actions depend on what the running platform supports.Economy, LuckPerms or WorldGuard menus are unavailable
Economy needs Vault plus a provider. Keep EconomyProvider: false to use your existing provider, or enable the built-in provider intentionally. The LuckPerms interface requires LuckPerms.
/wgregion requires WorldGuard and WorldEdit. /region and FastFlags work independently of those protection plugins.A kit, message or join effect does not work
Check
admintools.use.kit, the protected kit's admintools.kit.<kit_name>, its cooldown and name. This release's kit icon may display a legacy permission warning even when the actual claim permission is correct; test /kit <kit name> to distinguish the display from the action. For join effects, check their enable setting and matching admintools.use.* permission. Preserve message placeholders, and select one of the supported message-language codes.An update check fails or an error continues
A message such as Unable to check for updates means the version lookup failed; check the host's outbound HTTPS access and retry later. For a reproducible plugin fault, include the plugin version, server type/build, Java version, complete error and steps to reproduce. Remove private data from configuration excerpts before sharing them.