Navigation

Quick Start

Project Structure

Car Manager

Track Generator

Powerups

Game Systems

Levels

Car AI

Customization

Support

Track Generation

Wheel Rush uses a seed-based, weighted procedural system to generate track layouts. Each track piece has an assigned weight, and the generator selects pieces based on those weights and the current level’s seed ensuring variability while maintaining control.

Adding a New Track Piece

Follow these steps exactly. Track generation is flexible, but mistakes here will break the path alignment, AI navigation, or collision logic.

1. Prepare Your Track Piece Model

Before adding anything:

• The ground mesh (the surface cars drive on) must be sized:

  X = 2 units (2 meters)

• Ensure the mesh is clean, centered, and properly aligned in its own file.

2. Use the Track Piece Template

1. Open Assets/Prefabs/Misc/

2. Drag track_piece_template into an empty scene

   

3. Right-click the prefab instance → Prefabs → Unpack Completely

This gives you a clean, editable base.

3. Insert Your Mesh

1. Expand the parent object.
2. Find the meshes child object.
3. Drag your track mesh under meshes.
4. Position it correctly.
5. Set its layer to “Ground”.
6. Add a Mesh Collider if not already present.

4. Position the Start/Join Points

Under the track piece parent, you will see two empty objects:

• start
• join

These define where the piece begins and where the next piece connects.

Align these precisely to match the geometry of your track piece.

<aside> 🚨

Bad alignment = broken tracks during runtime.

</aside>

5. Configure AI Waypoint Lanes

The WaypointLanes component controls how AI cars move through the track.

1. Create empty GameObjects under the track piece parent.

   These will act as waypoints.

2. Place them along the path you want AI cars to follow.

3. Select the parent track piece.

4. In WaypointLanes:

   • Add the number of lanes you want.
   • Assign the waypoint objects to each lane manually.

Critical Rule:

Inside each lane, waypoint order must go from “start” → “join”.

If the order is reversed or mixed, AI cars will behave incorrectly.

6. Save as Prefab

Drag the track piece parent back into the Project window to create a new prefab.

This is now your usable track piece.

7. Register the Track Piece in the Generator

1. Open Assets/Prefabs/systems.fbx
2. Select the Track Generator object.
3. Add a new track piece entry.
4. Assign:
   • The prefab you created
   • Its weight (This determines how often your piece appears during procedural generation.)
   • Its piece type

<aside> ❓

Need Help?

If you run into issues with track alignment, AI movement, or generation settings, feel free to contact us—we’re always happy to help.

</aside>