Open Boat Race
A configurable, open-source server-side ice boat racing mod built using the Nucleoid project!
Screenshots
About this Mod
Open Boat Racing
A configurable, open-source server-side minecraft minigame mod built using the Nucleoid project!
This mod comes with 3 different game modes:
- TimeTrial: Compare personal bests against other players.
- Qualifying: Set a best lap time to qualify for a grid position.
- Race: "The only place that matters is first." - Max Verstappen
With support for teams, pit-stops, OpenBoatUtils¹, strange lightning rods, and more!
Join the Mumbo Jumbo discord server where we occationally run events with this among other mods within the Nucleoid project :3
Usage
Use /game open boatrace:example to get started! The mod does not include any maps. You will have to create maps or join a server (like ours!) that already have maps for this mod.
Mapping
You will need Nucleoid Creator Tools to create a map, you can follow their tutorial here to get started. Open Boat Racing uses the following regions with the following nbt in /map region (Region) and additional data nbt with /map data (Data).
(Region) `checkpoint` and `grid_box`
{
"index": [Int],
"yaw": [Float], // default: 0
"pitch": [Float], // default: 0
}
(Region) `spawn` and `pit_lane`
{
"yaw": [Float], // default: 0
"pitch": [Float], // default: 0
}
(Data) `track_format`
2 // this must be a constant and included with every map.
(Data) `meta`
{
"name": [String], // default: Unknown Name
"authors": [List[String]], // default: Unknown Authors
"description": [String], // Optional
"url": [String], // Optional
}
(Data) `attributes`
{
"time_of_day": [String],
"layout": ["circular" | "linear"] // default: "circular"
}
(Data) `openboatutils`
TODO document me https://github.com/Abaan404/boatrace/blob/3508adb0c3d3d0266115a162424e49f5bbd58c6c/src/main/java/com/abaan404/boatrace/compat/openboatutils/OBUTrackConfig.javaConfig
Check out the plasmid docs on creating a config to make a minigame. To choose a specific game mode, you must omit or include these fields accordingly:
- TimeTrial: exclude
qualifyingandrace. - Qualifying/Race: include
qualifyingandrace. - Race: exclude
qualifyingbut includerace. - OpenBoatUtils (experimental): adding this field makes the game require OpenBoatUtils, anyone who doesnt have the client mod will be forced into spectator.
config
{
"type": "boatrace:game",
"track": [Identifier],
"team": {
"size": [Int] // default: 1
},
"qualifying": {
"duration": [Long], // in ms
"laps": [Int] // optional
},
"race": {
"max_duration": [Long], // in ms
"max_laps": [Int], // default 1
"no_respawn": [Bool], // default: false
"accept_unqualified": [Bool], // default false
"pits": {
"success": {
"duration": [Long], // default 2000ms
"random": [Long] // default 3000ms
}
"failure": {
"duration": [Long], // default 2000ms
"random": [Long] // default 0ms
}
"count": [Int] // default 0
}
"grid_type": ["normal" | "reversed" | "random"], // default "normal"
"go_countdown": {
"duration": [Long], // default 5000ms
"random": [Long] // default 2000ms
}
"scoring": [List[Int]], // default: [10, 9, 8, 7, 6, 5, 4, 3, 2, 1]
},
"openboatutils": {
"filter": [List[String]],
"collision": ["vanilla" | "no_collision_with_any_entities" | "filtered_collision" | "no_collision_with_boats_and_players_plus_filtered_collision"],
"resolution": [Byte],
}
}
¹ OpenBoatUtils support is experimental and is seperately marked with +OBU, additional game configs will be required to setup the client.
Available Versions
How to Install Open Boat Race on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (26.1.2).
Install Mod
Open the mod browser in the dashboard and search for "Open Boat Race". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
26.1.2, 1.21.4
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Open Boat Race server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.1.2). You can switch loaders with one click in the panel.
Is Open Boat Race compatible with fabric?
Open Boat Race officially supports fabric for Minecraft 26.1.2, 1.21.4. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Open Boat Race – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Open Boat Race consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Open Boat Race with just one click on your server.