MCPJ – Puddle Jumper

完全由 AI 开发。 这个模组的所有代码、工具和本文档均由 AI 编写。玩得开心最重要 😉

MCPJ 将一艘可驾驶的《Stargate Atlantis》Puddle Jumper 加入 Minecraft。这是一款非官方粉丝模组。

它可以独立运行；Just Stargate Mod、通用机械等其他模组都是可选的。飞船全长约 10 格，设有七个座位，并配备隐形、护盾、货舱、可伸缩驱动舱、追踪无人机、前灯，以及可与任何 Forge Energy 模组配合使用的能源系统。

• 创造模式物品栏，独立分类页MCPJ：Puddle Jumper、Puddle Jumper Key、Jumper Charging Pad和Jumper Projector
• 生存模式：制作Jumper Charging Pad（红石粉周围摆放 8 颗绿宝石）和Jumper Projector（配方相同，但四角换成钻石）；投影仪可以建造飞船（见下文）。Puddle Jumper Key的配方是：绿宝石放在铁锭上方，铁锭放在红石粉上方。

在地面上使用物品，飞船就会出现，朝向与你的视线方向一致。新飞船的能量为 20%。

所有飞船操作按键都可以在选项 → 控制 → MCPJ中重新绑定。

飞行。飞船采用惯性飞行：平缓加速、转向，并会滑行。没有操作输入时，飞船会减速并悬停在原地，即使驾驶员在空中离开也一样。登船后会切换到第三人称视角，离船后则恢复之前的视角。第一人称视角下（F5），自己的飞船会隐藏，视角沿船头方向直视前方。飞船在空中时引擎会发光并拖曳离子尾焰，着陆后则会保持静音。边缘引导功能会让飞船滑过刚好碰到的边缘（可横向、上下偏移最多半格，flight.edgeGuidance见服务器配置），例如滑入星际之门。

隐形。对其他玩家不可见，仅会隐约显现为能量气泡，但飞船仍有实体。驾驶员能看到飞船淡淡发光的轮廓。生物会失去对驾驶员的追踪。发射无人机将解除隐形。

护盾。护盾会形成一个轻轻摇曳、外观像水的能量气泡，只要还有能量就能吸收所有伤害；受到攻击时会闪烁。

导航。飞船最多可以记录 64 个带名称的导航点。导航点会随飞船保存，并与所有乘客共享。在导航台（N）上，任何乘客都可以保存当前位置、选择目的地，以及重命名或删除导航点。驾驶员 HUD 顶部的罗盘带会显示航向和目的地标记（目的地在身后时，箭头会显示在边缘）；下方则显示目的地名称、距离、高度差，以及按当前速度估算的抵达时间。

目标与无人机。64 格范围内的生物和未隐形的飞船都会被标记（敌对生物为红色，飞船为青色，其他目标为白色；选中的目标会以粗体显示名称和距离）。无人机会追踪目标，并在撞击时爆炸（威力略低于苦力怕；只有在mobGriefing时才会破坏方块）；不会伤害自己的飞船及其乘客。

船体。船体有 240 点耐久（钻石剑大约需要攻击 35 次）。敌方无人机会摧毁 60% 的船体耐久，所以第二架无人机就足以致命。船体不会自行修复（充能垫可以修复着陆的飞船，见下文），在创造模式中也会受到伤害。飞船至少有一半浸在水中时，若没有护盾，每秒损失 1 点船体耐久。只要船体有任何部分碰到熔岩（包括流动的熔岩，例如将一桶熔岩倒在飞船上），每秒就会损失 8 点耐久；只要还有能量，启用的护盾就能吸收熔岩伤害。飞船不会受到爆炸、攻击、生物或水流造成的击退。

座位。飞船有七个座位：船头的驾驶位、后方的两个座位，以及后舱的四个座位（右键点击即可登船）。第一个登船的人担任驾驶员；驾驶员离开后，下一位乘客会移到驾驶位并接管操控。只有驾驶员可以驾驶、开火并查看 HUD。

钥匙。手持空白的Puddle Jumper Key对飞船点击右键，即可将钥匙与该飞船配对并上锁；之后每次用它右键点击飞船，都可以切换上锁或解锁状态。飞船上锁后，只有物品栏中带着对应钥匙的人才能登船或打开货舱（手持钥匙潜行时可打开货舱）。上锁时，不带钥匙的乘客会被赶下船。一艘已配对的飞船不能再绑定其他钥匙。上锁无法保护船体：即使钥匙丢失，飞船仍然可以被摧毁。携带已配对的钥匙时，只要客户端知道飞船的位置（追踪范围最多 160 格），屏幕上就会用黄色边框标记该飞船，即使它处于隐形状态也是如此。

