{"id":13494292,"url":"https://github.com/BeamMP/BeamMP-Server","last_synced_at":"2025-03-28T13:32:56.037Z","repository":{"id":39620883,"uuid":"236575760","full_name":"BeamMP/BeamMP-Server","owner":"BeamMP","description":"Server for the multiplayer mod BeamMP for BeamNG.drive","archived":false,"fork":false,"pushed_at":"2024-10-20T16:33:51.000Z","size":10410,"stargazers_count":129,"open_issues_count":85,"forks_count":53,"subscribers_count":7,"default_branch":"minor","last_synced_at":"2024-10-20T19:39:39.151Z","etag":null,"topics":["c-plus-plus","cpp","game","lua","server"],"latest_commit_sha":null,"homepage":"https://beammp.com","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BeamMP.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"patreon":"BeamMP"}},"created_at":"2020-01-27T19:33:33.000Z","updated_at":"2024-10-20T16:29:16.000Z","dependencies_parsed_at":"2023-12-08T17:28:03.202Z","dependency_job_id":"ed544e6d-2caa-43c9-9990-e83a1076d7e7","html_url":"https://github.com/BeamMP/BeamMP-Server","commit_stats":null,"previous_names":[],"tags_count":34,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BeamMP%2FBeamMP-Server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BeamMP%2FBeamMP-Server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BeamMP%2FBeamMP-Server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BeamMP%2FBeamMP-Server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BeamMP","download_url":"https://codeload.github.com/BeamMP/BeamMP-Server/tar.gz/refs/heads/minor","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222382544,"owners_count":16975383,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["c-plus-plus","cpp","game","lua","server"],"created_at":"2024-07-31T19:01:23.540Z","updated_at":"2025-03-28T13:32:56.030Z","avatar_url":"https://github.com/BeamMP.png","language":"C++","readme":"# BeamMP-Server\n\n[![CMake Windows Build](https://github.com/BeamMP/BeamMP-Server/workflows/CMake%20Windows%20Build/badge.svg?branch=master)](https://github.com/BeamMP/BeamMP-Server/actions?query=workflow%3A%22CMake+Windows+Build%22)\n[![CMake Linux Build](https://github.com/BeamMP/BeamMP-Server/workflows/CMake%20Linux%20Build/badge.svg?branch=master)](https://github.com/BeamMP/BeamMP-Server/actions?query=workflow%3A%22CMake+Linux+Build%22)\n\nThis is the server for the multiplayer mod **[BeamMP](https://beammp.com/)** for the game [BeamNG.drive](https://www.beamng.com/).\nThe 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](https://wiki.beammp.com).\n\n**For Linux, you __need__ the runtime dependencies, which are listed below under [Runtime Dependencies](#runtime-dependencies)**\n\n## Support + Contact\n\nFeel free to ask any questions via the following channels:\n\n- **Discord**: [click for invite](https://discord.gg/beammp)\n- **BeamMP Forum**: [BeamMP Forum Support](https://forum.beammp.com/c/support/33)\n\n## Minimum Requirements\n\nThese values are guesstimated and are subject to change with each release.\n\n* RAM: 30-100 MiB usable (not counting OS overhead)\n* CPU: \u003e1GHz, preferably multicore\n* OS: Windows, Linux (theoretically any POSIX)\n* GPU: None\n* HDD: 10 MiB + Mods/Plugins\n* Bandwidth: 5-10 Mb/s upload\n\n## Contributing\n\nTLDR; [Issues](https://github.com/BeamMP/BeamMP-Server/issues) with the \"help wanted\" or \"good first issue\" label or with nobody assigned.\n\nTo contribute, look at the active [issues](https://github.com/BeamMP/BeamMP-Server/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.\n\nFork 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.\n\nIf you need support with understanding the codebase, please write us in the Discord. You'll need to be proficient in modern C++.\n\n## About Building from Source\n\nWe 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.4.1`. See [the tags](https://github.com/BeamMP/BeamMP-Server/tags) for possible versions/tags, as well as [the releases](https://github.com/BeamMP/BeamMP-Server/releases) to check which version is marked as a release/prerelease. We recommend using the [latest release](https://github.com/BeamMP/BeamMP-Server/releases/latest).\n\n## Supported Operating Systems\n\nThe code itself supports (latest stable) Linux, Windows and FreeBSD. 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](#runtime-dependencies) further down the page, and it should build fine.\n\nRecommended compilers: MSVC, GCC, CLANG. \n\nYou can find precompiled binaries under [Releases](https://github.com/BeamMP/BeamMP-Server/releases/).\n\n## Build Instructions\n\nOn Linux, you need some dependencies to **build** the server (on Windows, you don't):\n\n```\nliblua5.3-dev curl zip unzip tar cmake make git g++\n```\n\nYou can install these with your distribution's package manager. You will need sudo or need root for ONLY this step.\n\nThe names of each package may change depending on your platform.\n\nIf you are building for ARM (like aarch64), you need to run `export VCPKG_FORCE_SYSTEM_BINARIES=1` before the following commands.\n\nYou can build on **Windows, Linux** or other platforms by following these steps:\n\n1. Check out the repository with git: `git clone --recursive https://github.com/BeamMP/BeamMP-Server`.\n2. Go into the directory `cd BeamMP-Server`.\n3. Specify the server version to build by checking out a tag: `git checkout tags/v3.4.1` - [Possible versions/tags](https://github.com/BeamMP/BeamMP-Server/tags)\n4. 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.\n5. Build via `cmake --build bin --parallel --config Release -t BeamMP-Server`.\n6. Your executable can be found in `bin/`.\n\nWhen you make changes to the code, you only have to run step 4 again.\n### Building for FreeBSD\nBuilding is only supported for major release branches of FreeBSD that are currently not EOL. The build process is the same as on Linux, although build dependencies can be universally installed from ports via pkg:\n```\npkg install git cmake-core zip bash devel/ninja devel/pkgconf lua53\n```\nAfter installing the necessary build dependencies, follow the Linux build instructions beginning from step 3. Beware that running the initial cmake command will compile vcpkg from source, as vcpkg has no native FreeBSD port - this may take some time.\n\nOn systems with a single logical CPU core, `make` may fail to build the server when using the `--parallel` option when calling CMake. If you see error messages related to make, simply omit the `--parallel` from the command: `cmake --build bin --config Release -t BeamMP-Server`.\n\n### Runtime Dependencies\n\nThese are needed to *run* the server.\n\nDebian, Ubuntu and friends: `liblua5.3-0`\n\nOther Linux distros: `liblua` of *some kind*.\n\nWindows: No libraries.\n\n## Support\nThe BeamMP project is supported by community donations via our [Patreon](https://www.patreon.com/BeamMP). This brings perks such as Patreon-only channels on our Discord, early access to new updates, and more server keys. \n","funding_links":["https://patreon.com/BeamMP","https://www.patreon.com/BeamMP"],"categories":["C++"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBeamMP%2FBeamMP-Server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FBeamMP%2FBeamMP-Server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBeamMP%2FBeamMP-Server/lists"}