Skip to content

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.