Частые проблемы

Данная статья описывает устранение распространённых проблем с сервером FiveM: недоступность txAdmin, ошибки лицензии Cfx.re, проблемы с базой данных, краши при запуске, ошибки подключения игроков, незагружающиеся ресурсы и падение производительности.

С чего начинать диагностику

При любой проблеме сначала проверьте последние строки во вкладке «Console».

Если включён txAdmin, дополнительно проверьте:

• Dashboard;
• Live Console;
• Server Log;
• Resources;
• CFG Editor.

Большинство ошибок FiveM прямо указывают причину: неверный лицензионный ключ, ошибка ресурса, неправильный порт, проблема базы данных или отсутствующий файл конфигурации.

txAdmin не открывается

Если txAdmin не загружается в браузере, проверьте, включён ли он в переменных запуска.

txAdmin включается переменной:

TXADMIN_ENABLE=1

Порт txAdmin задаётся переменной:

TXHOST_TXA_PORT

Адрес txAdmin имеет формат:

http://IP:TXHOST_TXA_PORT

Внимание: используйте http://, а не https://, если SSL отдельно не настраивался.

Что проверить, если txAdmin недоступен

• сервер запущен и имеет статус Running;
• TXADMIN_ENABLE установлен в 1;
• порт TXHOST_TXA_PORT выделен серверу во вкладке «Network»;
• вы используете правильный IP и порт;
• в консоли есть сообщение о запуске txAdmin;
• браузер не кэширует старую страницу;
• попробуйте открыть txAdmin в режиме инкогнито.

txAdmin включён, но сервер запускается не так, как ожидалось

В текущей startup-команде есть важная логика:

$( [ "$TXADMIN_ENABLE" == "1" ] || printf %s '+exec server.cfg' )

Это означает:

• если TXADMIN_ENABLE=1, сервер работает через txAdmin;
• если TXADMIN_ENABLE=0, сервер запускается напрямую через +exec server.cfg.

Если вы редактируете server.cfg, но настройки не применяются, проверьте, не управляет ли конфигурацией txAdmin.

Потерян пароль от txAdmin

Если вы потеряли доступ к аккаунту txAdmin, может потребоваться сброс профиля txAdmin.

Данные txAdmin обычно находятся в каталоге:

txData/

Перед удалением или сбросом данных обязательно сделайте резервную копию каталога txData/.

После сброса профиля перезапустите сервер и заново пройдите мастер настройки txAdmin.

Ошибки лицензии Cfx.re

Лицензия FiveM задаётся переменной запуска:

FIVEM_LICENSE

В server.cfg она соответствует параметру:

set sv_licenseKey "cfxk_xxxxxxxxxxxxxxxxxxxx"

Внимание: если лицензия задаётся и через переменную запуска, и вручную в server.cfg, значения должны совпадать. Лучше менять ключ через FIVEM_LICENSE.

Сервер не запускается

Если сервер падает при запуске, проверьте последние строки консоли.

Частые причины:

• не указан FIVEM_LICENSE;
• лицензия FiveM недействительна;
• ошибка в server.cfg;
• неверный порт в endpoint_add_tcp или endpoint_add_udp;
• сломанный ресурс в resources/;
• отсутствует зависимость ресурса;
• ошибка подключения к базе данных;
• артефакт FiveM скачался или распаковался некорректно.

Проверка server.cfg

Основной файл конфигурации:

server.cfg

Проверьте, что в нём есть корректные endpoint-строки:

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

Порт должен совпадать с игровым портом, выделенным серверу во вкладке «Network».

Также проверьте:

sv_hostname "My FiveM Server"
set sv_licenseKey "cfxk_YOUR_KEY_HERE"
set steam_webApiKey "none"
sv_maxclients 48

Изоляция проблемного ресурса

Если сервер начал падать после установки ресурса, временно отключите подозрительные ресурсы в server.cfg.

Для отключения добавьте # перед строкой ensure:

#ensure suspicious-resource
#ensure another-resource

ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure chat

Если ресурсов много, используйте быстрый метод: отключайте половину ресурсов за раз. Так быстрее найти проблемный ресурс.

Ресурсы не загружаются

Если ресурс не запускается, проверьте его структуру.

Правильно:

resources/my-resource/fxmanifest.lua

Неправильно:

resources/my-resource/my-resource/fxmanifest.lua

Каждый современный ресурс должен иметь файл:

fxmanifest.lua

Старые ресурсы могут использовать:

__resource.lua

Что проверить, если ресурс не запускается

• папка ресурса находится внутри resources/;
• имя папки совпадает со строкой ensure в server.cfg;
• в папке есть fxmanifest.lua или __resource.lua;
• нет двойной вложенности папок;
• установлены все зависимости;
• фреймворк ESX, QBCore или другой базовый ресурс загружается раньше зависимых ресурсов;
• если ресурсу нужна база данных, подключение к базе работает;
• в консоли нет Lua-ошибок или ошибок манифеста.

Ошибки базы данных

