Цей посібник охоплює налаштування адміністрування, серверні ресурси, користувацькі карти, керування транспортними засобами та усунення несправностей вашого сервера BeamMP на Legion Hosting. Щодо початкового налаштування сервера, ключів автентифікації та базової конфігурації див. Посібник із налаштування сервера BeamMP.
Налаштування адміністрування
BeamMP не має традиційної системи входу адміністратора або пароля. Натомість адміністративні команди виконуються через консоль сервера або через серверні Lua-плагіни, які перевіряють ідентифікатори гравців.
Команди консолі
Консоль сервера в GPanel надає прямий доступ до вбудованих команд сервера. Вводьте команди безпосередньо в поле введення консолі:
| Команда | Опис |
|---|---|
kick <player_id> <reason> |
Виганяє гравця із сервера з необов'язковим повідомленням про причину. |
ban <player_name> |
Блокує гравця на сервері. Заблоковані гравці не можуть повторно під'єднатися. |
unban <player_name> |
Знімає блокування з гравця, дозволяючи йому повторно під'єднатися. |
list |
Перелічує всіх під'єднаних на цей момент гравців із їхніми ідентифікаторами. |
say <message> |
Надсилає повідомлення в чат для всього сервера з консолі. |
status |
Відображає інформацію про стан сервера, зокрема кількість гравців і час безперервної роботи. |
help |
Перелічує всі доступні команди консолі. |
list, щоб побачити під'єднаних гравців та їхні ідентифікатори. Ці ідентифікатори потрібні для таких команд, як kick.
Структура папки Resources
BeamMP використовує папку Resources для організації серверного вмісту. Ця папка містить два підкаталоги з різними призначеннями:
Resources/
Client/ <-- Client-side mods (maps, vehicles) synced to players
Server/ <-- Server-side Lua plugins (not sent to players)
Клієнтські ресурси
Файли, розміщені в Resources/Client/, автоматично завантажуються гравцями під час під'єднання. Це використовується для:
- Користувацькі карти — .zip-файли модів карт, які потрібні гравцям для завантаження карти сервера.
- Користувацькі транспортні засоби — .zip-файли модів транспортних засобів, які додають нові автомобілі або змінюють наявні.
- Інші клієнтські моди — Будь-який мод BeamNG.drive, який має бути присутній на клієнті.
Resources/Client/, завантажується кожним гравцем, який приєднується. Великі файли або велика кількість модів значно збільшать час під'єднання. Тримайте свої клієнтські ресурси компактними для найкращого досвіду гравців.
Серверні ресурси (Lua-плагіни)
Каталог Resources/Server/ містить серверні Lua-плагіни. Вони виконуються лише на сервері й не надсилаються гравцям. Кожен плагін розміщується у власній підпапці з файлом main.lua:
Resources/
Server/
MyPlugin/
main.lua <-- Plugin entry point
AnotherPlugin/
main.lua
Серверні плагіни можуть:
- Реагувати на події гравців (під'єднання, від'єднання, повідомлення в чаті, появу транспортних засобів).
- Реалізовувати користувацькі команди, що активуються через чат (наприклад,
/tp,/give). - Керувати дозволами та обмеженнями для транспортних засобів.
- Додавати економічні системи, телепортацію або інші користувацькі ігрові функції.
- Реєструвати активність гравців і забезпечувати дотримання правил.
Додавання користувацьких карт
Щоб запустити користувацьку (нестандартну) карту на вашому сервері BeamMP:
- Завантажте мод карти у вигляді
.zip-файлу з джерела модів BeamNG.drive (наприклад, репозиторію модів BeamNG.drive). - Зупиніть свій сервер у GPanel.
- Завантажте
.zip-файл доResources/Client/через вкладку Files або SFTP. Не розпаковуйте архів. - Оновіть змінну запуску
MAP(абоMapуServerConfig.toml) на правильний шлях до користувацької карти. Цей шлях зазвичай має формат/levels/map_name/info.json— перевірте документацію мода щодо точного шляху. - Запустіть сервер.
Map не відповідає фактичному шляху всередині .zip-файлу мода, сервер не зможе завантажити карту. Перевірте документацію мода або огляньте структуру .zip-файлу, щоб знайти правильний шлях /levels/.
Resources/Client/, яких у гравця ще немає. Гравцям не потрібно вручну встановлювати моди карт.
Керування транспортними засобами
Керування транспортними засобами на серверах BeamMP контролюється за допомогою налаштування MaxCars і за бажанням через серверні Lua-плагіни.
Налаштування MaxCars
Налаштування MaxCars у ServerConfig.toml (або змінна запуску MAX_CARS) контролює, скільки транспортних засобів кожен гравець може створити одночасно:
1— Кожен гравець може мати один транспортний засіб за раз (рекомендовано для більших серверів).2–3— Дозволяє гравцям мати кілька транспортних засобів, корисно для менших серверів або зустрічей автолюбителів.- Вищі значення пропорційно збільшують навантаження на сервер.
Користувацькі моди транспортних засобів
Щоб додати користувацькі транспортні засоби на свій сервер:
- Завантажте мод транспортного засобу у вигляді
.zip-файлу. - Розмістіть його в
Resources/Client/. - Перезапустіть сервер. Гравці автоматично завантажать мод транспортного засобу під час під'єднання.
Обмеження транспортних засобів через плагіни
Для детальнішого контролю (наприклад, блокування певних транспортних засобів, обмеження типів транспортних засобів) вам знадобиться серверний Lua-плагін. Ці плагіни можуть перехоплювати події появи транспортних засобів і дозволяти або забороняти їх на основі користувацьких правил. Перевірте форуми BeamMP щодо плагінів керування транспортними засобами.
Встановлення та керування плагінами
Серверні Lua-плагіни розширюють функціональність вашого сервера. Ось як встановлювати ними та керувати:
Встановлення плагіна
- Завантажте файли плагіна (зазвичай папка, що містить
main.luaта, можливо, інші файли). - Зупиніть свій сервер.
- Завантажте папку плагіна до
Resources/Server/через вкладку Files або SFTP. - Переконайтеся, що структура папки правильна:
Resources/Server/PluginName/main.lua. - Запустіть сервер. У консолі з'являться повідомлення під час завантаження плагінів.
Видалення плагіна
- Зупиніть свій сервер.
- Видаліть папку плагіна з
Resources/Server/. - Запустіть сервер.
Усунення несправностей
Помилки ключа автентифікації
- Переконайтеся, що ключ правильно вставлено у змінну запуску
AUTH_KEY— без зайвих пробілів або розривів рядків. - Переконайтеся, що ключ не було відкликано або термін його дії не закінчився на BeamMP Keymaster.
- Кожен ключ можна використовувати лише на одному сервері за раз. Якщо ви використовуєте той самий ключ деінде, він не спрацює.
- Консоль відобразить помилки автентифікації під час запуску, якщо ключ недійсний.
Гравці не можуть під'єднатися
- Переконайтеся, що сервер повністю запущено й показано як онлайн у GPanel.
- Перевірте, що гравець використовує лаунчер BeamMP, а не стандартний лаунчер BeamNG.drive.
- Якщо сервер налаштовано як
Private = true, гравці мають використовувати пряме під'єднання з правильними IP та портом. Див. Як знайти IP та порт вашого сервера. - Переконайтеся, що версія лаунчера BeamMP гравця сумісна з версією сервера. Застарілі лаунчери можуть не під'єднатися.
- Якщо сервер повний (досягнуто
MaxPlayers), додаткові гравці не зможуть приєднатися, доки хтось не вийде.
Проблеми синхронізації модів
- Якщо гравці застрягають на завантаженні або отримують помилки про відсутні моди, переконайтеся, що .zip-файли модів у
Resources/Client/не пошкоджені. - Повторно завантажте файл мода, якщо .zip пошкоджено.
- Дуже великі файли модів можуть спричиняти тайм-аути для гравців із повільними з'єднаннями. Розгляньте можливість видалення непотрібних великих модів.
- Переконайтеся, що .zip-файли модів не вкладені (тобто .zip всередині папки всередині іншого .zip).
Проблеми з продуктивністю за великої кількості гравців/транспортних засобів
- Зменште
MaxCarsдо1на гравця. - Знизьте
MaxPlayers, якщо сервер зазнає постійних затримок. - Перейдіть на простішу карту (Grid Map або Industrial) для кращої продуктивності за великої кількості гравців.
- Видаліть непотрібні клієнтські моди з
Resources/Client/, щоб зменшити час завантаження та використання пам'яті. - Перевірте графіки використання ресурсів у GPanel — якщо CPU або RAM постійно на межі, розгляньте можливість оновлення тарифного плану сервера. Відкрийте тикет у підтримку, щоб обговорити варіанти.
Сервер не відображається у браузері
- Переконайтеся, що
Privateвстановлено наfalseу вашій конфігурації. - Переконайтеся, що ключ автентифікації дійсний і не використовується іншим сервером.
- Зачекайте 1–2 хвилини після запуску, щоб сервер зареєструвався в бекенді BeamMP.
- Перевірте консоль на наявність будь-яких помилок, пов'язаних із під'єднанням до головного сервера.
Пов'язані статті
- Посібник із налаштування сервера BeamMP — Початкове налаштування, ключ автентифікації, конфігурація та інструкції з під'єднання
- Як знайти IP та порт вашого сервера
- Як завантажувати файли через SFTP
- Посібник із запуску сервера — Загальний посібник із запуску будь-якого ігрового сервера на Legion Hosting
Потрібна додаткова допомога?
Якщо ви стикаєтеся з проблемами, не охопленими в цьому посібнику, наша команда підтримки готова допомогти. Відкрийте тикет за адресою legionhosting.net/submitticket.php, вказавши деталі вашого сервера, опис проблеми та будь-які відповідні повідомлення про помилки з консолі GPanel.