How to Configure Your BeamMP Server (ServerConfig.toml)
Complete ServerConfig.toml reference for BeamMP — every setting for server name, map, players, mods, auth key, and more.
All BeamMP server settings live in ServerConfig.toml (TOML format). Auto-generated on first run.
File Structure
ServerConfig.toml
Server.log
How to Edit ServerConfig.toml
Stop the server
In the XGamingServer Panel, go to Console and stop your server.
Open ServerConfig.toml
Click Files in the sidebar and open ServerConfig.toml in the server root.
Edit and save
Make your changes, click Save Content, then start the server from Console.
All Settings
Under [General]:
Server Identity
| Setting | Default | Max Length | Description |
|---|---|---|---|
Name | "Test Server" | 250 | Server browser display name (supports color codes) |
Description | "Total Random Beam MP Server" | 1000 | Description shown in browser |
Tags | "Freeroam" | 100 | Comma-separated filter tags |
Private | true | — | false = listed in public browser |
Authentication
| Setting | Default | Description |
|---|---|---|
AuthKey | "" | Required — get from BeamMP Keymaster |
AllowGuests | false | Allow players without BeamMP accounts |
Players & Vehicles
| Setting | Default | Description |
|---|---|---|
MaxPlayers | 10 | Max concurrent players |
MaxCars | 2 | Max vehicles per player |
Map
| Setting | Default | Description |
|---|---|---|
Map | "/levels/gridmap_v2/info.json" | Active map path — see Map Guide |
Network
| Setting | Default | Description |
|---|---|---|
Port | 30814 | Listening port (1024–65535, TCP + UDP) |
IP | "::" | Bind IP address |
Other
| Setting | Default | Description |
|---|---|---|
LogChat | false | Log chat messages to Server.log |
Debug | false | Enable debug logging |
ResourceFolder | "Resources" | Path to mod directory |
Environment Variable Overrides (v3.2.0+)
Settings can be overridden via env vars using the BEAMMP_ prefix:
| Env Var | Overrides |
|---|---|
BEAMMP_AUTH_KEY | AuthKey |
BEAMMP_MAX_PLAYERS | MaxPlayers |
BEAMMP_MAP | Map |
BEAMMP_PORT | Port |
BEAMMP_NAME | Name |
Example Config
[General]
AuthKey = "your-key-here"
Name = "^4XGaming ^fBeamMP Server"
Description = "Freeroam with mods! All welcome."
Tags = "Freeroam,Modded,Lang:English"
Map = "/levels/west_coast_usa/info.json"
MaxPlayers = 20
MaxCars = 2
Port = 30814
Private = false
AllowGuests = false
LogChat = true
Debug = false
ResourceFolder = "Resources"Related Guides
How is this guide?
40% Off — Limited TimeGet your Beammp server todayInstant setup, DDoS protection, and 24/7 support included.
Get a Server