Skip to main content

Troubleshooting

Plugin Fails to Load​

Symptom: No KeyAllPro output in console, or [Server] Could not load plugin.

Checklist:

  • Java version is 21 or higher (java -version)
  • Server is Paper or Spigot 1.21+
  • JAR file is not corrupted — re-download if needed
  • No conflicting plugin named KeyAllPro already loaded

Keys Not Being Delivered​

Symptom: /keyall give runs but players don't receive keys.

Steps:

  1. Check console for command errors — the give-command may have a typo
  2. Run the give command manually in console with a test player name to verify it works
  3. Confirm the crate plugin is installed and functional
  4. Check that %player% is present in the give-command (not a hardcoded name)

Timer Not Persisting After Restart​

Symptom: Timer resets to full interval after every restart.

Fix: Ensure persist-timer: true in config.yml and reload. Check that the plugin has write permissions to plugins/KeyAllPro/.

Rank Bonuses Not Working​

Symptom: VIP/MVP/Elite players receive the same keys as regular players.

Steps:

  1. Confirm rank-rewards.enabled: true
  2. Verify the permission is actually granted: /lp user <player> info
  3. Confirm the permission node in config matches exactly (case-sensitive)
  4. Check that the player was online — offline players receive base keys only until they join

Offline Keys Not Delivered on Join​

Symptom: Players who missed a drop don't receive keys when they log in.

Fix: Ensure offline-rewards.deliver-on-join: true and offline-rewards.enabled: true. Check that pending-rewards.yml exists and is not corrupted.

PlaceholderAPI Placeholders Showing Raw Text​

Symptom: %keyall_time% appears literally in chat/scoreboard.

Fix:

  1. Confirm PlaceholderAPI is installed and loaded before KeyAllPro
  2. Reload KeyAllPro: /keyall reload
  3. If using a scoreboard plugin, ensure it supports PAPI expansion

BossBar Not Showing​

Symptom: BossBar notifications are not visible.

Fix:

  1. Set notifications.bossbar.enabled: true
  2. Ensure warning-times has at least one entry
  3. Confirm players have not hidden boss bars in their client accessibility settings

Common Config Mistakes​

MistakeFix
give-command has wrong player variableUse %player% exactly
Interval set to 0 or negativeSet a positive integer
Rank permission typoCopy exact node from the permissions table
Missing crates listAt least one crate entry is required