Настройка server.cfg в FiveM: пошаговое руководство

Настройка server.cfg FiveM — первый и самый важный шаг при запуске собственного игрового сервера на платформе Cfx.re: именно в этом файле задаются порт подключения, количество слотов, лицензионный ключ, список ресурсов и режим OneSync. Одна неверная строка способна привести к тому, что процесс FXServer вообще не стартует или падает сразу после подключения первого игрока. Разберём файл по порядку — от базовых команд запуска до тонкой настройки синхронизации игроков.

Структура и порядок загрузки файла server.cfg FiveM

FXServer читает server.cfg построчно, сверху вниз, как обычный скрипт консоли. Это значит, что порядок команд имеет значение: если вы подключаете права администратора через exec permissions.cfg после того, как уже выполнили ensure для ресурса, требующего эти права на старте, ресурс либо не получит нужные ace-разрешения, либо вызовет ошибку инициализации. Базовый шаблон обычно выглядит так:

# endpoint и сеть
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# права доступа
exec permissions.cfg

# системные ресурсы
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure rconlog

# игровые ресурсы
ensure oxmysql
ensure es_extended
ensure esx_menu_default
ensure esx_identity

Файл server.cfg в FiveM не ограничен одним блоком — его можно разбить на несколько файлов и подключать через exec, что удобно для разделения конфигурации по модулям (экономика, работы, транспорт, права доступа). Такой подход упрощает отладку: если сервер падает после загрузки конкретного блока, вы точно знаете, в каком файле искать проблему.

Если вы только разворачиваете окружение Cfx.re и хотите получить уже подготовленный рантайм FXServer вместе с базовым шаблоном конфигурации, проще воспользоваться готовым решением — хостинг FiveM избавляет от ручной сборки артефакта и настройки системных зависимостей на чистой машине, оставляя вам только редактирование server.cfg и ресурсов.

Базовые параметры запуска: порт, слоты и лицензия

Прежде чем переходить к ресурсам, нужно закрыть обязательный минимум параметров server.cfg FiveM, без которых сервер либо не пройдёт проверку лицензии, либо будет недоступен для подключения игроков из клиента FiveM.

Параметр	Назначение
sv_hostname	Название сервера, которое видно в браузере серверов
sv_maxclients	Максимальное число игровых слотов
sv_licenseKey	Лицензионный ключ Cfx.re, привязанный к вашему проекту
rcon_password	Пароль удалённой консоли для администрирования
sets tags	Теги сервера для фильтрации в списке (roleplay, economy, pvp и т.д.)
sets locale	Локализация интерфейса и сообщений сервера

sv_hostname "My Roleplay Server | RU"
sv_maxclients 64
sv_licenseKey "cfxk_XXXXXXXXXXXXXXXXXXXXXXXX"
rcon_password "ChangeThisToAStrongPassword123!"
sets tags "roleplay, economy, drift"
sets locale "ru"
sets sv_projectName "My Roleplay Server"
sets sv_projectDesc "Русскоязычный ролевой сервер"

Лицензионный ключ получают в Keymaster на портале Cfx.re и привязывают к конкретному серверу — без него FXServer откажется стартовать с ошибкой проверки. Пароль rcon_password нельзя оставлять пустым или дефолтным: это открытая дверь для стороннего администрирования консоли, если порт сервера доступен извне. Для защиты от перебора паролей и паразитного трафика на уровне сети стоит рассчитывать на то, что инфраструктура, на которой крутится FXServer, уже фильтрует DDoS-нагрузку до того, как она дойдёт до процесса сервера.

Порядок загрузки ресурсов и команда ensure

Команда ensure в server.cfg FiveM запускает ресурс и перезапускает его, если он уже был запущен раньше. Но сама по себе команда не решает проблему зависимостей — если ресурс esx_extended стартует раньше oxmysql, он не найдёт подключение к базе данных и упадёт с ошибкой в консоли вида Error loading script... Couldn't find resource или dependency failed to start.

Практическое правило: сначала загружаются низкоуровневые зависимости (библиотеки работы с базой данных, фреймворк), затем общие менеджеры (инвентарь, работы, HUD), и только в конце — ресурсы, которые напрямую зависят от предыдущих.

