> For the complete documentation index, see [llms.txt](https://docs.av-scripts.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.av-scripts.com/laptop-pack/racing/ghost-replay.md).
# 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.
{% hint style="info" %}
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
{% endhint %}
### 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).
{% hint style="info" %}
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.
{% endhint %}