---

Terracarts brings coal-powered vehicles to Minecraft, designed to feel like a natural extension of vanilla survival. Explore the world to discover rare cores, build your own vehicle, customize its appearance, and hit the road.

---

---

Screenshots taken on the Umihara City map by Shiomate — huge thanks!

Map: Umihara City 海原 · Creator: Shiomate

---

✨ Features

• 🚙 Four Vehicle Tiers: Standard, Swift, Sturdy, and Prime, each with randomized stats.
• 🗺️ Exploration & Loot: Find vehicle cores in structure chests. Each core determines your Terracart's tier and randomized stats.
• ⚙️ Driving Physics: Responsive steering, downhill acceleration, uphill resistance, and terrain-dependent handling across different environments.
• 💥 Collisions & Crashes: Collide with mobs, walls, other vehicles, and the environment. Crashes can damage your vehicle, cause fuel loss, injure the driver, and temporarily stall the engine.
• ⛽ Fuel & Repairs: Refuel with coal and repair your vehicle with iron ingots.
• 🎨 Customization: Paint your vehicle with any of Minecraft's 16 dyes and give it a custom name.
• 📊 Driving HUD: View your speed, fuel, and vehicle health while driving.
• 🔊 Custom Sounds: Unique engine sounds for each tier, plus sounds for braking, shifting, sputtering, impacts, and crashes.
• ✨ Visual Effects: Animated wheels and steering, with particles during movement and collisions and every interaction.

---

🎮 How to Play

🗺️ 1. Find a Core

Cores cannot be crafted. Find them in structure chests.

Core Tier	Location
⚙️ Standard	Village Toolsmith, Weaponsmith, and Armorer chests
🛡️ Sturdy	Nether Fortress chests
⚡ Swift	Bastion Remnant chests
💎 Prime	Ancient City chests

Each core has randomized stats:

• 🏁 Top Speed: 17–25 blocks per second (BPS)
• ⛽ Fuel Capacity: 70–140 Fuel Units (FU)
• ❤️ Hull Health: 70–140 HP

🔧 2. Craft Your Terracart

Craft Terracart Wheels using 1 Iron Ingot + 4 Black Wool.

Then combine the following in a crafting table:

• 4 × Terracart Wheels
• 1 × Vehicle Core
• 1 × Iron Ingot
• 1 × Saddle
• 1 × Glass
• 1 × Minecart

Your Terracart inherits the randomized stats of its core.

🕹️ 3. Driving Controls

Input	Action
Right-click	Enter the vehicle
Hold Shift	Exit the vehicle
W	Accelerate forward
S	Brake, then reverse once stopped
A / D	Steer left / right

⛽ 4. Fuel, Repairs & Damage

Action	How It Works
⛽ Refuel	Hold Coal and right-click the vehicle.
Fuel Rate	1 Coal = 15 FU, providing 2 minutes of continuous driving. Fuel is consumed only while moving.
💥 Damage	Crashes, falls, heavy impacts, and explosions can damage the vehicle and injure the driver.
🔧 Repair	Hold an Iron Ingot and right-click the vehicle.
Repair Rate	Each Iron Ingot restores 15 HP.

💥 5. Collisions, Mobs & Environment

Vehicle Collisions

Collision Speed	Hull Damage	Fuel Loss	Driver Damage	Other Effects
🟢 Below 8 BPS	1–2 HP	—	—	—
🔴 8 BPS or above	5–15 HP	1–5 FU	1.5–3 hearts	0.5-second engine stall and recoil

Mob Interactions

Mob Category	Interaction
🐾 Light & Medium Mobs	Can take up to 22 HP impact damage.
🧱 Heavy Mobs	Act as solid obstacles. High-speed collisions can trigger the full crash consequences.

Environmental Interactions

Environment	Effect
🌿 Leaves	Increase driving resistance.
💧 Shallow Water	Reduces driving speed.
🌊 Deep Water	Causes vehicles to sink.
🔥 Fire & Lava	Dangerous to vehicles.
💣 Explosions	knock vehicles into the air.

Terrain also affects driving, including acceleration downhill and resistance uphill.

🎨 6. Painting & Naming

• Paint: Right-click with any of Minecraft's 16 dyes.
• Remove Paint: Right-click with a Wet Sponge to restore the factory-gray color. In Survival, the sponge becomes a Dry Sponge.
• Rename: Right-click with a Name Tag.

♻️ 7. Core Recovery

When a Terracart is destroyed, its core drops with its original randomized stats preserved. Use it to craft another vehicle with the same core attributes.

---

📝 Notes & Compatibility

🧩 Compatibility

• Flashback: Recorded replay playback may cause carts to stutter. (Fixed in V3.0).
• Debugify: enabling the fix for MC-259512 may cause carts to stutter while turning. (Fixed in V2.0+26.3).

🔄 World Migration

When updating from a Terracarts version before V3.0, legacy Terracarts will be converted to Standard Terracarts under the new random-stat system. Carts placed in the world will receive randomized stats.

🚦 A Friendly Reminder

Drive safely and build smooth paths or tracks for a better journey!