课程时长：120 分钟
技术栈：IntelliJ IDEA + Spigot API 1.21.1 + AI 助手
核心目标：深入掌握方块破坏事件（BlockBreakEvent），学习概率算法与物品堆叠逻辑。通过 AI 实现“权重掉落”系统，提升游戏的趣味性与操作效率。
一、 任务背景 (Mission Background)
在传统的 Minecraft 中，挖矿是一个重复且枯燥的过程：破坏方块、方块掉落、走过去捡起。今天，我们要彻底改变这个规则！你将开发两个功能：
-
自动拾取 (Auto-Pick)：方块被破坏后直接进入玩家背包，不再落地。
-
幸运方块 (Lucky Block)：挖掘特定方块（如金矿或海绵）时，会触发随机的“惊喜”或“惊吓”。
二、 学习路线图 (Technical Map)
-
编程技能：BlockBreakEvent 的深度应用、随机数生成 (Random)、集合 (List/ArrayList) 的基础。
-
工程思维：用户体验 (UX) —— 背包满了怎么办？边界处理 —— 创造模式下是否触发？
-
AI 素养：利用 AI 编写 “权重算法”（不同奖励出现的概率不同），而不是简单的 1:1 随机。
三、 核心项目：自动拾取系统 (Sprint 1: 45 min)
1. 拦截掉落物
默认情况下，方块破坏会生成一个 Item 实体。我们需要取消这个自然掉落，改为直接给玩家物品。
推荐 Prompt（提示词）：
“我正在使用 Spigot 1.21.1。请帮我写一个 BlockBreakEvent 监听器：
当玩家破坏方块时，取消默认掉落（event.setDropItems(false)）。
获取该方块原本会掉落的物品（block.getDrops()）。
将这些物品直接放入玩家的背包。
如果玩家背包满了，将物品掉落在玩家脚下，并发送一条 Actionbar 消息提示‘背包已满’。”
2. 代码解析：集合与循环
-
关键点：block.getDrops() 返回的是一个集合（Collection）。你需要用 for 循环把里面的东西一个个放进背包。
-
Vibe Check：问问 AI，为什么我们要用 p.getInventory().addItem(item) 的返回值来判断背包是否已满？（提示：它会返回放不下的物品集合）。
四、 多任务挑战：幸运方块掉落 (Sprint 2: 45 min)
现在我们要给特定的方块注入“灵魂”。
五、 工程思维：鲁棒性与性能 (Engineering Logic: 15 min)
工程师的深度思考：
-
创造模式保护：如果玩家在创造模式下拆家，也会触发幸运方块吗？
-
改进：在逻辑开头增加 if (p.getGameMode() == GameMode.CREATIVE) return;。
-
-
精准采集 (Silk Touch)：如果玩家用了精准采集附魔，自动拾取应该给原矿还是给矿石？
-
AI 任务：询问 AI “如何在 BlockBreakEvent 中判断玩家手中工具是否带有精准采集附魔？”
-
六、 联机调试与 Debug (Testing: 15 min)
-
压力测试：用效率 V 的镐子快速挖矿，自动拾取会卡顿吗？
-
极端测试：把背包塞满，看看物品是否能正确掉落在脚下，而不是直接消失。
-
AI 纠错：如果挖掘时报错 NullPointerException，通常是因为玩家手里没拿东西（空气）。请问 AI：“如何安全地获取玩家手中的物品对象？”
七、 自学习与探究 (Self-Learning)
拓展思考：
-
经验值处理：方块破坏通常会掉落经验球（如煤矿）。你能让经验值也自动加到玩家身上吗？
-
自定义方块：能否结合第 4 课的 Config，让服主在配置文件里自定义哪种方块是“幸运方块”？
八、 成果交付 (Deliverables)
-
演示：展示一段流畅的挖矿过程，物品直接进包，并在挖到海绵时触发了华丽的奖励。
-
代码截图：展示你处理“权重随机”逻辑的那部分代码。
-
Prompt 记录：记录你如何描述“权重掉落”需求，并让 AI 理解不同概率的。
九、 老师的 Vibe Tips (结语)
“今天你不仅仅是在写一个功能，你是在设计一种奖励机制。好的游戏开发者知道如何通过概率（Randomness）来控制玩家的情绪起伏。利用 AI 帮你处理复杂的数学概率，而你只需要专注于设计那个‘大奖’到底是什么。”