IceBoatRacing v2.0

A major update adding mandatory pit stops to races — full box detection, a per-team freeze-and-countdown sequence, and F1-team-themed visuals — plus disqualification handling for racers who skip them.

✨ Major Features

🅿️ Pit Box System

Racers can now be required to stop at a pit box mid-race, just like a real pit lane.

• New PitBox/PitBoxManager classes: each race can define any number of pit boxes, stored in the same race.yml as checkpoints and cars.
• Detection is folded directly into the existing checkpoint-crossing tick loop — no separate listener re-walking every racing boat.
• Entering an eligible box freezes the boat in place (velocity zeroed every tick) for a configurable duration — no early exit needed, since the freeze itself keeps the player inside the trigger zone.
• Adaptive title countdown (5, 4, 3... Go!) synced to each box's configured duration, with a rising-pitch pling on completion — mirrors the existing race-start light sequence.
• One occupant per box at a time; a box can be restricted to specific player names or opened to everyone (*).
• New PitBoxCreator: a guided, step-by-step wand-based setup (name → location → duration → allowed players → color), following the same chat-driven flow as RaceCreator.
• New /pitbox create|list|remove|setAllowed|setColor commands, with inline edit/color/remove/teleport buttons in /pitbox list.

🎨 Team-Themed Colors

Each pit box can be colored, including full gradients — not just solid colors.

