制作第一个物品

本章只做一张可以堆叠的教程代币。先确认物品定义与命令链正常，再学习随机装备。

1. 新建文件

在 plugins/SealItems/items/tutorial.yml 写入：

tutorial_token:
  item:
    material: PAPER
    name: '<gold>教程代币'
    lore:
      - '<gray>这是你的第一个 SealItems 物品'
      - '<yellow>可以安全堆叠'
    custom-model-data: 10001
    enchantment-glint: true
  instance: stackable
  tags: [currency, tutorial]

不要把 Markdown 的三个反引号复制进 YAML 文件。

2. 每一行是什么意思

• tutorial_token：稳定物品 ID。以后命令、费用、掉落表都用它引用，上线后不要随意改名。
• material：Paper/Bukkit 原版材质枚举，必须拼写正确。
• name、lore：MiniMessage 文本。
• custom-model-data：可选资源包模型编号。
• enchantment-glint：只显示光效，不代表增加附魔。
• instance: stackable：可堆叠，不保存逐件 UUID、品质、词条、鉴定或宝石。
• tags：供词条、孔位 profile 和内容分类使用，不直接展示。

3. 重载并检查

/si reload items
/si list
/si give 玩家名 tutorial_token 3

预期结果：重载成功；列表中出现 tutorial_token；玩家收到 3 张可堆叠代币。手持代币执行 /si inspect，应被识别为 SealItems 物品。

4. 如果没有生效

1. 看控制台最先报告的 YAML 路径。
2. 确认扩展名是 .yml，不是 .yml.txt。
3. 确认只用空格缩进，没有 Tab。
4. 确认文件在 items/，不是 examples/。
5. 运行 /si health，确认旧快照是否仍在使用。

5. 改成独立装备

tutorial_sword:
  item:
    material: IRON_SWORD
    name: '<aqua>教程长剑'
    lore: ['<gray>每一把都有独立身份']
    unbreakable: false
    damage: 0
    item-flags: [hide-attributes]
  instance: individual
  tags: [equipment, weapon, sword]

每次 /si give 都生成新的实例 UUID 和 revision。有品质、词条、鉴定或宝石的装备必须是 individual。

接下来阅读 物品定义，或先熟悉 命令与权限。