Skip to content

The config window, tab by tab

Everything a BeamJoy server is configured with lives in one in-game window: Server Configuration. This page is the map from that window to the rest of the documentation — which tab holds what, and who can open it.

You only see the tabs your permissions open. The window is assembled per player: a tab with no permission behind it is not greyed out, it is simply absent. A moderator and an owner open the same window and see different things, which is intended and is why two people comparing notes can disagree about what BeamJoy “has”.

In the order they appear.

Tab Needs What it governs
General SetConfig, Whitelist or SetEnvironment Almost every server-wide setting. Thirteen sections — see below.
Safe Zones EditSafeZones Areas where cars cannot collide. Create one where you stand, duplicate it, resize it.
Races EditRaces The race editor.
Vehicle Presets EditVehiclePresets Curated vehicle lists, and the shared builds that appear in everyone’s vehicle selector.
Arenas EditHunterArenas, EditInfectedArenas or EditDerbyArenas Hunter, Derby and Infected arenas: spawns, waypoints, zones, props and each mode’s own settings.
Freeroam EditFreeroamData or EditBusLines Stations & Garages, Bus Lines, Deliveries, Dragstrips and Drift spots.
Permissions SetPermissions The groups and which permission each one holds — see Groups and permissions.
Maps SetMaps Which maps this server will switch to, and their labels.
Core Config SetCore The server’s own identity, and Legacy Import.
Database DatabasePlayers Players who are not connected: their group, mute and ban state, and stored data.

Server plugins can add tabs of their own, after these, for anyone holding EditPluginConfig.

The tab opens with one switch of its own and then thirteen collapsible sections. Everything here needs SetConfig, with two exceptions called out below.

At the top What it does
Force-enable BeamJoy HUD Everyone gets the always-open, uncloseable window staff already get. On by default.
Setting What it does
Restrict editing to authors Only staff and a race’s own creator may edit or delete it. Off by default.
Only show editable races Hides races you cannot manage from the browse list. A display filter, not a permission.

Both are covered where they bite, in the race editor.

The rules of ordinary driving, when nobody is in an activity.

Setting Default What it does
Vehicle collisions Ghosts Forced: always collide. Disabled: never collide. Ghosts: respawn protection only.
Respawn ghost timeout On, 10s How long a car stays ghosted after spawning or resetting. Turn the timeout off and the ghost lasts until the car is clear of others instead.
Respawn ghost distance 0 m Extra clearance, beyond simple contact, a protected car needs before un-ghosting.
Preserve fuel on reset Off Keeps the fuel level across a reset instead of the game’s own refill to full.
Police chases between players On A police car may start a chase on a player breaking the law nearby. Players can opt out for themselves.
Passive races On Races marked Passive start when driven through in freeroam. Off, those races only run from a lobby.
Ghost players outside games Off Everyone not in a race, hunt, infected round or derby drives as a ghost.
Strict bus stops Off A bus stop also wants the doors open, and kneeling where the bus has it.
Emergency refuel cooldown 300s Before the free refuel button can be used again on the same car.
Setting Default What it does
Shortest route 500 m Jobs never go anywhere closer by road.
Longest route 8000 m Nor anywhere further.
Target speed 40 km/h Target time is route length at this average. Beating it raises the score by up to 25%.
Jobs per depot 4 How many offers a board shows at once. A taken job is replaced immediately.
Job rotation 5 min Roughly how long an untaken job stays up.
Drop-off hold 3s How long the vehicle must stay in the zone to deliver.
Jobs can run out of time On A job fails past twice its target time. Turning it off also spares jobs already running.

Below the table is the Vehicle delivery pool: which models and configurations vehicle jobs hand out. Refresh from my game rebuilds it from the vehicles installed in your game, which is the step to repeat after adding or removing vehicle mods.

Setting Default What it does
Pit entry speed penalty 5s Added for crossing PIT IN above the lane’s limit plus the tolerance. 0 turns it off — the limiter itself is always on.
Speed tolerance 5 km/h How far over the limit is forgiven at the line.
Experimental tyre changes Off Adds a Tyres row to the pit menu, separate from repairs.

The lane’s own speed limit is per race, not here. See pit stops.

Setting Default
Map vote pass threshold 51%
Map vote timeout 30s
Kick vote pass threshold 51%
Kick vote timeout 30s

How those percentages turn into a number of votes is in time, weather and the map.

Webhooks, and which posts each one carries. Discord integration is the whole subject.

Whitelist — needs Whitelist, not SetConfig

Section titled “Whitelist — needs Whitelist, not SetConfig”

Status, the player list, Add all connected players, and adding someone who is offline by exact name — it is case sensitive. A group can also be whitelisted as a group, which is what vip is for by default.

Setting What it does
State On by default.
Only once Show it on first connection only, rather than every time.
Title, Content The content field is HTML, and takes {player_name}, {server_name} and {players_count}. A literal < must be typed &lt;.
Image A built-in BeamNG image, or a root-relative path to one served from your own Resources/Client/ folder. Live https:// URLs are not supported; Browse folder lists images in a folder so you need not type the filename.

On a fresh install this is the panel that tells you how to claim ownership — see first boot.

Colours for server and staff tags, server messages, event messages and broadcasts; Show staff tag; and a welcome message per language.

Models nobody may spawn. BypassModelBlacklist exempts a group.

Setting Default What it does
Traffic state Off Nothing spawns until this is on.
Veh. amount 15 The server-wide target.
Max veh./player 1 What each connected player contributes.
Models, Rarity simple_traffic Which vehicles appear and how often — rare, medium or common.
Smart selection Off Weights by popularity and region instead.
Parked veh. amount 0 Parked cars, counted separately.
Max parked veh./player 1
Front plate usage, Plate shape, Plate design normal, eu Number plates on traffic cars.

Traffic is spawned by players’ own games, so what it costs is paid on their machines.

Time & Environment — needs SetEnvironment, not SetConfig

Section titled “Time & Environment — needs SetEnvironment, not SetConfig”
Setting Default What it does
Sync time of day Off One clock for everyone.
Sync gravity Off One gravity for everyone; it resets to Earth when the last staff member leaves.
Sync weather Off Everyone sees the same clouds, fog, wind and temperature. Turning it on shares your current weather.
Night speed 2× How fast night passes compared to day. Only applies while time is synced.
Full day/night cycle 30 min Real time for one full day and night at normal speed, using the map’s real sunrise and sunset.

Open environment settings hands off to the game’s own time and weather panel. The whole subject is time, weather and the map.

Status (off by default), the delay between messages (120s), and the messages themselves, which can be written per language.

The server’s own identity, as the server browser sees it — Name, Preview, Description, Players limit (staff bypass it), Private, Debug mode, Info. Packet — plus Legacy Import.

Legacy Import converts an old BeamJoy Free (BJI) server’s data into this one’s format: hunter arenas, infected arenas, derby arenas, races, stations and garages, bus lines, and delivery points. Each button previews what it found, with counts and conflicts, and nothing is written until you confirm.

The tab needs SetCore, which is owner-only by default, and its own ⓘ button repeats the copy-the-scenarii-folder steps in game.

Every player the server has seen, not just the connected ones. Their group, whether they are muted or banned and why, the last kick reason, Unban, and arbitrary stored key/value Player data.

This is where a ban is lifted for somebody who is not online to be right-clicked.