课程时长：120 分钟
技术栈：IntelliJ IDEA + Spigot API 1.21.1 + AI 助手
核心目标：掌握物品堆栈（ItemStack）与元数据（ItemMeta）的深度定制，学习使用 PersistentDataContainer（现代 NBT 存储）标记特殊物品，实现一套基于概率的稀有装备掉落系统。
一、 任务背景 (Mission Background)
普通的僵尸只掉落腐肉，这太无聊了！今天，你将化身为**“RPG 数值策划”。你要为服务器设计一种稀有传说装备——“僵尸之魂”**（一个散发着紫色光芒的附魔头盔）。
它不仅名字酷炫，还带有神秘的“灵魂标记”。当玩家佩戴它时，将获得永久的夜视能力。
二、 学习路线图 (Technical Map)
-
编程技能：EntityDeathEvent、ItemStack 对象创建、ItemMeta 修改（Display Name, Lore, Enchantments）。
-
工程思维：数据标记（Tagging）——如何从成千上万个头盔中精准识别出你创造的那一个？
-
AI 素养：利用 AI 快速生成繁琐的“物品描述（Lore）”，并学习如何通过 AI 获取复杂的物品颜色字符。
三、 核心项目：传说装备“僵尸之魂” (Sprint 1: 45 min)
1. 掉落逻辑与物品构建
我们需要在僵尸死亡时，有一定几率生成这个特殊物品。
推荐 Prompt（提示词）：
“我正在开发 Spigot 1.21.1 插件。请帮我写一个 EntityDeathEvent 监听器：
判断死亡的实体是否为僵尸（Zombie）。
如果是，有 10% 的几率在掉落物列表中加入一个特殊的钻石头盔。
物品属性：
名字：‘§5§l僵尸之魂’（紫色加粗）。
描述（Lore）：‘§7传闻中被诅咒的头盔’，‘§a[特殊能力] 赋予佩戴者夜视’。
附魔：保护 4，荆棘 2，且带有闪烁效果（Glow）。”
2. 代码解析：ItemMeta 的层级
-
关键步骤：创建 ItemStack -> 获取 ItemMeta -> 修改 Meta -> 将 Meta 还给 ItemStack。
-
Vibe Check：问问 AI，为什么修改了 meta.setDisplayName 之后，必须执行 item.setItemMeta(meta) 才能生效？（提示：Java 的对象引用与赋值机制）。
四、 多任务挑战：属性赋予与标记 (Sprint 2: 45 min)
我们要让这件装备真正发挥作用。
五、 工程思维：唯一性判断 (Engineering Logic: 15 min)
工程师的深度思考：
-
改名漏洞：如果玩家在铁砧里把普通的钻石头盔改名为“§5§l僵尸之魂”，它也能获得夜视能力吗？
-
解决方案：不要只靠“名字”判断。使用第 2 步学到的持久化标记。即使名字改了，隐藏在代码里的标签依然存在。
-
-
性能优化：我们不需要每秒钟都给玩家检查夜视，只需在玩家换衣服（InventoryClickEvent）时检查一次即可。
六、 联机调试与 Debug (Testing: 15 min)
-
刷怪测试：疯狂刷僵尸，看看掉率是否符合 10% 的预期。
-
功能测试：带上头盔，进入黑暗的山洞，看看是否瞬间变亮？脱下后效果是否消失？
-
AI 纠错：如果玩家死后头盔消失了，或者夜视效果变成了永久（脱不掉），请问 AI：“如何实现‘穿上给效果，脱下删效果’的闭环逻辑？”
七、 自学习与探究 (Self-Learning)
拓展思考：
-
套装属性：如果凑齐“僵尸之魂”衣服、裤子、鞋子，能否触发更强的“力量 II”效果？
-
掉落特效：当传说装备落地时，能否在地面生成一个持续的紫色粒子光柱，防止玩家没看到？
八、 成果交付 (Deliverables)
-
演示：展示你从僵尸堆里捡起那件发光的“僵尸之魂”，戴上后瞬间看清黑夜的特效。
-
代码截图：展示 PersistentDataContainer 写入和读取的代码段。
-
Prompt 记录：记录你如何让 AI 生成那段带有颜色和特殊格式的 Lore 列表。
九、 老师的 Vibe Tips (结语)
“在 Vibe Coding 中，不要做重复的苦力活。定义 100 行 Lore 是 AI 的工作，而定义这件装备为什么独特（即逻辑判断与 NBT 标记）是你的工作。今天你学会了给物品打上‘电子标签’，这是开发复杂 RPG 插件的基石。”