В этом руководстве рассматриваются настройка администрирования, серверные ресурсы, пользовательские карты, управление транспортными средствами и устранение неполадок для вашего сервера BeamMP на Legion Hosting. Для первоначальной настройки сервера, ключей аутентификации и базовой конфигурации см. Руководство по настройке сервера BeamMP.

---

Настройка администрирования

В BeamMP нет традиционной системы входа администратора или пароля. Вместо этого команды администратора выполняются через консоль сервера или через серверные Lua-плагины, которые проверяют идентификаторы игроков.

Консольные команды

Консоль сервера в GPanel обеспечивает прямой доступ к встроенным командам сервера. Вводите команды непосредственно в поле ввода консоли:

---

Структура папки 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, который должен присутствовать на клиенте.

Серверные ресурсы (Lua-плагины)

Каталог Resources/Server/ содержит серверные Lua-плагины. Они работают только на сервере и не отправляются игрокам. Каждый плагин находится в собственной подпапке с файлом main.lua:

Resources/
  Server/
    MyPlugin/
      main.lua        <-- Plugin entry point
    AnotherPlugin/
      main.lua

Серверные плагины могут:

• Реагировать на события игроков (вход, выход, сообщения в чате, появление транспортных средств).
• Реализовывать пользовательские команды, запускаемые через чат (например, /tp, /give).
• Управлять разрешениями и лимитами транспортных средств.
• Добавлять экономические системы, телепортацию или другие пользовательские игровые функции.
• Вести журнал активности игроков и обеспечивать соблюдение правил.

---

Добавление пользовательских карт

Чтобы запустить пользовательскую (не стандартную) карту на вашем сервере BeamMP:

1. Скачайте мод карты в виде .zip-файла из источника модов BeamNG.drive (например, из репозитория модов BeamNG.drive).
2. Остановите ваш сервер в GPanel.
3. Загрузите .zip-файл в Resources/Client/ через вкладку Files или по SFTP. Не распаковывайте zip-архив.
4. Обновите переменную запуска MAP (или Map в ServerConfig.toml) на правильный путь карты для пользовательской карты. Этот путь обычно имеет формат /levels/map_name/info.json — проверьте документацию мода для точного пути.
5. Запустите сервер.

---

Управление транспортными средствами

Управление транспортными средствами на серверах BeamMP контролируется через настройку MaxCars и опционально через серверные Lua-плагины.

Настройка MaxCars

Настройка MaxCars в ServerConfig.toml (или переменная запуска MAX_CARS) контролирует, сколько транспортных средств каждый игрок может создать одновременно:

• 1 — Каждый игрок может иметь одно транспортное средство за раз (рекомендуется для крупных серверов).
• 2–3 — Позволяет игрокам иметь пару транспортных средств, полезно для небольших серверов или автовстреч.
• Более высокие значения пропорционально увеличивают нагрузку на сервер.

Пользовательские моды транспортных средств

Чтобы добавить пользовательские транспортные средства на ваш сервер:

1. Скачайте мод транспортного средства в виде .zip-файла.
2. Поместите его в Resources/Client/.
3. Перезапустите сервер. Игроки автоматически загрузят мод транспортного средства при подключении.

Ограничение транспортных средств через плагины

Для более детального контроля (например, бан определённых транспортных средств, ограничение типов транспортных средств) вам понадобится серверный Lua-плагин. Эти плагины могут перехватывать события появления транспортных средств и разрешать или запрещать их на основе пользовательских правил. Проверьте форумы BeamMP на наличие плагинов управления транспортными средствами.

---

Установка и управление плагинами

Серверные Lua-плагины расширяют функциональность вашего сервера. Вот как их устанавливать и управлять ими:

Установка плагина

1. Скачайте файлы плагина (обычно папка, содержащая main.lua и, возможно, другие файлы).
2. Остановите ваш сервер.
3. Загрузите папку плагина в Resources/Server/ через вкладку Files или по SFTP.
4. Убедитесь, что структура папки правильная: Resources/Server/PluginName/main.lua.
5. Запустите сервер. В консоли будут показаны сообщения по мере загрузки плагинов.

Удаление плагина

1. Остановите ваш сервер.
2. Удалите папку плагина из Resources/Server/.
3. Запустите сервер.

---

Устранение неполадок

Ошибки ключа аутентификации

• Убедитесь, что ключ правильно вставлен в переменную запуска 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 — если ЦП или ОЗУ постоянно на пределе, рассмотрите возможность повышения тарифного плана сервера. Откройте тикет в поддержку, чтобы обсудить варианты.

Сервер не отображается в браузере

• Убедитесь, что Private установлено в false в вашей конфигурации.
• Убедитесь, что ключ аутентификации действителен и не используется другим сервером.
• Подождите 1–2 минуты после запуска, чтобы сервер зарегистрировался в бэкенде BeamMP.
• Проверьте консоль на наличие ошибок, связанных с подключением к мастер-серверу.

---

Связанные статьи

• Руководство по настройке сервера BeamMP — Первоначальная настройка, ключ аутентификации, конфигурация и инструкции по подключению
• Как найти IP-адрес и порт вашего сервера
• Как загружать файлы через SFTP
• Руководство по запуску сервера — Общее руководство по запуску любого игрового сервера на Legion Hosting

---

Нужна дополнительная помощь?

Если вы столкнулись с проблемами, не описанными в этом руководстве, наша служба поддержки готова помочь. Откройте тикет на legionhosting.net/submitticket.php с данными вашего сервера, описанием проблемы и любыми соответствующими сообщениями об ошибках из консоли GPanel.