For the complete documentation index, see llms.txt. This page is also available as Markdown.

Ghost Replay

Ghost Replay puts a see-through "ghost" car on track with you that re-drives a previously recorded lap in real time. It's the driver's own private pace car: chase it, and you're chasing your best. Paired with it is a live delta on the race HUD that shows, second by second, whether you're beating that lap or losing time to it.

It's built directly on top of Telemetry — the ghost is a recorded best lap — so a driver needs at least one clean lap on a track before a ghost can appear there.

How it works

When a driver starts a race, a translucent car spawns and replays a saved lap alongside them:

  • It drives the exact line of that recorded lap, at the exact pace it was originally driven.

  • It's see-through and non-solid — it never blocks the driver or knocks them around; you can drive straight through it.

  • It looks like the driver's current car — same model, same visual and performance mods — so it feels like a true mirror of themselves, just tinted a different colour.

  • It's personal and local: only the driver sees their own ghost. Other racers don't see it, and it has no effect on race results, positions, prizes or standings. It's purely a practice and pacing aid.

What you race against

A driver can chase one of two references, told apart at a glance by colour:

Ghost
Colour
What it is

Personal Best

Blue

The driver's own fastest lap on that track.

Track Record

Gold

The single fastest lap set by anyone on that track.

They can show one, the other, or both at once. If a driver happens to hold the track record, the two are the same lap, so only one ghost appears to avoid a duplicate.

Because the reference is a single best lap, the ghost works the same in every format — sprints, one-lap dashes and multi-lap circuits alike

Multi-lap circuits

On a circuit with several laps, the ghost restarts its lap each time the driver crosses the line. That means every one of the driver's laps is raced against their best lap from a clean start — not against a ghost that has drifted a whole lap ahead or behind. If the ghost's lap is quicker, it simply reaches the line first and waits for the driver to begin the next lap.

The live delta HUD

While a ghost is active, a GHOST line appears on the race HUD showing the current time gap to the best lap:

  • a negative, green number means the driver is ahead of their best lap right now

  • a positive, red number means they're behind it

  • it sits neutral (white) when they're within a hair of dead even

The gap updates continuously as they drive and resets at the start of each lap, so it always reflects the current lap versus their best. It's shown during timed races; it doesn't appear in drift events, which are scored on points rather than lap time.

Turning it on

There are two layers: the server switch and the player's own choice.

Server side. The whole system has a master switch that is on by default. As long as it's enabled, ghosts are available to everyone. You can disable it in config/_racing.lua > Config.GhostReplay

Player side. Each driver controls their own ghost from App → Settings:

Setting
What it does

Ghost Car

Turns the driver's ghost on or off.

Ghost Target

Chooses which ghost to race: My Best Lap, Track Record, or Best + Record (both at once).

A ghost only appears if there's a recorded best lap to replay. A brand-new track — or a driver who has never finished a clean lap there — simply won't show a ghost until that first lap is set.

Last updated