课程时长：120 分钟
技术栈：IntelliJ IDEA + Spigot API 1.21.1 + AI 助手
核心目标：理解**向量（Vector）**在游戏中的应用，学习如何通过逻辑组合捕捉玩家动作（如连跳、按键组合），并利用 HashMap 实现技能冷却（Cooldown）机制。
一、 任务背景 (Mission Background)
普通的行走和跳跃已经无法满足高级玩家的需求了。今天，你将化身**“战斗数值设计师”**，为服务器添加两个动作技能：
-
二段跳 (Double Jump)：在空中再次跳跃，像鸟儿一样短暂滑翔。
-
迅捷冲刺 (Dash)：手持特定道具（如羽毛）右键，或者通过快捷键，向准星方向瞬间爆发位移。
二、 学习路线图 (Technical Map)
-
编程技能：向量运算 (velocity)、状态切换 (setAllowFlight)、冷却存储 (HashMap<uuid, long=””></uuid,>)。
-
工程思维：物理模拟 —— 理解 XYZ 轴的速度方向；资源管理 —— 技能不能无限释放，必须平衡游戏性。
-
AI 素养：利用 AI 解释物理公式，并通过描述“动作意图”获取复杂的逻辑判定（如“检查玩家是否在地面”）。
三、 核心项目：二段跳逻辑 (Sprint 1: 45 min)
1. 欺骗服务器的“飞行”
二段跳的本质是：监听玩家尝试飞行的动作，将其拦截，并赋予一个向上的速度。
推荐 Prompt（提示词）：
“我正在使用 Spigot 1.21.1。请帮我写一个二段跳功能：
当玩家加入服务器时，设置 setAllowFlight(true)（否则无法触发连跳按键）。
监听 PlayerToggleFlightEvent 事件。
如果玩家不是创造模式，取消事件（防止真的飞起来）。
给玩家设置一个向上的速度向量（例如 Y 轴为 0.7）。
播放一个‘蝙蝠起飞’的音效和烟雾粒子。
跳完后暂时设置 setAllowFlight(false)，直到玩家落地（监听 PlayerMoveEvent 检查 isOnGround）再重新开启。”
2. 代码解析：向量与速度
-
关键代码：player.setVelocity(new Vector(0, 0.7, 0))。
-
Vibe Check：让 AI 解释，如果把 0.7 改成 2.0 会发生什么？（提示：玩家会像火箭一样飞入云端）。
四、 多任务挑战：冲刺与冷却 (Sprint 2: 45 min)
我们要通过“逻辑组合”来实现更酷的 Dash 技能。
五、 工程思维：物理边界与安全 (Engineering Logic: 15 min)
工程师的深度思考：
-
摔落伤害：玩家从高处二段跳，落地时会摔死吗？
-
改进：在触发技能时，给玩家添加一个短暂的“抗性提升”效果，或者监听 EntityDamageEvent 取消摔落伤害。
-
-
性能损耗：PlayerMoveEvent 每秒触发 20 次，如果在里面写太复杂的代码，服务器会卡死。
-
AI 任务：询问 AI “在 PlayerMoveEvent 中检查落地状态时，如何优化性能以免造成服务器延迟？”
-
六、 联机调试与 Debug (Testing: 15 min)
-
方向测试：向下看的时候按冲刺，你会钻进地里吗？
-
冷却测试：狂点右键，看看冷却提示是否能正确拦截多余的冲刺。
-
AI 纠错：如果二段跳之后无法再次恢复跳跃，通常是“落地判定”失效。请问 AI：“除了 isOnGround()，还有什么更精确的方法检查玩家是否踩在方块上？”
七、 自学习与探究 (Self-Learning)
拓展思考：
-
粒子拖尾：在冲刺的过程中，能否让玩家身后留下一串白色的烟雾轨迹？（提示：使用 BukkitRunnable 持续 1 秒生成粒子）。
-
能量系统：能否将技能与玩家的“经验条”绑定？释放一次冲刺消耗一格经验。
八、 成果交付 (Deliverables)
-
演示：展示你在建筑间通过二段跳轻盈穿梭，并用冲刺躲避僵尸攻击的过程。
-
代码截图：展示 HashMap 冷却逻辑的代码块。
-
Prompt 记录：记录你如何让 AI 帮你计算“视线方向速度”的提示词。
九、 老师的 Vibe Tips (结语)
“今天你接触到了游戏开发的灵魂——物理向量。AI 帮你处理了繁琐的数学计算，但‘手感’的调试（是冲 10 米还是 5 米）取决于你对数值的微调。记住，一个优秀的 Vibe Coder 总是通过不断尝试不同的 multiply() 倍数，来寻找最完美的操控感。”