高级模式¶
高级模式提供完整的 NBT 树编辑器，可查看和修改物品的所有数据组件。它通过 ItemStack.CODEC 将整个 ItemStack 序列化为 CompoundTag 进行编辑，保存时反序列化回去。
界面布局¶
- 左侧边栏 — 物品信息面板，显示物品 ID、堆叠数量和组件数
- 右侧面板 — NBT 树视图
- 顶部标题栏 — 标题、模式切换（简易/高级）、搜索栏、操作按钮
- 底部状态栏 — 状态消息
树形视图¶
NBT 树以层级结构展示物品的所有数据组件：
- 复合标签
{}— 包含命名子标签（花括号显示） - 列表标签
[]— 包含有序子标签（方括号显示） - 基础标签 — Byte、Short、Int、Long、Float、Double、String
- 数组标签 — ByteArray、IntArray、LongArray
每种标签类型使用不同颜色编码，便于区分：
| 标签类型 | 颜色 |
|---|---|
| Compound（复合） | 白色 |
| List（列表） | 浅蓝色 |
| String（字符串） | 绿色 |
| 数字类型（Byte/Short/Int/Long） | 金色/黄色 |
| 小数类型（Float/Double） | 橙色 |
| 数组类型 | 青色 |
树导航¶
| 操作 | 方式 |
|---|---|
| 选中节点 | 点击节点 |
| 上下导航 | 方向键（上/下） |
| 展开/折叠 | 双击、按 E、或点击箭头图标 |
| 全部展开 | 点击顶部"全部展开"按钮 |
| 全部折叠 | 点击顶部"全部折叠"按钮 |
编辑值¶
- 在树中选中一个标签节点。
- 双击或按
Enter打开值编辑器。 - 编辑器会根据标签类型自动校验输入：
- String（字符串）：任意文本
- Byte：整数 -128 到 127
- Short：整数 -32768 到 32767
- Int：整数 -2,147,483,648 到 2,147,483,647
- Long：整数 -9,223,372,036,854,775,808 到 9,223,372,036,854,775,807
- Float/Double：小数
- 按 Enter 或点击确认应用修改。
- 按 Esc 取消编辑。
文本选择¶
字符串和文本类编辑框支持基础文本编辑能力：
Ctrl+A全选。- 方向键移动光标。
- 按住
Shift再移动光标可以扩展选择范围。 - 鼠标点击可以定位光标。
- 鼠标拖动可以选择文本。
当需要批量替换一段文本或给片段插入格式代码时，先选中文本再输入或粘贴即可。
新建标签¶
- 选中一个 Compound（复合）或 List（列表）节点。
- 点击顶部 "+ 新建" 按钮。
- 从下拉列表选择标签类型。
- 输入标签名称（Compound 子节点需要）和值。
- 确认后添加新标签。
Info
可添加任意 NBT 类型：Byte、Short、Int、Long、Float、Double、String、ByteArray、IntArray、LongArray、List、Compound。
删除标签¶
- 选中要删除的标签。
- 按
Delete或点击删除按钮。 - 该标签及其所有子节点（如有）将被移除。
搜索/过滤¶
- 点击搜索图标或在搜索栏中输入。
- 树将过滤显示匹配的节点。
- 搜索匹配范围：
- 键名 — 标签名称
- 值 — 标签值
- 类型 — 标签类型名称
- 清空搜索恢复完整树。
搜索框同样支持鼠标点击、中文输入和常规光标移动。1.2.4 修复了部分 Minecraft 版本中搜索框失焦后无法重新输入的问题。
侧边栏信息¶
左侧边栏显示：
- 物品图标（渲染的物品）
- 物品 ID（如
minecraft:diamond_sword） - 堆叠数量（如
x1） - 组件数 — 数据组件总数
保存与工具¶
- 按
Ctrl+S将修改保存到物品（仅限创造模式）。 - 高级模式同样提供 导出 和 导入 NBT 文件功能。
- 使用 复制 NBT 将整个标签树以文本形式复制到剪贴板。
使用技巧¶
- 如果操作有误，直接关闭编辑器不保存即可 — 原始物品不受影响。
- 树默认折叠显示。可在配置文件中设置
treeExpandedByDefault: true自动展开。 - 可随时通过顶部切换按钮切换到简易模式进行常用编辑。