Troubleshooting

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

On this page

Startup
Arena and spawn
Gameplay
Tab list and scoreboard
Server commands

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

Startup

Console: AlphaWildSystem 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: Punishment system (ban/mute/warn/jail) failed to start - check your database config

Cause: The database connection failed. The line before it reads Failed to connect to the punishment database with the reason.
Fix: For MySQL, check host, port, database, username, password and use-ssl, and that the host allows your server's address.

Arena and spawn

/region setspawn or setarena cannot find the region

Cause: You ran the command in a different world. The plugin remembers the world you stand in and only searches regions there.
Fix: Stand inside the arena's world and run it again. See PvP & Arena → Region.

Console: Arena regen skipped — world 'X' isn't loaded

Cause: The arena's world is not loaded when the regeneration timer fires.
Fix: Keep the world loaded, or load it before the timer runs. Regions are restored when their world loads.

Players fall into the void instead of returning to spawn

Cause: spawn.void-safety-net is false, or no spawn is set.
Fix: Run /setspawn and keep void-safety-net: true.

Gameplay

The crafting table does nothing, and anvils never wear out

Cause: That is the default. features.no-crafting and features.anvil-no-damage are both on, since gear comes from kits and the shop.
Fix: Set them to false in config.yml and reload.

Players cannot use a command during a fight

Cause: They are combat-tagged. Only the commands in combat.allowed-commands work for combat.combat-seconds.
Fix: Wait it out, or give staff alphawildsystem.combat.bypass. See Combat.

Console: kits.yml: unknown material 'X' under …

Cause: A kit entry uses a material that does not exist on this Minecraft version.
Fix: Correct the name in kits.yml and run /awild reload.

Players cannot open /chatcolor

Cause: alphawildsystem.chatcolor defaults to op. It is a rank perk, not on by default.
Fix: Grant it to the ranks that should have it. A colour with its own permission: shows locked until that node is granted too.

A shop purchase fails, or a crate does not appear

Cause: The player cannot afford it, or their inventory is full. The shop blocks a purchase that would overflow, and takes the price before handing over the item.
Fix: Free a slot and check their balance with /money. Crates also drop from kills with crates.yml settings.kill-drop-chance.

Tab list and scoreboard

The sidebar scoreboard is missing

Cause: The player toggled it off with /sb, hidden-by-default is on, or scoreboard.enabled is false in tab/config.yml.
Fix: Run /sb, or fix the setting and /awild reload. See Sidebar scoreboard.

The tab list is not sorted by rank

Cause: Sorting needs a permissions plugin hooked through Vault. Without one, everyone is in the default group. The group names in sorting-types must also match your real groups.
Fix: Install LuckPerms with Vault, and replace the example group list with your own rank names.

Server commands

/restart only stops the server

Cause: The console says Couldn't determine how this server was launched or Failed to relaunch the server process for /restart.
Fix: On a host that restarts the server for you, set restart.relaunch-process: false. Otherwise start the server with a normal java command line.

Console: Discord webhook returned HTTP N or Failed to send Discord webhook

Cause: The webhook URL is wrong, deleted or rate limited, or the host blocks outgoing HTTPS.
Fix: Test the URL from the same machine. Leave webhook-url empty to turn it off.