Customizing Your Server

Whether you're self-hosting, or using a hosting provider, customizing your server works similarly between the two. The main differences you'll encounter is that hosting providers give you a nice, comfortable UI (user interface) to make it easy to see what you're doing, whereas self-hosting typically leaves you editing a text file for your changes. They both ultimately reach the same goal.

In your ServerConfig.toml file, or on your Startup tab within your server, here's a rundown of the different options you have and how you can use them.

AllowGuests = true

This is how you can specify whether or not Guest Accounts are allowed to join your server. These accounts are players who are not on a registered BeamMP account, and ususally just show up as guest5486621 or similar.

Name = "BeamMP Server"

This is where you cutomize how you'd like to display your server name on the public server list. They can be customized with different colors, too! Scroll down to Custom Naming for more options!

Max Cars = 1

This is where you can set the maximum amount of cars that each player can spawn in your server. This means that if you have this value set to 5, and there are 8 players in your server, it is possible that up to 40 cars could be spawned in at one time.

Max Players = 8

This is the maximum amount of players that can join your server at a time. Anybody that tries to join your server once the limit you specify has been reached will be faced with a "Disconnected: Server full!" error.

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

This is where you'll specify the map for your server. You can use these values to set stock BeamNG maps

- /levels/gridmap_v2/info.json
- /levels/johnson_valley/info.json
- /levels/automation_test_track/info.json
- /levels/east_coast_usa/info.json
- /levels/hirochi_raceway/info.json
- /levels/italy/info.json
- /levels/jungle_rock_island/info.json
- /levels/industrial/info.json
- /levels/small_island/info.json
- /levels/smallgrid/info.json
- /levels/utah/info.json
- /levels/west_coast_usa/info.json
- /levels/driver_training/info.json
- /levels/derby/info.json

If you are using a custom map, you'll simply need to edit this field to point toward the info.json file within your custom map. It will typically follow the same /levels/map_name/info.json format.

Description = "BeamMP Default Description"

This is where you cutomize how your server is described on the public server list. Similar to Name, they too can be customized!
See Custom Naming for more options!

Make sure you save the file File > Save when you're done!

Custom Naming

Looking for more customization? Use these special symbols before your text and it'll apply an effect to that text in the server list:

Value	Color	Value	Effect
^0	Black	^r	Reset
^1	Blue	^p	Newline (descriptions only)
^2	Green	^n	Underline
^4	Red	^l	Bold
^5	Pink	^m	Strike-through
^6	Orange	^o	Italic
^7	Grey
^8	Dark grey
^9	Light purple
^a	Light green
^b	Light blue
^c	Dark orange
^d	Light pink
^e	Yellow
^f	White