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

Editing

Stop your server
In the XGamingServer Panel, click Files
Open ServerConfig.toml
Edit, save, and start your server

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"

How to Configure Your BeamMP Server (ServerConfig.toml)

On this page