高级模式

高级模式提供完整的 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、或点击箭头图标
全部展开	点击顶部"全部展开"按钮
全部折叠	点击顶部"全部折叠"按钮

编辑值

1

选中节点

在树中选中一个标签节点。

2

打开编辑器

双击或按 Enter 打开值编辑器。

3

校验规则

编辑器会根据标签类型自动校验输入：

• 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：小数

4

应用或取消

• 按 Enter 或点击确认应用修改。

• 按 Esc 取消编辑。

新建标签

1

选择目标容器

选中一个 Compound（复合）或 List（列表）节点。

2

创建入口

点击顶部 "+ 新建" 按钮。

3

选择类型

从下拉列表选择标签类型。

4

输入名称与数值

输入标签名称（Compound 子节点需要）和值。

5

完成添加

确认后添加新标签。

可添加任意 NBT 类型：Byte、Short、Int、Long、Float、Double、String、ByteArray、IntArray、LongArray、List、Compound。

删除标签

1

选中待删除标签

选中要删除的标签。

2

删除操作

按 Delete 或点击删除按钮。

3

结果

该标签及其所有子节点（如有）将被移除。

搜索/过滤

1

打开搜索

点击搜索图标或在搜索栏中输入。

2

过滤显示

树将过滤显示匹配的节点。

3

匹配范围

搜索匹配范围：

• 键名 — 标签名称

• 值 — 标签值

• 类型 — 标签类型名称

4

恢复完整树

清空搜索恢复完整树。

侧边栏信息

左侧边栏显示：

• 物品图标（渲染的物品）

• 物品 ID（如 minecraft:diamond_sword）

• 堆叠数量（如 x1）

• 组件数 — 数据组件总数

保存与工具

• 按 Ctrl+S 将修改保存到物品（仅限创造模式）。

• 高级模式同样提供 导出 和 导入 NBT 文件功能。

• 使用 复制 NBT 将整个标签树以文本形式复制到剪贴板。

使用技巧

• 如果操作有误，直接关闭编辑器不保存即可 — 原始物品不受影响。

• 树默认折叠显示。可在配置文件中设置 treeExpandedByDefault: true 自动展开。

• 可随时通过顶部切换按钮切换到简易模式进行常用编辑。