BeamMP/BeamMP-Server
1
0
Fork 0
mirror of https://github.com/BeamMP/BeamMP-Server.git synced 2025-07-01 15:26:59 +00:00
Code Issues Packages Projects Releases Wiki Activity
BeamMP-Server/README.md
Lion bd4ab2b10d
Update README.md
2023-12-30 10:22:12 +01:00

5.0 KiB
Raw Permalink Blame History

BeamMP-Server

CMake Windows Build CMake Linux Build

This is the server for the multiplayer mod BeamMP for the game BeamNG.drive. The server is the point through which all clients communicate. You can write Lua mods for the server, there are detailed instructions on the BeamMP Wiki.

For Linux, you need the runtime dependencies, which are listed below under Runtime Dependencies

Support + Contact

Feel free to ask any questions via the following channels:

Minimum Requirements

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

Contributing

TLDR; Issues with the "help wanted" or "good first issue" label or with nobody assigned.

To contribute, look at the active issues. Any issues that have the "help wanted" label or don't have anyone assigned 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++.

About Building from Source

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 v3.1.0.

Supported Operating Systems

The code itself supports (latest stable) Linux and Windows. In terms of actual build support, for now we usually only distribute Windows binaries and Linux. For any other distro or OS, you just have to find the same libraries listed in Runtime Dependencies further down the page, and it should build fine.

Recommended compilers: MSVC, GCC, CLANG.

You can find precompiled binaries under Releases.

Build Instructions

On Linux, you need some dependencies to build the server (on Windows, you don't):

liblua5.3-dev curl zip unzip tar cmake make git g++

You can install these with your distribution's package manager. You will need sudo or need root for ONLY this step.

The names of each package may change depending on your platform.

If you are building for ARM (like aarch64), you need to run export VCPKG_FORCE_SYSTEM_BINARIES=1 before the following commands.

You can build on Windows, Linux or other platforms by following these steps:

  1. Check out the repository with git: git clone --recursive https://github.com/BeamMP/BeamMP-Server.
  2. Go into the directory cd BeamMP-Server.
  3. Run CMake cmake -S . -B bin -DCMAKE_BUILD_TYPE=Release - this can take a few minutes and may take a lot of disk space and bandwidth.
  4. Build via cmake --build bin --parallel --config Release -t BeamMP-Server.
  5. Your executable can be found in bin/.

When you make changes to the code, you only have to run step 4 again.

Runtime Dependencies

These are needed to run the server.

Debian, Ubuntu and friends: liblua5.3-0

Other Linux distros: liblua of some kind.

Windows: No libraries.

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.

Copyright

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.