Цей посібник охоплює все необхідне для запуску вашого сервера 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 (кандидат на реліз) або 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 = 0Параметр bitrate контролює якість голосу (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 та порт вашого сервера.
announce = true у вашому server.toml і що у вас є дійсний токен оголошення. Серверу може знадобитися хвилина для реєстрації після запуску. Перевірте консоль на наявність помилок підключення до головного сервера. Зауважте, що ваш порт призначається випадково, якщо у вас немає приватного IP — перевірте GPanel для правильного значення.
Максимальна кількість гравців та продуктивність
Сервери alt:V можуть підтримувати велику кількість гравців, але продуктивність значною мірою залежить від ваших ресурсів та тарифного плану сервера:
- 32–128 гравців: Поширений діапазон для більшості серверів. Прості ігрові режими працюють плавно при більшій кількості.
- 128–512+ гравців: Можливо для оптимізованих серверів з ефективними ресурсами. Вимагає більше CPU та RAM.
- Ефективність ресурсів: Погано оптимізовані скрипти є основною причиною проблем з продуктивністю. Серверні скрипти, що виконують важкі операції на кожному тіку або зберігають великі структури даних у пам'яті, можуть створювати вузькі місця на сервері.
- Запити до бази даних: Ігрові режими, що використовують бази даних (MySQL, MongoDB), повинні використовувати асинхронні запити, щоб уникнути блокування основного потоку.
Схожі статті
- Налаштування адміністратора та ресурсів alt:V — Розробка ресурсів, налаштування бази даних, інструменти адміністратора та усунення несправностей
- Як знайти IP та порт вашого сервера
- Як завантажувати файли через SFTP
- Посібник із запуску сервера — Загальний посібник із запуску будь-якого ігрового сервера на Legion Hosting
Потрібна додаткова допомога?
Якщо ви маєте проблеми, не охоплені цим посібником, наша команда підтримки готова допомогти. Відкрийте тікет за адресою legionhosting.net/submitticket.php з деталями вашого сервера та описом проблеми.
