Това ръководство ви превежда през настройката на вашия FiveM (GTA V мултиплейър) сървър, хостван в Legion Hosting — от получаването на вашия CFX лицензен ключ и конфигурирането на TXAdmin, до редактирането на server.cfg и свързването на играчи.
Предпоставки
- FiveM сървър в Legion Hosting (активен във вашия акаунт)
- Cfx.re форум акаунт (безплатен — необходим за генериране на вашия лицензен ключ)
- Достъп до GPanel
- FiveM клиент, инсталиран на вашия PC (fivem.net)
Стъпка 1: Получаване на вашия CFX лицензен ключ
Всеки FiveM сървър изисква уникален лицензен ключ от Cfx.re (разработчиците на FiveM). Този ключ е безплатен и обвързан с вашия Cfx.re акаунт.
- Отидете на https://keymaster.fivem.net/ и влезте с вашия Cfx.re форум акаунт.
- Щракнете върху New Server (или Register a new server).
- Попълнете детайлите:
- Label: Дружелюбно име за вашия сървър (напр. "My Legion FiveM Server")
- Server IP Address: Въведете IP адреса на вашия сървър от GPanel (вижте Как да намерите IP и порта на вашия сървър)
- Server Type: Изберете подходящия тип (обикновено "Other / Apache / nginx")
- Щракнете върху Generate.
- Копирайте генерирания лицензен ключ — ще ви е необходим в следващите стъпки.
Стъпка 2: Първо стартиране на сървъра и настройка на TXAdmin
FiveM сървърите, хоствани в Legion Hosting, включват TXAdmin — уеб-базиран панел за управление, който работи паралелно с вашия FiveM сървър. При първото стартиране, TXAdmin ще ви насочи през първоначалната настройка.
Стартиране на сървъра
- Влезте в GPanel и изберете вашия FiveM сървър.
- Отидете на раздела Startup и намерете променливата FIVEM_LICENSE (или подобно наречена). Поставете тук вашия CFX лицензен ключ и запазете.
- Отидете на раздела Console и щракнете върху Start.
- Наблюдавайте изхода на конзолата. При първото стартиране сървърът ще изтегли необходимите FiveM артефакти — това може да отнеме няколко минути.
- След като TXAdmin е готов, ще видите съобщение в конзолата, съдържащо URL адреса на TXAdmin и PIN код.
http://YOUR_SERVER_IP:TXADMIN_PORT.
Завършване на настройката на TXAdmin
- Отворете TXAdmin URL в браузъра си.
- Въведете PIN, показан в изхода на конзолата на GPanel.
- Създайте вашия администраторски акаунт за TXAdmin (потребителско име и парола).
- TXAdmin ще ви преведе през съветник за настройка:
- Server Name: Изберете името, показвано в браузъра за сървъри на FiveM.
- Deployment Type: Изберете шаблон (напр. "Popular Recipes" за предварително конфигурирана база или "Remote URL / Template", ако имате персонализирана настройка).
- Server Data Folder: Оставете това на стойността по подразбиране, освен ако нямате конкретна причина да го промените.
- CFX Key: Ако бъдете попитани отново, поставете вашия лицензен ключ.
- Завършете съветника и оставете TXAdmin да приключи разполагането на сървърните файлове. Това може да отнеме няколко минути.
Стъпка 3: Конфигуриране на server.cfg
Файлът server.cfg е основният конфигурационен файл за вашия FiveM сървър. TXAdmin генерира основен такъв по време на настройката, но ще искате да го прегледате и персонализирате.
Достъп до server.cfg
- В GPanel щракнете върху раздела Files.
- Навигирайте до вашата папка с данни на сървъра (обикновено основната директория или папка, създадена от TXAdmin шаблона).
- Щракнете върху
server.cfg, за да го отворите във вградения редактор.
Основни настройки
| Настройка | Описание | Пример |
|---|---|---|
sv_hostname |
Името на сървъра, показвано в браузъра за сървъри на FiveM | "My Legion FiveM Server" |
sv_licenseKey |
Вашият CFX лицензен ключ от Keymaster | "cfxk_xxxxxxxxxxxxxxxxxxxx" |
sv_maxclients |
Максимален брой играчи, разрешени на сървъра | 48 |
endpoint_add_tcp |
TCP адрес за слушане и порт | "0.0.0.0:YOUR_PORT" |
endpoint_add_udp |
UDP адрес за слушане и порт | "0.0.0.0:YOUR_PORT" |
sv_endpointprivacy |
Скрива IP адресите на играчите в списъка със сървъри | true |
sets sv_projectName |
Кратко име на проекта, показвано в детайлите на браузъра за сървъри | "My RP Server" |
sets sv_projectDesc |
Кратко описание, показвано в детайлите на браузъра за сървъри | "A custom roleplay server" |
Минимален пример за server.cfg:
# Server Identity
sv_hostname "My Legion FiveM Server"
sets sv_projectName "My RP Server"
sets sv_projectDesc "A custom roleplay server hosted by Legion Hosting"
# License Key
sv_licenseKey "cfxk_YOUR_KEY_HERE"
# Network — use the port assigned in GPanel
endpoint_add_tcp "0.0.0.0:YOUR_PORT"
endpoint_add_udp "0.0.0.0:YOUR_PORT"
# Player Limit
sv_maxclients 48
# Privacy
sv_endpointprivacy true
# Resources
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure chat
endpoint_add_tcp и endpoint_add_udp трябва да съответства на игровия порт, присвоен на вашия сървър в GPanel. Проверете раздела Network в GPanel за вашия конкретен порт.
Стъпка 4: Свързване с вашия FiveM сървър
След като вашият сървър е конфигуриран и работи, играчите могат да се свържат, използвайки или браузъра за сървъри на FiveM, или директна връзка.
Директна връзка
- Отворете FiveM клиента.
- Натиснете F8, за да отворите конзолата на FiveM, или щракнете върху бутона Direct Connect на началния екран.
- Въведете IP и игровия порт на вашия сървър във формат
IP:PORT. - Щракнете върху Connect.
Браузър за сървъри
- Отворете FiveM клиента и щракнете върху Play.
- В браузъра за сървъри потърсете името на вашия сървър (стойността
sv_hostnameот server.cfg). - Щракнете върху вашия сървър и след това върху Connect.
sv_licenseKey е валиден и портовете в server.cfg съответстват на вашата мрежова конфигурация в GPanel.
Управление на вашия сървър с TXAdmin
След първоначалната настройка, TXAdmin предоставя уеб табло за ежедневно управление на сървъра. Достъп до него на http://YOUR_SERVER_IP:TXADMIN_PORT.
| Функция | Описание |
|---|---|
| Dashboard | Прегледайте статуса на сървъра, броя на играчите и показателите за производителност с един поглед. |
| Players | Вижте онлайн играчите, изритвайте или банирайте играчи, прегледайте историята на играчите. |
| Live Console | Изпълнявайте сървърни команди в реално време, същото като конзолата в играта. |
| Resources | Стартирайте, спирайте и рестартирайте отделни ресурси без рестартиране на целия сървър. |
| Server Log | Прегледайте логовете на действията за одит на действията на играчи и администратори. |
| CFG Editor | Редактирайте server.cfg директно от TXAdmin, без нужда от файловия мениджър на GPanel. |
| Scheduled Restarts | Конфигурирайте автоматични рестартирания на зададени интервали, за да поддържате сървъра свеж. |
Получаване на помощ
Ако сте следвали това ръководство и все още изпитвате проблеми:
- Копирайте всички съобщения за грешки от конзолата на GPanel или лога на TXAdmin.
- Отбележете на коя стъпка сте заседнали и какво вече сте опитали.
- Отворете тикет за поддръжка на https://legionhosting.net/submitticket.php с тази информация. Нашият екип ще ви помогне възможно най-бързо.