潜影盒预览
备注
我们支持 Carpet AMS Addition 的 largeShulkerBox（大潜影盒）规则，开启后潜影盒容量将扩展至54格。
EasyBot 潜影盒预览 允许管理员和玩家在 QQ 群内直接查看指定玩家背包中潜影盒内的全部物品，以渲染图片形式呈现，所见即所得。同时支持多账号选择、多潜影盒选择、权限控制、自定义潜影盒名 称与自定义关键词触发。
| 默认大小 | 大潜影盒 |
|---|---|
 |  |
环境要求
| 平台 | 最低版本 |
|---|---|
| Bukkit 插件版 | ≥ 2.3.0 |
| Mod 版 | ≥ 0.3.0 |
查询前提
目标玩家必须 至少进入过一次服务器，即服务器世界文件中已存在该玩家的数据（playerdata/ or /players/data/ 目录下的玩家数据文件）。
- 无论玩家当前是否在线，均可正常查询
- 潜影盒数据通过插件上报的玩家 UUID 建立索引，而非玩家名
- 若通过 EasyBot 后台「玩家管理」手动创建的玩家记录未关联真实 UUID，则无法查询
简而言之：目标玩家必须曾正常登录过服务器，且 UUID 已被 EasyBot 插件自动记录。
配置步骤
- 在 EasyBot 后台选择目标服务器
- 设置触发关键词（如
盒子） - 导入对应版本的 纹理包
查询他人
启用「允许查询他人」后，在群内发送以下指令即可查询：
关键词 <玩家名 | @群成员>
| 场景 | 行为 |
|---|---|
| 输入本人绑定的玩家名 | 直接查询，跳过多账号选择 |
| 输入他人绑定的玩家名 | 经权限验证后查询 |
| @群成员 | 列举被 @ 成员绑定的账号列表，发送者选择后查询 |
| 输入的玩家名 / @ 成员均未绑定 | 提示未绑定错误 |
| 发送者无查询权限 | 提示权限不足 |
多账号选择
当被 查询的用户绑定了多个游戏账号时，EasyBot 会自动列举所有匹配的账号，由发送者选择具体查询哪一个。
选择方式
- 发送数字序号：直接发送列表中的数字编号
- 点击表情：点击机器人消息中对应的数字表情
其他群成员点击表情会被机器人自动忽略，不会干扰当前查询会话。
自动跳过选择
在关键词后直接附加游戏 ID（精确匹配，区分大小写），可跳过列表直接定位目标账号：
关键词 玩家名
会话生命周期
- 超时时间：1 分钟，超时自动取消且不主动通知
- 若发送者在超时前发送了其他消息，会话立即取消
潜影盒选择
完成账号选择后，若目标玩家背包中存在 多个潜影盒，EasyBot 会进一步列举所有潜影盒，由发送者选择具体查看哪一个。根据背包中潜影盒的数量，系统会自动切换不同的交互模式。
少量潜影盒（≤ 10 个）
当背包中潜影盒数量不超过 10 个时，支持通过 点击表情 或 发送数字序号 两种方式进行选择：
大量潜影盒（> 10 个）
安全限制
当背包中潜影盒数量超过 10 个时，消息长度可能超出 QQ 平台限制、导致交互异常。此时选择 仅支持发送纯数字序号，不支持点击表情选择。
会话生命周期
- 超时时间：1 分钟，超时自动取消且不主动通知
- 若发送者在超时前发送了其他消息，会话立即取消
- 潜影盒选择阶段独立计时，与账号选择阶段互不影响
自定义潜影盒名称
EasyBot 支持识别潜影盒的 自定义名称（通过铁砧重命名）。自定义名称会影响以下两处显示：
- 选择阶段的列表名称：在潜影盒列表中直接展示玩家自定义的名称，便于快速定位目标盒子
- 渲染输出图的标题：最终生成的潜影盒预览图中会以自定义名称作为标题
选择阶段效果
渲染输出效果
若潜影盒未经过铁砧重命名，则默认显示为「潜影盒」 「xxx色潜影盒」。
