Ice Boat Racing

Ice Boat Racing - v2.2

Changelog

/race prepare bug:

Fixed* - the racers wouldn't be able to move when /race prepare was ran before /race start

LiveScore:

Updated the _old_ LiveSideBar to have more info* (lap count and pit stops). * Format can be customized in the lang files (liveScore.format)

PitBoxes:

Switched from names to UUIDs* as identifiers (more reliable) Backward compatibility*: will convert old pit boxes that are still using names. Fixed the tab suggestions* when using /pitbox setAllowed [race][player names...] (the names suggestions didn't work as intended)

Race Lights:

Now easier* to set/modify: * Added /race setLights * Use easy-to-use pos1/pos2 with a wooden shovel to define * Updated the way they were stored and placed

Messages:

* The side bar title has been moved from noPrefix.liveSidebarTitle to liveScore.title * Added playerNeverJoined for PitBoxCommand.java * Updated some help messages for the commands as they didn't use the same format and added the missing help message for /car. * checkpoint.pos.1/2/notSet were moved to pos.1/2/notSet as they are now used for setting the race lights

So if you use a custom language file, I suggest you update it so that no messages are missing for you.

IceBoatRacing v2.1

Changelog

* Collisions:

Disabled server-side collisions when [PacketEvents](https://modrinth.com/plugin/packetevents) is installed. (So boats collisions shouldn't be as glitchy as they currently are in Vanilla Minecraft)

* Race start rotation:

Updated the /race command to support /race setStartRotation and start rotation now gets auto-applied after autotracing.

* Technical:

Added 3 new lang messages: currentStartRotation, updatedStartRotation and invalidStartRotation

Cleaned up the code for the /race command

Removed unused permissions

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)](https://github.com/mattmunichYT/IceBoatRacing/issues) (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

What's new in 1.1

- Plugin now fully supports the Paper permission system (this means it supports LuckPerms and other permission plugins) - Fixed some bugs

Version 1.0

Initial version, see project description.