Void Race Plugin

Void Race Plugin is a Paper server plugin for a multiplayer void race minigame.

Version: 1.2-beta

Players start on separate one-block lanes in a void world. Every few seconds, each active player lane receives a random item or block. The goal is to travel the greatest distance from the starting block before the timer runs out.

Important: An OP user or the server console must start the challenge with /voidrace start. The race does not begin automatically.

Requirements

• Paper server for Minecraft 1.21.11
• Java 21
• A void/air world is recommended

Void World Setup

Use this setup on your own Paper server if you want the same empty world generation used for Void Race.

1. Stop the server.
2. Open server.properties.
3. Set or replace these values:

generate-structures=false
level-type=minecraft:flat
generator-settings={"layers":[{"block":"minecraft:air","height":1}],"structures":{"structures":{}}}
allow-flight=true

4. If the world already exists, delete these folders so Paper can regenerate them with the new settings:

world
world_nether
world_the_end

5. Start the server again.
6. Join as an OP user and run:

/voidrace start

allow-flight=true is recommended because players can be moved through the void during the challenge and some server setups may otherwise kick them for flying.

Commands

Only OP players and the server console can use /voidrace commands.

Command	Description
/voidrace start	Starts the challenge for the currently online players.
/voidrace reset	Stops the challenge, clears dropped items, mobs, bosses, and lane blocks, then returns players to the lobby.
/voidrace interval <seconds>	Sets how often random loot drops. Default: 10.
/voidrace duration <minutes>	Sets the race duration. Default: 60.
/voidrace keepinventory <true/false>	Controls whether players keep inventory after falling into the void. Default: true.

Gameplay

• Each player gets a separate lane.
• Lanes are separated on the X axis and bounded by red particles.
• Loot drops only on lanes with active race participants.
• Distance is tracked on the scoreboard by the farthest grounded distance from the player's start block.
• Falling into the void teleports the player back to their lane start.
• Players who join during an active race wait in the lobby and do not receive a lane, bossbar, or scoreboard.
• When no race is running, the sidebar shows the waiting players instead of race distance.
• Hunger and portals are disabled during the challenge.
• On reset, non-player entities are removed so mobs and bosses from spawn eggs do not remain after the round.

Build

mvn clean package

The plugin JAR is created in target/.