Skip to content

FAQ

The current build uses a Java 25 toolchain. Run the server with Java 25 or newer.


Use Paper or a compatible fork. The current controls depend on Paper’s player input API and the build targets Paper 1.21.11.


The plugin maps horizontal controls relative to the facing direction saved with the arena start location. Edit the arena, stand at the camera position, look directly toward the board, save the start location again, and retest.


Why is the board selector rejecting my second corner?

Section titled “Why is the board selector rejecting my second corner?”

The board must be two-dimensional. Both corners must have either the same X coordinate or the same Z coordinate. If both differ, choose the first point again and select a flat vertical plane.


The arena needs valid start, end, first-corner, and second-corner locations. Use /snake edit <arena id>, set all four, then press Save before leaving editor mode.


Lower the arena’s Tick Interval. The minimum is 1; the default is 6. Very low intervals provide less time to react.


Disable Wrap Around in the arena options. With it enabled, the snake reappears on the opposite board edge.


Make sure the database selector is set in config.yml:

database: mysql

Then configure mysql.yml and restart the server.


Why is a leaderboard position empty or stale?

Section titled “Why is a leaderboard position empty or stale?”

Leaderboard positions include positive values only, are limited by leaderboard-size, and refresh during autosaves or when an active game is cleared. Check the statistic key and position, then wait for the next configured save cycle if a value changed recently.


Use the official The Snake resource page on SpigotMC.