Agency-Admin

🔧 优化

• Dashboard：减少了一个磁贴，快速访问栏也更加简洁；服务器控制台现在就在你预期的位置
• Reports：现在报告中的每条回复都由真实的工作人员提供，报告标题也更加整洁
• Announcements：发送按钮现在在所有语言中都有清晰的标签

🗑️ 已移除

• 迷你聊天：已移除仪表板聊天窗口及其自动回复举报的功能。

⚙️ Config

• config.lua 中的聊天区块和 Config.Reports 下的自动回复设置已不再使用，可以删除

📦 更新说明

• 替换资源文件夹；你的等级、封禁记录和已保存的数据都不会受到影响

🔧 改进

• 实时画面： 现在由脚本本身捕获图片；screenshot-basic 仅作为备用方案使用
• Web 面板： 当玩家的游戏中没有画面时，实时画面会对此进行提示，而不是显示黑屏

🐛 已修复

• Live view：修复了被观察玩家的游戏最小化或未渲染时出现黑屏的问题
• Live view：单张图片模式会持续尝试，并在图片恢复后自动继续

📦 更新说明

• 替换 Agency-Admin 文件夹，并保留你的 config.lua
• 玩家下次加入时将加载新的实时视图

✨ 新增

• Anticheat 页面：显示防护状态和服务器检查项的实时负载；检测模式（Learning、Relaxed、Balanced、Strict）可通过开关切换，并显示今日的命中、踢出和封禁记录
• 实时查看所有检测结果；在线玩家按风险排序，并提供 Kick 和 Ban 操作；还可查看所有 Anticheat 封禁及其证据，并执行 Unban
• 每项检测均可通过开关控制，并显示其在当前模式下的规则
• 一键启用 Lockdown；想通过 AgencyMod 连接的 Discord 服务器可直接在页面上确认
• 管理员自动豁免：所有有权访问此面板的人员都可以使用 noclip、godmode、invisibility、spectate 和 spawner，而不会被 Anticheat 标记
• 在“Anticheat”下新增权限 View Anticheat 和 Manage Anticheat；最高等级拥有这两项权限
• 为其他资源提供 Exports：IsStaff(source) 和 HasPermission(source, action)

📦 更新说明

• 替换 Agency-Admin 文件夹，并保留你的 config.lua
• 如果没有 Agency Anticheat，新页面只会说明它新增了什么，其他内容均不变
• Agency Anticheat：https://agencyscripts.dev/en/anticheat

✨ 新功能

• Web 面板： 可通过 companion.agencyg.de/app/admin 访问；无需配置端口、反向代理或 HTTPS。
• 登录： 在管理菜单中选择 Web Panel > 在浏览器中打开，或使用 /webpanel 一键登录。
• 登录： 在另一台 PC 上输入 Web Panel 标签页中的 6 位代码；代码有效期为 5 分钟。
• 离线访问： 曾经进入过游戏的管理员，即使离线也能继续使用面板和 companion app。
• 权限： 离线访问还支持 ACE、QBCore 权限和 ESX 组。
• 多服务器： 在一个面板中连接多个服务器并在它们之间切换。

🔧 改进

• 记忆权限： 游戏期间每两分钟刷新一次，离开时也会刷新；在线但未访问面板超过三分钟后，权限将被移除。
• 权限： 面板权限和等级分配优先。
• 配对设备： 每个连接都是一个配对设备，可在游戏内通过“设置 > Companion”注销。
• 安全性： 每次点击都会根据管理员的等级和权限进行实时检查，并应用游戏内的速率限制和操作日志。
• 旧地址： admin.agencyg.de 将转发至新面板。

📦 更新说明

• 将新文件复制到你的 Agency-Admin 文件夹中；保留 web/images/custom。
• 将 Config.WebPanelHttp 替换为 Config.Companion.WebPanel 和 WebPanelCommand；文件管理器请使用 Config.WebPanelFiles。
• 保持 Config.Companion.EnableRemote 启用，因为登录会使用 Agency relay。
• 可以删除 server/webhttp.lua 和 webpanel 文件夹。
• 可以移除为面板配置的任何 reverse proxy，以及 agency_admin_public_url 和 agency_admin_trust_proxy 配置行。

✨ 新增

• 图片：新增 161 辆载具、58 个 peds、229 个物体和 88 种武器的图片。
• 图片：超级管理员可在游戏中拍摄缺失的图片、重新拍摄单张图片或整个列表，并识别无效的模型名称。
• 品牌设置：在面板中显示服务器名称和 Logo。
• 玩家资料：关联账号显示 Cfx.re 论坛头像，其他账号显示姓名首字母头像。
• 仪表板：管理员可以排列、调整大小、隐藏、显示和重置磁贴；布局按管理员分别保存。
• 全局搜索：Ctrl + K 可搜索玩家、载具、武器、物体和页面，支持分类、匹配项高亮；快捷操作受权限限制。
• 系统性能：通过服务器发布的指标实时显示主线程 tick 时间、运行时长和已启动的资源；端口会自动检测。
• 物体生成器：包含 13 个类别的 229 个 props，并已对照游戏文件进行检查。
• 快捷键：为 duty、noclip、godmode 和其他工具分配专属按键，并由服务器端检查权限。