Многие сборки FiveM используют базу данных через oxmysql, mysql-async или аналогичный ресурс.

Если база данных не подключается, проверьте строку подключения и порядок загрузки ресурсов.

Настройка oxmysql

Если используется oxmysql, он должен быть установлен в resources/ и запускаться до ресурсов, которые требуют базу данных.

Пример порядка загрузки:

ensure oxmysql
ensure qb-core
ensure my-resource

Если строка подключения содержит специальные символы в пароле, их может потребоваться URL-кодировать.

Пример:

@ → %40
# → %23
% → %25

Внимание: не используйте localhost или 127.0.0.1, если база данных находится на отдельном сервере. Используйте хост, указанный во вкладке «Databases».

Игроки не могут подключиться

Если сервер запущен, но игроки не могут войти, проверьте порт, статус сервера и конфигурацию endpoint.

• сервер имеет статус Running;
• игроки используют игровой порт, а не порт txAdmin;
• порт в endpoint_add_tcp совпадает с портом сервера;
• порт в endpoint_add_udp совпадает с портом сервера;
• sv_maxclients не равен 0;
• MAX_PLAYERS задан корректно;
• если используется пароль сервера, игроки знают пароль;
• у игроков установлен клиент FiveM, а не только GTA V.

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

Новые серверы могут появляться в браузере FiveM не сразу.

Проверьте:

• сервер полностью запущен;
• после запуска прошло несколько минут;
• FIVEM_LICENSE действителен;
• sv_hostname задан корректно;
• порт сервера доступен;
• в консоли нет ошибок Cfx.re;
• сервер можно открыть через прямое подключение.

Для прямого подключения используйте:

connect IP:PORT

Steam Web API Key

Steam Web API Key задаётся переменной:

STEAM_WEBAPIKEY

Если Steam-интеграция не используется, допустимо значение:

none

Если ресурсы требуют Steam-идентификацию, укажите корректный Steam Web API Key.

Настройки не применяются

Проверьте, каким способом запускается сервер.

Если включён txAdmin:

TXADMIN_ENABLE=1

часть настроек может управляться через профиль txAdmin и его конфигурацию.

Если txAdmin отключён:

TXADMIN_ENABLE=0

сервер запускается через:

+exec server.cfg

Также учитывайте, что egg может автоматически подставлять значения в server.cfg из переменных запуска:

FIVEM_LICENSE
STEAM_WEBAPIKEY
MAX_PLAYERS
SERVER_HOSTNAME

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

Если сервер лагает, проверьте нагрузку ресурсов и время тика.

В txAdmin откройте:

• Dashboard;
• Resources;
• Live Console;
• Server Log.

Частые причины лагов:

• плохо оптимизированные ресурсы;
• слишком много одновременно запущенных ресурсов;
• тяжёлые SQL-запросы;
• ошибки в циклах Lua-скриптов;
• слишком большое количество игроков для текущего тарифа;
• переполненные логи из-за повторяющихся ошибок.

Как искать тяжёлый ресурс

1. Откройте txAdmin.
2. Перейдите в раздел Resources.
3. Проверьте ресурсы с высокой нагрузкой.
4. Отключите подозрительный ресурс.
5. Перезапустите сервер.
6. Проверьте, снизилась ли нагрузка.

Если txAdmin отключён, временно отключайте ресурсы через server.cfg и проверяйте результат после перезапуска.

Сервер зависает при запуске

Если запуск зависает на одном месте, проверьте, какой ресурс загружается последним.

Часто проблема находится в последнем ресурсе перед зависанием или в ресурсе, который ожидает подключение к базе данных.

Отключите подозрительный ресурс и перезапустите сервер.

Рекомендуемый порядок диагностики

1. Проверьте последние строки во вкладке «Console».
2. Проверьте FIVEM_LICENSE.
3. Проверьте endpoint-порты в server.cfg.
4. Проверьте, включён или отключён txAdmin.
5. Отключите недавно добавленные ресурсы.
6. Проверьте подключение к базе данных.
7. Проверьте порядок ensure в server.cfg.
8. Проверьте логи txAdmin или серверные логи.

Частые проблемы и решения

Рекомендации

• сначала всегда проверяйте консоль и последние ошибки;
• не используйте порт txAdmin для подключения игроков;
• порт в endpoint_add_tcp и endpoint_add_udp должен совпадать с игровым портом сервера;
• после изменения FIVEM_LICENSE перезапускайте сервер;
• добавляйте новые ресурсы по одному;
• перед изменением сборки создавайте резервную копию;
• если используется база данных, сначала запускайте oxmysql, затем фреймворк и остальные ресурсы;
• при включённом txAdmin проверяйте настройки в профиле txAdmin, а не только в server.cfg.

Файлы, каталоги и параметры, которые стоит проверить при неполадках:

server.cfg
resources/
logs/
txData/
FIVEM_LICENSE
MAX_PLAYERS
SERVER_HOSTNAME
STEAM_WEBAPIKEY
TXADMIN_ENABLE
TXHOST_TXA_PORT
TXHOST_DATA_PATH