В этом руководстве рассматривается всё, что нужно для запуска вашего сервера alt:V на Legion Hosting, от первого запуска и конфигурации server.toml до ресурсов игровых режимов, настройки CDN, голосового чата и того, как игроки подключаются через лаунчер alt:V. Для разработки ресурсов, настройки базы данных и управления администраторами см. Настройка администратора и ресурсов alt:V.
Что такое alt:V?
alt:V — это бесплатная модификация мультиплеера с открытым исходным кодом для Grand Theft Auto V. Она позволяет игрокам подключаться к пользовательским серверам с уникальными игровыми режимами, такими как ролевая игра (RP), deathmatch, гонки, freeroam и другими. Сервер запускает пользовательские ресурсы, написанные на JavaScript, TypeScript или C#, давая владельцам серверов полный контроль над игровой логикой. Игроки подключаются через лаунчер alt:V, который модифицирует GTA V для мультиплеерного подключения.
Первый запуск
Когда вы впервые получаете ваш сервер alt:V, выполните следующие шаги, чтобы вывести его в онлайн:
- Войдите в GPanel и выберите ваш сервер alt:V.
- Перейдите на вкладку Startup и настройте имя сервера, максимальное количество игроков и другие стартовые переменные.
- Перейдите на вкладку Console и нажмите Start.
- При первом запуске сервер загрузит файлы сервера alt:V. Это может занять несколько минут.
- Как только консоль отобразит, что сервер прослушивает и готов к подключениям, ваш сервер находится в онлайне.
- По умолчанию сервер запускается без ресурсов игровых режимов. Вам нужно будет добавить ресурсы для создания игрового процесса. См. Настройка администратора и ресурсов alt:V для подробностей.
Стартовые переменные GPanel
alt:V предоставляет несколько опций конфигурации в виде стартовых переменных в GPanel. Перейдите на вкладку Startup, чтобы изменить их. Изменения требуют перезапуска сервера.
| Переменная | По умолчанию | Описание |
|---|---|---|
PASSWORD |
ChangeMe |
Пароль для входа на сервер. Минимум 6 символов. |
SERVER_DESC |
A Pterodactyl Hosted Server |
Описание сервера, отображаемое в браузере серверов alt:V. |
BUILD |
release |
Ветка сервера alt:V: release (стабильная), rc (release candidate) или dev (разработка). |
Конфигурация сервера (server.toml)
Основной файл конфигурации для серверов alt:V — это server.toml, расположенный в корневом каталоге сервера. Вы можете редактировать этот файл через вкладку Files в GPanel или через SFTP.
Пример server.toml
name = "My alt:V Server"
host = "0.0.0.0"
port = 7788
players = 128
password = ""
announce = true
token = ""
gamemode = "Freeroam"
website = ""
language = "en"
description = "A custom GTA V multiplayer server"
modules = ["js-module"]
resources = ["myresource"]
tags = ["freeroam", "fun"]Ключевые настройки: name (отображаемое имя в браузере), host (оставьте 0.0.0.0), port (должен совпадать с GPanel), players (максимальное количество), password (пусто для публичного), announce (true для появления в браузере), token (токен анонса с сайта alt:V, требуется для листинга в браузере), gamemode (метка в браузере, например «Roleplay»), modules (модули скриптов: js-module или csharp-module), resources (массив папок ресурсов для загрузки) и tags (теги фильтров браузера).
Токен анонса
Чтобы ваш сервер появился в браузере серверов alt:V, вам нужен токен анонса с главного сервера alt:V:
- Посетите сайт alt:V и войдите или создайте аккаунт.
- Перейдите в раздел управления сервером и сгенерируйте новый токен сервера.
- Скопируйте токен и вставьте его в поле
tokenв вашемserver.toml. - Убедитесь, что в вашей конфигурации
announce = true. - Перезапустите сервер. Теперь он должен появиться в публичном браузере.
server.toml.
Ресурсы игровых режимов
Серверы alt:V работают на ресурсах — скриптах, определяющих всю игровую логику. Без ресурсов сервер не имеет пользовательской функциональности. Ресурсы размещаются в каталоге resources/.
Структура ресурса
resources/
myresource/
resource.toml <-- Resource configuration
server/
index.js <-- Server-side script
client/
index.js <-- Client-side script (runs on the player's GTA V)Загрузка ресурсов
Добавьте имена ресурсов в массив resources в server.toml, чтобы загружать их при запуске:
resources = ["chat", "freeroam", "spawn"]Каждый ресурс должен иметь файл resource.toml в своём каталоге, определяющий его тип, зависимости и точки входа скриптов. Для подробностей о создании и управлении ресурсами см. Настройка администратора и ресурсов alt:V.
Настройка CDN
alt:V использует механизм CDN для доставки клиентских файлов (модели, текстуры, скрипты) подключающимся игрокам. Встроенный CDN доставляет файлы напрямую с сервера без необходимости дополнительной настройки — это вариант по умолчанию, который хорошо работает для большинства серверов. Для крупномасштабных серверов с множеством пользовательских ассетов вы можете опционально настроить внешний CDN, загрузив клиентские файлы на веб-сервер и задав URL CDN в конфигурации вашего ресурса, что снижает использование пропускной способности игрового сервера.
Голосовой чат
alt:V включает встроенную систему голосового чата, которая обеспечивает позиционную (3D) голосовую связь между игроками. Голосовой чат включается и настраивается в server.toml.
Конфигурация голосовой связи
[voice]
bitrate = 64000
externalSecret = ""
externalHost = ""
externalPort = 0bitrate управляет качеством голоса (64000 — стандарт). Поля external* настраивают внешний голосовой сервер — оставьте их пустыми/нулевыми, чтобы использовать встроенный голосовой сервер, что рекомендуется для большинства настроек. Опция внешнего голосового сервера нужна только для продвинутых конфигураций, где обработка голоса вынесена на отдельную машину.
Как игроки подключаются
Игроки подключаются к серверам alt:V через лаунчер alt:V, а не напрямую через GTA V.
Через браузер серверов
- Скачайте и установите лаунчер alt:V с altvmp.com.
- Запустите лаунчер alt:V. Он обнаружит и проверит установку GTA V.
- В лаунчере просмотрите браузер серверов.
- Найдите ваш сервер по имени или используйте фильтры (игровой режим, теги, количество игроков).
- Кликните по вашему серверу и выберите Connect.
- Если на сервере установлен пароль, игроку будет предложено его ввести.
- GTA V запустится с мультиплеерным модом alt:V и подключится к вашему серверу.
Через прямое подключение
- В лаунчере alt:V выберите Direct Connect.
- Введите IP-адрес и порт вашего сервера в формате
IP:PORT(например,192.168.1.1:7788). - Нажмите Connect.
Чтобы найти IP-адрес и порт вашего сервера, см. Как найти IP и порт вашего сервера.
server.toml установлено announce = true и что у вас есть действительный токен анонса. Серверу может потребоваться минута для регистрации после запуска. Проверьте консоль на наличие ошибок подключения к главному серверу. Обратите внимание, что ваш порт назначается случайным образом, если у вас нет приватного IP — проверьте GPanel на предмет правильного значения.
Максимальное количество игроков и производительность
Серверы alt:V могут поддерживать большое количество игроков, но производительность сильно зависит от ваших ресурсов и тарифа сервера:
- 32–128 игроков: Распространённый диапазон для большинства серверов. Простые игровые режимы работают плавно при более высоком количестве.
- 128–512+ игроков: Возможно для оптимизированных серверов с эффективными ресурсами. Требует больше CPU и RAM.
- Эффективность ресурсов: Плохо оптимизированные скрипты — основная причина проблем с производительностью. Серверные скрипты, выполняющие тяжёлые операции на каждом тике или хранящие большие структуры данных в памяти, могут создать узкое место для сервера.
- Запросы к базе данных: Игровые режимы, использующие базы данных (MySQL, MongoDB), должны использовать асинхронные запросы, чтобы избежать блокировки основного потока.
Связанные статьи
- Настройка администратора и ресурсов alt:V — Разработка ресурсов, настройка базы данных, инструменты администратора и устранение неполадок
- Как найти IP и порт вашего сервера
- Как загружать файлы через SFTP
- Руководство по запуску сервера — Общее руководство по запуску любого игрового сервера на Legion Hosting
Нужна дополнительная помощь?
Если у вас возникают проблемы, не охваченные в этом руководстве, наша команда поддержки готова помочь. Откройте тикет на legionhosting.net/submitticket.php с данными вашего сервера и описанием проблемы.
