commit 869d50349e4337463d1179035c2da29ce0073370 Author: <> Date: Tue Aug 12 17:34:21 2025 +0000 Deployed a299103 with MkDocs version: 1.6.1 diff --git a/.nojekyll b/.nojekyll new file mode 100644 index 00000000..e69de29b diff --git a/404.html b/404.html new file mode 100644 index 00000000..f6048015 --- /dev/null +++ b/404.html @@ -0,0 +1,2494 @@ + + + +
+ + + + + + + + + + + + + + + + +The Launcher is not connecting to the game. +This quick guide explains how to manually change the launcher port.
+Show advanced options
Launcher port
change the port number to something else, for example 4567Open file location
in the context menulauncher.cfg
file in a text editor"Port": 4444,
number to the same you used earlier in the ingame options, in this example 4567If theres still no connection, try again with another port. Any number between ~2000 and 65535 is a valid port
+Create a support ticket on our Discord Server.
+Tags: Launcher, Connection Failed, Port Number
+ + + + + + + + + + + + + + + + + + + + + + + + +Info
+Before tampering with the firewall, make sure that your network within the windows networking settings is set to private (assuming you are in a private network).
+DISCLAIMER:
+Firewall / Defender exclsuions are a risk.
+By creating exclsuions, you understand the risks of allowing programs on your PC and opening up ports on your home network to the public and therefore void the right to hold BeamMP accountable for any and all damages that may happen to you or your household.
+We take no responsibility for any content on any externally linked services or websites.
+Windows Defender Firewall with advanced setting
.Inbound
to open the inbound exclusions tab.Create new rule
in the top right to create a new exclusion.Program
to create a program specific exclusion.BeamMP-Launcher.exe
. By default, this would be %appdata%\BeamMP-Launcher\BeamMP-Launcher.exe
without quotes.Windows Security
app.virus and threat protection
.Manage settings
beneath "Virus & threat protection settings".Exclusions
tab.process
.BeamMP-Launcher.exe
into the field and save it.Open a Thread on the Forum or on our Discord server in the #support
channel.
How to check for CGNAT?
+All Firewall exclusions and Port forwarding rules are set up correctly, yet nobody can join your home-hosted Server?
+If you have connection problems and you are using a Hosting-Service, contact them for assistance. If you want to use a VPS or cannot host a server at home, take a look at our +list of Partnered hosting services (Server setup documentation).
+For a detailed explanation, on what CGNAT is and why it's an issue when trying to host a server at home, take a look at this page.
+Open a command prompt, run tracert -4 beammp.com
. This will output a series of network hops. Wait for the operation to finish (may take up to 30 hops). Check the first few IP addresses after the IP of your Router/Modem/Gateway.
+If multiple IP addresses within the range of 100.64.x.x
-100.127.x.x
or 10.xx.xx.xx
appear after the first hop, you are most likely behind a CGNAT.
Note
+The first hop will be your Router/Modem/Gateway and differs between Devices.
+The official ranges for local networks are as follows: 10.0.0.xxx
- 192.168.xxx.xxx
- `172.16.xxx.xxx
Find out the WAN IP on your router by looking it up on its interface. Compare it to the IP posted on e.g. https://whatsmyip.org . If they are NOT the same, you are behind a CGNAT.
+Call your Internet Service Provider for assistance. +Depending on your ISP, they might not offer dedicated dynamic IP adresses. Keep in mind, that a static IP is not necessary.
+Warning
+Internet Service Providers may only offer dedicated IP addresses as a paid option. +Please check the prices of our partnered hosting services as they could be cheaper than this fee!
+Example of a non-CGNAT Network:
+Tags: Server, 10060 10061, CGNAT, Connection Failed, Port Forward, Firewall
+ + + + + + + + + + + + + + + + + + + + + + + + +In BeamMP, the Server you decide to connect to, provides the necessary mods. These get downloaded and activated automatically upon connecting. +Having local mods installed and active often leads to BeamMP not functioning properly, even if you have just one additional mod besides BeamMP.
+Warning
+Remove any mods you have placed in the BeamNG.Drive\content\ or sub-folders. That location is NOT meant for the installing mods and can lead to issues as stated in the DO_NOT_INSTALL_MODS_HERE.txt
file, located in the same directory.
DO_NOT_INSTALL_MODS_HERE.txt
+Do NOT copy mods into this folder: it can lead to broken mods, slower installation of updates, a broken mod manager, broken Safe Mode and others.
+There are 3 options to resolve possible issues when using BeamMP.
+Before joining any server, make sure you have no mods besides 'multiplayerbeammp' enabled. +If the game freezes or you still have issues, refer to the next option
+Open the BeamNG.Drive userfolder and rename the folder of the latest version (e.g. 0.35) to for example 0.xx_OLD (0.35_OLD). Close BeamNG.drive before renaming it.
+
To access the Beamng.drive\content\ folder and clean the folder of any mods, open the installation location of BeamNG.drive.
+Right click the content
folder and delete it. Proceed to verify the game files via Steam or Epic Games. This is going to download the files again.
After you are done, start BeamNG.Drive via the BeamMP-Launcher and you should have 'multiplayerbeammp' as your only enabled mod available in the repository as well as the button on the Main Menu to enter BeamMP. +If you still have issues joining modded server, they likely provide broken/outdated mods.
+To clean up cached mods from the BeamMP directories, go to the installation location of your BeamMP-Launcher. By default, the path would be 'C:\Users\AppData\BeamMP-Launcher\'. In there, you will find a 'Resources' folder. +Delete the folder to delete all cached mods. This can be helpful if you need more space on your disk or want to clean out oudated BeamNG mods.
+My settings and configs are gone! How can I restore them?
+If you renamed the userfolder, you forced the game to create a new, clean userfolder. You may copy the 'settings' and 'vehicles' folder from the folder you renamed (e.g. 0.34_OLD) to the new folder it created. +Make sure BeamNG.Drive is closed and replace all elements in the location you want to copy the folders to. You should now have all configs and settings as they were before.
+The Launcher can't update or shows a blank screen? +This quick guide explains how to manually update the Launcher.
+Note
+You should have already used or installed BeamMP using the installer provided by our website before continuing.
+C:\Users\<username>\AppData\Roaming\
. Replace D:\BeamMP-Launcher
, then place the Launcher in the respective BeamMP-Launcher folder.Create a support ticket on our Discord Server. +Tags: Launcher, download,
+ + + + + + + + + + + + + + + + + + + + + + + + +List of commonly asked questions.
+There is a full guide on how to install BeamMP on Windows, you can find it here.
+BeamMP will not work with pirated or outdated versions of BeamNG.drive. +The BeamMP support team does not offer support for issues with pirated / outdated copies.
+The Client is not officially supported on Linux. However, you can follow our guide on how to use BeamMP on Linux
+Some antivirus programs may flag BeamMP as a threat, due to it interacting with the network and other stuff. There are no viruses in any of the code. The code for the launcher, server, and lua client can be found on our GitHub.
+We are working hard to make the Multiplayer experience as stable as possible. If you have already lowered your graphic settings and your performance is still poor, consider playing on a server with less players. The game is mainly CPU bound when you play with lots of people, so older CPUs (even quadcores) will suffer with more than a handful of people. (General Rule of Thumb: 1 car per CPU Thread)
+All the source code can be found on our GitHub. +Before making any changes, keep in mind that the code is subject to our Terms of Use and licenses:
+Code | +License | +
---|---|
Server | +LICENSE | +
Launcher | +LICENSE | +
Client Lua | +LICENSE | +
If the issue is code related and you know how to use Github, open a new "Issue" in the appropriate repository on our GitHub. We use an issue-based workflow so even if you already have a fix for the bug, consider opening a new "Issue", then open a "Pull Request" with the solutions for the issue. More info on contributing can be found here.
+If you don't have a GitHub account or you don't know how to use GitHub or have any other questions, you can get in touch with us in the following ways:
+Linking your Discord and BeamMP account is a new feature to BeamMP. To do this you will need send !link
as a message to the BeamMP Accounts bot.
+The bot will respond with a link for you to sign into your BeamMP account. Simply sign in with your BeamMP account, once done you will receive a second message saying that it has successfully linked your accounts. 🎉
Early access (including the purple nametag and other benefits) can be obtained by supporting us financially on Patreon by buying a tier, donating, or by boosting the Discord Server. +Donating x amount US$ = x additional server key(s) including EA benefits. +Boosting gives you +4 Server keys in addition to EA benefits.
+Please ensure you do the following to automatically receive your perks:
+Please be patient, it can take a few hours, sometimes up to 12, for the system to sync. If you have not received your perks after 12 hours and have completed the above steps please contact BeamMP support.
+If your question or issue relates to the Game or playing please refer to the Game FAQs. +If your question or issue relates to running a Server please refer to the Server FAQs. +Otherwise please check out the forums where the community can ask questions and get answers.
+ + + + + + + + + + + + + + + + + + + + + + + + +List of commonly asked questions and known bugs.
+All the information to set up your own server can be found here.
+We provide binaries for many Linux distributions here. +If there are no binaries for your Operating System/Distribution, you can build it yourself by downloading the source on our GitHub, a tutorial can be found here.
+Read the port forwarding guide that's available here. Below there's a brief summary of the most noteworthy steps. +If other players, trying to connect to your server, receive an error code 10060, 10061 or 10038 in their BeamMP launcher, then you should check the following steps:
+You can check if you have successfully portforwarded using CheckBeamMP whilst the server is running.
+ + +Notes:
+If the server is running on the same machine as the game, you yourself have to use Direct Connect to join, with the IP 127.0.0.1 and your server's port. +For you to be able to join your own, self-hosted server trough the server-list, your router needs to support NAT-loopback, but this is a function not many home routers support.
+All the source code can be found on our GitHub. +Before doing anything keep in mind that the code is subject to our Terms of Use and licenses:
+Code | +License | +
---|---|
Server | +LICENSE | +
Launcher | +LICENSE | +
Client Lua | +LICENSE | +
If the issue is code related and you know how to use Github, create a new "Issue" in the appropriate repository on our GitHub. We use an issue-based workflow so even if you already have a fix for the bug, consider opening a new "Issue", then asking a "Pull Request" that solves your "Issue". More info on contributing can be found here.
+If you don't have a GitHub account or you don't know how to use GitHub you can get in touch with us in the following ways:
+If you are hosting a server with one of our partnered hosting services, the IP will be posted on the respective Server Management Interface. +You can also find the IP for your Server(s) on the Keymaster Website.
+For Servers hosted at home, open whatsmyip.org in a Browser. +This will output the public IPv4 address you are being contacted with from the Internet.
+Note, that 127.0.0.1 is the localhost address and can only be used by yourself, if the Server is hosted on the same Computer. +If you are still having connection troubles with your home hosted server, check the port forwardings as well as CheckBeamMP
+ + +Have a look at this page to determine wether you can host a server at home or not.
+Tags: IP, Server, Connection Failed, 10060/10061
+ + + + + + + + + + + + + + + + + + + + + + + + +