Начиная

1. Совместимость

BeamMP полностью совместим с Windows и Linux, совместимость с MacOS находится в разработке. Однако Linux и MacOS являются вторичными платформами, поэтому следует ожидать ошибок.

Предупреждение

BeamMP не будет работать с пиратскими или устаревшими версиями BeamNG.drive.
Служба поддержки BeamMP не оказывает помощь по вопросам, связанным с пиратскими/устаревшими копиями.

2. Установка

2а. Установка Windows

Примечание

По состоянию на 1 апреля 2026 года, согласно Windows Defender SmartScreen, установщик MSI является «неопознанным приложением».

Чтобы проигнорировать это предупреждение, нажмите «Подробнее», а затем нажмите «Запустить в любом случае».

Перейдите на сайт beammp.com и нажмите кнопку «Скачать сейчас».
Запустите установщик BeamMP_Installer.msi и следуйте инструкциям.
Значок BeamMP Launcher должен появиться на рабочем столе. Если нет, просто введите «BeamMP» в строку поиска Windows.

Примечание

  Поскольку при загрузке на карту с множеством созданных транспортных средств подключение может занять больше времени, чем ожидалось.

2б. Установка Linux

В настоящее время вам необходимо самостоятельно собрать Launcher. Для этого вам необходимо базовое понимание того, как собрать приложение.

Убедитесь, что у вас установлены базовые инструменты разработки, которые обычно входят в пакеты, например:

Debian/Ubuntu: sudo apt install build-essential
Fedora: sudo dnf install cmake gcc gcc-c++ make perl perl-IPC-Cmd perl-FindBin perl-File-Compare perl-File-Copy kernel-headers kernel-devel
Arch: sudo pacman -S base-devel
openSUSE: zypper in -t pattern devel-basis
SteamOS (Arch): sudo pacman -S base-devel linux-api-headers glibc libconfig (Вам также необходимо выполнить команду sudo steamos-readonly disable , но не забудьте включить ее снова после установки пакетов)

Склонируйте vcpkg, выполните его начальную сборку (bootstrap) и добавьте в PATH

1.

git clone https://github.com/microsoft/vcpkg.git

1.

./vcpkg/bootstrap-vcpkg.sh

1.

export VCPKG_ROOT="$(pwd)/vcpkg"
export PATH=$VCPKG_ROOT:$PATH

Клонируйте репозиторий BeamMP-Launcher в свою систему с помощью git, например: git clone https://github.com/BeamMP/BeamMP-Launcher.git Дополнительная информация о клонировании репозитория GitHub

Переключитесь на тег, который использовался для последнего релиза. Например, если в последнем релизе использовался v2.6.4, выполните команду git checkout v2.6.4

Если вы использовали пример команды клонирования, который мы предоставили, вы можете использовать cd BeamMP-Launcher, чтобы перейти в корневой каталог проекта.

В корневом каталоге проекта,

1.

cmake . -B bin -DCMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-linux

1.

cmake --build bin --parallel

  Если во время сборки не хватит оперативной памяти, можно исключить параметр --parallel — в этом случае сборка будет выполняться только в одном потоке процессора, что позволит сократить объем используемой оперативной памяти.

  Не указывая `-DCMAKE_BUILD_TYPE=Release`, вы создаете отладочную версию, которая больше по размеру файла, но не содержит ошибки, из-за которой программа запуска может подключиться к серверу только один раз.

!!!примечание "Пользователи Fedora" Если vcpkg выдаёт ошибку при компиляции OpenSSL из-за заголовков ядра, убедитесь, что все зависимости установлены: bash sudo dnf install kernel-headers kernel-devel gcc gcc-c++ make perl Затем очистите кэш vcpkg: bash rm -rf $VCPKG_ROOT/buildtrees/openssl И повторите команду конфигурации cmake.

Переместите готовое приложение из папки /bin в отдельную папку и запустите его оттуда:

mkdir -p ~/beammp-launcher
cp bin/BeamMP-Launcher ~/beammp-launcher/
cd ~/beammp-launcher
./BeamMP-Launcher

