Configuring Your BeamMP Server

Your server's behavior is controlled by ServerConfig.toml. You can edit it visually through the Config Editor tab, or manually through the File Manager. Both do the same thing — the Config Editor is just easier.

Using the Config Editor

Head to the Config Editor tab in your panel. You'll see all the settings laid out with labels and descriptions. Change what you want, hit save, and restart your server.

It's that simple. No syntax errors, no formatting issues — the visual editor handles it.

Key Settings Explained

Server Name

Name = "My BeamMP Server"

This is what shows up in the server list. Make it descriptive — "Bob's Drift Server" beats "My Server" when people are scrolling through hundreds of servers.

You can use special characters and emoji, but keep it readable.

Max Players

MaxPlayers = 10

How many people can be on at once. More players = more RAM and CPU usage. A rough guide:

• 2-5 players: 2GB RAM is fine
• 5-10 players: 3-4GB RAM recommended
• 10-20 players: 4-8GB RAM, depends on mods
• 20+: 8GB+ and you'll want minimal heavy mods

See performance optimization for more detail.

Map

Map = "/levels/gridmap_v2/info.json"

Which map the server loads. See installing custom maps for how to change this and a list of built-in options.

Auth Key

AuthKey = "your-key-here"

Required for your server to show up in the public server list. Get yours from the BeamMP Keymaster. Our auth key guide walks you through it.

Private

Private = false

Set to true to hide your server from the public list. Players can still join via Direct Connect using your IP and port. Good for private friend groups.

Max Cars

MaxCars = 1

How many vehicles each player can spawn. Setting this to 1 keeps things cleaner and uses less resources. Bump it up if you've got a small group and plenty of RAM.

Port

Port = 30814

The default is 30814. On Connect Hosting, this is assigned automatically — don't change it unless support tells you to.

Description

Description = "A fun server for cruising and drifting"

Shows up in the server list below your server name. Tell people what your server is about.

Raw Config File

If you want to edit the file directly, go to the File Manager and open ServerConfig.toml. Here's what a typical config looks like:

[General]
Name = "My BeamMP Server"
Port = 30814
AuthKey = "your-key-here"
MaxPlayers = 10
MaxCars = 1
Map = "/levels/gridmap_v2/info.json"
Description = "A fun BeamMP server"
Private = false

After saving any changes, restart your server for them to take effect.

Tips

• Changed a setting but nothing happened? You need to restart. Settings only load on boot.
• Messed up the config format? Restore from a backup or re-download the default config from the File Manager.
• Want a quick setup? Check out server templates for pre-configured setups.