Zipir Havaci

================================================================
  ZİPİRHAVACI 模组 
  机械师指南 | 按键绑定 | 卷轴位置 | 附魔保护

───────────────────────────────────────────────────────────────
  ⚡ 什么是 ZİPİRHAVACI 模组？
───────────────────────────────────────────────────────────────

ZipirHavaci 是一个实验性项目，源于个人好奇心，旨在让 Minecraft 静态的战斗系统更加动态化和物理响应式。该模组包含多个原型，包括动能手套、基于盾牌的牵引机制，以及基于实时重量计算的移动限制。

我在开发这个项目时的首要目标是确保每个动作都有物理后果和代价，而不是依赖“魔法”按钮。

该项目目前已达到预期的核心功能，并处于开放式休眠状态。虽然未来是否会推出新更新尚不确定，但 ZipirHavaci 作为一个爱好项目，专注于性能和原创机制。

🛠️ 依赖项
为确保 ZipirHavaci 流畅运行且所有动画正确渲染，需要以下依赖：

 GeckoLib
本模组利用 GeckoLib 的高级动画引擎。为避免视觉故障或崩溃，请确保使用指定版本或更高版本。

所需版本：4.4.9 或更高

平台：Forge

下载：

---

  

🎮 按键绑定与控制

• [ 右键 ] → 发射手套
• [ R ] → 切换模式（拉取或推送模式）
• [ Shift + 左键 ] → 开始装填（按住潜行 3.5 秒 — 松开则取消！）
• [ 绑定：超级技能 ] → 触发分级的超级技能冲击波
• [ V ] → 激活灵魂绑定（将盾牌拉向自己）
• [ 绑定：光环技能 ] → 激活/释放光环场

（在控制设置 → ZipirHavaci 中绑定自定义技能）

---

🪖 重量系统 — 工作原理

每次发射手套时，你的护甲重量直接影响性能。
公式： 总重量 = 护甲值 + 护甲韧性 （上限为 60）

重量（0–60）	发射倍率	伤害倍率
0（无护甲）	×1.00	×1.00
30（中等护甲）	×0.90	×1.025
60（满护甲）	×0.80	×1.05

• 更重的护甲 = 自身发射更慢，但对敌人的击退更强。
• 更轻的配装 = 飞行更快，但推力更弱。
• 空副手 = +15% 威力加成！

过热（重甲失效）：
在推送模式下，如果你已快速坠落（Y 速度 < -1.9）且总重量超过 46，手套将过热。这是因为角色对手套的推力来说太重，而非标准发射故障。会发生哑火：出现烟雾但不会发射。

---

💠 手套 — 超级技能等级

超级技能接受 1–5 级。更高等级消耗更多弹药并产生更大的效果范围。

等级	弹药消耗	基础威力	范围
1	2 弹药	4.5	6.1 格
2	3 弹药	6.0	7.7 格
3	4 弹药	7.5	9.3 格
4	5 弹药	9.0	10.9 格
5	6 弹药	16.0	12.5 格

  拉取技能 5 级：
    → 真空锥将前方敌人吸入，并将后方敌人推开
    → 依等级覆盖 80–110° 锥形区域
    → 方块显示裂纹动画 10 秒（仅视觉，无破坏）
    → 青色漏斗粒子效果

  推送技能 5 级：
    → 3 波冲击波，每环间隔 100 毫秒
    → 橙色圆圈 + 白色边框 + 旋转光环
    → 若向下瞄准且等级 ≥ 3 → 地面爆裂
       （全方位爆炸，木门碎裂，铁门震动）

---

  🔋 手套弹药与装填

---

手套有 6 个弹药槽位（内部使用值：0–6）。

  普通射击：   消耗 1 弹药，20 刻冷却
  超级技能：   消耗（等级 + 1）弹药

过热（使用 5 发弹药时）：
  射击后 500 毫秒触发延迟过热：
  → 开始 6 秒（120 刻）冷却
  → 播放冷却动画和音效

装填：
  冷却结束后：
  1. 过热标志清除
  2. 按住 Shift + 左键
  3. 持续潜行 70 刻（约 3.5 秒）
     （松开潜行取消装填 — 弹药保持 0！）
  4. 成功后 → 装载 3 发弹药

  进度条显示在动作栏上，作为 15 格进度显示。

燃料：
  每次射击消耗背包中的 1 个火药。
  没有火药时，射击被阻止并显示警告消息。

---

  🔗 灵魂绑定技能

---

