❄️ 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 without leaving the game.

Built for servers running competitive racing events (like Grands Prix by Mini Jeux Entre Potes).

✨ Features

📦 Installation

1. Download the latest .jar
2. Place it in your server's plugins/ folder
3. Restart the server (or run /ibr reload)
4. First run generates:
   • plugins/IceBoatRacing/config.yml
   • plugins/IceBoatRacing/lang/en_US.yml & fr_FR.yml
   • plugins/IceBoatRacing/races/ (race data folder)

⚙️ 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

  lights:
    enabled: false           # Set true + configure from/to coords to enable
    from: { x: 0, y: 0, z: 0 }
    to:   { x: 0, y: 0, z: 0 }

  startRotation: 0           # Boat yaw on start (degrees)

Tip: Race lights require a 3D region defined by from/to coordinates. The plugin fills it with stained glass during the 5-second countdown.

Tip: Pit stop count is set per-race, not globally — use /race setPitStops <race> <amount> (defaults to 1).

⌨️ Commands

Aliases: /ibr = /iceboatracing · Tab completion works for all subcommands, race names, and player names.

🔑 Permissions

Recommendation: Give staff iceboatracing.* or specific children like iceboatracing.race.*.

✅ Compatibility

Notes:

• Paper is required — uses Paper-specific APIs (Brigadier commands, Adventure components). Spigot/Purpur/Folia are not supported.
• No external dependencies — only Paper API (compile-only).
• Published on Modrinth and CurseForge.

❓ FAQ

<details> <summary>Why does it require Paper instead of Spigot?</summary> It uses Paper's Brigadier command API, Adventure text/title/sound/particle APIs, and modern NMS mappings — none of which exist on Spigot forks. </details>

<details> <summary>My boats face the wrong direction on start.</summary> Change race.startRotation in config.yml (degrees: 0=South, 90=West, 180=North, 270=East), then /ibr reload. </details>

<details> <summary>AutoTrace missed a turn / generated checkpoints in wrong order.</summary> 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 to fix individual gates before /accept. </details>

<details> <summary>Players get "Illegal GameMode!" in action bar.</summary> The plugin enforces racingGameMode (default ADVENTURE) during races. Either disable enforceRacingGameMode or ensure your server doesn't force a different gamemode. </details>

<details> <summary>What happens if a player skips a pit stop?</summary> 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. </details>

<details> <summary>Can I make a pit box available to only one team?</summary> Yes — /pitbox setAllowed <race> <id> <names...> restricts a box to specific player names, or use * to allow anyone racing. Only one player can occupy a box at a time. </details>

<details> <summary>Can I run multiple races at once?</summary> Yes — each race tracks independently. Use the race name argument to target a specific one. </details>

<details> <summary>How do I backup or move races to another server?</summary> Copy the plugins/IceBoatRacing/races/ folder (each .yml is a complete race, including its pit boxes). Copy config.yml and lang/ for full setup. </details>

<details> <summary>Are chest boats and bamboo rafts supported?</summary> Yes — all vanilla boat types including *_CHEST_BOAT, BAMBOO_CHEST_RAFT, and PALE_OAK_BOAT (1.21.5+). Just hold the item during /car create. </details>

❤️ Support & Links

• Modrinth: modrinth.com/plugin/ibr
• CurseForge: curseforge.com/minecraft/bukkit-plugins/ice-boat-racing
• Source Code: github.com/mattmunichYT/IceBoatRacing
• Issues / Bug Reports: GitHub Issues

📄 License

MIT License — free for any use, including commercial servers. See LICENSE.