2.jpg)
Това ръководство покрива всичко, което ви е необходимо, за да накарате вашия alt:V сървър да работи в Legion Hosting, от първоначалното стартиране и конфигурация на server.toml до gamemode ресурси, CDN настройка, voice chat и как играчите се свързват чрез alt:V launcher. За разработване на ресурси, настройка на база данни и управление на админи, вижте alt:V настройка на админи и ресурси.
Какво е alt:V?
alt:V е безплатна, open-source multiplayer модификация за Grand Theft Auto V. Тя позволява на играчите да се свързват с персонализирани сървъри, изпълняващи уникални gamemodes като roleplay (RP), deathmatch, racing, freeroam и други. Сървърът изпълнява персонализирани ресурси, написани на JavaScript, TypeScript или C#, давайки на собствениците на сървъри пълен контрол над gameplay логиката. Играчите се свързват чрез alt:V launcher, който модифицира GTA V за multiplayer свързаност.
Първо стартиране
Когато за първи път получите вашия alt:V сървър, следвайте тези стъпки, за да го пуснете онлайн:
- Влезте в GPanel и изберете вашия alt:V сървър.
- Навигирайте до раздела Startup и конфигурирайте името на вашия сървър, max players и други startup променливи.
- Отидете в раздела Console и кликнете Start.
- Сървърът ще изтегли файловете на alt:V сървъра при първото стартиране. Това може да отнеме няколко минути.
- След като конзолата покаже, че сървърът слуша и е готов за връзки, вашият сървър е онлайн.
- По подразбиране сървърът стартира без gamemode ресурси. Ще трябва да добавите ресурси, за да създадете gameplay. Вижте alt:V настройка на админи и ресурси за подробности.
GPanel Startup променливи
alt:V излага няколко опции за конфигурация като startup променливи в GPanel. Навигирайте до раздела Startup, за да ги модифицирате. Промените изискват рестарт на сървъра.
| Променлива | По подразбиране | Описание |
|---|---|---|
PASSWORD |
ChangeMe |
Парола за присъединяване към сървъра. Минимум 6 символа. |
SERVER_DESC |
A Pterodactyl Hosted Server |
Описание на сървъра, показвано в alt:V server browser. |
BUILD |
release |
alt:V server branch: release (стабилен), rc (release candidate) или dev (development). |
Конфигурация на сървъра (server.toml)
Основният конфигурационен файл за alt:V сървърите е server.toml, намиращ се в root директорията на сървъра. Можете да редактирате този файл чрез раздела 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 (announce token от alt:V уебсайта, изисква се за листване в браузъра), gamemode (етикет в браузъра като "Roleplay"), modules (script модули: js-module или csharp-module), resources (масив от папки на ресурси за зареждане) и tags (тагове за филтриране в браузъра).
Announce Token
За да се появи вашият сървър в alt:V server browser, ви е необходим announce token от alt:V master server:
- Посетете alt:V уебсайта и влезте или създайте акаунт.
- Навигирайте до секцията за управление на сървъра и генерирайте нов server token.
- Копирайте token и го поставете в полето
tokenвъв вашияserver.toml. - Уверете се, че
announce = trueе в конфигурацията ви. - Рестартирайте сървъра. Сега трябва да се появи в публичния браузър.
server.toml.
Gamemode ресурси
alt:V сървърите се захранват от ресурси — скриптове, които дефинират цялата gameplay логика. Без ресурси сървърът няма персонализирана функционалност. Ресурсите се поставят в директорията 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 файл в своята директория, който дефинира неговия тип, зависимости и script entry points. За подробности относно създаване и управление на ресурси, вижте alt:V настройка на админи и ресурси.
CDN настройка
alt:V използва CDN механизъм, за да обслужва client-side файлове (модели, текстури, скриптове) на свързващите се играчи. Вграденото CDN обслужва файлове директно от сървъра без нужда от допълнителна конфигурация — това е по подразбиране и работи добре за повечето сървъри. За широкомащабни сървъри с много персонализирани assets, можете по избор да конфигурирате външно CDN, като качите client файлове на уеб сървър и зададете CDN URL в конфигурацията на вашия ресурс, намалявайки използването на bandwidth на game сървъра.
Voice Chat
alt:V включва вградена voice chat система, която позволява позиционна (3D) гласова комуникация между играчите. Voice chat е активиран и конфигуриран в server.toml.
Гласова конфигурация
[voice]
bitrate = 64000
externalSecret = ""
externalHost = ""
externalPort = 0bitrate контролира качеството на гласа (64000 е стандартно). Полетата external* конфигурират външен гласов сървър — оставете ги празни/нулеви, за да използвате вградения гласов сървър, което се препоръчва за повечето настройки. Опцията за външен гласов сървър е необходима само за разширени конфигурации, където обработката на глас е прехвърлена на отделна машина.
Как се свързват играчите
Играчите се свързват с alt:V сървърите чрез alt:V launcher, а не директно чрез GTA V.
Чрез Server Browser
- Изтеглете и инсталирайте alt:V launcher от altvmp.com.
- Стартирайте alt:V launcher. Той ще открие и провери инсталацията на GTA V.
- От launcher прегледайте Server Browser.
- Потърсете вашия сървър по име или използвайте филтри (gamemode, tags, player count).
- Кликнете върху вашия сървър и изберете Connect.
- Ако сървърът има парола, играчът ще бъде подканен да я въведе.
- GTA V ще стартира с alt:V multiplayer mod и ще се свърже с вашия сървър.
Чрез Direct Connect
- В alt:V launcher изберете Direct Connect.
- Въведете IP адреса и port на вашия сървър във формат
IP:PORT(напр.192.168.1.1:7788). - Кликнете Connect.
За да намерите IP адреса и port на вашия сървър, вижте Как да намерите IP и port на вашия сървър.
announce = true е във вашия server.toml и че имате валиден announce token. Сървърът може да отнеме минута, за да се регистрира след стартиране. Проверете конзолата за грешки при свързване с master server. Имайте предвид, че вашият port се присвоява произволно, освен ако нямате частен IP – проверете GPanel за правилната стойност.
Max Players и производителност
alt:V сървърите могат да поддържат висок брой играчи, но производителността зависи силно от вашите ресурси и server plan:
- 32–128 играчи: Често срещан диапазон за повечето сървъри. Прости gamemodes работят гладко при по-високи бройки.
- 128–512+ играчи: Възможно за оптимизирани сървъри с ефективни ресурси. Изисква повече CPU и RAM.
- Ефективност на ресурсите: Лошо оптимизирани скриптове са основната причина за проблеми с производителността. Server-side скриптове, които изпълняват тежки операции на всеки tick или поддържат големи структури от данни в паметта, могат да създадат тясно място за сървъра.
- Database заявки: Gamemodes, използващи бази данни (MySQL, MongoDB), трябва да използват async заявки, за да избегнат блокиране на main thread.
Свързани статии
- alt:V настройка на админи и ресурси — Разработване на ресурси, настройка на база данни, админ инструменти и отстраняване на проблеми
- Как да намерите IP и port на вашия сървър
- Как да качвате файлове чрез SFTP
- Ръководство за стартиране на сървър — Общо ръководство за стартиране на всеки game сървър в Legion Hosting
Нуждаете се от повече помощ?
Ако изпитвате проблеми, които не са обхванати в това ръководство, нашият support екип е на разположение да помогне. Отворете ticket на legionhosting.net/submitticket.php с детайлите на вашия сървър и описание на проблема.
