AlphaEventHelpTroubleshooting

Troubleshooting

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

On this page

Startup
Setup and starting
During a round
Menus and boss bars

Check the server console first. AlphaEvent logs a specific line for most of these problems. Each card gives the symptom, the likely cause and the fix.

Startup

The plugin does not enable

Cause: WorldGuard or WorldEdit is missing, or does not support your Minecraft version.
Fix: Install both, using builds for your version, and restart. Both are hard dependencies.

Console: AlphaEvent 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.

After updating, the text looks different and my message edits are gone

Cause: 3.0 moved the text to lang/ with new keys and the pink theme.
Fix: Your old files are in backup/2.x/. Copy the lines you want into the new files and run /aevent reload. See Upgrading.

Setup and starting

/aevent start says the event is not ready to start

Cause: The arena is missing something the event needs, such as a region, spawn points or a finish line.
Fix: The message lists each item and its fixing command. /aevent check <event> shows the full list and /aevent arenas <event> shows every arena.

Console: [AlphaEvent] No spawn points for arena 'x' — cannot start the round!

Cause: The arena has no usable spawn points (or their world is not loaded).
Fix: Stand in the arena and run /aevent addspawn. /aevent points spawns shows what exists. Arenas in worlds that load late are picked up when the world loads.

Console: [AlphaEvent] No lobby set for arena 'x'

Cause: The arena has neither a lobby region nor a lobby point, so joining players stay where they are.
Fix: Run /aevent region lobby <region>, or /aevent setspawn for a single point.

The event ends right after joining with "not enough players"

Cause: Fewer than settings.min-players (default 2) joined before the join phase ended.
Fix: Lower min-players, lengthen settings.join-duration, or use /aevent forcestart once enough players have joined.

An event is stuck and will not stop cleanly

Cause: The game state is out of step with the server, for example after a crash mid-round.
Fix: /aevent reset clears everything, but it does not restore broken blocks. See FAQ.

During a round

Players see "Hey! Sorry, but you can't PvP here" / "you can't build here"

Cause: A WorldGuard flag on the arena region overrides what the plugin opens for the round, for example a region with pvp deny set explicitly, or a higher-priority region on top of the arena.
Fix: Remove the flag, or lower the priority of the other region. The plugin sets pvp, block-break, block-place or ride to allow on the arena region only for the round and restores them afterwards.

Players are eliminated the moment the round starts

Cause: The spawn points sit outside the arena region, or below the Y level where a fall counts. The default is the bottom of the arena region; elimination-y in the event file overrides it.
Fix: Make the region contain the spawns and reach below the floor, or set elimination-y.

Spleef players cannot break blocks

Cause: Only the blocks in floor-blocks break, only inside the arena region, only with the Spleef shovel, and only while a round is live.
Fix: Check the block list in events/spleef.yml, the arena region, and that mode is shovel.

Players cannot run commands in the lobby

Cause: protection.lobby.prevent-commands is on, and only the commands under allowed-commands pass.
Fix: Add the command to allowed-commands, or give the player alphaevent.bypass.

Boat Race: nobody is in a boat

Cause: Another plugin cancels mounting, or boat-type is not a boat on this Minecraft version.
Fix: Try OAK_BOAT (or BOAT on older servers). The console prints "Could not seat" with the player's name when mounting is refused.

Wave Survival: mobs vanish at once

Cause: The world difficulty is Peaceful, which removes hostile mobs.
Fix: Set the difficulty to Easy or higher.

Console: [AlphaEvent] Unknown material: X, defaulting to STONE

Cause: A material name in an event file or lang/gui.yml does not exist on this Minecraft version.
Fix: Correct the name and run /aevent reload.

Menus and boss bars

Console: [AlphaEvent] join-gui section missing in lang/gui.yml

Cause: lang/gui.yml has no join-gui section, so the join menu cannot open.
Fix: Delete the file and run /aevent reload, or restore the section from the default.

Console: [AlphaEvent] BossBar config not found: bossbars.<key>

Cause: A phase asked for a boss bar that is not defined in lang/bossbars.yml.
Fix: Add the missing key. See Configuration → Boss bars.

A message shows "Missing message: some-key"

Cause: A key was removed or renamed in lang/messages.yml.
Fix: Restart: missing keys are added back from the jar's defaults on start.