Как поднять сервер alt:V: пошаговая инструкция

MAATRIX GAMES

Если вы уже пробовали поднять мультиплеер для GTA V и упёрлись в закрытость FiveM или тяжеловесность RAGE:MP, alt:V может оказаться приятным сюрпризом — модульная архитектура, открытый серверный код и нормальная поддержка C# и JS/TS из коробки. Но есть нюанс, на котором спотыкаются почти все новички: билд сервера не лежит в Steam и не ставится через SteamCMD, как на большинстве других платформ. Разберём весь путь от чистого VPS до работающего сервера с автозапуском.

Что такое alt:V и чем он отличается от FiveM и RAGE:MP

alt:V — это модульная мультиплеер-платформа для GTA V, где ядро сервера ничего не знает о геймплее: вся логика (спавн, инвентарь, экономика, HUD) пишется в ресурсах на JavaScript/TypeScript или C#, в зависимости от того, какой игровой модуль вы подключите. В этом главное отличие от FiveM, где основной язык — Lua, а экосистема плотно завязана на CitizenFX-специфику, и от RAGE:MP, который исторически тяжелее в администрировании и менее активно развивается последние годы.

Из плюсов alt:V для владельца сервера: открытый исходный код серверной части, нормальная документация на docs.altv.mp, отдельные модули под JS и C# можно подключать одновременно, а порог входа для разработчиков с опытом в вебе или .NET ниже, чем в Lua-экосистеме FiveM. Из минусов — комьюнити и каталог готовых ресурсов заметно меньше, чем у FiveM, так что часть вещей придётся писать самому или адаптировать под alt:V вручную.

Системные требования и подготовка VPS

Для старта достаточно скромного VPS — от 3 ГБ RAM для сервера на 30-50 слотов с базовым набором ресурсов. Если планируете полноценный ролплей-проект с кастомной экономикой, инвентарём, синхронизацией транспорта и десятками скриптов — закладывайте 6-8 ГБ и минимум 3-4 виртуальных ядра, потому что игровая логика в alt:V выполняется на CPU сервера, а не на клиенте.

Ориентировочные требования:

Точная нагрузка сильно зависит от количества и качества написанных ресурсов — плохо оптимизированный JS-скрипт с интервалами на каждый тик легко положит и топовое железо, так что цифры в таблице — именно ориентир, а не гарантия.

На VPS понадобится Linux (Ubuntu 22.04/24.04 подойдёт без проблем) — Windows-сборка тоже существует, но для продакшена почти все выбирают Linux ради стабильности и меньшего расхода ресурсов. Перед установкой обновите систему и поставьте базовые утилиты:

apt update && apt upgrade -y
apt install -y curl unzip screen

Скачивание серверного билда через официальный updater

Здесь и кроется главная грабля новичков: сервер alt:V не публикуется в Steam и не ставится через SteamCMD. Официальный способ получить бинарник — updater с сайта docs.altv.mp. На странице документации в разделе, посвящённом установке сервера, есть генератор команд: вы выбираете операционную систему, ветку (release — для продакшена, rc/dev — если нужны свежие фичи, но с риском багов) и нужные вам игровые модули (js-module, csharp-module или оба сразу), а сайт собирает готовую команду для копирования в терминал.

Общая логика установки такая:

mkdir -p ~/altv-server && cd ~/altv-server
# сюда вставляете команду, сгенерированную на docs.altv.mp
# под вашу связку ОС + модули + ветка

После выполнения команды updater скачает altv-server (исполняемый файл под Linux), нужные .so-библиотеки модулей и базовые файлы конфигурации. Обязательно выставьте права на исполнение:

chmod +x altv-server

Важно: конкретные имена файлов модулей и структура команды могут немного меняться от версии к версии alt:V, поэтому не переписывайте команду вручную по памяти или со старых форумных постов — берите её заново с официального генератора перед каждой установкой, это займёт 30 секунд и убережёт от несовместимости версий.

Настройка server.toml

