Настройка server.cfg на FiveM: ресурсы, OneSync и порядок загрузки

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

Структура server.cfg FiveM и порядок загрузки ресурсов

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

Базовые директивы

Минимальный рабочий server.cfg FiveM выглядит примерно так:

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

sv_hostname "My FiveM Server"
sv_maxclients 48
sv_licenseKey "cfxk_XXXXXXXXXXXXXXXXXXXXXXXX"

sets tags "roleplay, custom"
sets locale "ru"

sv_scriptHookAllowed 0
rcon_password "СЛОЖНЫЙ_ПАРОЛЬ"

ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap

exec permissions.cfg
ensure es_extended
ensure my-custom-resource

Обратите внимание на порядок: системные ресурсы (mapmanager, sessionmanager) идут первыми, затем permissions.cfg с правами ACE, потом фреймворк, и только после него — пользовательские скрипты. Если поменять местами, ресурсы, зависящие от es_extended или другого фреймворка, будут падать с ошибкой в стиле "attempt to index a nil value".

ensure против start

Директива ensure перезапускает ресурс, если он уже был запущен, и запускает, если нет — это безопасный вариант по умолчанию. start просто запускает ресурс без проверки состояния, что иногда приводит к дублированию событий при hot-reload через RCON.

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

OneSync и его влияние на стабильность сервера

OneSync — это система синхронизации сущностей между клиентами, без которой невозможно превысить лимит в 32 игрока на классическом движке. В server.cfg FiveM режим задаётся одной строкой, но от выбранного значения зависит нагрузка на CPU и корректность работы скриптов транспорта, NPC и объектов.

Режимы OneSync

Значение	Назначение	Максимум игроков
onesync legacy	Устаревший режим, ограниченная синхронизация	до 64
onesync on	Стандартный режим для большинства ролевых серверов	до 1024 (практически до ~200)
onesync beta / infinity	Экспериментальные улучшения синхронизации	зависит от билда

onesync on
sv_maxclients 128
onesync_workaround763185 1
sv_entityLockdown "strict"

sv_entityLockdown в значении strict запрещает клиентам создавать сущности напрямую, снижая риск дюпа объектов и читов через прямой спавн машин. Для серверов с активной модерацией это стандартная практика при работе с OneSync.

Population и synced scenes

Отдельно стоит проверить convar'ы плотности NPC и трафика — они напрямую влияют на нагрузку клиента и на серверный тик:

set ped_density_multiplier 0.6
set vehicle_density_multiplier 0.7
set parked_vehicle_density_multiplier 0.5

На серверах с большим количеством ресурсов, обрабатывающих NPC (охрана, торговцы, ивенты), снижение плотности population в server.cfg FiveM освобождает ресурс тика для скриптовой логики и уменьшает лаги при пиковой нагрузке игроков.

Оптимизация ресурсов: приоритет загрузки, resmon и кеширование

Даже корректный OneSync не спасёт сервер, если ресурсы написаны неоптимально или загружаются в неправильном порядке. Встроенная команда resmon в консоли клиента показывает нагрузку по каждому скрипту в реальном времени — это первый инструмент диагностики перед изменением server.cfg.

Кеширование ресурсов на стороне сервера

Чтобы клиенты не перекачивали ресурсы при каждом обновлении, включите кеш-хранилище:

set sv_enforceGameBuild 2802
set fx_prof 1
setr fivem_scriptcache 1

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

Порядок загрузки тяжёлых ресурсов

• Карты и стриминг-ассеты (custom maps, MLO) — загружаются первыми, до фреймворка.
• Фреймворк и его зависимости (база данных, инвентарь, экономика).
• Ролевые скрипты, зависящие от фреймворка.
• UI и HUD-ресурсы — загружаются последними, чтобы не блокировать инициализацию логики.

Такой порядок в server.cfg снижает количество ошибок при старте и ускоряет полную инициализацию сессии для первого подключившегося игрока.

Если сервер работает через панель Pterodactyl, изменения в server.cfg применяются через файловый менеджер без доступа по SSH — это удобно для быстрых правок ensure-списка без риска повредить остальную конфигурацию. Подробнее о работе с этой панелью можно посмотреть на странице VPS Pterodactyl.

Диагностика ошибок и стабильная эксплуатация

Большинство крашей после правки server.cfg FiveM видно сразу в консоли при старте — ищите строки с Failed to load resource или Couldn't find resource. Это почти всегда указывает на опечатку в имени ресурса или на отсутствие exec-файла с правами доступа.

Типовые ошибки

Сообщение в консоли	Причина
Couldn't find resource X	Ресурс не находится в папке resources или неверно указан путь ensure
Error parsing script @resource/config.lua	Синтаксическая ошибка в Lua/JS-файле ресурса
OneSync is required for more than 32 players	Включён sv_maxclients выше 32 без onesync on

Для отладки удобно временно отключать RCON-пароль по умолчанию и подключаться через защищённый доступ, а также вести журнал изменений server.cfg перед каждым апдейтом ресурсов. Базовые практики безопасности стандартны для любого игрового сервера: сложный rcon_password, whitelist для тестового окружения и регулярные автоматические резервные копии конфигурации и базы данных перед массовыми правками.

# перезапуск сервера после правки server.cfg
systemctl restart fivem
# или через панель — просто перезапуск инстанса

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

Официальную документацию по convar'ам и структуре ресурсов стоит держать под рукой при любой серьёзной правке конфигурации: Source.

Заключение

Грамотный server.cfg — это не разовая настройка, а рабочий документ, который меняется вместе с ростом ресурсов и населения сервера. Проверяйте порядок загрузки, режим OneSync и convar'ы плотности после каждого крупного обновления скриптов, и большинство крашей уйдёт ещё до жалоб игроков.

FAQ

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

Проверьте консоль на строки с ошибкой ensure — чаще всего это опечатка в имени ресурса или нарушенный порядок загрузки, когда зависимый скрипт стартует раньше фреймворка.

Как включить OneSync на существующем сервере без потери прогресса?

Добавьте строку onesync on перед sv_maxclients, увеличьте лимит игроков постепенно и проверьте sv_entityLockdown, чтобы избежать проблем с синхронизацией транспорта после перезапуска.

Что делать, если ресурсы долго загружаются у игроков при подключении?

Включите fivem_scriptcache, проверьте вес стриминг-ассетов в кастомных картах и убедитесь, что тяжёлые MLO загружаются в начале server.cfg, а не вперемешку с логическими скриптами.