🧊 IceBoatRacing

IceBoatRacing is a fast, lightweight, and competitive ice boat racing plugin for Minecraft servers.

Create custom race tracks with checkpoints and sectors, spawn race boats ("cars"), track lap times, and run full races with live updates.

Perfect for minigame servers, events, and competitive boat racing maps.

---

✨ Features

• 🏁 Full race system with start/end control
• ⛵ Custom boat "cars" with owner support
• 📍 Checkpoints & sector checkpoints
• ⏱ Lap completion time tracking
• 📊 Live sidebar / scoreboard display
• 🌍 Multi-language message system
• ⚙️ Fully configurable plugin settings
• 🛠 Admin-friendly setup commands

---

🏎 Cars System

IceBoatRacing uses a car system (boats used as racing vehicles):

• Create cars with a step-by-step setup wizard
• Assign an owner to each car
• Remove or manage cars easily
• Players are automatically placed into their car during preparation mode

---

📍 Checkpoints & Sectors

Track progression through the race course using:

• Start line and finish line
• Multiple checkpoints
• Optional sector checkpoints
• Admin tools to list, remove, and normalize checkpoints

---

🏁 Race Management

Races can be controlled easily:

• Start a race instantly
• Enable preparation mode (players placed automatically)
• End races at any time

---

📜 Commands

/race

Command	Description
/race start	Starts the race
/race end	Ends the current race
/race prepare	Enables preparation mode*

*Players will be teleported to their car when they join (or if they're already online)

---

/checkpoint

Command	Description
/checkpoint pos1	Set checkpoint position 1*
/checkpoint pos2	Set checkpoint position 2*
/checkpoint create	Create a checkpoint
/checkpoint setFinish	Save the start/finish line**
/checkpoint list	List all checkpoints
/checkpoint remove <id>	Remove a checkpoint

*You can also use a shovel to define the positions. (use it like the WorldEdit axe)

**This defines the start line. Define 2 of them if your track doesn't have the same start and finish line

---

/car

Command	Description
/car create	Start the car creation wizard
/car list	List of the cars, and buttons
/car remove <id>	Remove a car*
/car owner <id> <player>	Change car owner*

*Just use /car list, it's easier

---

🌍 Language Support

IceBoatRacing supports multiple languages.

Select the language in config.yml:

language: en_US

Messages are stored in:

plugins/IceBoatRacing/lang/en_US.yml
plugins/IceBoatRacing/lang/fr_FR.yml

How to add your own language

1. Duplicate the file plugins/IceBoatRacing/lang/en_US.yml
2. Rename it to your_language.yml
3. Actually translate (you can ask an AI to do it if you want)
4. Change the config from:

language: en_US

to

language: your_language

But if you want the language to be added directly to the plugin, contact me on Discord (@mattmunich)!

---

⚙️ Configuration

• Customizable messages
• Prefix support
• Sidebar title & join/quit formatting
• Fully editable race text and feedback

---

📦 Installation

1. Download the plugin .jar
2. Put it into your server's plugins/ folder
3. Restart the server
4. Configure everything in:

plugins/IceBoatRacing/config.yml
plugins/IceBoatRacing/lang/

1. Setup your track:

• Set the start line using /checkpoint setFinish (it will act as start and finish)
• Create checkpoints using /checkpoint create
• Define sectors using /checkpoint create SECTOR [sectorID]

-> Sectors will tell your current lap-time in chat when you cross them

• Create race cars using /car create
• Start racing with /race start!

---

✅ Requirements

• Minecraft 1.21+
• Paper / Spigot compatible server
• Adventure API supported

---

⚙️ Bugs/issues

Please report any bugs you encounter on GitHub: https://github.com/mattmunichYT/IceBoatRacing/issues

Or contact me on Discord (@mattmunich)

Thank you very much, this helps me a lot!

---

🧊 Made for Competitive Ice Boat Racing

IceBoatRacing is designed to provide a clean and fun racing experience with proper timing, checkpoints, and full race control.

If you enjoy fast-paced boat racing, this plugin is for you.

---