Void Race Plugin

# 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. !(https://cdn.modrinth.com/data/P4SpyAdt/images/26334be2cbe387b7a06c5afaf9f54804debfc502.png) **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: ```properties generate-structures=false level-type=minecraft:flat generator-settings={"layers":,"structures":{"structures":{}}} allow-flight=true ``` 4. If the world already exists, delete these folders so Paper can regenerate them with the new settings: ```text world world_nether world_the_end ``` 5. Start the server again. 6. Join as an OP user and run: ```text /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 ```powershell mvn clean package ``` The plugin JAR is created in `target/`.