generic-henshin

https://modrinth.com/mod/mob-player-animator-neo

你必须下载此模组，才能确保怪物型骑士能够正确使用骑士踢和骑士拳。

 

假面骑士工艺通用变身附属模组（NeoForge 1.21.1）

这是 假面骑士工艺 的附属模组。它在完整保留原版模组原生变身机制的同时，增加了大量额外功能。

1. 形态系统

• 右键点击形态道具即可记住该形态。
• Ctrl+V：在已记住的形态之间快速切换。
• 切换形态不消耗任何道具。
• 滚动鼠标滚轮可预览形态列表。
• 支持“松开按键确认切换”模式。
• 防连按冷却，防止误触。
• 自动适配 KRC 腰带的形态列表和基础形态。

2. 武器系统

• H：快速变身 / 切换形态。
• O：保存当前形态的武器。
• 保存后可通过按键或命令召唤已分配的武器。
• 每个形态拥有独立的武器映射，不会误装备其他形态的武器。
• 可自定义武器映射配置文件。
• 召唤 / 脱下骑士装甲套装。
• 自动装备全套装甲；脱甲后归还至物品栏。

3. 骑士踢 / 骑士拳

• Shift+C：切换骑士踢模式。
• V：触发骑士踢。
• 支持触发骑士拳。
• 复用 KRC 原生动画、伤害值和冷却时间。
• 本地冷却指示器及跨玩家状态同步。

4. 召唤骑士实体技能

• 召唤的骑士实体（RiderSummonEntity、LegendarySummonEntity、CompleteSummonEntity、GrandSummonEntity、DecadeArmorExAidEntity、ParaDXSummonEntity、ZeinSummonEntity 等）可以执行骑士踢和骑士拳。
• 使敌对骑士怪物能够使用拳脚技能。
• 怪物骑士技能全局开关。
• 可配置触发范围、生命值阈值、公共冷却和内部技能冷却。
• 怪物施放这些技能时具有摔落伤害保护。
• 客户端播放技能动画，带 JSON 解析缓存优化。

5. 吃瘪 / “被击败”系统

• 当玩家生命值低于可配置阈值时触发吃瘪状态。
• 可调整爆炸强度和击退力度。
• 吃瘪触发后有冷却期。
• 吃瘪后一段时间内装备被锁定。
• 死亡、重进世界和玩家登出时进行状态清理。
• 创造模式免疫。
• 可配置吃瘪台词和变身语音。
• 可调整台词播放概率、显示时长和重复间隔。

6. 形态禁用 / 移除锁

• 定期清除 KRC 原生的形态禁用和超时效果。
• 可配置清除间隔。
• 对不兼容场景可禁用。

7. HUD

• 技能图标 HUD 覆盖层。
• 左下角形态预览 HUD。
• HUD 总开关和刷新频率配置。
• 新增道具滚轮 HUD：透明背景，显示道具图标、名称和序号。

8. 命令系统

• /generic_henshin next — 切换到下一个已存形态
• /generic_henshin save — 保存当前武器映射
• /generic_henshin list — 列出可用形态
• /generic_henshin kickmode — 切换骑士踢模式
• /generic_henshin kick — 手动触发骑士踢
• /generic_henshin punch — 手动触发骑士拳
• /generic_henshin reload — 重载模组配置
• /generic_henshin diagnose — 诊断假面骑士工艺兼容状态

9. KRC 兼容层

• 自动检测是否安装了假面骑士工艺。
• 基于反射的适配，支持 KRC 腰带、形态道具、能力条、冷却和动画。
• 缓存基础腰带形态列表，减少重复反射调用。

10. 右键道具滚轮（新功能）

• Shift+Z：将主手可右键使用的道具保存到当前活动形态。
• 按住 Shift+V：进入道具选择模式。
• 滚动鼠标滚轮：在已保存道具间循环切换。
• 松开 Shift+V：激活当前选中的已保存道具。
• 每个形态可存储多个道具。
• 同一道具重复保存会覆盖之前的条目。
• 每个已保存道具拥有独立冷却（默认：10 秒）。
• 使用已保存道具时不会消耗或复制真实物品栏中的道具。

11. 删除已保存道具（新功能）

• 空手时按住 Shift+Z：进入删除选择模式。
• 滚动鼠标滚轮：选择要删除的已保存条目。
• 松开 Shift+Z：移除所选已保存道具条目。
• HUD 显示删除模式标记，防止误删。

12. 性能优化（版本 0.1.110 / 0.1.112）

• 缓存召唤骑士实体的类名检查，以减少每 tick 的反射开销。
• 缓存腰带基础形态列表。
• 实体卸载 / 玩家登出时自动清理映射，减轻内存泄漏。
• 对核心武器切换和形态切换逻辑零修改。

13. 配置文件

config/generic_henshin/settings.json      # 主通用变身设置
config/generic_henshin_item_wheel.json    # 道具滚轮相关设置

道具滚轮配置项：

• enabled：右键道具滚轮功能总开关
• cooldownTicks：每个已保存道具的独立冷却（200 ticks = 10 秒）
• maxSavedPerForm：每个形态最多保存道具数量（范围：1-54）