Настройка сервера FiveM (server.cfg, ресурсы, права)

Материал из ARK-HOSTER.RU | Документация хостинга
Версия от 06:43, 17 ноября 2026; Maintenance script (обсуждение | вклад) (Статья исправлена по результатам проверки: образец server.cfg приведён к текущему стандартному набору ресурсов)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Перейти к навигации Перейти к поиску

Сервер FiveM настраивается одним файлом — server.cfg, а всё, что видят игроки (режим игры, машины, карты, работы), подключается ресурсами. В статье — что означает каждая строка файла, как устроены ресурсы, как ими управлять из консоли и как выдать права администратора. Сервер должен быть уже установлен: Установка сервера FiveM (GTA 5) на Ubuntu 24.04. Проверено 17 ноября 2026 года на Ubuntu 24.04.4, сборка сервера 38435.

Где что лежит

Путь Что это
~/FXServer/server-data/server.cfg Файл настроек сервера
~/FXServer/server-data/resources/ Ресурсы
~/FXServer/server-data/cache/ Временные файлы. Можно удалить при остановленном сервере — создадутся заново
~/FXServer/server/txData/ Данные панели txAdmin: администраторы, расписание перезапусков, журналы
~/FXServer/server/alpine, run.sh Программа сервера. Не правьте — заменяется при обновлении

Файл server.cfg

На снимке — рабочий файл без пояснений (пароль базы заменён). Каждая строка — команда: те же команды можно вводить в консоль работающего сервера. Строки, которые начинаются с #, сервер пропускает.

Строка Что делает
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
Адрес и порт сервера. Нужны обе строки. Меняйте только порт; 0.0.0.0 — «все адреса VDS»
ensure имя Запустить ресурс при старте сервера. Порядок строк — это порядок запуска
sv_maxclients 48 Число мест, от 1 до 2048. От 32 мест нужен включённый OneSync. Сколько мест доступно бесплатно, а сколько по подписке, FiveM указывает на странице fivem.net/server-hosting
set onesync on OneSync — синхронизация, при которой сервер сам знает, где находятся игроки и машины. Нужна большинству современных ресурсов. Значение legacy — режим совместимости для старых скриптов, off — выключено
sv_licenseKey ключ Лицензионный ключ с portal.cfx.re. Без него сервер не запускается
sv_scriptHookAllowed 0 Не пускать игроков с Script Hook V — через него работают чит-меню. Оставляйте 0
sv_enforceGameBuild 3407 Версия игры для всех игроков: от неё зависит, какие машины, одежда и здания из обновлений GTA Online доступны на сервере. Каждая версия включает все предыдущие. Меняется только с перезапуском
sv_master1 "" Сделать сервер «частным»: в списке серверов кнопка подключения отключена, войти можно только по адресу
sv_endpointPrivacy true Скрывать IP-адреса игроков в открытых сведениях о сервере
sv_pureLevel 1 Запретить игрокам изменённые файлы игры. 1 — кроме звуков и известных графических модификаций, 2 — любые
sv_enforceSteamAuth true Пускать только игроков с привязанной учётной записью Steam. Включайте, если ресурсы или права опираются на идентификатор steam:. Прежняя переменная steam_webApiKey с ноября 2026 года не действует
set resources_useSystemChat true Использовать чат, встроенный в сервер
exec имя.cfg Выполнить команды из другого файла. Так удобно вынести, например, список ресурсов или права
set gamename rdr3 Превращает сервер в сервер RedM — для Red Dead Redemption 2: установка сервера RedM

Название, описание, язык, метки, баннер и значок сервера задаются на портале portal.cfx.re, в карточке сервера. Строки sv_hostname, sets sv_projectName, sets sv_projectDesc, sets tags, sets locale, sets banner_detail и load_server_icon из старых инструкций в файле больше не действуют.

Номера версий игры для sv_enforceGameBuild:

Номер Обновление GTA Online
2189 Cayo Perico Heist
2372 Los Santos Tuners
2545 The Contract
2699 The Criminal Enterprises
2802 Los Santos Drug Wars
2944 San Andreas Mercenaries
3095 The Chop Shop
3258 Bottom Dollar Bounties
3407 Agents of Sabotage
3570 Money Fronts
3751 A Safehouse in the Hills
3889 The Kortz Center Heist

Изменения в server.cfg вступают в силу после перезапуска сервера — кнопкой в панели txAdmin или командой sudo systemctl restart fivem.

Ресурсы

Ресурс — это папка с файлом fxmanifest.lua, в котором перечислены скрипты и файлы. Ресурсом может быть режим игры, карта, набор машин, чат, меню администратора.

Что видно на снимке:

  • папки в квадратных скобках — [gamemodes], [managers], [system] — это не ресурсы, а категории: сервер заглядывает внутрь них. Вложенность любая, названия произвольные;
  • имя ресурса — имя его папки: mapmanager, basic-gamemode. Оно и пишется после ensure;
  • в fxmanifest.lua — описание ресурса и списки скриптов: client_script выполняется у игрока, server_script — на сервере.

