Alpha Race Learner - Hirochi Racing 0.8.0

More features are coming soon; I've been debugging this update first to ensure a stable mod.
*0.7.1 update

Race Learner is an experimental racing AI mod for Hirochi Raceway. It runs continuous laps, tests changes to its driving line and pace, and saves what it learns for each vehicle setup.

Three driving profiles*
• Slow: starts near the center of the track, explores the racing line, then gradually increases speed.
• Normal: uses BeamNG’s AI grip pace with racing-line experiments and learned local speed limits.
• Fast: pushes harder from the opening laps, accepting more crashes while learning where to slow down.

Switch profiles while driving using the HUD buttons. Each profile has its own saved learning. A lap driven with multiple profiles is excluded from learning and records.

Persistent vehicle learning*
Learning is saved separately for each car’s parts/tuning setup, circuit path, and driving profile. Change cars, reload the map, or restart the game—returning to the same combination restores its progress.

The learner remembers successful driving plans, braking estimates, local speed limits, racing-line adjustments, and contact clearance. New stints still include warm-up laps.

Shared circuit knowledge*
Repeated clean laps contribute to a shared circuit library. New vehicle setups can start with a restrained blend of a demonstrated racing line, while keeping their own speed and braking estimates. Existing vehicle learning remains intact.

Supported circuits
• Long Race Circuit
• Medium Race Circuit
• Short Race Circuit

You can also record a custom circuit path* by manually driving a complete lap.

Additional features*
• Continuous warm-up and push laps
• Local adjustments after contact or failed attempts
• Automatic crash and stuck recovery
• Separate lap-records HUD with vehicle configuration snapshots
• Confirmed record resets for one layout or all layouts
• Optional replay capture with best-lap bookmarks
• Live circuit map and vehicle position
• Button-based profile and settings controls

Getting started
1. Load Hirochi Raceway in freeroam.
2. Add the Race Learner HUD and, optionally, Race Learner Records.
3. Select your vehicle, circuit, and driving profile.
4. Press Prepare, then Start.

An automatic or sequential transmission is recommended. Use Off before changing the circuit or learning/recovery settings.

Alpha status:
Crashes can occur, especially with the Fast profile. Track boundaries are approximate, and results vary by vehicle and setup. The mod adapts local driving parameters within the selected route; it does not replace BeamNG’s steering controller or guarantee an optimal racing line.

Learning data stays in your BeamNG user folder and is preserved when replacing the mod ZIP.
*0.7.1 update

Requirements
BeamNG.drive 0.39 or newer.

License
MIT.