前往课程主页

第 10 课：神奇钩爪 (Grappling Hook) —— 丛林跃迁者

第 10 课：神奇钩爪 (Grappling Hook) —— 丛林跃迁者

课程时长：120 分钟技...

课程时长：120 分钟
技术栈：IntelliJ IDEA + Spigot API 1.21.1 + AI 助手
核心目标：深度应用**向量数学（Vector Math）**实现复杂的物理位移，学习如何捕捉特定工具的特殊动作（钓鱼竿钩住方块），并掌握防止“摔落伤害”的工程解决方案。

一、 任务背景 (Mission Background)

在崎岖的山地或高楼林立的城市中穿梭，走路太慢，二段跳不够远。今天，你将化身为**“物理引擎专家”，制作一把像《蝙蝠侠》或《进击的巨人》里的神奇钩爪**（由钓鱼竿改造而成）。玩家向目标投掷鱼钩，当鱼钩嵌入方块时，再次收杆即可将自己瞬间拉向目标。

二、 学习路线图 (Technical Map)

  • 编程技能：PlayerFishEvent 事件状态判定、向量减法（目标点 – 起始点）、速度缩放（multiply）。

  • 工程思维：异常保护 —— 玩家被拉飞后摔死怎么办？逻辑严密性 —— 如果鱼钩勾住的是空气或生物呢？

  • AI 素养：利用 AI 解释“向量标准化（Normalize）”的物理意义，并让 AI 编写复杂的物理冲力公式。

三、 核心项目：钩爪弹射逻辑 (Sprint 1: 45 min)

1. 识别“钩住方块”状态

钓鱼竿的事件非常复杂，我们只需要关注鱼钩进入方块的那一刻。

推荐 Prompt（提示词）：

“我正在使用 Spigot 1.21.1。请帮我实现神奇钩爪功能：

  1. 监听 PlayerFishEvent。

  2. 检查事件状态是否为 IN_GROUND（钩住方块）或 REEL_IN（收杆时）。

  3. 获取玩家的 Location 和鱼钩（Hook）的 Location。

  4. 计算从玩家指向鱼钩的向量（Vector）。

  5. 使用 player.setVelocity() 让玩家向该方向飞出。

  6. 确保玩家手中的物品是名为‘神奇钩爪’的特定钓鱼竿。”

2. 代码解析：物理冲力公式

  • 关键代码：

    codeJava

     
    Vector v = hookLoc.toVector().subtract(playerLoc.toVector());
v.multiply(0.3); // 调整力量倍率
v.setY(v.getY() + 0.5); // 额外给一个向上的力，防止擦地摩擦
player.setVelocity(v);

  • Vibe Check：问问 AI，为什么向量计算要用“终点减去起点”？（提示：这决定了力量的方向）。

四、 多任务挑战：安全与打击感 (Sprint 2: 45 min)

飞得快是好事，但“平安落地”才是高级工程。

任务等级 任务名称 功能描述 AI 协助方向
基础版 空中音效 玩家飞出时，播放‘弓箭射出’或‘风声’音效。 “如何在 setVelocity 时播放一个高音调的音效？”
进阶版 摔落保护 使用钩爪飞出后，下一次落地免除摔落伤害。 “如何利用 Metadata 或集合记录钩爪玩家，并监听 EntityDamageEvent 取消其摔落伤害？”
专家版 钩爪粒子索 在玩家和鱼钩之间生成一条由‘烟雾’组成的虚线（索链）。 “如何计算两点之间的连线坐标，并沿线生成粒子效果？”

五、 工程思维：向量缩放与标准化 (Engineering Logic: 15 min)

工程师的深度思考：

  1. 距离越远飞得越快吗？：如果直接相减，钩住 100 格外的东西会让玩家瞬间变成超音速。

    • 优化：学习 v.normalize()。这会将向量长度变为 1，确保无论钩多远，速度都是恒定的。然后再 multiply(1.5) 来控制固定速度。

  2. 安全性检查：如果鱼钩勾住的是天花板，玩家会撞头受伤吗？

六、 联机调试与 Debug (Testing: 15 min)

  1. 飞行手感调试：调整 multiply 里的数字（从 0.1 到 2.0）。哪个数字让你觉得自己最像蜘蛛侠？

  2. 摔落测试：在极高的地方勾住地面拉过去。你落地时掉血了吗？如果掉了，检查你的 EntityDamageEvent 是否正确识别了钩爪玩家。

  3. AI 纠错：如果玩家还没收杆就开始乱飞，请问 AI：“如何区分 CAUGHT_FISH（钓到鱼）和 IN_GROUND（钩住地）的状态？”

七、 自学习与探究 (Self-Learning)

拓展思考：

  • 立体机动装置：结合第 12 课的 Boss 战，能否用钩爪快速接近巨大的 Boss？

  • 抓取生物：如果鱼钩勾住的是僵尸，能不能把僵尸拉向玩家？（提示：event.getCaught() 获取被钩住的实体并给它设置 Velocity）。

八、 成果交付 (Deliverables)

  1. 演示：展示你如何利用钩爪跨越一个巨大的岩浆湖，并在落地时毫发无伤。

  2. 代码截图：展示你计算向量及进行 normalize() 优化的代码块。

  3. Prompt 记录：记录你如何让 AI 解决“落地不掉血”逻辑的提示词。

九、 老师的 Vibe Tips (结语)

“今天你征服了重力。在游戏开发中，物理参数（Velocity, Gravity, Vector）的微调就是‘灵魂’所在。AI 给了你计算公式，但‘飞行的快乐’是由你不断调整那 0.1 的参数创造出来的。记住，一个伟大的 Vibe Coder 总是能在严谨的物理公式和狂野的想象力之间找到平衡。”

上一篇 下一个