Настройка server.cfg в FiveM: ресурсы, OneSync и права

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

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

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

# Сетевые настройки
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# Лицензионный ключ (обязателен для запуска)
sv_licenseKey "ваш_ключ_с_portal.cfx.re"

# Название и описание на странице сервера
sv_hostname "^1Мой сервер ^2FiveM"
sv_projectName "Описание проекта"
sv_projectDesc "RP сервер, OneSync включен"

Если sv_licenseKey указан неверно или отсутствует, процесс FXServer завершится сразу после старта с ошибкой в консоли — это первое, что стоит проверять при неудачном запуске.

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

Настройка ресурсов и ensure в server.cfg FiveM

Каждый ресурс — скрипт, карта, библиотека — должен быть явно указан в server.cfg через директиву ensure. Без неё сервер даже не попытается загрузить папку из каталога resources, даже если файл fxmanifest.lua составлен корректно.

Базовый набор ресурсов

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

Типичные ошибки загрузки

• Ресурс указан, но папка называется иначе — проверяйте регистр и точное имя каталога.
• Отсутствует fxmanifest.lua или используется устаревший __resource.lua без fx_version.
• Зависимый ресурс (например, oxmysql) подключён после скрипта, который его требует.

Порядок строк ensure важен для зависимостей: если скрипт обращается к базе данных через oxmysql, строка ensure oxmysql должна стоять выше, чем ensure самого скрипта. Для диагностики используйте консоль FXServer — она показывает точную причину отказа в загрузке ресурса построчно.

# Проверка через консоль
refresh
restart имя_ресурса

Команда refresh пересканирует папку resources без полного перезапуска сервера, что удобно при частых правках во время разработки режима.

OneSync, слоты и лимиты подключений в server.cfg FiveM

OneSync отвечает за синхронизацию мира между игроками за пределами стандартного лимита в 32 слота. Без включённого OneSync сервер FiveM физически не сможет корректно синхронизировать NPC, транспорт и объекты при большом количестве игроков.

set onesync on
sv_maxclients 64

Режим	Макс. игроков	Назначение
off	32	Классическая синхронизация, малые сервера
legacy	до 128	Совместимость со старыми скриптами
on (Infinity)	до 1024	Текущий рекомендуемый режим для RP и больших карт

Значение sv_maxclients должно соответствовать реальным ресурсам CPU и ОЗУ машины: завышенный лимит слотов при слабом железе приводит к падению тикрейта и задержкам (лагам) синхронизации позиций игроков. Процессор с высокой частотой напрямую влияет на стабильность тикрейта при OneSync Infinity, так как логика мира обрабатывается однопоточно для каждого ресурса.

# Дополнительные параметры стабильности
set sv_enforceGameBuild 2802
set gametype "RP"
set mapname "Los Santos"

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

Права администратора и ACE-разрешения в server.cfg FiveM

Система прав в FiveM построена на ACE (Access Control Entries) и принципалах. Вместо жёстко прописанных списков администраторов server.cfg FiveM использует гибкую иерархию групп, которая задаётся через add_ace и add_principal.

# Добавление идентификатора в группу admin
add_ace group.admin command allow
add_ace group.admin command.quit allow
add_principal identifier.steam:110000112345678 group.admin

# Отдельный файл с правами (рекомендуется)
exec permissions.cfg

Вынос прав в отдельный файл permissions.cfg упрощает резервное копирование конфигурации и позволяет обновлять список администраторов без риска случайно затронуть остальные директивы server.cfg.

Рекомендации по безопасности RCON

• Используйте длинный уникальный rcon_password, не связанный с паролями от других сервисов.
• Ограничьте rcon_password доступом только через защищённый панель управления, не публикуйте его в публичных чатах команды.
• Регулярно меняйте идентификаторы доступа при смене состава администрации.

rcon_password "сложный_уникальный_пароль"

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

Если конфигурация растёт и требует более тонкого контроля над файлами, логами и перезапуском отдельных ресурсов, удобнее работать через панель с доступом к консоли в реальном времени — это ускоряет диагностику ошибок загрузки по сравнению с правкой файлов вручную через FTP. Полный список поддерживаемых игр и готовых конфигураций можно изучить в разделе Все наши игровые серверы, а практические разборы других настроек — в Блог Fly-Serv.

Грамотно настроенный server.cfg FiveM — это баланс между набором загружаемых ресурсов, режимом OneSync и аккуратно выстроенной системой прав. Проверяйте консоль после каждого изменения, храните резервные копии конфигурации и обновляйте ACE-разрешения по мере роста команды администраторов.

FAQ

Что делать, если сервер FiveM не загружает ресурсы после изменения server.cfg?

Проверьте консоль FXServer на наличие ошибок с точным названием ресурса, убедитесь, что папка в resources называется так же, как в строке ensure, и что fxmanifest.lua содержит корректный fx_version. Используйте команду refresh для пересканирования без полного перезапуска.

Как включить OneSync Infinity и сколько слотов он поддерживает?

Добавьте строку set onesync on в server.cfg и задайте sv_maxclients в соответствии с мощностью машины. OneSync Infinity технически поддерживает до 1024 слотов, но реальный лимит зависит от частоты CPU и сложности установленных ресурсов.

Как настроить ACE-разрешения для админов без прямого доступа к RCON?

Создайте отдельный файл permissions.cfg с директивами add_ace и add_principal, привязанными к Steam или license идентификаторам администраторов, и подключите его через exec permissions.cfg в основном server.cfg. Это позволяет управлять правами без передачи пароля RCON.