将盾牌扔向墙壁。激活灵魂绑定 — 你会像被钩爪一样拉向盾牌。

分步说明：
  1. 双手不要持有盾牌
  2. 按下灵魂绑定按键
  3. 盾牌必须在 25 格以内
  4. 背包中至少需要 1 个灵魂沙（会被消耗）
  5. 牵引开始 — 你以旁观者模式飞向盾牌
  6. 当距离盾牌 2 格时自动停止
  7. 恢复之前的游戏模式

灵魂代价（每次使用）：
  • 0.5 点生命值（魔法伤害）
  • 3 秒凋零效果
  • 消耗 1 个灵魂沙

牵引停止条件：
  • 盾牌被摧毁或移除
  • 你已在盾牌 2 格范围内
  • 前方有不可破坏方块（基岩、破坏速度 < 0 或 ≥ 50）

冷却时间：8 秒

牵引结束后：
  • 5 秒缓慢 + 虚弱（灵魂疲劳）
  • 若牵引绳断裂：烟雾 + 链条断裂音效

  ⚠ 你必须先学习灵魂绑定 — 需先阅读灵魂绑定卷轴
  技能才能生效。

---

  ⚡ 光环技能

---

通过被闪电击中（闪电校准）获得光环等级。
你的光环等级从 0 开始，每次被击中后提升。

光环激活期间：
  • 一个动态动能场环绕着你（每 2 刻扫描一次）
  • 没有光环的敌人受到范围击退和伤害
  • 与另一个光环玩家碰撞触发平衡的智能碰撞
    （等力交换 — 双方都不会获得免费推力）

再次按下光环（取消激活）：
  → 释放冲击波 — 附近敌人被弹飞

连击系统：
  在 5 秒内多次击中同一目标可累积连击。
  对同一目标的两次命中之间的最小间隔：800 毫秒。

---

  ☄️ 流星冲击技能

---

装备盾牌。格挡状态下高速坠落或飞行。
随着充能累积，你周围会形成增强的视觉光环。

充能条件：
  • 格挡状态下速度 > 1.25 米/刻 → 每刻 +3 充能
  • 格挡状态自由落体 50 刻以上 → 每刻 +1 充能
  • 充能上限：50

音爆：
  充能达到 50 时，播放雷鸣般音爆声 — 你已满功率。

冲击触发条件：
  • 充能 ≥ 35
  • 通过多点射线检测检测到前方有固体表面
  • 正在使用盾牌

1. 攻击者（自身）机制

---

自身伤害与护甲重量惩罚：
当玩家撞击地面时，会根据自身速度和护甲重量承受自伤。

• 基础原始伤害：(冲击速度 * 4.5) * 0.90
• 重量惩罚：较重的护甲在撞击时伤害使用者。攻击者的总护甲韧性 * 0.15 直接加到原始伤害中。
• 盾牌伤害：用于触发冲击的盾牌将损失最大耐久度的 10%（最低损失 15 点耐久）。

自身伤害减免（上限 85%）：
攻击者可通过附魔和效果减少自身伤害：

• 摔落缓冲：满效率时减少 30% 伤害（等级 / 16 * 0.30）。
• 爆炸保护：满效率时减少 44% 伤害（等级 / 16 * 0.44）。
• 保护：满效率时减少 18% 伤害（等级 / 16 * 0.18）。
• 火焰保护：满效率时减少 30% 伤害（等级 / 16 * 0.30）。
• 抗火效果：额外提供固定 6% 伤害减免。

防致命保护：
该技能尽量不直接杀死使用者：

• 最大可能的自身伤害硬性上限为 16.0 生命值（8 颗心）。
• 若玩家生命值高于 10 点（5 颗心），伤害将使其至少保留 4 点生命值（2 颗心）。
• 若玩家生命值高于 5 点（2.5 颗心），伤害将使其至少保留 2 点生命值（1 颗心）。
• 冲击后减益：落地后攻击者获得虚弱 IV（4 秒）、缓慢 VI（1.75 秒）和反胃 V（1.5 秒）。

2. 攻击者进攻缩放

攻击者的护甲韧性实际上提升了其对目标的进攻威力：

• 技能熟练度：随攻击者韧性缩放（0.5 + (韧性 * 0.05)）。作为基础伤害倍率，上限为 1.2 倍。
• 重量加成：较重的护甲打击更重。提供额外倍率 (1.0 + (韧性 * 0.06))。

3. 目标（受害者）机制

目标承受的伤害：

