Agency-Reports：真正被使用的 FiveM 管理员举报工具

2026年FiveM报告的现状

大多数服务器仍使用 Discord 工单或游戏内聊天命令处理玩家举报。两者均有缺陷。Discord 无玩家上下文；聊天命令一旦举报玩家断线即丢失所有信息。管理员变成侦探而非裁判。Agency-Reports 是我们在运营服务器时希望拥有的工具。

自动捕获上下文

当玩家提交举报时，我们自动捕获其坐标、附近玩家 ID、装备武器、车辆及最近 60 秒聊天内容。管理员不仅看到指控，还能看到现场情况。这大大缩短调查时间。

智能路由

举报根据类型、优先级和当前在线管理员分配。作弊举报发送给技术管理员，RP纠纷发送给RP管理员，骚扰举报发送给值班管理员。离线举报会排队并在Discord上提醒。再也不用在管理员聊天中问“有人处理吗？”。

处理跟踪

每条举报都有状态：打开、认领、调查中、已解决、关闭。管理员撰写的解决备注永久保留。六个月后同一玩家再次举报，其历史一键可查。这是MMO中专业审核团队的运作方式，FiveM中早该如此。

玩家反馈循环

当举报结案时，举报人会收到简短消息说明处理结果。即使答案是“已审核，无需行动”，玩家也感到被倾听而非被忽视。感受到被倾听的社区更具忠诚度，这是真正优秀管理工具背后的留存机制。

安装与设置

Agency-Reports requires oxmysql for report history persistence. Import reports.sql，将资源文件夹拖入，并添加 ensure agency-reports 到 server.cfg. 在中连接你的Discord webhook。 config.lua 用于离线警报转发。首次启动时，路由规则从配置初始化，无需额外数据库设置。

游戏内举报 UI 由玩家通过可配置快捷键（默认：F9 或聊天命令）打开。管理员仪表盘是仅限拥有管理员权限标志的玩家访问的独立面板。

配置选项

该 config.lua 控制路由、保留和 UI 行为：

• 举报类别，定义任意数量的类别（作弊、骚扰、RP争议、错误报告等）及每类别的路由规则。
• 员工路线规划，每个类别路由到特定权限等级。作弊报告给技术管理员，RP争议给RP版主等。
• 自动捕获列表，自动捕获哪些上下文字段（坐标、附近玩家、最近60秒聊天、车辆、武器）。可逐字段切换。
• Discord webhook，离线报告转发的 URL。无在线管理员匹配路由的报告将发送至 Discord。
• 处理消息模板，自定义玩家报告关闭时收到的消息。
• 匿名举报，切换举报者是否可以匿名提交（管理员始终可见举报者）。

框架兼容性

Agency-Reports works on QBCore, ESX, and standalone. The only framework-touching component is the permission check for admin dashboard access. For standalone setups, implement Config.IsAdmin(src, level) 在config.lua中。所有报告存储、路由和UI都是框架无关的。

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

每个未解决的玩家举报都是信任赤字。玩家举报后若无回复，要么自行采取行动（加剧局势），要么完全脱离服务器。Agency-Reports通过解决消息系统闭合反馈环，玩家知道举报已被接收和处理，即使结果不尽如人意。

上下文捕获系统是实用的管理倍增器。管理员在事发五分钟后加入场景调查时，拥有完整的情境信息：每个人的位置、说了什么、被告携带了什么。他们花时间做决策，而非重建事件。调查时间的压缩直接提高了管理员团队每小时处理报告的数量。

六个月的历史访问是经常被忽视但能长期保护社区的功能。跨月的报告历史模式识别能捕捉那些缓慢违规的玩家，而非明显违规者，比如每月提交三份报告且被举报三次、总是游走于处罚阈值边缘的中度违规者。历史记录使这种模式可见。

常见问题

玩家可以在举报中附加截图或视频证据吗？

玩家可以附加指向外部证据（Imgur、YouTube、Medal.tv）的URL。出于安全和存储原因，不支持直接上传文件到服务器。Discord关联的举报会在Discord通知中包含证据URL，方便审核。

当举报玩家断线时，举报会怎样处理？

举报会保存在数据库中，无论玩家是否在线。举报时捕获的所有上下文（坐标、聊天等）都会被存储。管理员可以在举报者离开后调查和处理举报，处理结果消息将在玩家下次加入时发送。

能否将Agency-Reports与我们现有的ticket bot集成？

是的，通过Discord webhook转发。如果您的工单机器人从Discord频道读取，指向该频道的webhook，报告将作为Discord消息出现，您的机器人可以处理。为了更紧密的集成，资源会触发服务器端事件。 agency-reports:onNewReport 任何服务器端脚本都可监听。

是否有批量关闭大量举报事件的功能？

是的。管理面板在举报列表中包含多选功能。高级管理员可以选择多个举报，应用单一解决备注，并批量关闭它们。服务器活动后生成关于同一事件的重复举报时非常有用。

需求

• FiveM 服务器（QBCore、ESX 或独立）
• oxmysql
• 拥有有效 Agency-Reports 许可证的 cfx.re 账户
• Discord webhook URL（用于离线警报）

使用 Agency-Reports 进行员工入职

新管理员特别受益于 Agency-Reports 的结构化工作流程。系统引导他们完成调查过程，无需大量培训。首次提交报告的新管理员会自动获得完整上下文，无需询问“发生了什么？”，因为预先捕获的数据在他们输入任何文字前已回答大部分问题。

解决备注要求（可选，但建议通过配置启用）是一种培训工具。写下“已审核录像，玩家明显违反规则3.2，处以24小时禁令”作为解决备注，迫使管理员阐述理由。此阐述随着时间推移提升决策质量，并为升级或申诉创建书面记录。

对于从Discord工单式管理过渡到Agency-Reports的社区，建议并行运行两套系统两到四周。让员工自由选择使用，同时跟踪解决时间和举报者满意度。数据通常显示Agency-Reports解决工单更快；利用这些证据推动自愿采用，而非强制切换。