# 1. база данных и ядро фреймворка
ensure oxmysql
ensure es_extended

# 2. общие системы
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_inventoryhud

# 3. игровые скрипты, зависящие от ядра
ensure esx_society
ensure esx_jobs
ensure esx_vehicleshop

Проверить корректность порядка проще всего по логу консоли FXServer: при старте каждый ресурс выводит статус загрузки, и первая ошибка в цепочке обычно указывает на то, какой ресурс нужно поднять выше. Отдельно стоит следить за файлом resources.cfg, если вы его используете вместо прямого перечисления в server.cfg — он должен подключаться через exec resources.cfg до вызова ensure для зависимых скриптов.

Подробное описание всех консольных команд FXServer, включая endpoint, ensure, add_ace и принципы работы ACL, есть в официальной документации Cfx.re Docs.

OneSync и расчёт числа слотов на сервере FiveM

OneSync — это механизм синхронизации сущностей (игроков, транспорта, объектов), без которого сервер FiveM ограничен 32 игроками в классическом режиме GTA Online. Для серверов ролевого плей с десятками и сотнями игроков OneSync обязателен, и именно в server.cfg FiveM он включается одной строкой.

Режим	Макс. игроков	Когда использовать
onesync off (legacy)	до 32	Тестовые окружения, минимальные сборки
onesync on	до 1024 (практически до 128-256)	Ролевые сервера среднего и крупного размера
onesync_population	зависит от карты	Управление плотностью NPC и трафика

set onesync on
set sv_maxclients 128
set onesync_population true
set sv_enforceGameBuild 2802

Чем выше заявленное число слотов, тем сильнее нагрузка на один поток процессора — FXServer, как и большинство игровых серверов, упирается в однопоточную производительность, поэтому частота ядра CPU напрямую влияет на то, сколько игроков сервер выдержит без просадок тика. Загрузка тяжёлых ресурсов (карты, большие фреймворки) также зависит от скорости диска: на NVMe рестарт сервера с десятками ресурсов в server.cfg происходит заметно быстрее, чем на классических накопителях, что критично при частых перезапусках во время отладки конфигурации.

Параметр sv_enforceGameBuild стоит задавать явно, если ресурсы требуют конкретной версии игры — иначе игроки с разными билдами GTA могут получать расхождения синхронизации, особенно заметные при включённом OneSync. Перед массовым запуском обязательно протестируйте конфигурацию на ограниченном числе слотов, постепенно увеличивая sv_maxclients и наблюдая за нагрузкой на тик сервера в консоли.

Готовые конфигурации под разные типы серверов на базе Cfx.re можно посмотреть в разделе Все наши игровые серверы, а для тех, кто администрирует несколько проектов одновременно через панель Pterodactyl, подойдёт изолированное окружение на VPS Pterodactyl, где каждый server.cfg и набор ресурсов хранится отдельно от других серверов.

Заключение

Файл server.cfg определяет, как FXServer загружает ресурсы, проверяет лицензию и распределяет слоты между игроками. Соблюдение порядка команд, корректная настройка OneSync и аккуратный расчёт числа слотов под реальную нагрузку избавляют от большинства ошибок старта и нестабильной работы сервера FiveM на этапе тестирования и после запуска.

FAQ

Почему сервер FiveM не стартует после правки server.cfg?

Чаще всего причина — ошибка в порядке ensure (ресурс стартует раньше своей зависимости) или неверный лицензионный ключ. Проверьте консоль FXServer: первая строка с ошибкой обычно указывает точный ресурс и причину сбоя.

Сколько слотов реально можно задать с включённым OneSync?

Технически sv_maxclients позволяет указать до 1024, но на практике стабильная работа зависит от частоты процессора и сложности ресурсов. Начинайте с 64-128 слотов и увеличивайте значение постепенно, контролируя нагрузку на тик сервера.

Как проверить синтаксис server.cfg перед перезапуском сервера?

Запустите FXServer локально с тем же server.cfg и посмотрите вывод консоли при старте — все синтаксические ошибки и проблемы с ensure появляются до того, как сервер примет первое подключение игрока.