Как стать администратором на FiveM: add_ace, add_principal, group.admin

Вы запускаете свой сервер, присоединяетесь к нему, и команды администратора не работают: нет меню, нет /car, фреймворк говорит, что у вас нет прав. Вы владеете сервером, но сервер об этом пока не знает. Вам нужно рассказать ему, кто вы.

FiveM имеет систему разрешений, называемую ACE. Это руководство показывает, как добавить себя в группу администраторов, как найти свой идентификатор и что установить в ESX и QBCore дополнительно.

#Как работает ACE

ACE (Access Control Entries) встроен в FiveM. Важны два момента:

• add_ace дает разрешение группе или игроку, например «группе admin разрешено выполнять любую команду».
• add_principal добавляет игрока или группу в другую группу.

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

#Шаг 1: определите группу администраторов

add_ace group.admin command allow
add_ace group.admin command.quit deny

Первая строка позволяет группе admin выполнять все команды. Вторая отключает одну опасную команду, чтобы администратор не мог остановить сервер с помощью quit. Вы можете добавить больше строк deny для команд, которые вы не хотите давать группе.

#Шаг 2: добавьте себя в группу

add_principal identifier.license:aabbccddeeff00112233445566778899aabbccdd group.admin

Замените длинное значение на свой собственный идентификатор. Вы можете добавить более одного игрока, по одной строке для каждого:

add_principal identifier.license:aabbccddeeff00112233445566778899aabbccdd group.admin
add_principal identifier.fivem:1234567 group.admin
add_principal identifier.discord:123456789012345678 group.admin

Тип идентификатора идет перед двоеточием, и вы можете использовать любой из них. Они все указывают на одного и того же игрока, поэтому одной строки на человека достаточно.

#Шаг 3: найдите свои идентификаторы

Вам нужен ваш идентификатор с точки зрения сервера, поэтому сначала присоединитесь к серверу.

• В txAdmin: откройте страницу Players, нажмите на свое имя и откройте информацию об игроке. Идентификаторы указаны там (license, fivem, discord, steam и другие).
• В консоли сервера: введите status. Она выводит список всех подключенных игроков со своими идентификаторами.

Какой использовать:

• license: привязан к лицензии Rockstar игрока. Присутствует для всех, поэтому это безопасный выбор.
• fivem: привязан к аккаунту Cfx.re. Стабилен, и хорош для сотрудников, которые используют несколько ПК.
• discord: привязан к аккаунту Discord, и присутствует только когда приложение Discord открыто на ПК игрока при подключении. Не полагайтесь на него одного.

Внимание: скопируйте идентификатор со страницы игрока в txAdmin, а не из скриншота, который кто-то вам отправил. Неправильный или старый идентификатор даст права администратора другому человеку или никому.

#Шаг 4: примените это

server.cfg читается при запуске сервера, поэтому перезагрузите сервер. Вы также можете вставить строки в консоль сервера, чтобы применить их без перезагрузки:

add_principal identifier.license:aabbccddeeff00112233445566778899aabbccdd group.admin

После этого переподключитесь к серверу, потому что ваши разрешения проверяются при присоединении.

Чтобы протестировать, выполните команду, требующую прав, или в консоли F8 используйте команду, которая является ограниченной. Если вы можете её использовать, правило работает.

#Администратор в ESX

ACE управляет командами. ESX также имеет свои собственные группы игроков, хранящиеся в столбце group таблицы users в вашей базе данных. Игрок по умолчанию имеет статус user, а администратор имеет статус admin.

Из консоли сервера вы можете установить это командой:

setgroup 1 admin

где 1 — это ID вашего сервера (см. список игроков в txAdmin). Вы также можете отредактировать столбец group напрямую с помощью инструмента базы данных, а затем переподключиться. Некоторые скрипты администратора читают группу ACE, некоторые — группу ESX, поэтому установите обе, если одна из них не работает.

#Администратор в QBCore

QBCore читает свои разрешения из ACE. Стандартный server.cfg в QBCore определяет группы такие как qbcore.god, qbcore.admin и qbcore.mod. Добавьте себя в нужную:

add_principal identifier.license:aabbccddeeff00112233445566778899aabbccdd qbcore.god

Если вы не видите эти строки групп в своем server.cfg, проверьте тот, что идет с qb-core, и скопируйте их. Перезагрузитесь и переподключитесь, затем попробуйте команду администратора.

На QBox разрешения также основаны на ACE. Следуйте примеру в документации qbx_core или её стандартном server.cfg, и используйте ту же форму add_principal со своим идентификатором.

#Если это все еще не работает

• Никакого эффекта: строка находится в server.cfg, который сервер не загружает, или она закомментирована. Проверьте путь в верхней части консоли txAdmin.
• Опечатка в идентификаторе: сравните его посимвольно со страницей игрока в txAdmin.
• Вы не переподключились: разрешения применяются при присоединении.
• Неправильный префикс: это identifier.license: с точкой, а не identifier:license: или license:.
• Фреймворк все еще говорит нет: установите также группу ESX или QBCore, как описано выше.

Для доступа к панели txAdmin это отдельный вход, см. забыли пароль txAdmin.

#Контрольный список