Конфигурация сервера хранится в файле server.toml в корне папки сервера. Базовый пример для старта:

name = 'My alt:V Server'
host = '0.0.0.0'
port = 7788
players = 128
password = ''
announce = true
gamemode = 'Freeroam'
website = 'https://example.com'
language = 'ru'
description = 'Тестовый сервер alt:V'

modules = ['js-module']
resources = ['gamemode']

Ключевые поля:

• port — игровой порт, по умолчанию 7788 (TCP и UDP);
• players — максимум слотов;
• password — если оставить пустым, сервер публичный без пароля;
• announce — публиковать ли сервер в мастер-листе alt:V (чтобы его находили через клиент);
• modules — какие игровые модули грузит ядро (об этом ниже);
• resources — список папок-ресурсов из директории resources/, которые сервер подгружает при старте, в порядке, который вы укажете.

Точный набор доступных полей может отличаться в зависимости от версии сервера — сверяйтесь с актуальным server.toml, который создаёт updater при установке: он уже содержит закомментированные примеры под вашу сборку, и проще редактировать его, чем писать конфиг с нуля.

Выбор игрового модуля: js-module или csharp-module

Модуль — это то, на каком языке вы будете писать игровую логику (гейммоды, ресурсы). alt:V поддерживает несколько модулей одновременно, если это нужно вашему проекту:

• js-module — JavaScript/TypeScript. Самый популярный выбор: низкий порог входа, много переиспользуемых паттернов из веб-разработки, TypeScript даёт типизацию и меньше рантайм-ошибок на больших проектах.
• csharp-module — C# на .NET. Подойдёт, если у вас уже есть опыт в .NET или команда бэкенд-разработчиков — строгая типизация и производительность компилируемого кода дают преимущество на тяжёлой логике (сложная экономика, античит, большие карты активностей).

Для конкретного ресурса модуль указывается в файле resource.toml внутри папки этого ресурса — например, type = 'js' или type = 'cshrp'. Это значит, что даже в рамках одного сервера можно держать часть ресурсов на JS, а часть на C#, если так удобнее разработчикам. Для старта, если не уверены, берите js-module — материалов и готовых примеров под него в комьюнити заметно больше.

Запуск, проброс портов и автозапуск

Первый запуск делайте вручную, чтобы сразу увидеть ошибки в конфиге или ресурсах:

cd ~/altv-server
./altv-server

Если сервер стартовал без ошибок, в консоли появится строка о том, что сервер слушает выбранный порт. Дальше — сеть. Откройте порт 7788 (TCP и UDP) на файрволе VPS:

ufw allow 7788/tcp
ufw allow 7788/udp

Если сервер стоит за NAT (актуально не для аренды VPS, а для домашнего железа) — пробросьте тот же порт на роутере в сторону локального IP машины с сервером. При аренде VPS у хостера обычно достаточно открыть порт в файрволе самой ОС, дополнительный проброс на уровне провайдера не нужен.

Для продакшена нельзя просто держать сервер в открытой SSH-сессии — при разрыве соединения процесс упадёт. Самый надёжный вариант — systemd-юнит:

[Unit]
Description=alt:V Game Server
After=network.target

[Service]
Type=simple
User=altv
WorkingDirectory=/home/altv/altv-server
ExecStart=/home/altv/altv-server/altv-server
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

Сохраните как /etc/systemd/system/altv-server.service, затем:

systemctl daemon-reload
systemctl enable altv-server
systemctl start altv-server
systemctl status altv-server

Идея с юнитом и правами отдельного пользователя (не root) в целом такая же, как при автозапуске серверов на других играх — мы разбирали похожий подход в статьях про Rust и Minecraft, если нужен более пошаговый разбор systemd для новичка. А с точки зрения архитектуры ресурсов и модульного подключения геймплейных аддонов alt:V местами напоминает Garry's Mod — там тоже список активных дополнений задаётся в конфиге и грузится при старте.

Частые вопросы