Нативный Linux-ланчер BeamMP запустится и будет использовать нативную версию BeamNG.drive для Linux

2c. Использование beamNG.drive с Proton

Если вы хотите использовать родной Linux BeamMP-Launcher вместе с BeamNG.drive, работающим через Proton, вы можете сделать это:

Запустите BeamMP-Launcher, используя аргумент --no-launch (Это не позволит Launcher запустить собственный Linux BeamNG.drive). Дополнительную информацию об аргументах Launcher можно найти в разделе Настройка среды разработки

Измените расположение пользовательской папки Proton-BeamNG.drive на расположение Linux-BeamNG.drive (поскольку собственный Linux BeamMP-Launcher в настоящее время записывает только в пользовательскую папку Linux-BeamNG.drive)

Это можно сделать, например, создав символическую ссылку

Запомните местоположение пользовательской папки Linux-BeamNG.drive (обычно она находится в ~/.local/share/BeamNG.drive) и переименуйте ее, например, в BeamNG.drive_old
Обратите внимание на расположение пользовательской папки Proton-BeamNG.drive (обычно она находится в ~/.local/share/Steam/steamapps/compatdata/284160/pfx/drive_c/users/steamuser/AppData/Local/BeamNG.drive)
Создайте символическую ссылку между обеими папками пользователей ln -s ~/.local/share/Steam/steamapps/compatdata/284160/pfx/drive_c/users/steamuser/AppData/Local/BeamNG.drive ~/.local/share

После установки символической ссылки между пользовательскими папками и скомпилированным лаунчером вы можете заставить Steam запустить игру через Proton, при этом лаунчер автоматически запустится со следующей заменой параметров запуска для оригинальной игры, которые можно найти в окне «Свойства» игры в ее записи в Steam:

~/BeamMP/BeamMP-Launcher --no-launch & %command% ; killall BeamMP-Launcher

Обратите внимание, что это предполагает, что вы поместили скомпилированный ранее двоичный файл лаунчера в /home/user/BeamMP/, поэтому измените его так, чтобы он соответствовал месту, куда вы поместили готовый двоичный файл, и вам придется перекомпилировать лаунчер с правильной веткой git каждый раз при выпуске обновления лаунчера.

Добавление шрифта эмодзи для получения эмодзи в тексте

Для того чтобы эмодзи отображались в списке серверов (как часть пользовательского имени сервера) или во внутриигровом чате, вам нужен шрифт, содержащий эмодзи.

Это можно сделать, например, добавив [Linux-версию шрифта эмодзи Segoe-UI для Windows](https://github.com/mrbvrz/segoe-ui-linux)

3. Использование BeamMP

После запуска лаунчера вы увидите окно терминала. Вскоре после этого должен запуститься стандартный лаунчер BeamNG. Не закрывайте окно терминала.
В главном меню BeamNG.drive нажмите кнопку Repository и убедитесь, что включен только мод multiplayerbeammp .
Выйдите в главное меню, нажмите «Ещё..», затем кнопку «Мультиплеер», чтобы начать игру по сети.
Вам будет предложено войти или играть в качестве гостя (не все серверы допускают гостей). Вы можете создать учетную запись на нашем форуме, а затем войти в BeamMP с теми же учетными данными.
Выберите любой понравившийся вам сервер и нажмите Connect. Наслаждайтесь!

4. Известные проблемы

Нативный linux BeamMP-Launcher в настоящее время может подключиться к серверу только один раз, после отключения вам нужно перезапустить лаунчер. Вы можете сделать это, не закрывая игру между
Если вы не видите кнопку «Мультиплеер». Убедитесь, что мод BeamMP присутствует и активирован в «Менеджере модов», затем попробуйте нажать CTRL + L.
VPN любого типа могут вызывать проблемы с подключением.
Если Launcher сообщает о каких-либо ошибках, прочтите FAQ.

Если вам потребуется дополнительная помощь с установкой, вы можете создать сообщение на нашем форуме или задать вопрос на нашем сервере Discord.