Цей посібник проведе вас через налаштування вашого сервера FiveM (багатокористувацька гра GTA V), розміщеного на Legion Hosting — від отримання ліцензійного ключа CFX і налаштування TXAdmin до редагування server.cfg та підключення гравців.
Перш ніж почати: Переконайтеся, що у вас є облікові дані для входу в GPanel із привітального листа і що ваш сервер FiveM створено у вашому обліковому записі. Якщо ви ще не запускали сервер, спершу прочитайте Посібник із запуску сервера.
Передумови
- Сервер FiveM від Legion Hosting (активний у вашому обліковому записі)
- Обліковий запис форуму Cfx.re (безкоштовний — потрібен для генерації вашого ліцензійного ключа)
- Доступ до GPanel
- Клієнт FiveM, встановлений на вашому ПК (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.
- Скопіюйте згенерований ліцензійний ключ — він знадобиться вам на наступних кроках.
Тримайте свій ліцензійний ключ у таємниці. Не діліться ним публічно. Якщо ваш ключ скомпрометовано, ви можете відкликати його на сторінці Keymaster та згенерувати новий.
Крок 2: Перший запуск сервера та налаштування TXAdmin
Сервери FiveM, розміщені на Legion Hosting, включають TXAdmin — вебпанель керування, що працює поруч із вашим сервером FiveM. Під час першого запуску TXAdmin проведе вас через початкове налаштування.
Запуск сервера
- Увійдіть до GPanel і виберіть свій сервер FiveM.
- Перейдіть на вкладку Startup та знайдіть змінну FIVEM_LICENSE (або з подібною назвою). Вставте сюди свій ліцензійний ключ CFX та збережіть.
- Перейдіть на вкладку Console та натисніть Start.
- Спостерігайте за виведенням консолі. Під час першого запуску сервер завантажить необхідні артефакти FiveM — це може зайняти кілька хвилин.
- Щойно TXAdmin буде готовий, ви побачите у консолі повідомлення, що містить URL-адресу TXAdmin і PIN-код.
Пошук вашої URL-адреси TXAdmin: TXAdmin працює на окремому порту від ігрового сервера. Перевірте виведення консолі або вкладку Network у GPanel щодо порту TXAdmin. Формат URL-адреси такий:
http://YOUR_SERVER_IP:TXADMIN_PORT.
Завершення налаштування TXAdmin
- Відкрийте URL-адресу TXAdmin у браузері.
- Введіть PIN, відображений у виведенні консолі GPanel.
- Створіть свій обліковий запис адміністратора TXAdmin (ім'я користувача та пароль).
- TXAdmin проведе вас через майстер налаштування:
- Server Name: Виберіть назву, що відображається у браузері серверів FiveM.
- Deployment Type: Виберіть шаблон (наприклад, «Popular Recipes» для попередньо налаштованої основи або «Remote URL / Template», якщо у вас є власне налаштування).
- Server Data Folder: Залиште значення за замовчуванням, якщо у вас немає конкретної причини змінювати його.
- CFX Key: Якщо буде повторний запит, вставте свій ліцензійний ключ.
- Завершіть роботу майстра та дайте TXAdmin завершити розгортання файлів сервера. Це може зайняти кілька хвилин.
Збережіть свої облікові дані TXAdmin. Якщо ви втратите доступ до свого облікового запису адміністратора TXAdmin, вам доведеться видалити профіль 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
Порт має збігатися з GPanel. Порт у
endpoint_add_tcp та endpoint_add_udp має збігатися з ігровим портом, призначеним вашому серверу в GPanel. Перевірте вкладку Network у GPanel щодо вашого конкретного порту.
Крок 4: Підключення до вашого сервера FiveM
Щойно ваш сервер налаштовано та запущено, гравці можуть підключатися за допомогою браузера серверів FiveM або прямого підключення.
Пряме підключення
- Відкрийте клієнт FiveM.
- Натисніть F8, щоб відкрити консоль FiveM, або натисніть кнопку Direct Connect на головному екрані.
- Введіть IP та ігровий порт вашого сервера у форматі
IP:PORT. - Натисніть Connect.
Пошук вашого IP та порту: Перевірте вкладку Network у GPanel або див. Як знайти IP-адресу та порт вашого сервера.
Браузер серверів
- Відкрийте клієнт FiveM та натисніть Play.
- У браузері серверів знайдіть назву свого сервера (значення
sv_hostnameіз server.cfg). - Натисніть на свій сервер, а потім натисніть Connect.
Сервер не відображається у браузері? Поява нових серверів у списку серверів FiveM після запуску може зайняти 5–15 хвилин. Тим часом використовуйте пряме підключення. Також перевірте, що ваш
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 з цією інформацією. Наша команда допоможе вам якомога швидше.
