1 Agency Companion 中的网页面板
Agency-Admin 为你的电脑提供了完整的管理面板:companion.agencyg.de/app/admin。它在浏览器中的 Agency Companion 内运行,并像手机应用一样通过加密的 Agency 中继连接到你的服务器。无需开放任何端口,游戏服务器上也不托管任何内容。
| 页面 | 功能 |
|---|---|
| 仪表盘 | 在线玩家、tick 时间、运行时长、资源、城市资金、最近操作 |
| 玩家 | 游戏内面板的所有管理操作、消息与警告、实时查看玩家屏幕 |
| 实时控制台 | 完整的服务器控制台,并可以服务器控制台身份执行命令 |
| 资源 | 启动、停止和重启任意资源,重新扫描资源列表 |
| 配置 | 服务器上每个资源的配置文件,可按设置或代码方式编辑 |
| 文件 | 带编辑器的服务器文件夹文件管理器 |
| 封禁、操作日志、团队与职级、服务器控制 | 离线封禁、所有管理操作的历史记录、带倒计时的服务器重启或停止 |
网页面板是为电脑设计的。在手机或平板上请使用 Agency Companion 应用,它内置了管理模块。
2 连接
在游戏中打开管理菜单,进入 Web Panel 并点击在浏览器中打开,或输入 /webpanel。浏览器会打开面板并立即为你登录。
在另一台电脑上,打开 companion.agencyg.de/app/admin,并输入 Web Panel 页面上的 6 位代码。代码有效期为 5 分钟。
你可以连接任意数量由你管理的服务器,并在面板中切换。每个连接都是一台已配对的设备,你可以在游戏中的 设置 > Companion 下将其登出。
3 权限与安全
浏览器和应用一样持有设备令牌。每一次点击都会在你的服务器上根据管理员的职级和权限实时检查,速率限制和操作日志与游戏内相同。
| 权限 | 解锁内容 | 是否继承 |
|---|---|---|
companion_console | 实时控制台和资源 | 是 |
server_power | 重启和停止服务器 | 否,仅限最高职级和你勾选的职级 |
web_files | 文件和配置 | 否,仅限最高职级和你勾选的职级 |
控制台、重新扫描资源和服务器重启均以控制台命令方式运行。它们需要在 server.cfg 中添加一行:
add_ace resource.Agency-Admin command allow
4 每个资源的配置
配置页面会列出服务器上每个资源(无论作者是谁)的配置文件,并自动发现它们:config.lua、shared/config.lua、config/*.lua、settings.lua、config.json,以及资源的 fxmanifest.lua 中指定的每个配置文件。资源无需注册任何内容。
| 视图 | 显示内容 |
|---|---|
| 设置 | 每个简单值(true 或 false、数字、文本)以开关或输入框显示,旁边附有文件中的注释,并按章节分组。编辑某个值只会修改那一行,格式和注释保持不变。 |
| 代码 | 带语法高亮的完整文件。 |
保存会先在服务器上检查语法,因此损坏的 config.lua 永远不会被写入。每次保存前都会保留旧版本(每个文件最近 15 个,位于 Agency-Admin/config_backups)。保存并重启会立即重启该资源,历史版本可以恢复旧版本。
使用 FiveM Escrow 加密的配置会显示锁图标,无法编辑。
5 较新的 FXServer 版本:每个资源一行
大约从 25770 起的 FXServer 版本会对文件系统进行沙箱隔离:只有在服务器启动前 server.cfg 允许的情况下,一个资源才能写入另一个资源。运行中的服务器会忽略这些行。请为每个你想从面板保存其配置的资源添加一行,然后重启一次服务器:
add_filesystem_permission Agency-Admin write qb-core
add_filesystem_permission Agency-Admin write Agency-Housing
如果缺少某一行,面板会在你保存时提示,并显示可直接复制的准确行,可针对该资源,也可一次性针对所有带配置的资源。在 txAdmin 中,请将它们粘贴到 CFG Editor。