• 基础冲击伤害：(冲击速度 * 22.0) * 技能熟练度
• 真实伤害：目标承受最大生命值 8% 的真实伤害。该伤害随其与爆炸中心的距离缩放（更近 = 更多真实伤害）。
• 距离衰减：在玩家 1.2 格范围内伤害为 100%，在爆炸半径边缘线性衰减至 0%。

目标伤害减免（上限 80%）：
目标可通过护甲韧性、附魔和特殊头盔进行防御：

• 护甲韧性：每点韧性提供 2.5% 伤害减免。
• 爆炸保护：满效率时减少 46% 伤害（等级 / 16 * 0.46）。
• 保护：满效率时减少 18% 伤害（等级 / 16 * 0.18）。

特殊头盔机制（凋灵、苦力怕、海龟）：
佩戴特定头颅可提供针对流星冲击的独特防御修正：

• 苦力怕头颅：提供固定 25% 伤害减免。
• 海龟壳：提供固定 18% 伤害减免。
• 凋灵骷髅头颅：提供固定 15% 伤害减免。
    * 凋灵生存增益：佩戴此头盔被击中时，目标获得抗性提升 I 和生命恢复 II，持续 8 秒。此效果有 5 分钟冷却。

海龟壳“安全屋”集成：
若目标佩戴海龟壳且来袭伤害具有致命危险，会触发特殊保护机制：

• 触发条件：最终计算伤害（含真实伤害）超过 14.0 生命值（7 颗心）。
• 效果：伤害被硬性限制在 14.0 生命值。
• 获得增益：生命恢复 I（3 秒）、抗性提升 VIII（4 秒，几乎免疫伤害）和海豚的恩惠 II（10 秒用于逃脱）。
• 冷却：此集成有 5 分钟冷却。

耐久度损伤与击退抗性：

• 护甲破损：目标护甲承受严重耐久损伤。若其韧性低于 2.0，所有护甲部位损失最大耐久度的 18%。若韧性高于 2.0，损失最大耐久度的 10%。
• 击退：目标的击退因爆炸保护（每级减少 5%）和标准保护（每级减少 3%）而降低。

目标减益：
被冲击击中的目标承受：

• 缓慢 IV（1.25 秒）
• 缓慢 II（2.25 秒）
• 虚弱 II（1.5 秒）
• 反胃 I（1 秒）

4. 冷却与世界机制

• 充能：该技能需要持有盾牌。最大充能为 50 刻。快速坠落或自由落体会加速充能。
• 冷却：
    * 短冷却：3.5 秒（充能在半空中取消但已达高速时触发）。
    * 长冷却：25 秒（成功撞击地面时触发）。
• 活跃弹坑：弹坑持续 20 秒。对站在其中的实体每秒造成 0.25 持续伤害（弹坑所有者仅受 0.12 伤害）。
• 载具与盾牌：附近的矿车、船和被投掷的盾牌会根据冲击速度被猛烈推开。
• 破门冲击：3 格范围内的木门被完全炸离铰链。铁门（或 15 格内的门）会剧烈震动。

卷轴：
  你必须阅读流星冲击卷轴后才能激活此技能。
  学习后，卷轴被消耗且无法重复使用。

---

  📜 卷轴 — 获取位置

---

  | 卷轴 | 位置 | 概率 |
| :--- | :--- | :--- |
| 灵魂绑定卷轴 | 下界要塞宝箱战利品 | 9% |
| 流星冲击卷轴 | 远古城市宝箱战利品 | 15% |

  两种卷轴均通过 Forge 的 loot_table_id 系统注入现有战利品表 — 原始表不会被修改。

  ⚠ 卷轴一经阅读即被永久消耗。
  阅读已知卷轴会被阻止并显示警告消息。

═══════════════════════════════════════
           核心棒
═══════════════════════════════════════
 
核心棒是一种多功能红石组件，将六种不同逻辑模式集成于单个方块中。无需构建重复结构，右键切换模式即可完成任务。
 
 
───────────────────────────────────────
 模式
───────────────────────────────────────
 
  中继器  — 经典延时门。以 1–6 刻延迟转发输入的信号。
 
  脉冲     — 振荡器。在设定刻数间隔内产生闪烁输出，只要存在输入信号。
 
  反相器  — 非门。无输入时输出信号；有信号到达时切断输出。
 
  锁存器  — 切换记忆。在每个上升沿翻转状态并保持，即使区块重载也如此。
 
  计数器  — 每 N 个上升沿输出一次。N 可在 1 至 6 间配置。
 
  与门     — 仅当两个不同面同时收到信号时输出。
 
 
