This is the whole of BeamJoy, one row at a time. It is the page to skim before you decide what to
turn on, and the page to search when you have heard a feature named and want to know what it is.
Almost none of it runs until somebody starts it. The activities sit there as a list until a
player opens a lobby, and the settings that change how freeroam behaves ship off. The exceptions
are worth knowing before you install, so they are first.
Six things are already doing something on a fresh install. Every one of them is a switch you can
turn off.
| On by default |
What it does |
Where it is |
| The welcome window |
Shows every player a panel on connect — on a fresh install, the one telling you how to make yourself the owner. |
Config → General |
| The main window is forced open |
The BeamJoy window cannot be closed, for everyone. This is ForceHud, and it is on. |
Config → General |
| Respawn ghost protection |
A car ghosts briefly when it spawns or resets, and un-ghosts once it is clear of other cars, so nobody explodes by materialising inside someone. |
Config → Freeroam |
| Police chases between players |
From a police car, your game may start a chase on another player who breaks the law nearby. Players can opt out for themselves. |
Config → Freeroam |
| Passive races |
A race marked Passive starts when someone drives through its start gate in freeroam. No lobby, no invitation. |
Config → Freeroam |
| Update checking |
The server asks GitHub whether there is a newer release and tells owners in game. It installs nothing on its own. |
Updating |
And, for the avoidance of doubt, these ship off: traffic, the whitelist, chat broadcasts,
Discord webhooks, ghosting non-racers from freeroam, restricting race editing to authors, and
experimental pit tyre changes.
| Feature |
What it gives you |
| The main window |
A rail down the right edge that opens small panels, or a fullscreen window with Home, Activities, Crew, Players, Leaderboards and Settings. HTML, resizable and movable. |
| Invite and lobby cards |
A new lobby or an invitation appears as a card beside the rail with Join and Dismiss, so you never have to be watching a list. |
| Controller support |
The whole window works on a gamepad. RB + X takes focus so the pad drives the interface instead of the car. |
| The HUD |
Per-activity readouts: race timing and standings, derby damage, hunter distance, infected, deliveries, drift score, the drag tree and timeslip, the bus board. |
| Three race HUD layouts |
Built for full grids, so a twenty-car field still fits on screen. |
| Thirteen languages plus English |
German, Spanish (Spain and Latin America), French, Italian, Japanese, Korean, Polish, Portuguese (Portugal and Brazil), Russian, and Chinese (Simplified and Traditional), on both client and server at full key parity. |
| Settings that follow you |
Your own preferences are kept locally and travel between BeamJoy servers. |
| Feature |
What it gives you |
| Grid racing |
Lobbies, ready-up, a countdown or a light gantry, gate detection, lap and sector timing, a live leaderboard, DNF handling and retirement. Solo hotlapping and head-to-head on the same races. |
| 315 bundled races on 14 maps |
A fresh install already has races to run, most of them dressed with props. |
| The race editor |
Build a route from inside the game: gates, start positions, sectors, a pit lane, props, and the defaults the race carries. |
| Branching routes |
A gate can have more than one valid next gate, so a route genuinely forks instead of being one fixed sequence. |
| Manual sector boundaries |
Pick the sector splits yourself by flagging gates, rather than an even split by distance. |
| Race events of up to 20 phases |
Practice, qualifying, heats, a final — each phase with its own start, length, ranking, grid, entry list, rules and break. Ready-made formats in the start menu, editable and savable as your own. |
| Five start types |
A five-light gantry with a hold the server picks fresh each time, waves, one car at a time, a flying start timed from the first checkpoint, and an untimed out lap. |
| Jump start penalties |
Your car is released on the first light, so moving before they go out is a jump start and costs time. |
| Pit stops |
A PIT IN / PIT OUT lane with its own limiter, a box per grid slot, refuelling in your own units, repairs scaled to damage, optional tyre changes, required stops with a penalty for missing one, and a tow for a car that cannot move. |
| Race control |
Staff can hand out time penalties, disqualify, red-flag a phase, and add time or a lap while it runs. |
| Rejoin after a disconnect |
Come back inside the window and carry on from your last checkpoint, in your exact car. The clock keeps running. |
| Reset rules |
Six respawn strategies, an optional time penalty per reset, and an optional speed limit so a reset cannot be used as an airbrake. |
| Ghosting |
Ghost the grid during the countdown, ghost everyone for the whole race, ghost backmarkers once they are lapped, or hide other racers entirely for a qualifying session. |
| Anticheat |
Blocks the node grabber, Free Cam and gravity changes while racing. All three on by default — turning any of them off forfeits the leaderboard time. |
| Vehicle restrictions |
Lock a race to one exact vehicle, custom setup included, or to a host-curated pool players pick from. Per race or chosen fresh at the start. |
| Persistent leaderboards |
Per-race personal bests and records, top 100 with your own rank pinned if you are outside it, a popup on a new best, and a Leaderboards tab with Races, Deliveries, Derby, Drift and Drag boards. |
| Share codes |
Export a race as a BJRACE1: text code and import it on another server. |
| Import map races |
Take the time trials and quick races a map already ships with — modded maps included — as BeamJoy races. |
| Feature |
What it gives you |
| Derby |
Last man standing, Timed, and Sumo with a shrinking arena, on the map’s derby arenas. Wreck credit, a kill feed, results and a Derby leaderboard. Several arenas per map, each with its own spawns, zone and settings. |
| Hunter |
Asymmetric chase: one random player is the fugitive, everyone else hunts. Stuck-timer elimination rather than a tag, a three-trigger reveal system, a head start for the fugitive, GPS routing and a beacon to the next waypoint, a crash-reset penalty for hunters, and a staff tool to reassign the fugitive. |
| Infected |
One or more players start infected and it spreads by actual contact, not a button. A freeze on the infected at the start, a round timer survivors can outlast, role-coloured nametags, and an option to hide infected nametags so the colour does not give them away. |
| Deliveries |
Package and vehicle jobs from a depot’s job board, scored on route distance, time and the vehicle’s condition. Bundled delivery points for nine maps, or import the map’s own. A Jobs window lists every depot’s open offers. |
| Convoys |
Take a delivery job together, up to four players, with its own lobby. |
| Drift spots |
A painted corridor with signs, scored on angle and speed held. Runnable both ways on one leaderboard, or one-way only. |
| Dragstrips |
1/4 mile, 1/8 mile or 1000 ft, a sportsman or pro tree, live times and a timeslip. |
| Bus lines |
Drive a server-defined route stop to stop with GPS guidance, holding inside each stop to advance, looping if the line says to. Any vehicle the game calls a bus, a Big Map pin per line, and an optional strict-stops mode that wants the doors open. |
| Passive activities |
Passive races, drift spots and dragstrips all have leaderboards and Big Map pins — the game’s own drift spots and strips included — and need no lobby at all. |
| Crews |
Groups of up to eight. When the leader opens a race, hunt, infected game, derby or convoy, every free crewmate joins automatically. |
| Arena editors |
In-world editors for derby, hunter and infected arenas: spawns, waypoints, zones and props. |
| Props editor |
Place props with the mouse in races and arenas. Hundreds of curated props plus every mesh in the game, curved lines, curbs and walls, road paint and skid marks, copy and paste between races, up to 1000 per race. |
| Feature |
What it gives you |
| Groups and permissions |
Six groups, every privileged action behind its own permission key, edited in the config window. |
| Moderation tools |
Mute, kick, ban, temporary ban, freeze, and removing a player’s vehicles, from the player list or by chat command. |
| The players database |
Manage players who are not connected right now. |
| Whitelist |
A list with its own panel, kept in its own file so it can be edited while the server runs. Off by default. |
| Vote-kick |
/votekick, with a configurable threshold and timeout and a live status panel. 51% and 30 seconds by default. |
| Teleportation |
Teleport to another player, rate-limited, or have a moderator summon someone. /tp and /tpfrom do the same from chat. |
| Chat commands |
A permissioned command system — racing, moderation and utility — where /help lists only what the caller may actually do. |
| Private messages |
/pm, with a copy to staff. |
| Custom chat |
Staff tags, configurable colours for server, event and broadcast messages, and a welcome message per language. |
| Chat broadcasts |
Rotating messages on a delay, translated per player. Off by default. |
| Safe zones |
Areas with no collisions. A car leaving one stays a ghost until it is clear of other cars, so nothing merges. |
| Collision modes |
Collisions always on, every car permanently ghosted, or respawn protection only. Plus ghosting everyone who is not in an activity. |
| Feature |
What it gives you |
| Synced time of day |
One clock for everyone, staff-editable, with a configurable cycle length, a night speed from 0.1× to 10× and a live readout of the resulting day length. Night follows each map’s real sunset and sunrise, and the date is synced too. |
| Synced weather |
Everyone sees the same clouds, fog, wind and temperature. |
| Synced gravity |
Staff-editable, and it resets to Earth when the last staff member leaves. |
| Synced pause and simulation speed |
Staff-editable, bound to the game’s own keys, and simulation speed falls back to 1× when the last staff member leaves. |
| Map switching |
Switch map in game with a permission, edit map labels, and turn individual maps off so nobody can switch to them. |
| Map voting |
/votemap, with its own threshold, timeout and status panel. |
| Energy stations and garages |
Place refuel and repair points that register as real BeamNG points of interest, so the game’s own markers, drive-up prompt and Big Map show them like vanilla stations. Configurable fuel type and duration, a low-fuel HUD warning with a GPS button, and a cooldown-gated emergency refuel for when you are stranded. |
| Traffic |
Server-distributed AI traffic with a vehicle cap per player, chosen models, parked cars, number plates, automatic lights on the day–night cycle, and pursuits and arrests when you drive a police car. Off by default. |
| Vehicle presets and shared builds |
Curated, shareable vehicle lists captured from a real car — model, config, parts and tuning — usable to restrict a race, hunt or infected round. Add the car you are driving and every player can pick it in their selector. |
| Vehicle model blacklist |
Ban specific models outright. |
| Trailer and prop permissions |
Decide which groups may spawn them. |
| Client mods |
Players’ own mods are client-side only, and server-served mods cannot be disabled or removed by players. |
| Mods analyzer |
Built in, with a modded-map detector. |
| Nametags |
Separate configurable colours for active cars, idle cars and spectators, shared across BeamJoy servers; off for props, and off for a trailer while its owner’s car is attached. |
| Replay support |
A player watching a replay, and their cars, are invisible to everyone else until they play again. |
| The vehicle selector |
Fixed and integrated: presets from disabled mods hidden, filtered by permission, working action buttons. |
| Right-click context menu |
Act on another vehicle from a context menu, disabled while you are nodegrabbing or dragging the view. |
| Middle-click vehicle switch |
Jump between your cars with the mouse wheel button. |
| Feature |
What it gives you |
| Install |
One zip into Resources. Updates never replace server or player data. |
| Self-updater |
The server checks GitHub, tells owners in game, and installs with /bjupdate. /bjupdate channel development follows test builds instead. |
| Where your data lives |
JSON under BeamJoyData/db/, no external database, written on first start. |
| Legacy import |
Convert an old BeamJoy Free server’s hunter arenas, races and delivery points into this fork’s format, with a preview and a confirmation before anything is written. |
| Discord webhooks |
Post race results and records, hunter, infected and derby results, deliveries, votes, joins and leaves, and chat to your channels. No extra plugin. Off until a webhook exists. |
| Server core settings |
A UI for the settings that are not per activity. |
| The welcome window |
Editable title, content and image, shown on every connect or only the first. |
| Plugin API |
Your own BeamMP plugins can read BeamJoy’s data, hear race events as they happen, take part in races, draw overlays, set time and weather, and add options and pages to BeamJoy’s own windows. |
| Console commands |
bj help in the server console lists them; bj group <player> owner is the one you need first. |
The mod’s own roadmap names these as planned and not implemented: per-race time and weather
planning, half and full mile drag options, heads-up and bracket drag racing, trailer delivery, and
rideshare. If you read about one of those somewhere, that is why you cannot find the switch.