• Preset color list rather than free-form hex input, so anyone setting up a box just types a name.
• Real F1 team livery gradients: McLaren, Mercedes, Red Bull, Ferrari, Williams, VCARB, Aston Martin, Haas, Alpine, Audi, and Cadillac.
• Plus solid basics (red/blue/green/gold) and a few extra gradients (the plugin's own ICE brand gradient, fire, rainbow).
• Colors apply live to the "BOX BOX" call and countdown title, so each team's stop feels distinct.
• Fully editable post-creation via /pitbox setColor <race> <id> <color>.

🏆 Mandatory Stops & Disqualification

• Races now have a configurable required pit-stop count (/race setPitStops, same pattern as setLapCount).
• Racers who cross the finish line without completing the required number of stops are marked disqualified with an immediate broadcast notice.
• Final ranking now correctly reconstructs finish order from crossing order (previously relied on unordered map iteration) and lists disqualified racers separately at the bottom under a DSQ marker, below all qualified finishers.

🌍 Localization

• Full fr_FR/en_US coverage for every new pit box message, command, and creation step.

🛠️ General / Technical

• PitBoxManager mirrors CheckpointManager's save/load conventions exactly, so pit box storage follows the same per-race config pattern as everything else.
• Pit box task type is stored as an enum (TIMED for now) rather than hardcoded, so future task types (e.g. skill-based stops) won't need a config migration.
• Lowered the minimum supported Paper version to 1.21.4 — the version registerCommand() was introduced in, and also the version Paper hard-forked from its former Spigot upstream on, making it effectively the floor for the current Paper API. Built and tested with Java 21, no errors.

📝 Notes

Pit boxes ship as a v1: timed stops only, mandatory, no early exit. Task variety (beyond a simple timer) and finer-grained enforcement (e.g. blocking the finish line itself rather than DSQ-ing after the fact) are natural next steps if you want to build on this.

Ice Boat Racing 2.0-BETA-2

Bug fixes update

Downgraded Paper build and Java version to actually support 1.21.9 and later (and nothing changes on modern versions). Added /checkpoint autotrace add. Actually fixed /checkpoint autotrace resize (fr this time). Added centerline preview in autotrace preview. Updated /checkpoint create to work with planes. Fixed CheckpointManager#getNearestCheckpoint (would cause a branch of /checkpoint remove to not work properly). Updated some messages. Position set messages now won't show it the position hasn't changed. Checkpoint#getCenter now also supports BOX checkpoints (propably fixing a bunch of bugs btw). RaceCreator's cancel operation now actually cancels.

Disclaimer

This is still a beta version of v2.0, so it will probably contain bugs. If you encounter any, please report them on GitHub (click me) (or the 'Report issues' button on the right of this plugin's page)

IceBoatRacing 2.0-BETA 1

Fixed a bunch of bugs including:

• Fixed /checkpoint autotrace resize
• /checkpoint remove now supports new checkpoints
• Fixed /race setLapCount

Added automatic race load when loading a world gets loaded and saved when a world gets unloaded.

Full changelog on the previous version

IceBoatRacing v2.0-BETA

A major update focused on multi-race support, a brand-new auto-trace checkpoint system, and a big pass on stability, translations, and race-finish feedback. This is a BETA release — core features are implemented and playable, but some older systems are still being polished and re-tested.

✨ Major Features

🏁 Multi-Race System

IBR now supports multiple simultaneous races instead of a single global race.

• New Race class: every race (checkpoints, cars, sectors, data) is now scoped to its own race instance instead of being global.
• RaceManager can load, save, and manage many races at once.
• Cars, checkpoints, and sectors are all race-aware.
• Races can be started/ended/prepared directly from Race.java, without needing to go through RaceManager.

🧙 RaceCreator: Guided Race Setup

A new guided, step-by-step process for creating a race from scratch, replacing manual/scattered setup steps.

🛰️ Auto-Trace Checkpoint System

A brand new way to place checkpoints — record a lap and let IBR trace the track for you instead of manually placing every checkpoint with a wand.

• Full language/config support for auto-trace messages.
• Integrated directly into the RaceCreator guided flow.
• New /checkpoint view <Race> command to visualize all checkpoints of a race.

🌍 Localization

• Full French (fr_FR) and English (en_US) language files, including translated error and ranking messages.
• Auto-trace and checkpoint messages now support the language config system.

🏆 Ranking & Finish Stats

• Races now send a full ranking when they end, with proper error handling/logging.
• Players get a personal stats message when they finish a race, including best sector times (fixed a bug where these previously wouldn't display correctly).

🚤 Cars

• Added support for chest boat cars.
• Prevented players from creating more than one car per race.
• Fixed cars not deleting properly (config path bug).
• Fixed the car listener not stopping cars from moving before a race starts.
• Cars are now removed before respawning to prevent duplicate boats.
• Improved handling of cars when a player disconnects and reconnects mid-race (start location, logging, etc.).

🏎️ Races

• Races now automatically end when the last racer disconnects.
• Racing gamemode is now enforced and configurable, along with spectateOnFinish, via config.yml.
• Added /race setLapCount.
• Added support for players disconnecting and reconnecting during an active race.
• Players can now skip a checkpoint if needed.
• Fixed /race delete reading from the wrong race list.
• Fixed race name lookups not supporting spaces.

🛠️ General / Technical

• Migrated the project from Maven to Gradle.
• Plugin version in build.gradle.kts is now kept in sync with paper-plugin.yml.
• Rewrote README.md.
• Added automatic reload when a world loads.
• Various dev quality-of-life improvements.
• Numerous bug fixes and project warning cleanups throughout (checkpoint/car commands, tab completion, sidebar scoring, sector/finish messages, and more).

📝 Notes

This is a BETA build — auto-trace and several reworked systems are still being play-tested. Feedback and bug reports are very welcome!

Disclaimer: This is an alpha, as it doesn't contain any new groundbreaking feature.

• Removed LuckPerms dependency, as it wasn't used
• Limited to only 1 passengers per car during a race (otherwise racers could hop in other racer's cars)
• Added temporary ranking that will be sent in the console on race end (planning on implementing a better one)
• Racers will automatically be put in spectator mode when they finish the race

Disclaimer: This is an alpha, as it doesn't contain any new groundbreaking feature.

• Added comments in the default config and language configs to make them easier to understand.
• Can now configure race lap count in config under race.lapCount

  = The required laps to complete the race

Additions

• Plugin now supports multiple languages
• Cars now support custom names -> Better support for the race cars texture pack
• Car rotation on race start is now customisable in config under the path race.startRotation
• Added race lights (like colored glass that change color during the countdown) - configurable in config under race.lights.[...]

A bunch of fixes

• Fixed /ibr reload (now actually reloads)
• Race world is now set correctly
• Fixed /ibr where prefix would show correctly
• Config would sometimes not be saved
• And more...

Bug fixes