───────────────────────────────────────
 控制
───────────────────────────────────────
 
  Shift + 空手 + 右键  →  循环切换模式（中继器 → 脉冲 →
                             反相器 → 锁存器 → 计数器 → 与门 → ...）
 
  右键（无手持物品）          →  增加延时 / 计数器目标（1–6）
                               （锁存器和与门模式不可用）
 
 
───────────────────────────────────────
 放置与信号流向
───────────────────────────────────────
 
  • 方块面向你放置时注视的方向。
  • 输入从 FACING 的对面接收。
  • 输出发送到除输入面外的所有其他面。
  • 在与门模式中，第二个输入来自相对 FACING 的顺时针面（例如，面向北方时，第二个输入来自东方）。
  • 输出信号强度始终为 15。
 
 
───────────────────────────────────────
 技术说明
───────────────────────────────────────
 
  • 锁存器和计数器模式通过 NBT 数据持久化状态。
    状态在区块重载和世界重启后保持不变。
  • 该方块永远不会向其输入面回传信号。
  • 延时调度通过服务端刻调度处理。

 

---

  ⚙️ 兼容性说明

---

  • 我的世界：1.20.x（Forge）
  • 模组添加的门：视为铁门类（仅震动，永不碎裂）
  • 原版木门：近距离爆炸中碎裂
  • 原版铁门：始终仅震动
  • 模组护甲：自动纳入重量计算（上限：60）
  • 多人游戏：所有计算在服务端运行 — 客户端接收数据包

---

  ❓ 常见问题

---

问：我找到了灵魂绑定卷轴，但技能不生效。
答：确保你没有持有盾牌。该技能需要双手空闲且背包中有灵魂沙。

问：手套无法发射。
答：首先，确保背包中有火药作为燃料。
   如果看到“过重”或“过热”消息，说明你试图在重甲状态下坠落时使用推送模式。装置无法抵抗那么大的动能，会暂时失效。

问：装填（Shift + 左键）如何工作？
答：手套有两种补充弹药的方式：
   1. 自动充能：完全重置需要 6 秒。此计时器激活期间无法手动装填。
   2. 手动装填：需要 3.5 秒，向当前数量添加 +3 弹药（最大 6）。

问：何时应使用手动装填？
答：要策略性地使用。由于最大容量为 6，超出部分的弹药会被浪费。例如，若有 4 发弹药时装填，只会获得 2 发，“浪费”了装填包中的 1 发。弹药剩余 3 发或更少时装填效率最高。

问：为什么超级技能 5 级消耗全部 6 发弹药？
答：5 级消耗等级+1=6 发弹药。这会完全耗尽手套 — 这是有意设计。过热和装填会紧随其后。

问：我使用了灵魂绑定，现在移动非常缓慢。
答：这是预期的灵魂疲劳效果。
   缓慢 + 虚弱持续 5 秒，然后清除。

问：我的光环无法激活 — 显示等级为 0。
答：光环需要被闪电击中才能获得等级。
   在雷暴期间站在室外或使用避雷针。
   等级 0 时，光环没有力量激活。

问：我被流星冲击击中但几乎没掉血。
答：爆炸保护对冲击效果极佳。
   全身满级爆炸保护 IV 可使冲击伤害降低高达 46%，还可叠加其他
   附魔和特殊头盔效果。

问：流星冲击技能会破坏方块吗？
答：不会。裂纹和移位的方块碎片纯属视觉效果。
   展示实体制造了地形破碎的幻象；
   所有方块保持完整。视觉效果在 20 秒后清除。

 

问：为什么能量载体无法从红石粉接收能量？
答：能量载体按设计不接受红石粉的能量。
   但是，红石粉可以从能量载体接收能量。
   这是有意为之，由于信号传播内部工作方式的技术原因而实现。

───────────────────────────────────────────────────────────────
  🔍 发现：配方笔记
───────────────────────────────────────────────────────────────

在 ZipirHavaci 中取得进展需要的不仅仅是原材料；
还需要知识。高级组件和特殊能力的蓝图散落在世界各地。

• 寻找配方：
  在村庄宝箱（武器匠、盔甲匠、神庙等）和其他
  战利品地点有 8% 的几率找到“配方笔记”。

• 如何学习：
  手持配方笔记右键即可
  永久解锁该特定合成配方。

密切关注那些村庄宝箱 — 知识与铁和金一样珍贵。

================================================================
                      无名氏