BeamMP

A Lua mod bringing online multiplayer to BeamNG.drive!

Important Links

• Documentation
• Discord
• Website
• Docs
• Forum
• #beammp on irc.libera.chat (webchat link)

Contents

• BeamMP
• Important Links
• Contents
• Installation
• Servers
• How does it work?
• Roadmap
• Troubleshooting
• Support
• Translations

Installation

Click here for a step-by-step guide on how to install the mod on Windows.

The BeamMP mod has been made as simple as it gets. Just head over to our website (BeamMP.com) and click download. This will download a zip file which contains the installer exe. Just run that exe and follow the instructions. Once this completes all you need to do is double click the shortcut on your desktop.

Now you can play by clicking "Play" and then "Multiplayer", logging in with either a guest account or a BeamMP Forum account. Then just select a server to play on! That's it! :)

If you need help at any point, see the troubleshooting section. There are instructions there on how to get support from our dedicated support team.

Servers

Click here for a step-by-step guide on how to set up and run a server for you & your friends.

The server is usable free of charge for non-commercial use, and the source code is available on GitHub.

Please check out docs.beammp.com for a guide on how to setup your own server. If you run into issues, join the official Discord or join us via IRC in #beammp on irc.libera.chat (webchat link).

How does it work?

This section is a technical explanation of the inner workings of the project and is not relevant for most players.

The Launcher is a separate program which starts the game and connects to the Lua mod right away. The launcher then connects to a remote server of your choice, and these two communicate. The launcher then forwards some packets to the game, like car positions, rotations, chat messages, etc.

For more information on how the launcher and server operate, you can read the source code (C++) in their respective repositories:

• Launcher
• Server

Roadmap

You can see and keep track of development, planned features, etc. Here or on the GitHub Issues section of each repository.

Additionally, you can join the Discord, where regular updates are posted! Also there is our community Forum, where we post additional details.

Troubleshooting

• Frequently Asked Questions/Common Issues
• Error Codes
• Server Auth Key

If none of these fix your issue, we have a dedicated support team on our Discord, and our Forum

Support

The BeamMP project is supported by community donations via our Patreon This brings perks such as Patreon-only channels on our Discord, Early access to new updates, and more server keys.

Translations

BeamMP makes an effort to be maintained for multiple languages. The current progress of this sits at: We use GitLocalize for managing this. You can contribute if you wish here: https://gitlocalize.com/repo/9181.

The individual language progress is as follows:

| Language | Badge | |-----------------------|---------------------------------------------------------------------------------------------------------------------------------| | Catalan | | | Chinese | | | Czech | | | French | | | German | | | Japanese | | | Korean (South Korea) | | | Polish | | | Portuguese (Brazil) | | | Portuguese (Portugal) | | | Russian | | | Slovak | | | Spanish | | | Turkish | |