乘客坐在座位上时不会受伤，受到的攻击会改由船体承受（只有/kill和虚空伤害仍然有效）。因此，攻击驾驶员的生物会转而攻击飞船：近战生物靠近飞船后会攻击船体，箭矢和爆炸也会伤害船体（与往常一样，生物不会以创造模式的玩家为目标）。船体被摧毁时，乘客会先被弹出，随后飞船爆炸（威力约等于 TNT；只有在mobGriefing时才会破坏方块），爆炸仍有可能伤到乘客。之后会掉落飞船物品和货舱物品（创造模式下只掉落货舱物品）。

碰撞。擦过墙壁、轻微碰撞和正常着陆（即使以最大下降速度着陆）都不会造成伤害。以约 8 米/秒的速度撞上障碍物，或以 15 米/秒的速度向下撞击时，受到的伤害会逐渐增加；每次撞击最多损失30% 的船体耐久（例如全速撞墙或从高空坠毁）。护盾也能吸收撞击伤害。

前灯。Minecraft 没有会移动的光源，因此服务器会在船体内和船头前方放置隐形的原版光照方块（minecraft:light，亮度等级 15），并在飞船驶过后移除。飞船与光源相距 2 格后，光源才会移动，且最多每 4 tick 移动一次。速度超过 10 米/秒时，只会使用船头前方的光源。隐形状态下的飞船不会发光。

货舱。共 54 格。靠近船体掉落的物品会像被玩家捡起一样自动收集。

水下。所有速度都会减慢：推力和转向速度减半，无人机飞行速度也减半。

熔岩。推力和转向速度降至 30%，飞船会更快减速，并会在动力失效时缓慢下沉。

传送门和星际之门。飞船会作为一个整体穿越：乘客仍留在座位上，货舱、能量和船体耐久都会保留，飞船也会沿新的航向保持原有速度。已坐在座位上的乘客和船体部件不会单独穿越。使用Just Stargate Mod时，同一维度中的星际之门也能正常使用（JSG 为可选模组；此联动通过反射实现）。飞入星门的接收端或咔哇嗖（kawoosh）会摧毁飞船，和其他实体一样。

飞船使用 Forge Energy（FE）；所有功能都会消耗能量，创造模式下也不例外。

如果能量不足以吸收一次攻击，护盾就会崩溃，攻击也会穿透护盾。能量耗尽时，所有系统都会失效（护盾、隐形、灯光、驱动和控制），飞船也会坠毁。HUD 会显示电量、能耗或充能功率，以及剩余时间；电量低于 10% 时，指示会闪烁并响起警报。

闪电每道闪电可为飞船充入相当于容量 20% 的能量（每道闪电只计一次），且不会造成伤害。雷暴期间，位于无遮挡露天处的飞船会像小型避雷针一样吸引 32 格范围内的自然闪电，无论飞船在空中还是着陆。

可从任意一侧接收 Forge Energy（通用机械、热力、沉浸工程等；通用机械的焦耳会自动换算）。飞船着陆后，船体正下方的所有充能垫都会为其充能，每个充能垫每 tick 提供 10,000 FE；着陆区域越大，充能速度越快。

默认情况下，充能垫不需要电力：没有接入能量线缆时，每个充能垫也会自行以每 tick 2,500 FE 的速度充能（空飞船在一个充能垫上充满大约需要 20 分钟）。如果接入线缆，充能垫会优先使用线缆提供的能量，并以全速充能。服务器配置中启用chargingPad.requirePower = true后，充能垫才会使用线缆提供的能量进行充能。

电池充满后，充能垫会消耗相同的能量来修复船体，但修复所需能量要多得多：将船体从零修复到满需要 1.2 亿 FE（chargingPad.fullRepairEnergy，相当于一块满电电池的两倍；设为 0 可关闭修复）。

• 关闭（熄灭） → 已通电（跑道灯亮起） → 充能中（明亮，亮度等级 15）
• 着陆箭头指向玩家放置充能垫时面朝的方向
• 比较器会读取当前正在充能的飞船电量

会在自身上方建造一艘飞船，船头朝向玩家放置投影仪时面对的方向。发送红石脉冲即可启动一次建造（建造过程中收到的脉冲无效；每次建造之间要断开信号，例如使用按钮）。也可以右键点击投影仪顶部并确认提示。上方必须有足够空间（约 9 格长、3 格宽、3 格高）；空间被挡住时，建造会暂停。

• 建造需要 10 分钟。尚未完成的飞船会显示为发光轮廓，亮度逐渐增强，并有火花沿船体扫描；此时无法登船，也不会受到伤害。破坏投影仪会移除飞船。
• 投影仪顶部的八盏灯会依次变黄（从船头开始，顺时针亮起），表示建造进度。
• 默认情况下，建造不需要电力。服务器配置中启用projector.requirePower = true后，每艘飞船都需要从线缆获取 1.2 亿 FE（在建造过程中每 tick 提供 10,000 FE；能量不足时建造会暂停，轮廓也会消失，直到能量再次到达）。
• 建造完成的飞船初始能量为 20%。