Настройка сервера FiveM (server.cfg, ресурсы, права): различия между версиями
Новая статья: настройка сервера FiveM (проверено на Ubuntu 24.04, со снимками экрана) |
Статья исправлена по результатам проверки: образец server.cfg приведён к текущему стандартному набору ресурсов |
||
| Строка 49: | Строка 49: | ||
| <code>sv_enforceSteamAuth true</code> || Пускать только игроков с привязанной учётной записью Steam. Включайте, если ресурсы или права опираются на идентификатор <code>steam:</code>. Прежняя переменная <code>steam_webApiKey</code> с ноября 2026 года не действует | | <code>sv_enforceSteamAuth true</code> || Пускать только игроков с привязанной учётной записью Steam. Включайте, если ресурсы или права опираются на идентификатор <code>steam:</code>. Прежняя переменная <code>steam_webApiKey</code> с ноября 2026 года не действует | ||
|- | |- | ||
| <code> | | <code>set resources_useSystemChat true</code> || Использовать чат, встроенный в сервер | ||
|- | |- | ||
| <code>exec имя.cfg</code> || Выполнить команды из другого файла. Так удобно вынести, например, список ресурсов или права | | <code>exec имя.cfg</code> || Выполнить команды из другого файла. Так удобно вынести, например, список ресурсов или права | ||
|- | |- | ||
| <code>set gamename rdr3</code> || Превращает сервер в сервер RedM — для Red Dead Redemption 2 | | <code>set gamename rdr3</code> || Превращает сервер в сервер RedM — для Red Dead Redemption 2: [[Установка сервера RedM (Red Dead Redemption 2) на Ubuntu 24.04|установка сервера RedM]] | ||
|} | |} | ||
Название, описание и значок сервера задаются на портале portal.cfx.re, в карточке сервера. Строки <code>sv_hostname</code>, <code>sets sv_projectName</code>, <code>sets sv_projectDesc</code> и <code>load_server_icon</code> из старых инструкций | Название, описание, язык, метки, баннер и значок сервера задаются на портале portal.cfx.re, в карточке сервера. Строки <code>sv_hostname</code>, <code>sets sv_projectName</code>, <code>sets sv_projectDesc</code>, <code>sets tags</code>, <code>sets locale</code>, <code>sets banner_detail</code> и <code>load_server_icon</code> из старых инструкций в файле больше не действуют. | ||
Номера версий игры для <code>sv_enforceGameBuild</code>: | Номера версий игры для <code>sv_enforceGameBuild</code>: | ||
| Строка 112: | Строка 110: | ||
|- | |- | ||
| <code>spawnmanager</code> || Появление игрока в мире | | <code>spawnmanager</code> || Появление игрока в мире | ||
|- | |- | ||
| <code>basic-gamemode</code> || Простейший режим игры — свободная игра | | <code>basic-gamemode</code> || Простейший режим игры — свободная игра | ||
|- | |- | ||
| <code>chat</code> || Чат и команда <code>say</code> | | <code>chat</code> || Чат и команда <code>say</code>. Встроен в программу сервера, в папке <code>resources</code> его нет | ||
|- | |- | ||
| <code>hardcap</code> || Не пускает игроков сверх <code>sv_maxclients</code> | | <code>hardcap</code> || Не пускает игроков сверх <code>sv_maxclients</code> | ||
|} | |} | ||
В старых инструкциях в этом списке есть ещё <code>sessionmanager</code> и <code>rconlog</code>. В текущем стандартном наборе этих ресурсов нет, и в официальном образце txAdmin они не упоминаются — строки <code>ensure sessionmanager</code> и <code>ensure rconlog</code> не нужны. | |||
=== Как установить свой ресурс === | === Как установить свой ресурс === | ||
| Строка 165: | Строка 161: | ||
В <code>start</code>, <code>stop</code>, <code>restart</code> и <code>ensure</code> вместо имени ресурса можно указать категорию: <code>restart [cars]</code>. | В <code>start</code>, <code>stop</code>, <code>restart</code> и <code>ensure</code> вместо имени ресурса можно указать категорию: <code>restart [cars]</code>. | ||
Команды <code>status</code> и <code>clientkick</code> по документации относятся к ресурсу <code>rconlog</code>, которого в текущем стандартном наборе нет. Если сервер ответит, что такой команды нет, список игроков и отключение игрока — в панели txAdmin, раздел Players. | |||
== Права администраторов == | == Права администраторов == | ||
Текущая версия от 06:43, 17 ноября 2026
Сервер 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:
- VPS/VDS серверы — для небольших и средних проектов
- Выделенные серверы — для высоконагруженных проектов