图片模板
在服务器配置页管理图片模板实例
图片模板可以把在线玩家列表、服务器状态、排行榜等数据渲染成一张图片，由聊天指令触发后发送到群里。本页介绍如何在管理面板中安装模板包并为服务器配置实例；模板包本身的开发请参考图片模板开发。
安装模板包
进入图片模板库
在左侧主菜单点击 图片模板（/templates）。这里管理的是全局安装的模板包，安装后可在任意服务器中创建实例。
上传模板包
点击右上角 上传模板，选择打包好的 .zip 模板包。上传成功后会弹出该模板所需的数据源与第三方网络权限，确认无误即可。
删除模板包前需先删除所有服务器上引用该模板的实例，否则删除会被拒绝。
配置服务器实例
进入服务器的图片模板页面
在服务器列表中点击对应服务器卡片进入配置页面，然后点击左侧菜单 服务器管理 → 图片模板。
新增实例
点击右上角 新增实例，在弹窗中选择一个模板。同一服务器下每个模板只能添加一个实例，已添加过的模板不会出现在选择列表中。
填写自定义参数
左侧表单由模板的 configSchema 动态生成（如标题、强调色、显示数量等），右侧会实时渲染预览图。
绑定触发指令与权限（可选）
- 触发指令：玩家在群里发送的指令词（如
rank），命中后会渲染并发送该实例的图片。留空表示该实例不通过聊天指令触发。 - 权限：限制可使用该指令的角色；留空表示所有人可用（仅 OneBot 平台支持角色限制）。
启用并保存
打开 启用 开关，点击 保存。
若模板声明的某个 required 数据源（如 server_status、player_advancements）当前服务器不支持，保存后会收到警告提示，该实例不会真正生效——需要先确认服务器上的 FGateClient 已开启对应能力。
管理实例
- 临时停用：在实例列表中直接切换 启用 开关，无需进入编辑页。
- 编辑：点击实例卡片上的 编辑，修改参数 / 指令 / 权限后保存。
- 删除：点击实例卡片上的 删除 并确认。