Void Race 插件
Void Race Plugin 是一款适用于 Paper 服务器的多人虚空竞速小游戏插件。
版本: 1.2-beta
玩家将在一个虚空世界中,从各自独立的单格赛道出发。每隔几秒,每位活跃玩家的赛道会随机掉落一个物品或方块。目标是在计时结束前,从起始方块移动尽可能远的距离。

重要提示: 必须由 OP 用户或服务器控制台通过 /voidrace start 命令开始挑战。比赛不会自动开始。
要求
- Minecraft 1.21.11 的 Paper 服务器
- Java 21
- 建议使用虚空/空气世界
虚空世界设置
如果您希望在您的 Paper 服务器上使用与 Void Race 相同的空世界生成效果,请按以下步骤操作:
- 停止服务器。
- 打开
server.properties 文件。
- 设置或替换以下值:
generate-structures=false
level-type=minecraft:flat
generator-settings={"layers":[{"block":"minecraft:air","height":1}],"structures":{"structures":{}}}
allow-flight=true
- 如果世界已经存在,请删除这些文件夹,以便 Paper 能够使用新设置重新生成它们:
world
world_nether
world_the_end
- 重新启动服务器。
- 以 OP 用户身份加入并运行:
/voidrace start
建议启用 allow-flight=true,因为在挑战期间玩家可能会被移动到虚空中,而某些服务器配置可能会因此将玩家踢出(视为飞行)。
命令
只有 OP 玩家和服务器控制台可以使用 /voidrace 相关命令。
| 命令 |
描述 |
/voidrace start |
为当前在线的玩家开始挑战。 |
/voidrace reset |
停止挑战,清除掉落的物品、生物、Boss 和赛道方块,然后将玩家送回大厅。 |
/voidrace interval <seconds> |
设置随机战利品掉落的频率。默认值:10。 |
/voidrace duration <minutes> |
设置比赛持续时间。默认值:60。 |
/voidrace keepinventory <true/false> |
控制玩家在坠入虚空后是否保留物品栏。默认值:true。 |
游戏玩法
- 每位玩家拥有独立的赛道。
- 赛道在 X 轴上分离,并由红色粒子标记边界。
- 战利品仅在有活跃参赛者的赛道上掉落。
- 距离通过记分板记录,计算方式为从玩家起始方块到最远落地位置的距离。
- 坠入虚空会将玩家传送回其赛道的起点。
- 在比赛进行中加入的玩家会在大厅等待,不会获得赛道、Boss 条或记分板。
- 当没有比赛运行时,侧边栏会显示等待中的玩家,而不是比赛距离。
- 挑战期间禁用饥饿值和传送门。
- 重置时,非玩家实体将被移除,以防止刷怪蛋生成的生物和 Boss 在回合结束后残留。
构建
mvn clean package
插件 JAR 文件将生成在 target/ 目录中。
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.
- Stop the server.
- Open
server.properties.
- 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
- If the world already exists, delete these folders so Paper can regenerate them with the new settings:
world
world_nether
world_the_end
- Start the server again.
- 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/.
评论 0
登录后参与评分
还没有评论,来抢沙发吧