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”.
The ten tabs
Section titled “The ten tabs”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.
General, section by section
Section titled “General, section by section”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. |
Race Editor
Section titled “Race Editor”| 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.
Freeroam
Section titled “Freeroam”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. |
Deliveries
Section titled “Deliveries”| 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.
Voting
Section titled “Voting”| 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.
Discord
Section titled “Discord”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.
Welcome Screen
Section titled “Welcome Screen”| 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 <. |
| 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.
Vehicle blacklist
Section titled “Vehicle blacklist”Models nobody may spawn. BypassModelBlacklist exempts a group.
Traffic
Section titled “Traffic”| 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.
Broadcasts
Section titled “Broadcasts”Status (off by default), the delay between messages (120s), and the messages themselves, which can be written per language.
Core Config
Section titled “Core Config”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.
Database
Section titled “Database”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.
- Players and moderation — the actions in that window and in chat.
- Time, weather and the map — the shared world settings, and votes.
- Discord integration — what each webhook can post.
- Settings reference — every setting with its default, in one table.
- Permission reference — every key, and what it gates.