Стандартные ресурсы из образца:

Ресурс Зачем
mapmanager Управляет картами и режимами игры
spawnmanager Появление игрока в мире
basic-gamemode Простейший режим игры — свободная игра
chat Чат и команда say. Встроен в программу сервера, в папке resources его нет
hardcap Не пускает игроков сверх sv_maxclients

В старых инструкциях в этом списке есть ещё sessionmanager и rconlog. В текущем стандартном наборе этих ресурсов нет, и в официальном образце txAdmin они не упоминаются — строки ensure sessionmanager и ensure rconlog не нужны.

Как установить свой ресурс

1. Положите папку ресурса в ~/FXServer/server-data/resources/ — удобнее в свою категорию, например [cars] или [standalone]. Владельцем файлов должен быть пользователь fivem.

2. Допишите в server.cfg строку ensure имя_папки. Можно запустить всю категорию разом: ensure [cars].

3. Перезапустите сервер, либо в консоли выполните refresh и ensure имя_папки.

Ресурсы зависят друг от друга: то, что нужно другим (база данных, основа ролевого набора), ставится в файле выше остальных.

Скачивайте ресурсы у авторов — с GitHub, с форума forum.cfx.re или из их собственных магазинов. Сборки с «утёкшими» платными скриптами часто содержат закладки, которые дают посторонним доступ к серверу.

Команды консоли

Консоль открывается в панели txAdmin (раздел Live Console) или на VDS: sudo -u fivem tmux -L fivem attach -t fivem, выход без остановки — Ctrl+B, затем D.

Команда Что делает
start имя Запустить ресурс
stop имя Остановить ресурс
restart имя Перезапустить запущенный ресурс
ensure имя Перезапустить, а если не запущен — запустить
refresh Перечитать папку resources: сервер увидит новые ресурсы
status Список игроков: номер, имя, идентификатор, пинг
clientkick 12 причина Отключить игрока с номером 12
say текст Сообщение в чат от имени консоли
exec имя.cfg Выполнить команды из файла
quit "причина" Остановить сервер, игроки увидят причину

В start, stop, restart и ensure вместо имени ресурса можно указать категорию: restart [cars].

Команды status и clientkick по документации относятся к ресурсу rconlog, которого в текущем стандартном наборе нет. Если сервер ответит, что такой команды нет, список игроков и отключение игрока — в панели txAdmin, раздел Players.

Права администраторов

Права в FiveM состоят из двух команд:

  • add_ace кому что allow — разрешить (или deny — запретить);
  • add_principal кто группа — включить игрока в группу.
add_ace group.admin command allow
add_ace group.admin command.quit deny
add_principal identifier.fivem:1 group.admin

Первая строка разрешает группе group.admin все команды, вторая запрещает одну — остановку сервера, третья включает в группу игрока. identifier.fivem:1 — заглушка из образца: замените её идентификатором своей учётной записи.

Идентификатор Что это
identifier.fivem:123456 Номер учётной записи Cfx.re
identifier.license:… Лицензия игры (Rockstar). Есть у каждого игрока
identifier.steam:1100001… Steam, в шестнадцатеричном виде. Есть только у тех, кто привязал Steam
identifier.discord:… Номер учётной записи Discord

Свои идентификаторы проще всего увидеть в панели txAdmin: раздел Players, карточка игрока. Проверить право из консоли: test_ace group.admin command.quit.

Панель txAdmin ведёт свой список администраторов — с банами, предупреждениями и журналом действий. Права из server.cfg нужны для команд в игре и для ресурсов, которые проверяют права сами (например, меню администратора).

Что не проверено

Строки образца, структура ресурсов и содержимое файлов проверены на сервере. Сервер без лицензионного ключа не запускает ресурсы, а ключ выдаётся только владельцу учётной записи Cfx.re — поэтому команды консоли и права приведены по официальной документации FiveM и в работе с игроками не проверялись.

Если что-то пошло не так

Что видите Причина и решение
«Couldn't find resource …» Имя в ensure не совпадает с именем папки, либо в папке нет fxmanifest.lua. Часто архив распакован «папка в папке»
Ресурс не виден после копирования Выполните refresh или перезапустите сервер
Ресурс запускается с ошибками Не запущен ресурс, от которого он зависит, — поднимите его строку ensure выше
Игроков не пускает больше 32 Не включён OneSync: set onesync on
Изменения в server.cfg не действуют Сервер не перезапущен, либо txAdmin настроен на другой файл настроек
После обновления игры пропали машины или одежда Проверьте sv_enforceGameBuild: ресурс мог быть рассчитан на более новую версию игры

Для размещения ваших проектов рекомендуем услуги ARK-HOSTER.RU: