❄️ IceBoatRacing
一款专业级的 Minecraft Paper 插件,用于竞技冰船竞速 — 精确的检查点、实时记分板、自动赛道生成、强制进站以及完整的赛事管理。

? 这是什么?
IceBoatRacing 将你的 Minecraft 服务器变成一个竞技冰船竞速平台。创建比赛、设计赛道、注册船只、强制执行进站,并在实时计时的情况下举办活动 —— 全部集成在一个插件中。
专为运行竞技赛车活动的服务器打造(例如 Mini Jeux Entre Potes 的 Grands Prix)。
✨ 功能特性
| 类别 |
功能 |
| 赛事管理 |
交互式创建向导 · 准备/开始/结束比赛 · 可配置的圈数 · 最后一名玩家完成后自动结束 · 比赛结束时提供包含丰富信息的清晰排名 |
| 检查点 |
定向矩形区域,赛车手穿过此处以更新实时记分板 · 替代绕行路线 · 赛段计时门 |
| AutoTrace |
驾驶/步行一圈 → 插件自动生成精确的检查点 · 粒子预览 · 在保存前编辑检查点 |
| 进站 |
强制性(若设置为 0 则非强制),每场比赛可配置进站次数 · 带有实时倒计时的计时进站区 · 真实的 F1 车队配色主题(11 种真实 F1 车队渐变色) · 跳过进站的赛车手将被自动取消资格 |
| 实时记分板 |
显示当前排名的实时侧边栏 |
| 起步灯光 |
可选的 6 阶段彩色玻璃起步灯光(棕色 → 红色 → 橙色 → 黄色 → 石灰绿 → 绿色),与倒计时同步 |
| 载具系统 |
为每位玩家注册船只(所有木材类型、木筏、箱子变体) · 自定义名称 · 准备时自动生成 · 无敌状态 |
| 多语言 |
内置英语和法语 · 可通过 YAML 扩展 · 支持 MiniMessage 和旧版颜色代码格式化(渐变和颜色) |
| 存储 |
每个比赛一个 YAML 文件 · 易于备份/导入导出 |
? 安装
- 下载 最新的
.jar 文件
- 将其放入服务器的
plugins/ 文件夹中
- 重启 服务器
- 开始比赛。
⚙️ 配置亮点
编辑 plugins/IceBoatRacing/config.yml:
language: en_US # en_US 或 fr_FR(可在 lang/ 中添加你自己的语言)
race:
allowRejoin: true # 允许玩家在登出后于比赛中途重新加入
racingGameMode: ADVENTURE # 比赛期间的游戏模式
enforceRacingGameMode: true
spectateOnFinish: true # 将完赛者置于旁观者模式
removeCarWhenLoggingOut: false
提示: 起步灯光需要一个由 from/to 坐标定义的 3D 区域。这些区域会在 5 秒倒计时期间填充彩色玻璃。
提示: 进站次数和起步旋转角度是按比赛设置的,而非全局设置 —— 请使用 /race setPitStops <race> <amount>(默认为 1)。
⌨️ 命令
| 指令 |
描述 |
权限 |
/race create |
交互式赛道创建向导 |
iceboatracing.race.create |
/race start [name] |
开始比赛,包含 5 秒倒计时 + 信号灯 |
iceboatracing.command.race |
/race prepare [name] |
生成赛车、传送玩家、设置冒险模式 |
iceboatracing.command.race |
/race end [name] |
结束比赛,发送排名和有用信息 |
iceboatracing.command.race |
/race delete [name] |
永久删除赛道 |
iceboatracing.race.create |
/race setLapCount [name] <amount> |
查看/更改圈数 |
iceboatracing.command.race |
/race setPitStops [name] <amount> |
查看/更改所需的进站次数 |
iceboatracing.command.race |
/race setStartRotation [name] <amount> |
查看/更改起始旋转角度 |
iceboatracing.command.race |
/checkpoint create <arguments> |
从铲子选择创建检查点 |
iceboatracing.command.checkpoint |
/checkpoint remove [race] [id] |
通过 ID 或距离玩家最近的位置移除检查点 |
iceboatracing.command.checkpoint |
/checkpoint view <race> |
切换所有检查点的粒子预览 |
iceboatracing.command.checkpoint |
/checkpoint list [page] |
列出所有检查点(分页、可点击) |
iceboatracing.command.checkpoint |
/checkpoint autotrace start <race> [...] |
开始录制一圈以用于 AutoTrace |
iceboatracing.command.checkpoint |
/checkpoint autotrace accept |
将生成的检查点保存到赛道 |
iceboatracing.command.checkpoint |
/checkpoint autotrace preview |
切换生成检查点的粒子预览 |
iceboatracing.command.checkpoint |
/checkpoint autotrace sector |
在最近的预览检查点处添加赛段门 |
iceboatracing.command.checkpoint |
/checkpoint autotrace resize |
调整最近预览检查点的大小 |
iceboatracing.command.checkpoint |
/checkpoint autotrace add |
添加一个检查点 |
iceboatracing.command.checkpoint |
/checkpoint autotrace delete |
删除最近的预览检查点 |
iceboatracing.command.checkpoint |
/checkpoint autotrace cancel |
取消 AutoTrace 会话 |
iceboatracing.command.checkpoint |
/checkpoint addAlternate <race> <id> |
为某个检查点添加备用检查点(需铲子选择) |
iceboatracing.command.checkpoint |
/checkpoint clearAll <race> |
删除所有检查点(需确认) |
iceboatracing.command.checkpoint |
/pitbox create <race> |
交互式维修区创建向导 |
iceboatracing.command.pitbox |
/pitbox list <race> |
列出所有维修区(可点击编辑/着色/传送/移除) |
iceboatracing.command.pitbox |
/pitbox remove <race> <id> |
移除一个维修区 |
iceboatracing.command.pitbox |
/pitbox setAllowed <race> <id> <names|*> |
更改允许使用某个维修区的玩家 |
iceboatracing.command.pitbox |
/pitbox setColor <race> <id> <color> |
更改维修区的颜色主题 |
iceboatracing.command.pitbox |
/car create |
为玩家注册一艘船(交互式向导) |
iceboatracing.command.car |
/car list [page] |
列出所有赛车(可点击传送/移除/查看所有者) |
iceboatracing.command.car |
/car remove <id> <race> |
从某场比赛中移除一辆赛车 |
iceboatracing.command.car |
/car changeOwner <id> <race> <player> |
更改赛车所有者 |
iceboatracing.command.car |
/ibr reload |
从文件重新加载配置、语言文件和赛道 |
iceboatracing.command.plugin |
/ibr info |
显示一些信息 |
iceboatracing.command.plugin |
别名: /ibr = /iceboatracing · Tab 补全适用于所有子命令、赛道名称和玩家名称。
? 权限概览
| 权限 |
描述 |
默认值 |
iceboatracing.* |
所有权限 |
op |
iceboatracing.command.* |
所有指令 |
op |
iceboatracing.command.race |
/race 指令 |
op |
iceboatracing.command.checkpoint |
/checkpoint 指令 |
op |
iceboatracing.command.pitbox |
/pitbox 指令 |
op |
iceboatracing.command.car |
/car 指令 |
op |
iceboatracing.command.plugin |
/ibr 指令 |
op |
建议: 给予工作人员 iceboatracing.* 或特定的子权限,例如 iceboatracing.command.car。
✅ 兼容性
| 要求 |
版本 |
| Minecraft |
1.21.4+ |
| 软件 |
Paper |
| Java |
21 |
注意:
- 必须使用 Paper — 依赖 Paper 专属 API(Brigadier 命令、Adventure 组件)。不支持 Spigot/Purpur/Folia。
- 无需外部依赖 — 您只需要一个 Paper 服务器。
PacketEvents 是可选的,即使没有它插件也能正常运行。
- 发布在 Modrinth 和 CurseForge。
❓ 常见问题
为什么需要 Paper 而不是 Spigot?
它使用了 Paper 的 Brigadier 命令 API 以及 Adventure 的文本/标题/声音/粒子 API,这是最稳定且现代的服务器版本。
我的船在起跑时方向不对。
使用 `/race setStartRotation <race> <rotation>` 来设置。
AutoTrace 漏掉弯道 / 检查点生成顺序错误。
进行干净、连续的圈速且不回头。调整 `spacing`(默认 3 格)——长直道调高,急弯调低。使用 `/checkpoint autotrace resize`/`delete`/`add` 修复单个门控,然后再执行 `/checkpoint autotrace accept`。
玩家动作栏显示“非法游戏模式!”。
插件在比赛期间强制执行 `racingGameMode`(默认 ADVENTURE)。您可以禁用 `enforceRacingGameMode`,或确保您的服务器不会强制更改为其他游戏模式。
如果玩家跳过进站会发生什么?
如果他们未完成比赛要求的进站次数就直接冲过终点线,将自动被取消资格,并在最终排名底部单独列出,标记为 `DSQ`。
我可以只为一个车队提供进站箱吗?
可以 — `/pitbox setAllowed <race> <id> <names...>` 可将进站箱限制给特定玩家名称,或使用 `*` 允许任何参赛玩家。同一时间只有一个玩家可以占用一个进站箱。
我可以同时运行多场比赛吗?
可以 — 每场比赛独立追踪。使用比赛名称参数来指定目标比赛。
如何备份或将比赛迁移到其他服务器?
复制 `plugins/IceBoatRacing/races/` 文件夹(每个 `.yml` 都是一个完整的比赛文件,包括其进站箱和车辆)。复制 `config.yml` 和 `lang/` 以保留完整设置。
支持箱子船和竹筏吗?
支持 — 所有原版船只类型,包括 `*_CHEST_BOAT`、`BAMBOO_CHEST_RAFT` 和 `PALE_OAK_BOAT`(1.21.4+)。只需在创建车辆 `/car create` 时手持该物品即可。
? 链接
? 许可证
MIT 许可证 — 免费用于任何用途,包括商业服务器,但需正确署名。详见 LICENSE。

❄️ 专为 Minecraft 赛车社区打造
❄️ IceBoatRacing
A professional-grade Minecraft Paper plugin for competitive ice boat racing — precision checkpoints, live scoreboards, automatic track generation, mandatory pit stops, and full race management.

? What Is This?
IceBoatRacing turns your Minecraft server into a competitive ice boat racing platform. Create races, design tracks, register boats, enforce pit stops, and run events with live timing — all in one plugin.
Built for servers running competitive racing events (like Grands Prix by Mini Jeux Entre Potes).
✨ Features
| Category |
Features |
| Race Management |
Interactive creation wizard · Prepare/start/end races · Configurable lap counts · Auto-end when last player finishes · Clean ranking with a bunch of info when the race ends |
| Checkpoints |
Oriented rectangle that the racers cross to update the live scoreboard · Alternate bypass routes · Sector timing gates |
| AutoTrace |
Drive/Walk one lap → plugin generates precise checkpoints automatically · Particle preview · Edit checkpoints before saving |
| Pit Stops |
Mandatory (or not if set to 0), configurable pit-stop count per race · Timed pit boxes with a live countdown · Real F1 teams color themes (11 real F1 team gradients) · Automatic disqualification for racers who skip them |
| Live Scoreboard |
Real-time sidebar that shows the current ranking |
| Race Lights |
Optional 6-stage stained-glass starting lights (Brown → Red → Orange → Yellow → Lime → Green) synced with countdown |
| Car System |
Register boats per player (all wood types, rafts, chest variants) · Custom names · Auto-spawn on prepare · Invulnerable |
| Multi-Language |
English & French built-in · Extensible via YAML · MiniMessage and legacy color codes formatting (gradients and colors) |
| Storage |
One YAML file per race · Easy backup/export-import |
? Installation
- Download the latest
.jar
- Place it in your server's
plugins/ folder
- Restart the server
- Race.
⚙️ Configuration Highlights
Edit plugins/IceBoatRacing/config.yml:
language: en_US # en_US or fr_FR (add your own in lang/)
race:
allowRejoin: true # Let players rejoin mid-race after logout
racingGameMode: ADVENTURE # GameMode during race
enforceRacingGameMode: true
spectateOnFinish: true # Put finishers in spectator mode
removeCarWhenLoggingOut: false
Tip: Race lights require a 3D region defined by from/to coordinates. These get filled with stained glass during the 5-second countdown.
Tip: Pit stop count and start rotation is set per-race, not globally — use /race setPitStops <race> <amount> (defaults to 1).
⌨️ Commands
| Command |
Description |
Permission |
/race create |
Interactive race creation wizard |
iceboatracing.race.create |
/race start [name] |
Start race with 5s countdown + lights |
iceboatracing.command.race |
/race prepare [name] |
Spawn cars, teleport players, set Adventure mode |
iceboatracing.command.race |
/race end [name] |
End race, send ranking and useful info |
iceboatracing.command.race |
/race delete [name] |
Delete race permanently |
iceboatracing.race.create |
/race setLapCount [name] <amount> |
View/change lap count |
iceboatracing.command.race |
/race setPitStops [name] <amount> |
View/change required pit-stop count |
iceboatracing.command.race |
/race setStartRotation [name] <amount> |
View/change start rotation |
iceboatracing.command.race |
/checkpoint create <arguments> |
Create checkpoint from shovel selection |
iceboatracing.command.checkpoint |
/checkpoint remove [race] [id] |
Remove checkpoint by ID or nearest to player |
iceboatracing.command.checkpoint |
/checkpoint view <race> |
Toggle particle preview of all checkpoints |
iceboatracing.command.checkpoint |
/checkpoint list [page] |
List all checkpoints (paginated, clickable) |
iceboatracing.command.checkpoint |
/checkpoint autotrace start <race> [...] |
Begin recording a lap for AutoTrace |
iceboatracing.command.checkpoint |
/checkpoint autotrace accept |
Save generated checkpoints to race |
iceboatracing.command.checkpoint |
/checkpoint autotrace preview |
Toggle particle preview of generated checkpoints |
iceboatracing.command.checkpoint |
/checkpoint autotrace sector |
Add sector gate at nearest preview checkpoint |
iceboatracing.command.checkpoint |
/checkpoint autotrace resize |
Resize nearest preview checkpoint |
iceboatracing.command.checkpoint |
/checkpoint autotrace add |
Add a checkpoint |
iceboatracing.command.checkpoint |
/checkpoint autotrace delete |
Delete nearest preview checkpoint |
iceboatracing.command.checkpoint |
/checkpoint autotrace cancel |
Cancel AutoTrace session |
iceboatracing.command.checkpoint |
/checkpoint addAlternate <race> <id> |
Add an alternate checkpoint for a checkpoint (shovel selection) |
iceboatracing.command.checkpoint |
/checkpoint clearAll <race> |
Delete all checkpoints (with confirmation) |
iceboatracing.command.checkpoint |
/pitbox create <race> |
Interactive pit box creation wizard |
iceboatracing.command.pitbox |
/pitbox list <race> |
List all pit boxes (clickable edit/color/TP/remove) |
iceboatracing.command.pitbox |
/pitbox remove <race> <id> |
Remove a pit box |
iceboatracing.command.pitbox |
/pitbox setAllowed <race> <id> <names|*> |
Change which players may use a pit box |
iceboatracing.command.pitbox |
/pitbox setColor <race> <id> <color> |
Change a pit box's color theme |
iceboatracing.command.pitbox |
/car create |
Register a boat for a player (interactive wizard) |
iceboatracing.command.car |
/car list [page] |
List all cars (clickable TP/remove/owner) |
iceboatracing.command.car |
/car remove <id> <race> |
Remove a car from a race |
iceboatracing.command.car |
/car changeOwner <id> <race> <player> |
Change car owner |
iceboatracing.command.car |
/ibr reload |
Reload config, languages, races from file |
iceboatracing.command.plugin |
/ibr info |
Show some info |
iceboatracing.command.plugin |
Aliases: /ibr = /iceboatracing · Tab completion works for all subcommands, race names, and player names.
? Permissions overview
| Permission |
Description |
Default |
iceboatracing.* |
All permissions |
op |
iceboatracing.command.* |
All commands |
op |
iceboatracing.command.race |
/race commands |
op |
iceboatracing.command.checkpoint |
/checkpoint commands |
op |
iceboatracing.command.pitbox |
/pitbox commands |
op |
iceboatracing.command.car |
/car commands |
op |
iceboatracing.command.plugin |
/ibr commands |
op |
Recommendation: Give staff iceboatracing.* or specific children like iceboatracing.command.car.
✅ Compatibility
| Requirement |
Version |
| Minecraft |
1.21.4+ |
| Software |
Paper |
| Java |
21 |
Notes:
- Paper is required — uses Paper-specific APIs (Brigadier commands, Adventure components). Spigot/Purpur/Folia are not supported.
- No required external dependencies — you only need a Paper server.
PacketEvents is optional, the plugin will run just like normal without it.
- Published on Modrinth and CurseForge.
❓ FAQ
Why does it require Paper instead of Spigot?
It uses Paper's Brigadier command API, Adventure text/title/sound/particle APIs, which is the most stable and modern server version.
My boats face the wrong direction on start.
Use `/race setStartRotation <race> <rotation>` to .
AutoTrace missed a turn / generated checkpoints in wrong order.
Drive a clean, continuous lap without backtracking. Adjust `spacing` (default 3 blocks) — higher for long straights, lower for tight corners. Use `/checkpoint autotrace resize`/`delete`/`add` to fix individual gates before `/checkpoint autotrace accept`.
Players get "Illegal GameMode!" in action bar.
The plugin enforces `racingGameMode` (default ADVENTURE) during races. Either disable `enforceRacingGameMode` or ensure your server doesn't force a different gamemode.
What happens if a player skips a pit stop?
They're automatically disqualified when they cross the finish line without completing the race's required pit-stop count, and are listed separately at the bottom of the final standings marked `DSQ`.
Can I make a pit box available to only one team?
Yes — `/pitbox setAllowed <race> <id> <names...>` restricts a box to specific player name(s), or use `*` to allow anyone racing. Only one player can occupy a box at a time.
Can I run multiple races at once?
Yes — each race tracks independently. Use the race name argument to target a specific one.
How do I backup or move races to another server?
Copy the `plugins/IceBoatRacing/races/` folder (each `.yml` is a complete race, including its pit boxes and cars). Copy `config.yml` and `lang/` for full setup.
Are chest boats and bamboo rafts supported?
Yes — all vanilla boat types including `*_CHEST_BOAT`, `BAMBOO_CHEST_RAFT`, and `PALE_OAK_BOAT` (1.21.4+). Just hold the item during `/car create`.
? Links
? License
MIT License — free for any use, including commercial servers, but proper credit is required. See LICENSE.

Made with ❄️ for the Minecraft racing community
评论 0
登录后参与评分
还没有评论,来抢沙发吧