AlphaLevelsHelpTroubleshooting

Troubleshooting

The problems server owners actually hit, matched to the console line or symptom you will see.

On this page

Check the server console first. Each card gives the symptom, the likely cause and the fix.

Startup

Console: AlphaLevels is disabled — this server is waiting for approval.

Cause: A new server starts as pending, and the plugin stays off until AlphaStudio approves it.
Fix: Send the server id from the next console line to AlphaStudio, then restart once it is approved. See Server approval.

Console: Ignoring non-numeric milestone level in levels.yml (or objectives level)

Cause: A key under rewards.milestones or objectives is not a number, so that entry is skipped.
Fix: Use plain level numbers as keys, then /leveladmin reload.

Console: Unknown sound in config.yml

Cause: A name under sounds is not a Bukkit Sound on your Minecraft version.
Fix: Use a valid name. The same warning exists for the confirmation menu.

XP is full but the level will not claim

Cause: The level has objectives that are not finished yet. Kill counts only count kills made while on that level, so earlier kills do not help.
Fix: Open /level and read the objectives in the tile's lore. See Objectives.

Players earn XP too slowly, or too fast

Cause: The default curve is a long grind on purpose.
Fix: Change the pace with xp-sources in config.yml, or the cost with xp-curve in levels.yml, and reload.

Mob or player kills give no XP

Cause: The source is off, the mob came from a spawner or is a Citizens NPC (ignored by default), the victim is on the 20 minute same-victim-cooldown-minutes, or the kill was in a world outside allowed-worlds.
Fix: Check those settings under xp-sources.

The level is claimed but no money arrives

Cause: The money is paid by the console command in rewards.base.commands, which ships as money give {player} {money} (CMI's syntax). If nothing on your server owns that command, it does nothing.
Fix: Use your economy plugin's give-money command there. See Rewards.

A milestone item reward is wrong

Console: Failed to load level data for <uuid> or Failed to save level data

Cause: The player's file in playerdata/ is unreadable, or the folder is not writable.
Fix: Fix the permissions and free disk space. Keep the file, it holds that player's progress.

Console: Player data writes are still running after 30 seconds

Cause: On shutdown the plugin waits up to 30 seconds for pending saves, and the disk was too slow.
Fix: Check the disk. Progress made just before the stop may be missing.