Skip to content

Troubleshooting

Arena is not resetting as expected

  1. Confirm the arena exists:
/arena list
  1. Check the arena details:
/arena info <name>
  1. Run a manual reset:
/arena reset <name>

If the saved arena version is wrong, update it with the safe edit workflow:

/arena pause <time>
/arena reset <name>

Make your changes, then save them:

/arena edit <name>
/arena pause off

Players see resets slowly

Large arenas may need more time to visually update for every player.

If you know what you are doing, you can adjust:

update-queue:
  enabled: true
  max-sections-per-player-per-tick: 6

Higher values make reset visuals appear faster but can increase packet bursts.

Light looks wrong after a reset

Make sure light update packets are enabled:

reset-packets:
  send-light-updates: true

If the arena was saved with bad lighting, fix the lighting in-world and run:

/arena edit <name>

Migration provider says "not available"

The plugin you are migrating from must be:

  • installed
  • enabled
  • running on the same server while you migrate

After migration is complete, you can disable or remove the old plugin.

Migration fails for one arena

Try migrating one arena at a time:

/arena migrate <provider> <arena>

Confirm that the old plugin can still load or reset that arena before migrating it.

Periodic resets feel bursty

Use the rotation helper for shared-area rotations:

/arena rotation <time_between_resets> <arena1> <arena2> [arena3...]

For unrelated arenas, offsets are optional. Use one only when you want an arena to start its schedule later than another arena:

/arena periodic <name> <time> <offset>

Automatic resets need to stop temporarily

Pause every automatic periodic reset:

/arena pause 5m

Resume:

/arena pause off

Check status:

/arena pause status

Manual /arena reset <name> still works while automatic resets are paused.