FiveM 在 server.cfg 中利用 Access Control Entries（ACE）系统管理管理员指令、管理团队权限以及模块资源调用。该系统通过特定前缀（如 steam:、license:、discord: 和 xbl:）来区分和识别玩家身份。
清楚掌握每种标识符的机制能够有效规避权限漏洞，提升服务器安全性。以下是 FiveM 标识符的详细说明与配置示例。
什么是 FiveM ACE 权限系统中的玩家标识符？ #
FiveM 标识符是用于将特定外部平台账户或通信协议与 FXServer 内玩家槽位绑定的文本字符串。当玩家进入服务器时，客户端会向服务端发送所有检测到的标识符。
服务端将这些传入的信息与 server.cfg 中的规则进行比对。如果玩家标识符被列入管理员权限组，服务器便会赋予其相应的操作指令。
如我们在 FiveM Steam Hex 完整指南 中所介绍，每个平台都拥有通过冒号分隔的独立命名空间。
FiveM 标识符类型总览 #
FXServer 支持识别以下七种主要的标识符命名空间：
| 标识符 | 格式 / 来源 | 推荐用途 |
|---|---|---|
license: |
Rockstar Games Social Club 的 40 位十六进制码 | ACE 核心管理权限与全服封禁首选 |
license2: |
Rockstar Games 的现代 SHA-256 哈希格式 | 新版本 FXServer 的备用标识符 |
steam: |
15 或 16 位 Steam Hex 识别码 | 角色扮演数据库主键（ESX、QBCore、oxmysql） |
discord: |
Discord 数字用户 ID（Snowflake） | 社区身份与游戏内 VIP 角色自动同步 |
xbl: |
Xbox Live 数字服务标识符 | 跨平台识别绑定 |
live: |
微软 Live 身份认证 | 旧版微软账号关联 |
ip: |
公网 IP 地址 | 应急临时拦截（不建议作为白名单凭据） |
1. `license:` 与 `license2:`（Rockstar Games） #
代表用户在 Rockstar Games 名下的正版 GTA V 授权。由于运行 FiveM 必须以正版游戏为基础，因此每位玩家都具备该标识。Cfx.re 官方建议将其作为管理团队指令的授权基准。
2. `steam:`（Steam Hex） #
即玩家 64 位 SteamID 的十六进制表现形式。传统 RP 框架（如 ESX 与 QBCore）在 MySQL 数据库中通常使用 steam: 作为角色档案的存储主键。如需转换，可使用我们的 SteamID 解析工具。
3. `discord:`（Discord 用户 ID） #
允许服务器插件检测玩家是否加入了指定的 Discord 社区，以便自动下发白名单或特权。
如何在 `server.cfg` 中配置 ACE 权限 #
配置 ACE 权限主要依赖两条核心命令：add_principal 与 add_ace。
add_principal将某个玩家标识符映射到某个权限组（例如group.admin）。add_ace为该权限组授予或拒绝具体的指令权限。
实战配置范例：
# ===================================================
# FiveM ACE 权限配置示例 (server.cfg)
# ===================================================
# 1. 玩家标识符与权限组绑定
# 方案 A：使用 Rockstar 许可证绑定（官方推荐安全方案）
add_principal identifier.license:1234567890abcdef1234567890abcdef12345678 group.admin
# 方案 B：使用 Steam Hex 绑定
add_principal identifier.steam:1100001000056ba group.admin
# 方案 C：使用 Discord 用户 ID 绑定
add_principal identifier.discord:198273645123456789 group.moderator
# 2. 权限继承设置
# admin 组自动继承 moderator 组的所有权限
add_principal group.admin group.moderator
# 3. 授予具体权限节点
# 允许 moderator 执行踢出与封禁指令
add_ace group.moderator command.kick allow
add_ace group.moderator command.ban allow
# 允许 admin 执行所有控制台指令
add_ace group.admin command allow
# 禁止在游戏聊天窗口执行关闭服务器指令
add_ace group.admin command.quit deny为何管理员权限更推荐 `license:` 而非 `steam:`？ #
Cfx.re 推荐将重要管理员权限绑定到 license:，原因有二：
- 登录稳定性： 若管理人员在 Steam 客户端未打开时进入游戏，绑定在
steam:上的权限在当次游戏中将无法生效。 - 账号切换成本： 在同一台电脑上切换 Steam 账号相对简单，而更换 Rockstar 游戏许可证的门槛更高。
但在 MySQL 数据库存储角色背包及房产时，steam: 依旧不可或缺。详情可参考 FiveM 通过 Steam Hex 添加白名单教程。
编写 ACE 规则时的常见错误 #
- 遗漏
identifier.关键字： 直接输入add_principal steam:1100001... group.admin将无法生效，必须完整书写identifier.steam:。 - 继承关系颠倒：
add_principal group.admin group.moderator表示管理员继承巡查员的权限。若写反，巡查员将直接获得所有管理权限。 - 冒号周围存在多余空格： 标识符内切勿包含任何空格。
- 十六进制字母使用大写： 请始终统一使用小写字符以保证插件兼容性。
常见问题 #
FiveM 中 steam: 与 license: 标识符有何区别？ #
steam: 标识符根据 SteamID64 换算生成，要求 Steam 客户端正在运行；license: 标识符绑定 Rockstar Games 游戏本体，每次连接 FiveM 时均会自动传输。
如何查看已连接玩家的 FiveM 标识符？ #
在服务器控制台中输入 status 命令，或在 txAdmin 管理面板中查看玩家详情，系统会列出 license、steam、discord 及 IP 等所有有效标识符。
玩家能否在 FiveM 中伪造 steam: 标识符？ #
不能。FXServer 在握手认证阶段会通过 Valve 官方的 Steam Web API 校验登录凭据，无法伪造 Steam Hex。
在 FiveM 中分配管理员权限使用哪个标识符最合适？ #
Cfx.re 官方建议使用 license: 或 license2: 分配高权限，因为 Rockstar 许可证牢固绑定于本地游戏安装，无法随意剥离。
需要将玩家账户转换为可用于 server.cfg 的 Steam Hex？使用免费的 SteamID 转换器 即刻获取。
最后更新：2026年10月