BeamMP Server Troubleshooting Guide

This guide covers the most common issues with BeamMP servers and how to resolve them. Always check the Console page in the NolimitHost Game Panel first — BeamMP prints a clear message for most problems during startup.

Server Does Not Appear in the List

• Private server - if Private = true in ServerConfig.toml, the server is hidden from the list. Set it to false to go public, or join it with Direct Connect.
• Missing or invalid AuthKey - without a valid key the server cannot register with the BeamMP network. See Set Up an AuthKey.
• Still starting - give the server a moment and refresh; confirm it shows as running in the console.

Players Cannot Connect

Server Will Not Start

• "Key already in use" - an AuthKey works on one server at a time. Generate a separate key for the second server in the BeamMP Keymaster.
• Config errors - a typo in ServerConfig.toml can stop the server starting. Restore your last working copy, or fix the value highlighted in the console. Make sure strings stay inside quotes and numbers are not quoted.
• Map fails to load - the Map path does not match a map on the server. Point it at an existing map, or install the custom map first. See Change the Map.

Mods Are Missing or Broken

• Client mods must be uploaded as .zip files directly inside Resources/Client, not extracted and not inside a sub-folder.
• Single-player mods installed locally do not work on BeamMP and should be disabled.
• Allow the automatic download to finish the first time a player connects. See Install Mods.

Lag, Desync, or Crashes

• Lower MaxCars to reduce the number of vehicles each client simulates. See Change Max Cars Per Player.
• Reduce MaxPlayers if the host hardware is struggling.
• Remove large or poorly optimised mods, which are a common cause of lag and desync.
• Spawning AI traffic on a server with a very low MaxCars can crash clients. See Add AI Traffic.