This is the server for the multiplayer mod BeamMP for the game BeamNG.drive. The server is the point throug which all clients communicate. You can write lua mods for the server, detailed instructions on the BeamMP Wiki.
These values are guesstimated and are subject to change with each release.
- RAM: 50+ MiB usable (not counting OS overhead)
- CPU: >1GHz, preferably multicore
- OS: Windows, Linux (theoretically any POSIX)
- GPU: None
- HDD: 10 MiB + Mods/Plugins
- Bandwidth: 5-10 Mb/s upload
TLDR; Issues with the "help wanted" label or with nobody assigned, any trello cards in the "To-Do" column.
To contribute, look at the active issues and at the trello. Any issues that have the "help wanted" label or don't have anyone assigned and any trello cards that aren't assigned or in the "In-Progress" section are good tasks to take on. You can either contribute by programming or by testing and adding more info and ideas.
Fork this repository, make a new branch for your feature, implement your feature or fix, and then create a pull-request here. Even incomplete features and fixes can be pull-requested.
If you need support with understanding the codebase, please write us in the discord. You'll need to be proficient in modern C++.
We only allow building unmodified (original) source code for public use. master
is considered unstable and we will not provide technical support if such a build doesn't work, so always build from a tag. You can checkout a tag with git checkout tags/TAGNAME
, where TAGNAME
is the tag, for example v1.20
.
The code itself supports (latest stable) Linux and Windows. In terms of actual build support, for now we usually only distribute windows binaries and sometimes linux. For any other distro or OS, you just have to find the same libraries listed in the Linux Build Prerequisites further down the page, and it should build fine. We don't currently support any big-endian architectures.
Recommended compilers: MSVC, GCC, CLANG.
You can find precompiled binaries under Releases.
Do not compile from master
. Always build from a release tag, i.e. tags/v2.0
!
Currently only linux and windows are supported (generally). See Releases for official binary releases. On systems to which we do not provide binaries (so anything but windows), you are allowed to compile the program and use it. Other restrictions, such as not being allowed to distribute those binaries, still apply (see copyright notice).
Please use the prepackaged binaries in Releases.
Dependencies for windows can be installed with vcpkg
, in which case the current dependencies are the x64-windows-static
versions of lua
, zlib
, rapidjson
, boost-beast
, boost-asio
and openssl
.
These package names are in the debian / ubuntu style. Feel free to PR your own guide for a different distro.
-
git
-
make
-
cmake
-
g++
-
libcurl4-openssl-dev
or similar (search forlibcurl
and look for one with-dev
)Must support ISO C++17. If your distro's
g++
doesn't support C++17, chances are that it has ag++-8
org++-10
package that does. If this is the case. you just need to run CMake with-DCMAKE_CXX_COMPILER=g++-10
(replaceg++-10
with your compiler's name). -
liblua5.3-dev
Any 5.x version should work, but 5.3 is what we officially use. Any other version might break in the future. You can also use any version of
libluajit
, but the same applies regarding the version. -
libz-dev
-
rapidjson-dev
-
libopenssl-dev
orlibssl-dev
If you're building it from source, you'll need libboost1.70-all-dev
or libboost1.71-all-dev
or higher as well.
If you can't find this version of boost (only 1.6x, for example), you can either update to a newer version of your distro, build boost yourself, or use an unstable rolling release (like Debian sid
aka unstable
).
On windows, use git-bash for these commands. On Linux, these should work in your shell.
- Make sure you have all prerequisites installed
- Clone the repository in a location of your choice with
git clone --recurse-submodules https://github.com/BeamMP/BeamMP-Server
. Now change into the cloned directory by runningcd BeamMP-Server
. - Ensure that all submodules are initialized by running
git submodule update --init --recursive
. Then change into the cloned directory by runningcd BeamMP-Server
. - Checkout the branch of the release you want to compile (
master
is often unstable), for examplegit checkout tags/v1.20
for version 1.20. You can find the latest version here. - Run
cmake .
(with.
) - Run
make
- You will now have a
BeamMP-Server
file in your directory, which is executable with./BeamMP-Server
(.\BeamMP-Server.exe
for windows). Follow the (windows or linux, doesnt matter) instructions on the wiki for further setup after installation (which we just did), such as port-forwarding and getting a key to actually run the server.
tip: to run the server in the background, simply (in bash, zsh, etc) run: nohup ./BeamMP-Server &
.
Copyright (c) 2019-present Anonymous275 (@Anonymous-275), Lion Kortlepel (@lionkor). BeamMP-Server code is not in the public domain and is not free software. One must be granted explicit permission by the copyright holder(s) in order to modify or distribute any part of the source or binaries. Special permission to modify the source-code is implicitly granted only for the purpose of upstreaming those changes directly to github.com/BeamMP/BeamMP-Server via a GitHub pull-request. Commercial usage is prohibited, unless explicit permission has been granted prior to usage.