物品编辑器
物品编辑器（ItemEditionGui）是单件物品的编辑主界面。从类型浏览器 → 物品浏览器 → 右键物品 / 新建进入，或 /qi editor <itemId> 直达。
1. 主界面结构
界面是 6 行 54 槽的动态背包，分页展示可点击「字段行」。每个字段是以下三种之一：
| 类型 | 交互 | 例子 |
|---|---|---|
| 开关 | 点击即时切换 | 无限耐久、发光、隐藏属性、隐藏附魔 |
| 聊天输入 | 点击后在聊天框输入 | 材质、品质、类型、显示名、物品名、Lore、最大堆叠、CMD、附魔总上限 |
| 子编辑器 | 点击打开新界面 | 动作、宝石孔、属性、常驻效果、附魔、限制、套装、模板、Provider |
- 保存：槽位 53（绿宝石）→ 校验并写回 YAML。
- 编辑器中心：槽位 50 → 返回编辑器 Hub。
🖼️ [图片占位] 物品编辑器主界面，标注各字段按钮位置 · 建议
assets/editor-item-main.png
2. 各字段写入哪里
| GUI 字段 | 写入 QinhItemDefinition 的 |
|---|---|
| 材质 | material |
| 品质 | tier |
| 类型 | type |
| 显示名 | displayName |
| 物品名 | itemName |
| Lore（添加 / 清空） | lore |
| 无限耐久 / 发光 / 隐藏属性 / 隐藏附魔 | options.* |
| 最大堆叠 | options.maxStackSize |
| CustomModelData | options.customModelData / resourcePack.customModelData |
| 附魔总上限 | enchantMaxTotalLevel |
| 绑定拾取 | options.bindOnAcquire |
| 限制 | options.restrictions |
对应 YAML 字段说明见 物品定义。
3. 子编辑器入口
属性编辑器（AttributeEditorGui）
编辑物品的 providers.ap 属性。
- 属性列表：按键名排序，显示
键 值+ 分类 + 提示。 - 左键：编辑值（聊天输入）。
- Shift + 右键：删除该属性。
- 添加属性：聊天输入键（或从 AP 目录选）→ 输入数值（支持单值
10或范围10-20）。写入providers.ap的 JSON blob。 - 基础值（BaseValueEditorGui）：编辑 ICVM 核心键（
base_attack_damage/base_defense/base_health）。 - 清空全部：移除整个 ap provider。
属性机制见 属性与数值。
常驻效果编辑器（PermEffectEditorGui）
编辑 providers.perm_effects。添加：输入效果名 → 输入放大等级。见 属性与数值 → 常驻药水效果。
附魔编辑器（EnchantmentEditorGui）
编辑 enchantments。添加：输入附魔键 → 输入等级（0–255 校验）。见 附魔上限。
限制编辑器（RestrictionEditorGui）
编辑 options.restrictions。添加：聊天输入一条限制（如 level:20）。见 物品定义 → restrictions。
Provider 浏览器（ProviderBrowserGui）
编辑任意 providers.*。添加：输入 provider ID → 进入 Provider Blob 编辑器输入载体 + 载荷。开发者向细节见 Provider 与桥。
宝石孔编辑器（GemSocketEditionGui）
编辑 gem-sockets。
- 左键添加孔（聊天输入孔类型 ID）/ 右键移除最后一个。
- Legendinlay 元数据按钮：输入
set,slot[,piece]。 - 清空 / 保存。
见 宝石孔。
4. 其他入口
5. 典型流程
/qi editor
→ 点 Weapon
→ 新建物品 → 聊天输入 ID
→ [材质] 输入 diamond_sword
→ [品质] 输入 EPIC
→ [显示名] 输入 <gold>试炼之刃</gold>
→ [属性] 添加 attack_damage = 18
→ [动作/技能] 添加 qi:title / qi:sound
→ [保存]（槽位 53）→ 成功提示