BoatRacing

An F1-style ice boat racing plugin for Bukkit/Spigot (Paper/Purpur compatible) with a clean, vanilla-like GUI. Manage teams, configure tracks, run timed races with checkpoints, pit penalties, false starts, 5-light countdowns, ghost replays, and more — all with full multi-language support (16 languages).

What's New in 26.2

• New version numbering: aligned with Minecraft's new YY.D.H system (Year.Drop.Hotfix). Plugin version now matches the Minecraft release it targets.
• Per-track broadcast mode: racing.broadcast-mode accepts global or racers, overridable per track. Contributed by @MC-MrBirdy in #5.
• Per-track lobby configuration: lobby settings can now be set per track for dedicated lobbies. Contributed by @MC-MrBirdy in #5.
• Per-track rewards configuration: rewards can now be overridden per track. Contributed by @MC-MrBirdy in #5.
• Admin -p: target flag: admins/console can target other players for commands by appending -p:<player>. Contributed by @MC-MrBirdy in #5.
• Start lights wand UX: Shift+Left Click a Redstone Lamp with the wand to add, Shift+Right Click to remove. Lamp glows with green particles on add.
• Per-track registration time: /boatracing setup setregtime <seconds> and setup wizard step 8/8. Reported by @supershootstudions-lgtm in #6.
• Restart command: /boatracing race restart [track] stops + re-opens + re-joins + force-starts in one command. Auto-detects track.
• Clearlobby command: /boatracing setup clearlobby to disable the lobby for a track.
• Debug logging levels: debug: "off"/"severe"/"warning"/"info"/"fine"/"finer"/"finest" in config.yml.
• Setup show: now shows laps, registration time, and properly translated status labels.
• MC-MrBirdy added as co-author for ongoing contributions across multiple releases.

What's New in 1.1.6

• Forfeit command (/boatracing race forfeit): abandon a race without stopping it for others. Forfeited players show as DNF in results. Contributed by @MC-MrBirdy.
• Practice ghost replay: your best practice run is recorded as a ghost boat that replays alongside you.
• Database persistence: SQLite (default), MySQL, or YAML storage. JDBC drivers auto-downloaded with SHA-256 verification on first run.
• Practice leave: /boatracing race practice leave <track> and auto-exit on disconnect.
• Minecraft 26.2 support: AnvilGUI updated for native 26.1/26.2 compatibility.
• Fast-crossing detection: ray-AABB segment intersection prevents checkpoints/finish lines from being missed at high boat speeds.
• SimpleScore/TAB compatibility: sidebar plays nice with external scoreboard plugins.

Full changelog →

Features

• Team system: create/join/leave teams, set racer numbers and boat types, team colors
• Admin GUIs: manage teams, players, race control, and named tracks from in-game menus
• Named tracks: per-track YAML configs with laps, pit stops, penalties, registration time, broadcast mode, and start slot overrides
• Setup wizard: 8-step guided flow to configure starts, finish, lights, pits, checkpoints, laps, and registration time
• Race systems: ordered checkpoints, mandatory pit stops, false-start penalties, 5-light F1-style countdown, registration lobby teleport/return
• Ghost replays: best practice runs saved as ghost boats with no-collision rules
• Map voting: /boatracing race voteopen with auto-open winner registration
• Solo practice: /boatracing race practice <track> to train alone
• PlaceholderAPI: 100+ %boatracing_*% placeholders for holograms, scoreboards, NPCs
• i18n: 16 bundled languages (EN/ES official + 14 community translations), hot-reloadable
• Rewards: per-position race rewards with commands, messages, and broadcasts — now per-track configurable
• SQLite/MySQL/YAML storage: pluggable persistence with automatic legacy migration
• Per-track configuration: broadcast mode, lobby, rewards, registration time — all overridable per track

Quick Start

1. Download and place in plugins/
2. /boatracing teams → create a team
3. /boatracing setup wizard → configure a track (8 steps)
4. /boatracing race open <track> → open registration
5. /boatracing race join <track> → players join
6. /boatracing race start <track> → go!

Commands

Command	Description
/boatracing teams	Open team GUI
/boatracing race open/join/leave <track>	Manage race registration
/boatracing race start/force/stop/restart <track>	Control races
/boatracing race practice <track>	Start solo practice
/boatracing race forfeit	Abandon current race
/boatracing race voteopen/vote/voteui	Map voting
/boatracing stats [player]	View stats (admins: -p:<player>)
/boatracing setup wizard	Guided track setup (8 steps)
/boatracing setup show	View current track configuration
/boatracing setup setlaps/setregtime/setpitstops	Per-track overrides
/boatracing setup setlobby/clearlobby	Lobby configuration
/boatracing admin	Admin management hub

Requirements

• Java 17+
• Bukkit/Spigot/Paper/Purpur 1.19 – 26.2
• PlaceholderAPI (optional, for placeholders)

Links

• GitHub · Changelog · QA Checklist