Troubleshooting Your BeamMP Server

Here are some common BeamMP server issues you may encounter and how to fix them.

Server Not Showing in Browser

If your server isn't appearing in the multiplayer browser, or you're seeing [WARN] Backend failed to respond to a heartbeat in your console, this means your server is unable to be queried by BeamMP.

The most common causes are:

• Missing AUTH key - Your server requires an AUTH key to display in the server browser. Create an AUTH key for your BeamMP server.
• Server set to private - Ensure Private is set to False in Server Options of the GhostCap Panel.

If unsuccessful, ensure your AUTH key is correct and that you've restarted your server. Otherwise, there's nothing to do except wait, as BeamMP may be having network issues. You can view our own network status here.

Stuck on Connecting

If you're having trouble connecting to a server and are stuck on "Connecting", "Start," or "Socket Error", in most cases this is caused by an incompatible or corrupted mod file and is especially common right after BeamNG has updated. Follow these steps to deactivate your mods before trying to load into your server:

1. Restart your PC/BeamMP.
2. Open BeamMP.
3. Go to Repository > Mods Manager.
4. Click Deactivate all mods.
5. Then only re-enable MultiplayerBeamMP.
6. Connect to your server.

If this doesn't resolve the issue, temporarily disable the mods on your server to confirm whether a mod is the cause:

1. Access the GhostCap Panel and Stop your server.
2. In the sidebar, go to File Manager and open the Resources folder.
3. Rename the Client folder to Client_OLD.
4. Start your server and try connecting without mods.

If you can connect, you've confirmed it's a mod-related issue. Rename the folder back to Client, then remove half of the mods from Resources/Client and test again. Keep halving until you find the mod causing the problem.

We highly recommend using SFTP to move multiple mods at a time.

If you recently uploaded a mod, start troubleshooting from there. Persistent "Socket Error" messages may indicate that one of your mod files is corrupted or a firewall/anti-virus issue, so double-check to ensure all mod uploads were successful.

Creating a New BeamNG Profile

Do this if the steps above don't resolve the issue:

1. Open the BeamMP launcher.
2. Click Manage User Folder.
3. Select Open User Folder.
4. Rename the current folder, for example current to current_OLD.
5. Start BeamMP and connect to your server.

Cars Not Moving

If you can connect to your server but cars won't move, try the following:

• Check your system date and time - An incorrect date or time on your PC can cause cars to not move in BeamMP.
• Wait for the event queue - On the latest versions of BeamMP, you need to wait for the event queue to finish processing before cars will start moving. This may take a few moments after spawning.
• Check for a ? in Ping or Players - If you see a ? in either the Ping or Players column of the server browser, reconnect until it shows a value. This is typically caused by high ping, and a VPN can help.

BeamMP Won't Start

1. Restart your PC.
2. Run the launcher as administrator.
3. Check your firewall/antivirus.
4. Check for GPU driver updates.
5. Search the BeamMP Reddit or Discord.
6. Reinstall BeamMP.

Still having trouble? Contact us so we can take a look. Here's our Discord.