Racing
This page is the detail behind your first race night. Read that one first if you have not run a race yet; this one assumes you have, and goes through every rule you can change and what it is actually for.
Every default here was read out of the mod’s own source, so a table that says a setting is off means it ships off.
What a race is made of
Section titled “What a race is made of”| Part | What it is |
|---|---|
| Gates | The checkpoints. Crossing one in the right direction is what advances you. |
| Start positions | The grid slots. How many there are is the lobby’s maximum size. |
| Loopable | Whether the route is a circuit (laps) or point to point (driven once). |
| Sectors | Optional splits within a lap, for sector timing. Not available on a branching route. |
| Mode | Grid — the normal kind, with a lobby. Passive — no lobby at all; see the end of this page. |
| Pit lane | Optional, circuits only. A PIT IN / PIT OUT lane with a box per grid slot. |
Building these is the race editor.
The lobby
Section titled “The lobby”A lobby is the waiting room. Its state is on the panel at all times: Waiting for players, Starting…, Racing, Between phases, Finished.
| Setting | Default | What it does |
|---|---|---|
| Multiplayer | Off | On: others may join on the grid, and the countdown waits for everyone to ready up. Off: it starts as soon as you ready up. This is the race’s own default — Open lobby in the start menu is what you actually press on the night. Forced off on a race with a single start position, where there is nowhere to put a second car. |
| Grid ready timeout | 10 s | A floor: the grid stays open at least this long even once everyone is ready, so a latecomer has a chance. |
| Grid timeout | 180 s | The hard cutoff. When it expires the ready racers start and the unready are dropped. |
| Countdown | 10 s | How long you are frozen on your slot before the race begins. |
| Grid placement | Random | Join order (host first), Random, or Manual — you assign slots yourself from the lobby. |
| Players can join mid-race | Off | A latecomer starts alone from a free slot after a short countdown. In a race their time still counts from the race’s start. |
Change settings edits the lobby while it is open. Saving sets everyone back to not ready — deliberately, so nobody races under a rule that appeared after they agreed to the last one.
Chat commands do the same job as the buttons: /race ready, /race leave, /race cancel,
/race retire.
The start
Section titled “The start”| Setting | Default | What it does |
|---|---|---|
| Start sequence | Countdown | Countdown is the plain frozen count. Lights is a five-light gantry. |
| Jump start penalty | 5 s | Seconds added to the race time of anyone who moves off their slot before the lights go out. 0 leaves a jump start unpunished — it is still shown. |
| Release in waves of | 0 (everyone together) | Releases the grid this many cars at a time, each wave a set interval behind the one before, every car from its own slot. |
| Timing starts | Standing start | Standing: your clock starts as you are released. Flying: it starts as you cross the first checkpoint, so you can be up to speed. |
| Out lap | Off | An untimed lap from the grid first. Your time starts as you cross the start/finish line at the end of it. |
| Start from | Grid | Grid, or Pits — each racer in their own pit box, driving out through PIT OUT. |
The five-light start is deliberately un-learnable. The lights come on a second apart, hold lit for an interval the server picks fresh every single time, then go out together — that is the green. Your car is released from its freeze as the first light comes on, so hold it on the brake. Moving before they go out is a JUMP START, shown on the HUD and charged at the finish.
While it runs
Section titled “While it runs”The race HUD carries your lap and position, Last and Best, the gap to the car ahead and behind, the Leader and the Fastest lap of the race, and calls Final lap and Out lap as they happen. Its layout is each player’s own choice — Standard, Compact, Full standings or off — in Settings → Menu.
| Setting | Default | What it does |
|---|---|---|
| Auto-spectate on finish | On | Finish before the others and you are switched to spectating one of them. Your car comes back when the race ends. |
| DNF timeout | On, 30 s | Seconds without progress before a stalled racer is marked DNF. A warning counts down first: Not moving! DNF in 5s, keep going! |
| Rejoin time | 10 min | How long a racer who disconnects has to come back and carry on from their last checkpoint, in their exact car. The clock keeps running while they are away. 0 retires them at once. |
| Gate markers | On | The gates drawn in the world. |
| Limit visible gates | On, 2 | Show only the next n gates (1–5) rather than the whole route. |
| Waypoint beams | On | The vertical beams above gates. |
| Show gate nametags | Off | Numbers floating on the gates. |
Retire gives up your attempt and leaves you spectating without leaving the session. On the HUD it is a press and hold, not a click, so it cannot happen by mistake.
Resets
Section titled “Resets”Resetting is the single biggest difference between a casual race and a serious one, so BeamJoy gives it three independent controls.
Respawn strategy decides what a reset even does:
| Strategy | What a reset does |
|---|---|
| Last checkpoint (default) | Puts the car back at the last gate it crossed. |
| Free respawn | The game’s normal behaviour, unrestricted. |
| No respawn | Every kind of reset is blocked outright. |
| Reset in place | Rebuilt and repaired where it stands, facing the way it was — no ground gained, no checkpoint given back. |
| Flip upright | The game’s flip-upright, which keeps the damage. |
| Last road | The game’s recover-to-road. |
Reset penalty (off by default) makes each reset cost something — 5 seconds by default, either Hold the car (frozen and ghosted where it reset for that long) or Add time (no wait; the seconds go onto the race time at the finish).
Reset speed limit (off by default, 20 km/h) refuses a reset or recover above a speed, so a reset cannot be used as an airbrake: press it mid-crash and you keep the crash. The HUD says Too fast to reset! Below 20 km/h only. It is hidden when No respawn is chosen, which already blocks everything.
Ghosting
Section titled “Ghosting”A ghost is a car nobody can collide with. Four separate uses:
| Setting | Default | What it does |
|---|---|---|
| Ghost on countdown | On | Ghosts everyone during the countdown so simultaneous grid spawns cannot collide. On a solo attempt the ghost stays on for the whole race. |
| Disable collisions | Off | Ghosts everyone for the whole race. Nobody can hit anybody. |
| Ghost backmarkers | Off | Ghosts you once the leader laps you, until you catch back up. This ghosts you against everyone, not only the leader. |
| Hide other racers | Off | Qualifying on an empty track: every other racer’s car and nametag is hidden from you, and yours is ghosted so you cannot hit what you cannot see. Cars not in the race are still drawn. |
A viewer who dislikes see-through cars can turn Disable ghost transparency on in their own settings. They are still ghosts; they just look solid.
Anticheat, and what invalidates a time
Section titled “Anticheat, and what invalidates a time”Three switches, all on by default:
| Setting | Blocks |
|---|---|
| Disable node grabber | The node-grabber tool, while racing. |
| Disable Free Cam | Free Cam, Cinematic and Steadycam, while racing. |
| Disable gravity changes | Gravity being moved off the server’s expected value while racing. |
Turn any of them off and BeamJoy warns before the race starts that the attempt will not be recorded on the leaderboard, and asks whether to start anyway. A time set with the checks off is not comparable to one set with them on, so it is not allowed to sit beside them.
Vehicle restrictions
Section titled “Vehicle restrictions”| Mode | What happens |
|---|---|
| Free | Any vehicle. |
| Single Config | Every racer is put into one exact vehicle and configuration the moment they join, custom setups included. |
| Pool | Racers pick any vehicle from a vehicle preset — an admin-curated list — via the vehicle selector. |
| Race-defined | Whatever restriction the race itself carries. |
Two modifiers: Allow tuning (on by default — tyre pressures, gearing, diffs stay adjustable in the required car; paint is always free) and Randomize vehicle assignment (off; hands each joiner a random car from the pool instead of making them pick).
Matching tolerates paint and tuning changes made after the car spawned, so a legal car does not become illegal because somebody adjusted a camber.
Pit stops
Section titled “Pit stops”Pits are for circuits. A race without a pit lane runs exactly as it always did — none of this appears.
In the lane: the game’s own limiter holds the lane’s speed limit (20–150 km/h, 60 by default), entering too fast costs a time penalty, and cars are ghosted so neighbours cannot shove each other. Your route’s gates do not count while you are in the lane — the server credits the steps the lane skips — and laps still close at the real start/finish line, which continues sideways across the lane as on a real circuit. A lap that touched the lane counts toward race time but is not eligible for best lap or the leaderboard, so a drive-through is never a shortcut.
In your box, the car is held on the external camera while the work is done:
| Setting | Default | What it does |
|---|---|---|
| Required stops | 0 | Stops each racer must make. |
| Penalty per missing stop | 30 s | Added to their time at the finish, per stop not made. |
| Refuelling | On | Racers may add fuel. The pit menu sets how much, in your own units. |
| Fill rate | 5% of the tank per second | At 5, a full tank takes 20 s on any car. |
| Start fuel | 100% | Below 100, resets in the race keep the fuel level, so the pits become the only place to refuel. |
| Repairs | On | Repair time scales with how badly the car is damaged. |
| Repair time, wrecked car | 60 s | The ceiling that damage scales toward. |
| Tyre changes | On | New tyres apart from a repair. Experimental, and only while the server has RacePits.ExperimentalTyres on; otherwise flat tyres are part of a repair. |
| Tyre change time | 10 s | A plugin’s own tyre set may carry its own time. |
| Tow to pits | On | A car that cannot move is taken to its box, held for the drive back. |
| Tow speed | 50 km/h | The hold is the route back at this speed, plus 10 s — slower than driving it. |
| Return to pits after each phase | Off | After the flag, racers drive or tow back to their box and wait there. Anyone not back when the break ends is towed in. |
The server confirms the stop from BeamMP’s own positions — that the car really stood in its own box. A stop it never saw does not count.
Race control, for staff
Section titled “Race control, for staff”Staff get a Race control panel during the race:
- Penalties of 0.5, 5 or 10 seconds. They add up, are applied at the finish, and can change the order.
- Disqualify puts a racer at the bottom of the results and withdraws their leaderboard time. If they are still driving, they are out. Reinstate undoes it, and Clear penalties wipes the ones given.
- In an event: End phase is a red flag — it ends now and laps under way do not count — plus +5 min, +1 lap and +1 run, which are refused once somebody has already finished the phase, because extending a race somebody has completed is not a thing that can be done fairly.
Events in phases
Section titled “Events in phases”A race can be an event of up to 20 phases — practice, qualifying, heats, a final. A race started the old way is simply one phase and behaves exactly as before.
Pick a Format to start from, then edit its phases, and save your own back into the list:
| Format | What it runs |
|---|---|
| Race | One race. |
| Qualifying + race | Qualifying ranked on best lap, then a race gridded from it. |
| Practice, qualifying + race | The same, with practice in front. |
| Sprint + feature (reversed grid) | A short race, then a longer one with the front of the grid turned around. |
| Time attack | Ranked on best lap. |
| Knockout qualifying + race | Only the top n of a phase go through. |
| Two runs, times added up | Both runs summed, rally-style. |
| Custom | Yours from scratch. |
Each phase sets its own:
| Field | Options |
|---|---|
| Start | Grid (standing, together), Waves (a few cars at a time), Time offset (a set time apart, each on their own clock — a time trial or rally stage), One at a time (alone, the others watching or waiting on their slots), Open runs (point-to-point, each finish sends you back for another run). |
| Length | Laps, Time, or Both — whichever comes first ends it. |
| When time’s up | Leader’s lap (racing rules: the leader’s next crossing ends their race, then everyone finishes on their own next crossing), Finish the lap (everyone’s current lap counts), or Stop (over at once; a lap under way does not count). |
| Ranked by | Race order (most laps, then fastest time), Best lap (practice, qualifying, time attack — retiring keeps it), or Total time (every lap added up). |
| Grid | Lobby order, the result of an earlier phase, or the event standings — optionally reversed, for the top n or all. |
| Who races | Everyone, or the top n of an earlier phase or of the event, for knockouts and finals. The rest watch. |
| Counts for the event’s result | Off for practice and qualifying: the event’s result comes only from the phases that count. |
| Laps go on the leaderboard | Whether this phase’s best laps count for the race’s own leaderboard. |
| Break after | How long its results are shown before the next phase’s countdown. The leader can start it sooner with Next phase now. |
| This phase’s rules | Collisions, ghosting, pits and the rest, for this phase only. Anything left As the event follows Advanced settings. |
The event result is either the last phase that counts (the race) or times added up across every counted phase (two runs, rally legs).
If a phase is not yours to race — a final you did not qualify for — the panel says so: you’re not in this phase: you’re watching it. You get your car back at the next break.
Leaderboards and records
Section titled “Leaderboards and records”Each race keeps its own board, across restarts: the top 100, with your own rank pinned separately if you are outside it, and a popup when you set a personal best or a server record.
A time is not recorded when the anticheat switches were off, and a lap that used the pit lane is not eligible. Disqualification withdraws a time that was already set.
Passive races
Section titled “Passive races”A Passive race has no lobby and nobody to wait for: you drive through its start gate in freeroam and you are in it. Players who would rather not be can turn Take part in passive races off in their own settings.
Drift spots and dragstrips work the same way, and so do the game’s own, with their own leaderboards and pins on the Big Map.
- The race editor — building the route these rules run on.
- Your first race night — the flow, if you came here first.
- Every feature, one row — what else BeamJoy does.