Права ACE у FiveM: Розбір ідентифікаторів (steam:, license:, xbl:)

Система Access Control Entries (ACE) у FiveM керує правами персоналу, командами модераторів та доступом до ресурсів у файлі server.cfg. Система ідентифікує користувачів через спеціальні префікси, такі як steam:, license:, discord: та xbl:.

Розуміння того, як працює кожен ідентифікатор, допомагає запобігти витоку прав і захищає сервер від зловмисників. Нижче наведено детальний огляд усіх типів ідентифікаторів та приклади їх налаштування.

Що таке ідентифікатори у системі ACE FiveM? #

Ідентифікатор FiveM — це текстовий рядок, який пов'язує певний акаунт або протокол з ігровою сесією гравця на сервері FXServer. Коли гравець підключається, його клієнт надсилає серверу всі доступні ідентифікатори.

Сервер перевіряє ці дані за правилами у файлі server.cfg. Якщо ідентифікатор належить до групи адміністраторів, сервер відкриває гравцеві доступ до відповідних команд.

Як описано в нашому гайдi по Steam Hex для FiveM, кожен сервіс має власний унікальний префікс перед двокрапкою.

Огляд усіх типів ідентифікаторів FiveM #

Сервер FXServer розпізнає сім основних типів ідентифікаторів:

1. `license:` та `license2:` (Rockstar Games) #

Ідентифікатор license: підтверджує наявність гри Grand Theft Auto V в обліковому записі Rockstar Games. Оскільки FiveM неможливо запустити без купленої GTA V, цей код є у кожного користувача. Розробники Cfx.re рекомендують саме його як основний ключ для адміністративних прав.

2. `steam:` (Steam Hex) #

Цей ідентифікатор є шістнадцятковим еквівалентом 64-бітного SteamID. Фреймворки рольової гри (ESX, QBCore) традиційно використовують steam: для збереження персонажів у таблицях MySQL. Щоб дізнатися свій код, скористайтеся конвертером SteamID.

3. `discord:` (ID користувача Discord) #

Ідентифікатор Discord дозволяє серверним скриптам перевіряти, чи є гравець учасником вашого Discord-сервера. Це використовується для автоматичної видачі вайтлиста або прав за ролями в Discord.

Як налаштувати права ACE у `server.cfg` #

Налаштування ACE базується на двох командах: add_principal та add_ace.

• add_principal прив'язує ідентифікатор користувача до певної групи (наприклад, group.admin чи group.moderator).
• add_ace дозволяє або забороняє виконання окремих дій для цієї групи.

Приклад налаштування для робочого файлу server.cfg:

# ===================================================
# Конфігурація прав ACE у FiveM (server.cfg)
# ===================================================

# 1. Прив'язка ідентифікаторів гравців до груп
# Варіант A: Через ліцензію Rockstar (Найбезпечніший спосіб)
add_principal identifier.license:1234567890abcdef1234567890abcdef12345678 group.admin

# Варіант B: Через Steam Hex ID
add_principal identifier.steam:1100001000056ba group.admin

# Варіант C: Через обліковий запис Discord
add_principal identifier.discord:198273645123456789 group.moderator

# 2. Успадкування прав між групами
# Група admin отримує всі права групи moderator
add_principal group.admin group.moderator

# 3. Призначення прав групам
# Дозволити модераторам команди кіку та бану
add_ace group.moderator command.kick allow
add_ace group.moderator command.ban allow

# Дозволити адміністраторам усі команди сервера
add_ace group.admin command allow

# Заборонити зупинку сервера через чат
add_ace group.admin command.quit deny

Чому варто використовувати `license:` замість `steam:` для безпеки? #

Команда Cfx.re радить надавати права адміна через license: з двох причин:

1. Стабільність підключення: Якщо на сервері не вимагається обов'язковий запуск Steam, адміністратор може зайти у гру без нього. У такому разі права, видані тільки на steam:, не активуються.
2. Захист від підміни: Змінити акаунт Steam на комп'ютері простіше, ніж переприв'язати ліцензію Rockstar Games.

Якщо ж на сервері працює база даних MySQL для інвентарю та персонажів, ідентифікатор steam: залишається важливим. Про роботу з базою читайте в інструкції як додати гравця у вайтлист FiveM.

Типові помилки під час налаштування ACE #

• Пропуск ключового слова identifier.: Рядок add_principal steam:1100001... group.admin не спрацює. Необхідно обов'язково писати префікс identifier. перед назвою служби (identifier.steam:).
• Помилковий порядок успадкування: Команда add_principal group.admin group.moderator означає, що адміністратори отримують можливості модераторів. Якщо написати навпаки, модератори отримають повний доступ адміністраторів.
• Пробіли у значеннях: Не ставте пробіли біля двокрапки (identifier.steam: 1100001... є помилкою).
• Великі літери: Завжди пишіть шістнадцятковий код малими літерами.

Часті запитання #

У чому різниця між ідентифікаторами steam: та license: у FiveM? #

Ідентифікатор steam: формується зі SteamID64 і вимагає запущеного клієнта Steam. Ідентифікатор license: прив'язаний до вашої копії GTA V у Rockstar Games і передається завжди під час входу.

Як дізнатися ідентифікатори підключеного гравця у FiveM? #

Введіть команду status у консолі сервера або перегляньте вкладку гравця в панелі txAdmin. FiveM відображає всі активні ідентифікатори, включаючи license, steam, discord та IP.

Чи можуть гравці підробити свій ідентифікатор steam: у FiveM? #

Ні. Сервер FXServer перевіряє квитки Steam через офіційний Steam Web API під час авторизації гравця. Підробити Steam Hex неможливо.

Який ідентифікатор найкраще підходить для прав адміністратора у FiveM? #

Команда розробників Cfx.re рекомендує використовувати license: або license2: для безпеки, оскільки ліцензія Rockstar Games завжди прив'язана до клієнта.

Потрібно отримати Steam Hex гравця для внесення у server.cfg? Скористайтеся нашим швидким Конвертером SteamID, щоб перевірити профіль за кілька секунд.

Останнє оновлення: жовтень 2026 р.