TrackLang: Getting Started

Opening Track Developer

1. Navigate to your track list or create a new track
2. Click "Edit Track" to enter edit mode
3. Click "Track Developer" button to open the code editor
4. Track Developer opens with source code window + 3D track view

Track Developer Interface

The Track Developer interface has two main areas:

• Code Editor (left/top): Write TrackLang code with syntax highlighting and autocomplete
• 3D Preview (right/bottom): Live 3D visualization of your track—updates as you code
• Toolbar: Run, Save, Version controls, and settings
• Console: Errors, warnings, and build output

Option 1: Start from Template

The easiest way to get started:

1. In Track Developer, click "Templates" or "New from Template"
2. Browse pre-fab templates for common track styles (outdoor MX, supercross, flat track, etc.)
3. Select a template that matches your desired track style
4. Template code loads into editor with 3D preview
5. Modify the template to fit your actual track layout

Templates include all necessary structure—start/finish, timing zones, basic geometry. Just customize GPS coordinates if required or use a virtual space without GPS.

Option 2: Start from Scratch

For experienced users or unique track layouts:

1. Open Track Developer with a blank track
2. Define basic track structure (name, location, discipline)
3. Define first section of track (turn, jump, slope, etc.)
4. Define any subsequent sections of track (turn, jump, slope, etc.)
5. If creating a circuit track, define a junction to connect the first and last section of track
6. If using a pit lane, starting chute or an exit be sure to defin junctions appropriately to enter and exit the track
7. Add timing zones for lap detection
8. Configure cameras (optional)
9. Preview in 3D to verify layout

Running Code (Build Version)

Click "Run" to execute TrackLang code. This creates a build version—a snapshot of the track at this moment. Every run creates a new build version, preserving history even if you make mistakes.

Saving to New Version

Click "Save New Version" to create a named version (e.g., v1.0, v2.0, "Spring 2025 Layout"). Versions can be marked public or private. Public versions are duplicatable and forkable by others.

Public vs. Private Versions

• Public: Visible in track library, others can duplicate/fork, used for public events
• Private: Only you (and team members) can see/use, good for testing or proprietary layouts

Version History

Every saved version is preserved:

• View all versions in track history panel
• Compare versions side-by-side
• Revert to previous version if needed
• See who made changes and when (for team tracks)

Forking Tracks

"Forking" creates a new track based on an existing one:

1. Find a public track you like (yours or someone else's)
2. Click "Fork" to create a copy under your account
3. Modify the fork as needed (change layout, camera positions, etc.)
4. Save as your own version
5. Use for events or make public for others to fork

Team Collaboration

Multiple developers can work on the same track:

• Invite team members to a track (share permissions)
• Team members can edit, run, and save versions
• Version history shows who made each change
• Merge conflicts handled automatically (last save wins, but history preserved)

Where Tracks Appear

• Track Developer: Live 3D view as you code
• Event pages: 3D track map for riders and spectators
• Track library: Isometric 2D previews of all tracks
• Race Control: Live 3D track with rider positions during races
• Results pages: Track layout context for race finishes

Rendering Modes

• 3D: Full 3D view with terrain elevation, obstacles, and camera perspective
• Isometric 2D: Flat, overhead view—easier to see full layout at a glance
• Satellite overlay: Track path overlaid on satellite imagery (if GPS geofence is used)

Available Template Styles

• Outdoor Motocross (MX): Natural terrain track with elevation changes
• Supercross (SX): Stadium-style track with technical obstacles
• Flat Track: Dirt oval for flat track racing
• Arenacross: Compact indoor track layout
• Endurocross: Extreme obstacles and technical sections
• Practice Track: Simple loop for training and casual riding

Using Templates

1. Open Track Developer → "New from Template"
2. Browse templates and select one
3. Template code loads in a virtual space without GPS
4. Set GPS geofence if desired
5. Add your own custom features and junctions as needed
6. Adjust distances, heading, tilt, fov, height, timing zones, cameras to match your track
7. Build it to see your track in 3D

Do I need to install anything to use TrackLang?

No. Everything runs in your browser. Track Developer is a web-based code editor—no downloads required.

Can I edit someone else's track?

Not directly. But you can fork public tracks, which creates your own copy. Edit the fork however you want—it's yours now.

What happens if I make a mistake and save a broken version?

No problem! Version history preserves every previous version. Just revert to the last working version and continue from there.

How do I know if my TrackLang code is correct?

Click "Run." If there are syntax errors, the console shows them. If no errors, the 3D view updates. For timing accuracy, run ad-hoc races to test timing zones.

Can multiple people edit the same track simultaneously?

Team members can edit, but not simultaneously like Google Docs. Last save wins. Version history prevents losing work—you can always see previous versions.

Are templates customizable?

Absolutely! Templates are just starting points. Modify GPS coordinates, timing zones, cameras, and geometry to match your actual track.

Do I need to know programming to use TrackLang?

Not necessarily. Templates + examples + autocomplete make it accessible to non-programmers. But coding experience helps for complex tracks.

Can I export TrackLang code?

Yes! Tracks can be exported as TrackLang files for backup or sharing outside Adrenaline. You can also import TrackLang files created elsewhere.