Как создать свой сервер BeamMP
Полное руководство по созданию сервера BeamMP (мультиплеер BeamNG.drive) на VPS или выделенном сервере Linux: AuthKey, карта, моды, плагины Lua, сервис systemd и брандмауэр.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
BeamMP — это мультиплеерный мод для BeamNG.drive, созданный сообществом. Это руководство объясняет, как установить его сервер на ваш VPS или выделенный Linux-сервер, запустить его от выделенного пользователя через сервис systemd, затем выбрать карту и добавить моды и плагины Lua.
Заказать сервер
BeamMP нетребователен: необходимые ресурсы определяются в основном количеством игроков, автомобилей и модов. HostMyServers предлагает несколько подходящих вариантов:
- NVMe VPS - Для сервера с друзьями или тестового сервера
- Performance VPS - Выделенные ресурсы, для публичного сервера
- Эко выделенные серверы - Для активного сообщества или большого количества модов
- Выделенные серверы Performance - Максимальная производительность
Предварительные требования
- SSH-доступ как root или пользователь с правами sudo
- 64-разрядная система Linux x86_64: Debian 12/13 или Ubuntu 22.04/24.04
- Активный брандмауэр: nftables (рекомендуется), iptables или ufw (используйте только один инструмент брандмауэра одновременно)
- Публичный адрес IPv4: сервер BeamMP пока не поддерживает IPv6 для игроков
- Аккаунт Discord, чтобы создать ваш AuthKey на Keymaster BeamMP
- Порт 30814 доступен по TCP и по UDP
Каждый игрок должен владеть BeamNG.drive и установить лаунчер BeamMP.
Требуемая конфигурация
BeamMP публикует следующие минимальные значения, не учитывающие потребление операционной системы. Правый столбец — рекомендуемая отправная точка, которую следует корректировать в зависимости от вашего использования.
| Компонент | Официальный минимум | Рекомендуемая отправная точка |
|---|---|---|
| RAM | 50 МиБ свободно | 2 ГБ |
| CPU | Более 1 ГГц, желательно многоядерный | 2 ядра |
| Хранилище | 10 МиБ, плюс моды и плагины | 10 ГБ SSD, больше при большом количестве модов |
| Сеть | 5-10 Мбит/с на исходящий трафик | 100 Мбит/с |
| Видеокарта | Не требуется | Не требуется |
Обновление системы
sudo apt update && sudo apt upgrade -yУстановка зависимостей
BeamMP требует библиотеку Lua 5.3 (liblua5.3-0). Остальные пакеты нужны для загрузки, модов и резервного копирования:
sudo apt install -y liblua5.3-0 curl tar unzip nano cronСоздание выделенного пользователя
BeamMP не рекомендует запускать сервер от root или от вашей личной учётной записи. Создайте выделенного пользователя:
sudo adduser --disabled-password --gecos "" beammpИспользуемые порты
| Порт | Протокол | Назначение |
|---|---|---|
| 30814 | TCP | Подключение игроков, загрузка модов |
| 30814 | UDP | Игровые данные в реальном времени |
В BeamMP нет ни RCON, ни веб-интерфейса: открывать порты администрирования не нужно. Консоль доступна только с самого сервера (см. Администрирование).
Настройка брандмауэра
С UFW
sudo ufw allow 30814/tcp
sudo ufw allow 30814/udp
sudo ufw reloadС iptables
sudo iptables -A INPUT -p tcp --dport 30814 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 30814 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4Сохранение правил после перезагрузки требует пакета iptables-persistent.
С nftables
Эти команды используют таблицу inet filter и цепочку input, присутствующие по умолчанию в /etc/nftables.conf в Debian.
sudo nft add rule inet filter input tcp dport 30814 accept
sudo nft add rule inet filter input udp dport 30814 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.confСоздание AuthKey
AuthKey идентифицирует ваш сервер в BeamMP. Без него сервер отказывается запускаться, даже если он остаётся приватным.
- Перейдите на Keymaster BeamMP и войдите через Discord.
- Откройте раздел Keys.
- Нажмите зелёную кнопку +.
- Введите имя сервера, затем нажмите Create.
- Скопируйте полученный ключ.
Установка сервера
Войдите как пользователь beammp и создайте папку сервера:
sudo -iu beammp
mkdir -p ~/beammp-server
cd ~/beammp-serverЗагрузите последнюю версию для вашей системы. Первая строка определяет ваш дистрибутив, чтобы получить, например, debian.12 или ubuntu.24.04:
. /etc/os-release
curl -fL -o BeamMP-Server "https://github.com/BeamMP/BeamMP-Server/releases/latest/download/BeamMP-Server.$ID.$VERSION_ID.x86_64"
chmod +x BeamMP-ServerЗапустите сервер один раз, чтобы сгенерировать его конфигурацию:
./BeamMP-ServerНастройка сервера
Откройте файл конфигурации:
nano ~/beammp-server/ServerConfig.tomlИзмените как минимум эти значения в разделе [General], не трогая остальные строки. Порядок строк в вашем файле может отличаться:
[General]
AuthKey = "PASTE_YOUR_KEY_HERE"
Name = "Мой сервер BeamMP"
Description = "Добро пожаловать на мой сервер"
Tags = "Freeroam,Lang:Russian"
Map = "/levels/west_coast_usa/info.json"
MaxPlayers = 8
MaxCars = 2
Private = true
AllowGuests = falseЗатем защитите этот файл, содержащий ваш ключ, и выйдите из сессии пользователя beammp:
chmod 600 ~/beammp-server/ServerConfig.toml
exitОсновные параметры
| Параметр | Значение по умолчанию | Описание |
|---|---|---|
AuthKey |
пусто | Ключ, созданный на Keymaster (обязателен) |
Name |
BeamMP Server |
Имя, отображаемое в списке серверов (не более 250 символов) |
Description |
BeamMP Default Description |
Описание сервера (не более 1000 символов) |
Tags |
Freeroam |
Теги для поиска через запятую (не более 100 символов) |
Map |
/levels/gridmap_v2/info.json |
Размещаемая карта |
MaxPlayers |
8 |
Максимальное количество игроков |
MaxCars |
1 |
Максимальное количество автомобилей на игрока |
Port |
30814 |
TCP- и UDP-порт сервера |
Private |
true |
true скрывает сервер из публичного списка, false публикует его там |
AllowGuests |
true |
Разрешает подключение игроков без аккаунта BeamMP |
LogChat |
true |
Записывает чат в журналы |
Debug |
false |
Подробные журналы, значительно большего объёма |
ResourceFolder |
Resources |
Папка модов и плагинов |
Если вы меняете Port, измените и правила брандмауэра.
Форматирование имени
Name и Description принимают коды форматирования, которые ставятся перед текстом: ^l жирный, ^o курсив, ^n подчёркнутый, ^r сброс, ^4 красный, ^2 зелёный, ^e жёлтый, ^f белый. Например: Name = "^l^4Мой сервер ^r^fBeamMP". Документация BeamMP содержит полный список, а также список распознаваемых тегов.
Выбор карты
Укажите путь к карте в параметре Map. Карты, входящие в игру, не требуют установки:
| Карта | Значение Map |
|---|---|
| Grid Map | /levels/gridmap_v2/info.json |
| Small Grid | /levels/smallgrid/info.json |
| West Coast USA | /levels/west_coast_usa/info.json |
| East Coast USA | /levels/east_coast_usa/info.json |
| Utah | /levels/utah/info.json |
| Italy | /levels/italy/info.json |
| Jungle Rock Island | /levels/jungle_rock_island/info.json |
| Johnson Valley | /levels/johnson_valley/info.json |
| Hirochi Raceway | /levels/hirochi_raceway/info.json |
| Automation Test Track | /levels/automation_test_track/info.json |
| Industrial | /levels/industrial/info.json |
| Small Island | /levels/small_island/info.json |
| Driver Training | /levels/driver_training/info.json |
| Derby | /levels/derby/info.json |
Настройка как сервис systemd
Приведённый ниже сервис запускает BeamMP автоматически. К нему добавлен небольшой локальный канал (/run/beammp.stdin), позволяющий отправлять команды в консоль сервера.
Создание канала консоли
sudo nano /etc/systemd/system/beammp.socket[Unit]
Description=BeamMP Server console
PartOf=beammp.service
[Socket]
ListenFIFO=/run/beammp.stdin
SocketUser=beammp
SocketGroup=beammp
SocketMode=0660
RemoveOnStop=trueСоздание файла сервиса
sudo nano /etc/systemd/system/beammp.service[Unit]
Description=BeamMP Server
Wants=network-online.target
After=network-online.target beammp.socket
Requires=beammp.socket
[Service]
Type=simple
User=beammp
Group=beammp
WorkingDirectory=/home/beammp/beammp-server
ExecStart=/home/beammp/beammp-server/BeamMP-Server
Sockets=beammp.socket
StandardInput=socket
StandardOutput=journal
StandardError=journal
Restart=on-failure
RestartSec=10
TimeoutStopSec=30
[Install]
WantedBy=multi-user.targetАктивация и запуск сервиса
sudo systemctl daemon-reload
sudo systemctl enable beammp.service
sudo systemctl start beammp.serviceКоманды управления
# Проверить статус
sudo systemctl status beammp.service
# Остановить сервер
sudo systemctl stop beammp.service
# Перезапустить сервер
sudo systemctl restart beammp.service
# Просмотр логов
sudo journalctl -u beammp.service -fПроверка работы
Сервер готов, когда в логах появляется ALL SYSTEMS STARTED SUCCESSFULLY, EVERYTHING IS OKAY:
sudo journalctl -u beammp.service -n 30 --no-pagerПроверьте, что он слушает и по TCP, и по UDP:
sudo ss -tulpn | grep 30814Вы должны получить строку tcp и строку udp, связанные с BeamMP-Server. При Private = false в логах также должно появиться Authenticated!.
Подключение к серверу
- Запустите лаунчер BeamMP, который запускает BeamNG.drive.
- Откройте мультиплеерное меню BeamMP.
- Используйте Direct Connect, затем введите
IP_СЕРВЕРАи порт30814.
Если сервер публичный (Private = false), игроки также могут найти его по имени в списке. Для этого им нужно отключить фильтры и установить для карты значение Any.
Добавление модов
Моды автомобилей и карт помещаются в формате .zip в Resources/Client. Не распаковывайте их. Игроки загружают их автоматически при подключении к серверу.
С вашего компьютера отправьте мод на сервер от имени вашей учётной записи администратора:
scp my_mod.zip ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_СЕРВЕРА:/tmp/На сервере установите его, затем перезапустите BeamMP:
sudo install -o beammp -g beammp -m 644 /tmp/my_mod.zip /home/beammp/beammp-server/Resources/Client/
sudo rm /tmp/my_mod.zip
sudo systemctl restart beammp.serviceИспользование модифицированной карты
Файл .zip карты содержит папку levels/<название_карты>. Найдите это название:
unzip -l /home/beammp/beammp-server/Resources/Client/my_map.zip | grep 'levels/.*/info.json'Если в выведенной строке есть levels/my_map/info.json, измените ServerConfig.toml:
Map = "/levels/my_map/info.json"Затем перезапустите сервис. Если файл info.json не найден в архиве, загрузите карту в одиночной игре в BeamNG.drive, откройте консоль клавишей ~ и выполните print(getMissionFilename()), чтобы получить точный путь.
Добавление плагинов Lua
Плагины выполняются на сервере. У каждого из них своя папка в Resources/Server:
Resources/
├── Client/ Моды, отправляемые игрокам (.zip)
└── Server/
└── Welcome/ Одна папка на плагин
└── main.luaВсе файлы .lua, расположенные непосредственно в папке плагина, загружаются при запуске в алфавитном порядке. Сервер автоматически перезагружает плагин при изменении любого из этих файлов. Вложенные папки не загружаются автоматически: используйте require(). Справочник по плагинам подробно описывает доступные события и функции.
Пример: приветственное сообщение
sudo -iu beammp
mkdir -p ~/beammp-server/Resources/Server/Welcome
nano ~/beammp-server/Resources/Server/Welcome/main.luafunction onInit()
print("Плагин Welcome загружен")
end
function onPlayerArrival(player_id)
MP.SendChatMessage(player_id, "Добро пожаловать на сервер!")
end
MP.RegisterEvent("onPlayerJoin", "onPlayerArrival")Пример: белый список
Этот плагин принимает только перечисленные ники BeamMP и отклоняет гостей. По-прежнему от имени пользователя beammp:
mkdir -p ~/beammp-server/Resources/Server/Whitelist
nano ~/beammp-server/Resources/Server/Whitelist/main.lualocal allowedPlayers = {
["Player1"] = true,
["Player2"] = true,
}
function checkPlayer(name, role, isGuest, identifiers)
if isGuest or not allowedPlayers[name] then
return "Этот сервер доступен только для авторизованных игроков."
end
end
MP.RegisterEvent("onPlayerAuth", "checkPlayer")Затем выйдите из сессии пользователя beammp и перезапустите сервер, так как новый плагин не обнаруживается на лету:
exit
sudo systemctl restart beammp.serviceСообщение Плагин Welcome загружен должно появиться в логах.
Администрирование
Отправка команд в консоль
Создайте небольшую команду, которая записывает в консоль и показывает её ответ:
sudo nano /usr/local/bin/beammp-cmd#!/bin/bash
if [ ! -p /run/beammp.stdin ]; then
echo "Сервер BeamMP не запущен." >&2
exit 1
fi
echo "$*" > /run/beammp.stdin
sleep 1
journalctl -u beammp.service -n 15 --no-pager -o catsudo chmod 755 /usr/local/bin/beammp-cmdЗатем вы можете выполнить, например:
sudo beammp-cmd list
sudo beammp-cmd say Перезапуск через 5 минутДоступные команды
| Команда | Описание |
|---|---|
help |
Показывает справку |
list |
Список подключённых игроков |
status |
Показывает состояние сервера |
say <сообщение> |
Отправляет сообщение всем игрокам |
kick <имя> [причина] |
Выгоняет игрока |
version |
Показывает версию сервера |
reloadmods |
Перезагружает моды из Resources/Client |
protectmod <файл.zip> <true/false> |
Защищает платный или приватный мод: он больше не отправляется игрокам, которым нужно получить его самостоятельно |
settings help |
Показывает справку по просмотру и изменению настроек |
Чтобы остановить сервер, используйте sudo systemctl stop beammp.service.
Обновление сервера
BeamMP не обновляется автоматически. О новых версиях сообщается на странице релизов. Проверьте свою версию командой sudo beammp-cmd version.
Загрузите новую версию рядом со старой:
sudo -iu beammp
cd ~/beammp-server
. /etc/os-release
curl -fL -o BeamMP-Server.new "https://github.com/BeamMP/BeamMP-Server/releases/latest/download/BeamMP-Server.$ID.$VERSION_ID.x86_64"
chmod +x BeamMP-Server.new
exitЗатем замените исполняемый файл и перезапустите:
sudo systemctl stop beammp.service
sudo -u beammp mv /home/beammp/beammp-server/BeamMP-Server.new /home/beammp/beammp-server/BeamMP-Server
sudo systemctl start beammp.serviceЕсли вы меняете версию Debian или Ubuntu, повторите эту процедуру: исполняемый файл зависит от дистрибутива.
Автоматическое резервное копирование
Достаточно сохранять конфигурацию и папку Resources.
Скрипт резервного копирования
sudo nano /home/beammp/backup.sh#!/bin/bash
umask 077
BACKUP_DIR="/home/beammp/backups"
SERVER_DIR="/home/beammp/beammp-server"
DATE=$(date +%Y-%m-%d_%H-%M-%S)
mkdir -p "$BACKUP_DIR"
# Резервная копия конфигурации, модов и плагинов
tar -czf "$BACKUP_DIR/beammp_$DATE.tar.gz" -C "$SERVER_DIR" ServerConfig.toml Resources
# Удаление резервных копий старше 7 дней
find "$BACKUP_DIR" -name "beammp_*.tar.gz" -mtime +7 -delete
echo "Резервное копирование завершено: beammp_$DATE.tar.gz"sudo chown beammp:beammp /home/beammp/backup.sh
sudo chmod 700 /home/beammp/backup.shПланирование резервного копирования
sudo crontab -u beammp -eДобавьте:
# Резервное копирование каждый день в 5 часов
0 5 * * * /home/beammp/backup.shПри возникновении проблем
Сервер не запускается
Проверьте логи:
sudo journalctl -u beammp.service -n 100 --no-pagerФайл /home/beammp/beammp-server/Server.log содержит ту же информацию и не содержит вашего AuthKey. Он полезен, когда вы просите помощи у сообщества BeamMP.
| Сообщение | Причина и решение |
|---|---|
No AuthKey specified |
Ключ отсутствует в ServerConfig.toml |
AuthKey specified is the wrong length |
Ключ неполный или скопирован неверно |
Backend REFUSED the auth key |
Ключ отклонён BeamMP: проверьте его на Keymaster или убедитесь, что он ещё не используется другим сервером |
Error parsing config file value |
Синтаксическая ошибка, часто пропущенные кавычки, или файл недоступен для чтения: проверьте, что его владелец beammp |
bind() failed: Address already in use |
Порт уже используется другой программой: определите её командой sudo ss -tulpn | grep 30814 |
Если ServerConfig.toml больше не принадлежит beammp, исправьте его права:
sudo chown beammp:beammp /home/beammp/beammp-server/ServerConfig.toml
sudo chmod 600 /home/beammp/beammp-server/ServerConfig.tomlОшибка GLIBC_ или cannot execute binary file
Исполняемый файл не соответствует вашей системе. Проверьте версию командой cat /etc/os-release, затем загрузите подходящий файл заново. Исполняемые файлы, предлагаемые в этом руководстве, предназначены для процессоров x86_64.
Игроки не могут подключиться
Коды ошибок 10060, 10061 или 10030 на стороне игрока чаще всего означают, что сервер недоступен или введён неверный адрес.
- Проверьте, что сервис активен:
sudo systemctl status beammp.service - Проверьте, что порт слушается и по TCP, и по UDP:
sudo ss -tulpn | grep 30814 - Проверьте правила брандмауэра для обоих протоколов
- Проверьте, что игрок использует именно адрес IPv4 сервера
- VPN вроде Hamachi или RadminVPN не поддерживаются
Сервер не появляется в списке
- Проверьте, что
Private = false - Поищите
Authenticated!илиBackend REFUSED the auth keyв логах - В игре отключите фильтры и установите для карты значение Any
Подключение блокируется после добавления мода
Вероятно, мод несовместим, повреждён или конфликтует с другим. Убирайте моды из Resources/Client по одному, перезапуская сервер каждый раз, чтобы найти виновника.
Карта не загружается
- Проверьте путь в
Map, он должен заканчиваться на/info.json - Для модифицированной карты проверьте, что её
.zipнаходится вResources/Client
Сервер BeamMP не запущен при использовании beammp-cmd
Канал консоли существует только пока работает сервис. Запустите его командой sudo systemctl start beammp.service.
AuthKey был раскрыт
Если ваш ключ утёк, BeamMP предлагает открыть тикет Account Support на своём официальном Discord.