RU

Игровые серверы

Как управлять правами ACE на FiveM

Разберитесь с ACE и принципалами FiveM, создайте группы администрирования в отдельном файле, проверьте каждое право из консоли и устраните ошибки Access denied.

6 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

FXServer контролирует доступ к командам с помощью системы ACE (access control entries, записи управления доступом) и принципалов. Это руководство объясняет, как она принимает решения, как создать ваши группы в отдельном файле, как проверить каждое право и как отозвать доступ.

Предварительные требования

  • Сервер, установленный по руководству Создание сервера FiveM
  • Доступ к txAdmin для работы с Live Console, CFG Editor и списком игроков
  • Идентификатор игрока, которому вы хотите выдать права

Что нужно знать

Правило читается так: такой-то принципал имеет или не имеет право доступа к такому-то объекту.

Понятие Роль Примеры
Принципал Кто получает право group.admin, identifier.license:abc123, resource.es_extended
Объект Что защищено command, command.quit, myserver.garage
ACE Правило allow или deny add_ace group.admin command allow
Наследование Принципал получает права другого add_principal identifier.license:abc123 group.admin

Наиболее распространённые принципалы:

Принципал Обозначает
identifier.license:... Игрока по его лицензии Rockstar. Это самый надёжный идентификатор
identifier.fivem:... Игрока по его учётной записи Cfx.re
identifier.discord:... Игрока по его учётной записи Discord, только если Discord был обнаружен при его подключении
player.1 Игрока с номером 1 в текущей сессии. Этот номер меняется при каждом подключении
group.name Группу, которую вы определяете произвольно
resource.name Ресурс, когда он сам выполняет команду
builtin.everyone Всех

Как принимает решения FXServer

Четырёх правил достаточно, чтобы предсказать результат:

  1. Без правила доступ запрещён. По умолчанию у принципала нет доступа ни к чему.
  2. Право охватывает вложенные объекты. command охватывает command.quit, а myserver.garage охватывает myserver.garage.open.
  3. deny имеет приоритет над allow, независимо от порядка строк.
  4. Игрок проверяется по каждому идентификатору отдельно. Достаточно, чтобы был разрешён один из его идентификаторов, и доступ у него будет.

У четвёртого правила есть важное следствие: deny для identifier.license:abc123 не запрещает доступ, если разрешён identifier.fivem:42 того же игрока. Чтобы отозвать право у игрока, уберите его из группы, а не добавляйте deny.

Шаг 1: определение идентификатора игрока

Игрок должен уже хотя бы раз подключиться к серверу. В txAdmin откройте его карточку из списка игроков, затем вкладку IDs. Там вы найдёте значения вроде license:abc123 или fivem:42.

Для FXServer добавьте префикс identifier.: license:abc123 превращается в identifier.license:abc123.

Шаг 2: создание файла прав

Отдельный файл сохраняет server.cfg читаемым. Найдите папку сервера, имя которой заканчивается на .base. Если появилось несколько папок, нужная указана в Server Data Folder, в Settings, вкладка FXServer:

Терминал
sudo find /home/fivem/txData -maxdepth 1 -type d -name '*.base'

Откройте сессию fivem, сохраните конфигурацию, затем создайте файл:

Терминал
sudo -iu fivem
BASE=/home/fivem/txData/FOLDER_NAME.base
cp "$BASE/server.cfg" "$BASE/server.cfg.before-permissions"
nano "$BASE/permissions.cfg"

Пример с группой модерации и группой администрирования, который нужно адаптировать:

Текст
# Права модераторов
add_ace group.moderator command.clientkick allow
add_ace group.moderator command.say allow

# Администраторы наследуют права модераторов
add_principal group.admin group.moderator

# Права администраторов
add_ace group.admin command allow
add_ace group.admin command.quit deny

# Члены команды
add_principal identifier.license:MODERATOR_LICENSE group.moderator
add_principal identifier.license:ADMIN_LICENSE group.admin

Выйдите из сессии командой exit.

Шаг 3: загрузка файла

В CFG Editor добавьте эту строку рядом с уже имеющимися правами:

Текст
exec permissions.cfg

Путь указывается относительно папки сервера. Сохраните, затем примените файл без перезапуска, введя ту же команду в Live Console. В любом случае он будет перечитан при следующем запуске.

Подключённый игрок получает новые права сразу, без повторного подключения.

Шаг 4: проверка прав

Все эти команды вводятся в Live Console. test_ace отвечает true или false:

Текст
test_ace identifier.license:MODERATOR_LICENSE command.clientkick
test_ace identifier.license:MODERATOR_LICENSE command.quit
test_ace group.admin command.quit

В приведённом выше примере вы должны получить true, false, затем false. Ответ имеет такой вид:

Текст
identifier.license:MODERATOR_LICENSE -> command.clientkick = true

Чтобы вывести всё, что загружено:

Текст
list_principals
list_aces

list_principals выводит потомок <- родитель, а list_aces выводит принципал -> объект = ALLOW или DENY.

Если результат вас удивляет, включите подробное отслеживание, повторите действие, затем отключите его:

Текст
se_debug true
se_debug false

Тогда консоль покажет каждое проверенное правило в строках TEST ACL [...] -> ALLOW или DENY.

Разрешение команды или ресурса

Открыть ограниченную команду для всех игроков:

Текст
add_ace builtin.everyone command.mycommand allow

Разрешить ресурсу запускать команду. Когда ресурс использует ExecuteCommand, право должно быть у него самого. Предоставляйте только необходимую команду:

Текст
add_ace resource.my_resource command.add_principal allow

Защитить функцию вашего собственного скрипта. Создайте произвольный объект, затем проверьте его на стороне сервера с помощью IsPlayerAceAllowed:

Текст
add_ace group.moderator myserver.garage allow
lua
if IsPlayerAceAllowed(source, 'myserver.garage') then
    -- действие, доступное только избранным
end

ACE и фреймворки

Фреймворки опираются на эту систему, но у каждого свой метод. Не удаляйте строки add_ace resource..., добавленные их рецептом: они нужны им для работы.

ESX Legacy

Группа игрока хранится в столбце group таблицы users. При каждом подключении ESX автоматически добавляет игрока в group.<группа_игрока>. Поэтому меняйте группу предусмотренной командой, в Live Console или в игре, пока игрок подключён:

Текст
setgroup 1 admin

Здесь 1 — номер игрока в сессии.

QBCore

QBCore использует уровни god, admin и mod. Для постоянного права поместите лицензию в permissions.cfg:

Текст
add_principal identifier.license:PLAYER_LICENSE qbcore.god

Игровая команда /addpermission 1 god действует на player.1: право теряется, как только игрок отключается.

txAdmin

Учётные записи интерфейса txAdmin не зависят от ACE. Их права управляются в Admins и хранятся в admins.json. Поэтому выдача group.admin игроку не даёт ему доступа к txAdmin, и наоборот.

Отзыв права

Удалите строку из permissions.cfg, иначе право вернётся при следующем запуске. Удаления строки недостаточно для текущего запущенного сервера, так как правила остаются в памяти. Введите также в Live Console:

Текст
remove_principal identifier.license:MODERATOR_LICENSE group.moderator
remove_ace group.moderator command.say allow

Затем проверьте с помощью test_ace. Можно также перезапустить сервер, и тогда он начнёт только с файлов.

Чтобы полностью отменить ваши изменения, удалите строку exec permissions.cfg из CFG Editor, при необходимости верните копию server.cfg.before-permissions, затем перезапустите сервер.

При возникновении проблем

Access denied for command

Сообщение Access denied for command xxx. показывает, у кого нет права, в зависимости от контекста:

  • Команду запустил игрок: проверьте его идентификатор командой test_ace identifier.license:... command.xxx.
  • Оно появляется при запуске ресурса или без действий игрока: права нет у самого ресурса. Добавьте add_ace resource.name command.xxx allow.

В ESX сообщение о add_principal или remove_principal часто означает, что строки add_ace resource.es_extended ... из рецепта были удалены.

No such config file: permissions.cfg

Файла нет в папке сервера, или его имя отличается. Он должен находиться рядом с server.cfg и быть доступным для чтения пользователю fivem. В случае сомнений исправьте владельца:

Терминал
sudo chown fivem:fivem /home/fivem/txData/FOLDER_NAME.base/permissions.cfg

Access type needs to be 'allow' or 'deny'

Строка add_ace или remove_ace написана неверно. Её форма — add_ace принципал объект allow, без других слов.

test_ace отвечает true, но у игрока нет доступа

  • Убедитесь, что это тот же идентификатор, на вкладке IDs его карточки.
  • Не используйте identifier.discord, если Discord не был открыт при его подключении: лучше используйте лицензию.
  • Убедитесь, что команда запускается именно так, как вы себе представляете. Меню или скрипт могут применять собственные проверки в дополнение к ACE.

deny не блокирует игрока

Вероятно, игрок разрешён по другому из своих идентификаторов. Найдите их командой list_principals, затем уберите его из соответствующих групп.

Право исчезло после повторного подключения или перезапуска

Оно было выдано через player.N или введено только в консоли. Добавьте его в permissions.cfg через identifier.license:....

Право, удалённое из файла, всё ещё работает

Уже загруженные правила остаются активными до перезапуска. Используйте remove_ace или remove_principal либо перезапустите сервер.