Agency-Admin：面向真实 FiveM 社区的专业管理工具

业余与专业工具之间的差距

大多数 FiveM 管理菜单属于业余水平：提供武器、传送、无碰撞等按钮。Agency-Admin 为那些像真实游戏工作室的管理团队一样严肃对待管理的社区而设计。

带上下文的操作日志

每个管理员操作都会写入一个防篡改日志，包含管理员ID、目标、操作、时间戳和原因。不再有“谁给那个玩家Rhino了？”的谜团。日志可通过管理员UI查询，支持管理员、时间范围和操作类型过滤。这是员工团队真正需要的基本责任制基础设施。

权限等级

三个内置权限等级：moderator（踢出、超时、基本物品检查）、admin（封禁、物品赠送、传送）、senior admin（配置更改、权限管理、数据库管理）。每个等级的操作权限严格限定，moderator无法通过漏洞提升权限。我们在过去两年中与多个大型社区测试了此模型。

封禁管理

封禁支持持续时间、原因、证据链接（截图或视频链接）、申诉状态和审核备注。当被封禁的玩家尝试重新加入时，他们看到的消息包括封禁原因，如果配置了，还会显示申诉链接。透明的管理就是有效的管理。

实时威胁检测。

Agency-Admin 自带可配置的检测层，可标记可疑模式：金钱突然激增、不可能的传送、快速复制物品、异常武器生成。标记会连同完整上下文显示在管理面板中。我们不是反作弊工具，而是检测工具，能将管理员的响应时间从数小时缩短到几分钟。

安装与设置

Agency-Admin requires oxmysql for log persistence. Import admin.sql 进入您的数据库，将资源添加到您的服务器，并添加 ensure agency-admin 到 server.cfg. 初始管理员分配通过 config.lua，将您最高信任的标识列为高级管理员。所有其他权限授予将通过游戏内UI管理。

资源启动时自动检测您的框架。捆绑了QBCore和ESX权限钩子；独立设置实现 Config.IsAdmin(src, level) function 中手动处理。

配置选项

该 config.lua 涵盖权限和检测设置：

• 权限等级，每个等级的名称和功能均可完全重新定义。默认的三级模型是起点，而非强制要求。
• 检测阈值，配置金钱峰值阈值、传送距离限制和触发标志的物品数量速度。
• Discord webhook，所有管理员操作和检测标记可同时转发至 Discord 频道及游戏内日志。
• 封禁申诉网址，被封禁玩家在封禁消息中看到的 URL。
• 日志保留，管理员操作日志保留天数，超过自动清理。默认90天。
• 高级管理员的隐身模式，高级管理员可匿名浏览服务器，且不出现在玩家列表中。

框架兼容性

Agency-Admin 支持 QBCore、ESX 和 standalone 环境。权限层是唯一与框架交互的部分，其余所有功能（UI、日志、封禁系统、检测引擎）均与框架无关。对于自定义框架，只需在 config.lua 中实现四个函数，即可完成兼容适配。

为什么这对角色扮演很重要

服务器健康状况直接关联到管理质量。拥有可见、一致、负责任管理的社区比依赖非正式判断的社区留住玩家时间更长。Agency-Admin 的审计日志是关键的责任机制：当管理决定受到质疑时，日志提供确切的事件背景、时间及授权人。

检测层将管理员团队的姿态从被动转为主动。不再等待玩家举报疑似作弊者，仪表盘提前显示可疑模式，防止造成全服损害。第一小时抓到的钱币复制者造成的损害远小于两天未被发现的复制者。

权限等级系统防范内部风险。新招募的版主拥有与高级管理员相同权限是安全和责任隐患。权限严格限定，即使员工作恶，其影响范围也受限于其等级。

常见问题

我可以添加集成权限系统的自定义管理员命令吗？

是的。使用 exports['agency-admin']:RegisterCommand(name, tier, handler) 注册继承 Agency-Admin 权限检查和自动日志记录的自定义命令。你的命令会显示在管理员 UI 的命令列表中，并以与内置操作相同的方式记录。

封禁系统如何处理VPN/备用账号？

Agency-Admin 会在封禁时记录完整的标识符集合（license、steam、discord、IP）。玩家尝试重新连接时，系统会检查所有标识符，而不只是登录时使用的那个。对于长期存在封禁规避问题的服务器，管理面板还提供标记系统，可识别可疑的标识符模式。

版主在采取行动前可以看到检测标记吗？

标记会显示给所有达到或超过该标记类型最低配置等级的管理员。金钱激增标记对所有管理员可见；默认情况下，无法传送标记仅路由给技术管理员。所有标记查看操作均有日志记录，管理员可以查看同事查看了哪些标记以及采取了何种操作（如果有）。

Agency-Admin 是否与其他管理菜单如 vMenu 或 qb-adminmenu 冲突？

无冲突。Agency-Admin可以与其他菜单共存，它们使用不同的快捷键且不共享状态。一些服务器在过渡期间同时运行Agency-Admin和传统管理菜单，使用Agency-Admin进行日志记录和检测，同时保留资深工作人员熟悉的命令。

需求

• FiveM 服务器（QBCore、ESX 或独立）
• oxmysql
• 拥有有效 Agency-Admin 许可证的 cfx.re 账户
• 可选：Agency-Reports（用于集成玩家举报处理）

围绕工具构建员工文化

世界上最好的管理员工具如果您的员工文化不支持问责制也无济于事。Agency-Admin的审计日志在员工知道其行为被记录并接受此为标准操作程序而非监控的社区中最有价值。

早期确定所有管理员操作都通过日志接口进行。抵制“仅此一次”绕过日志以快速修复的诱惑，日志的价值在于完整性。当需要重建事件时，有缺口的日志几乎和没有日志一样糟糕。

在每周员工审核中使用检测标志，而不仅仅是在出现问题时使用。即使一周内没有显著事件，审查标志也能帮助熟悉正常情况，从而使异常情况一出现就显而易见。

权限等级系统在通过等级晋升时效果最佳。经过三个月清晰记录工作的版主获得管理员权限，拥有上下文和投入，而非立即授予完全访问权限。