🔧 改进

• 设计：新增金色点缀、凸起瓷砖、药丸形按钮，以及会跟随页面切换或鼠标移动的侧边栏金色动态高亮。
• 玩家信息：可在小窗口中给予或扣除金钱。
• 安全性：Teleport All 和 Kick All 操作需要确认。
• 设置：在底部显示版本号。
• 物体生成器：为已放置的物体新增渲染距离滑块。
• Noclip：使用鼠标滚轮设置速度。

🐛 已修复

• 搜索：玩家名称无法再注入代码并破坏菜单。
• Dashboard：不再将 CPU 和 RAM 显示为可用指标；FiveM 没有用于获取它们的 native。
• 玩家资料：修复真实头像显示，改用可用的 Cfx.re 图片，而非不可用的头像服务和错误的 Steam 地址。
• Noclip：打开暂停菜单或地图时，摄像头不再旋转，控制也不会失灵。
• Dashboard：不再在每次刷新时保存磁贴顺序，也不会在重新打开面板时多次重建。
• 设计：更改强调色后不再留下超过 100 处金色细节。

⚙️ Config

• Branding：使用 Config.Branding 配置服务器名称和徽标。
• Noclip：使用 Config.Noclip 配置鼠标滚轮速度。
• Hotkeys：使用 Config.Hotkeys 配置工具按键。
• Configuration：config.lua 新增了用于 branding、玩家头像、图片、指标、noclip、hotkeys 和物体生成器的配置块。

📦 更新说明

• 备份现有配置值，安装新的 config.lua，然后重新设置配置值。不要用旧文件覆盖新文件。
• 将 config/objects.lua 中的对象列表替换为更新后的列表。
• 只有在需要拍摄自己的图片时才需要 screenshot-basic。
• 自定义图片保存在 web/images/custom 中；更新时请保留此文件夹。
• 更新后，等级、权限、封禁、已生成的对象和 dashboard 布局都会保留。无需导入。
• manifest 已更改。重启 resource 前运行 refresh，或者重启服务器。
• config.lua、配置列表、翻译和菜单仍可编辑。

✨ 新增

• Agency Companion：使用 /aaconnect 或 /aac 配对工作人员设备，然后扫描 QR code 或输入 6 位数代码。
• Agency Companion：管理玩家、封禁和等级；踢出、封禁、冻结、观察、使用 goto 和 bring、治疗和复活玩家；退出已配对设备的登录。
• Agency Companion：查看实时服务器控制台，并以自己的客户端身份运行命令；扫描到的命令和 framework 命令均支持本地化自动补全。
• Agency Companion：免费 app 可在 iOS 和 Android 上使用。设置指南：companion.agencyg.de。
• Agency Companion：一个 app 即可连接 Agency-Admin、Phone、Pad、Elevator、Reports 等。

• 🔧 改进
• 本地化：新增的应用、配对、控制台和 UI 文本已翻译为全部 13 种支持语言：EN、DE、CS、ES、FR、IT、NL、PL、PT、RO、RU、SV 和 TR。
• 安全性：仅工作人员可以配对。Tokens 不授予任何权限，每项操作都会根据实时权限进行检查，包括 ACE、framework、等级，以及针对在线玩家的逐玩家覆盖设置。
• 安全性：离线权限检查使用标识符和实时等级表；仅使用 ACE 的管理员必须在线。
• 安全性：Companion 请求会在 Companion 层和面板操作通道两处进行检查，并对远程操作进行速率限制。
• 配对：设备保持关联期间，6 位验证码会持续显示，因此可以配对其他手机。

🐛 已修复

• 服务器事件： Give-weapon、spawn-object、edit-object 和 claim-vehicle-ownership 现在需要面板访问权限和对应的操作权限，并由服务器端进行检查。
• 配对： 6 位数代码现在始终显示在 QR 码下方。
• 面板： 优化了配套面板的打开和关闭行为，并进一步完善了 NUI。

⚙️ 配置

• 将 Config.Companion.Enable = false 设置为 false，以禁用可选的 companion 集成。
• 配对码会在 Config.Companion.TokenTTL 指定的时间后过期，默认值为 5 分钟。

📦 更新说明

• 现有等级、权限、封禁和面板设置均保持不变。无需迁移，也不会丢失数据。
• 配对表会在首次启动时自动创建；无需手动修改 SQL。
• 需要 oxmysql（此前也已是必需项）。通过 txAdmin 或运行 ensure Agency-Admin 重启资源。
• 替换以下文件：fxmanifest.lua、config.lua、client/main.lua、client/companion.lua、server/db.lua、server/main.lua、server/companion.lua、server/companion_relay.lua、web/index.html、web/style.css、web/app.js、web/companion.js、web/qrcode.min.js、shared/locale.lua，以及 locales/ 中的所有文件。若保留自己的 config.lua，请检查 Config.Companion 代码块。

✨ 新增

• 执行封禁时会打开一个模态窗口，要求填写不超过 200 个字符的原因。可选时长：Permanent、1h、6h、24h、48h、7d 或 30d。
• 封禁踢出消息会显示原因和限时封禁的到期时间；被封禁玩家列表也会显示到期日期。
• 直接命令使用与面板按钮相同的等级权限，没有权限时将无法使用。
• /agoto [id] 使用 goto_player 传送到玩家身边；/abring [id] 使用 bring_player 将玩家带到你身边。
• /arevive [id] 使用 revive_player 复活玩家；/aheal [id] 使用 heal_player 治疗玩家。
• /aslay [id] 和 /akill [id] 使用 slay_player 杀死玩家；/akill 是别名。
• /aclothing [id] 使用 open_clothing_menu 打开玩家的服装菜单。
• /akick [id] [reason] 使用 kick_player 踢出玩家。
• /aban [id] [reason] 使用 ban_player 永久封禁玩家；/aban [id] 1h/6h/24h/7d/30d [reason] 则创建限时封禁。
• /anoclip 使用 tool_noclip 为自己切换 noclip；/atpm 使用 goto_player 传送到地图上的 waypoint。
• 现在可以按名称生成车辆。

🐛 已修复

• 标签页现在会遵循对 tab_server 和 tab_vehicles 的显式 false 拒绝，即使存在隐含的操作权限也一样。
• 服装、传送及其他操作命令现在会注册，并使用与面板按钮相同的权限检查。
• Open Inventory 现在会先检测 ox_inventory，再检测 qs-inventory，最后将 esx_inventoryhud 作为备用选项。
• 封禁弹窗的遮罩层和元素现在使用 pointer-events: all，允许点击和键盘输入。
• saveBanState 和 loadBanState 现在会将 expires 字段保存到 banned_players.json，使限时封禁能够在重启后自动过期。
• Revive 现在会先清除 QBCore 和 ESX 服务端的死亡状态，再复活客户端。

📦 更新说明

• 将现有的 Agency-Admin 文件夹替换为此版本；无需更改数据库。
• 在 ESX 上，Open Inventory 可自动与 ox_inventory 或 qs-inventory 配合使用，无需更改配置。

✨ 新增

• Agency Admin：将报告模块集成到管理面板中。
• Agency Admin：新增用于管理操作的 Discord webhook，包括封禁、踢出和金钱变更。
• Agency Reports V2：新增返回按钮，可一键将传送过来的玩家送回原来的位置。

📦 更新说明

• 版本：1.2.0

✨ 新增

• 添加了可拖动的游戏内控制台窗口，可通过仪表板磁贴打开。
• 添加了按客户端保存的命令历史记录。
• 在权限面板中添加了可配置的 server_console 权限。

🔧 改进

• 所有管理数据现在都通过 oxmysql 使用单个 agency_admin_data 表。
• 管理数据采用三重冗余存储，即使删除文件夹、全新重装或覆盖文件也能保留。
• Object Spawner：生成的对象通过 SQL、JSON 和 KVP 持久化存储在服务器端。
• UI：重新制作了卡片进入动画，并修复了切换标签页时内容切换造成的闪烁。
• UI：玩家数量、性能和封禁信息会在后台静默刷新，无需重建当前显示的标签页。

📦 更新说明

• 覆盖文件以进行更新。请勿删除现有文件夹；SQL 会确保数据安全。

✨ 新增

• Object Spawner：新增生成物体的搜索、放置和持久化存储功能。
• Admin Duty：新增带旋转控制的交互式服装菜单。
• Admin Duty：新增各等级专属的男女服装预设。
• Admin Duty：新增各等级专属的 nametags，并支持自定义文本、颜色和缩放比例。

🔧 改进

• 权限：重新设计了等级和权限管理，现在可在游戏内通过 Settings 面板进行管理。
• 权限：等级分配、权限、服装预设和 nametags 均以 JSON 格式存储在服务器端，无需编辑 config。
• 权限：新增按玩家分配等级的功能，并支持可选的权限覆盖。
• 权限：更改会立即应用于在线工作人员。

🐛 已修复

• 修复了导致玩家无法加入的服务器崩溃问题。
• 改进了封禁检查和数据加载的错误处理。
• 修复了头发颜色变绿的问题。
• 修复了多个 UI 错误。

📦 更新说明

• 只有拥有全局 ACE 的服务器管理员才能管理等级和权限，从而防止权限提升。
• 生成的对象会保存在服务器端并同步给所有玩家，在 resource 重启或服务器重启后仍会保留。