generic-henshin

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

You must download this to ensure monster‑type riders can use Rider Kicks and Rider Punches properly.

Generic Henshin Addon for Kamen Rider Craft (NeoForge 1.21.1)

This is an add‑on mod for Kamen Rider Craft. It fully preserves the original mod’s native henshin mechanics while adding extensive extra features.

1. Form System

• Right‑click a form item to memorize that form.
• Ctrl+V: Quick‑switch between memorized forms.
• Form switching consumes no items.
• Mouse wheel scroll to preview the form list.
• Support for release‑key‑to‑confirm switching mode.
• Anti‑spam cooldown to prevent accidental triggers.
• Automatically adapts to KRC belt form lists and base forms.

2. Weapon System

• H: Quick‑henshin / form switch.
• O: Save weapons for the current form.
• Summon assigned weapons via hotkeys or commands after saving.
• Independent weapon mapping per form; weapons from other forms will not be mistakenly equipped.
• Customizable weapon mapping config file.
• Summon / unequip rider armor sets.
• Auto‑equip full armor set; unequip and return armor to inventory.

3. Rider Kick / Rider Punch

• Shift+C: Toggle Rider Kick mode.
• V: Trigger Rider Kick.
• Rider Punch trigger supported.
• Reuses native KRC animations, damage values and cooldowns.
• Local cooldown indicator and cross‑player state synchronization.

4. Summoned Rider Entity Skills

• Summoned rider entities (RiderSummonEntity, LegendarySummonEntity, CompleteSummonEntity, GrandSummonEntity, DecadeArmorExAidEntity, ParaDXSummonEntity, ZeinSummonEntity, etc.) can execute Rider Kick and Rider Punch.
• Enable hostile rider mobs to perform kick‑punch skills.
• Global toggle for mob rider skills.
• Configurable trigger range, HP threshold, public cooldown and internal skill cooldown.
• Fall damage protection when mobs cast these skills.
• Client‑side‑played skill animations with JSON parsing cache optimization.

5. Defeat / "Getting Wrecked" System

• Trigger defeat state when player HP drops below configurable threshold.
• Adjustable explosion intensity and knockback strength.
• Cooldown period after defeat triggers.
• Equipment lock‑out for a duration after defeat.
• State cleanup on death, world re‑entry and player logout.
• Creative mode immunity.
• Configurable defeat lines and henshin voice‑lines.
• Tunable line‑play probability, display duration and repeat‑interval.

6. Form Ban / Removal Lock

• Periodically clear KRC‑native form ban and timeout effects.
• Configurable clearing interval.
• Can be disabled for incompatible scenarios.

7. HUD

• Skill‑icon HUD overlay.
• Bottom‑left corner form preview HUD.
• Master HUD toggle and refresh‑rate configuration.
• New item‑wheel HUD: transparent background, displays item icon, name and index number.

8. Command System

• /generic_henshin next — Switch to next stored form
• /generic_henshin save — Save current weapon mapping
• /generic_henshin list — List available forms
• /generic_henshin kickmode — Toggle Rider Kick mode
• /generic_henshin kick — Manually trigger Rider Kick
• /generic_henshin punch — Manually trigger Rider Punch
• /generic_henshin reload — Reload mod configuration
• /generic_henshin diagnose — Diagnose Kamen Rider Craft compatibility status

9. KRC Compatibility Layer

• Auto‑detect whether Kamen Rider Craft is installed.
• Reflection‑based adaptation for KRC belts, form‑items, ability bars, cooldowns and animations.
• Cache base belt‑form lists to reduce repeated reflection calls.

10. Right‑Click Item Wheel (New Feature)

• Shift+Z: Save main‑hand usable right‑click item to current active form.
• Hold Shift+V: Enter item‑selection mode.
• Mouse wheel scroll: cycle through saved items.
• Release Shift+V: Activate currently selected saved item.
• Multiple items can be stored per individual form.
• Duplicate saves of the same item overwrite previous entries.
• Independent cooldown for each saved item (default: 10 seconds).
• Saved items will not consume or duplicate real inventory items on use.

11. Delete Saved Items (New Feature)

• Hold Shift+Z with empty hands: enter delete‑selection mode.
• Mouse wheel scroll: pick which saved entry to erase.
• Release Shift+Z: Remove selected saved‑item entry.
• HUD shows delete‑mode marker to prevent accidental erasure.

12. Performance Optimizations (Version 0.1.110 / 0.1.112)

• Cached class‑name checks for summoned rider entities to cut per‑tick reflection overhead.
• Cached belt base‑form lists.
• Automatic map cleanup on entity unload / player logout to mitigate memory leaks.
• Zero modification to core weapon‑switching and form‑switching logic.

13. Configuration Files

config/generic_henshin/settings.json      # Main generic‑henshin settings
config/generic_henshin_item_wheel.json    # Item‑wheel related settings

Item‑wheel config keys:

• enabled: Global toggle for right‑click item‑wheel feature
• cooldownTicks: Per‑saved‑item cooldown (200 ticks = 10 seconds)
• maxSavedPerForm: Maximum number of saved items per form (range: 1‑54)

Would you like to use work task mode, which can polish this mod introduction into mod‑page format, sort out feature highlights and write brief changelog excerpts?

这是一个 **Kamen Rider Craft（假面骑士工艺）** 的 NeoForge 1.21.1 附属模组。
它在完整保留原版通用变身功能的基础上，。

---

一、形态系统

• 右键使用形态道具后，自动记住该形态。
• Ctrl+V：一键切换已记住的形态。
• 切换形态不消耗道具。
• 支持滚动滚轮预览形态列表。
• 支持“松开按键确认切换”模式。
• 切换有连按保护冷却，防止误触。
• 自动适配 KRC 腰带的形态列表和基础形态。

二、武器系统

• H 键：快速变身/切换形态。
• O 键：保存当前形态的武器。
• 保存后可通过按键/命令随时召唤当前形态的对应武器。
• 每个形态拥有独立的武器映射，不会拿错其他形态的武器。
• 支持武器映射配置文件。
• 支持召唤/脱下对应骑士装甲。
• 支持自动装备全套装甲、脱甲回背包。

三、骑士踢 / 骑士拳

• Shift+C：开关通用骑士踢模式。
• V：触发骑士踢。
• 支持骑士拳触发。
• 复用 KRC 原生骑士踢/拳的动画、伤害和冷却。
• 有本地冷却显示和状态同步。

四、怪物骑士技能

• 召唤出来的骑士（RiderSummonEntity、LegendarySummonEntity、CompleteSummonEntity、GrandSummonEntity、DecadeArmorExAidEntity、ParaDXSummonEntity、ZeinSummonEntity 等）也能使用骑士踢/骑士拳。
• 让怪物也能使用骑士踢/骑士拳。
• 支持怪物技能总开关。
• 支持触发距离、血量阈值、冷却、内部冷却配置。
• 怪物使用技能时带摔落保护。
• 技能动画通过客户端播放，并有 JSON 解析缓存优化。

五、吃瘪系统

• 玩家血量低于阈值时触发“吃瘪”。
• 可配置爆炸强度、击退强度。
• 吃瘪后进入冷却。
• 吃瘪后装备锁定一段时间。
• 死亡、重进、登出都有对应清理。
• 创造模式可免疫。
• 支持吃瘪台词和变身台词。
• 台词概率、显示时长、重发间隔均可配置。

六、形态禁用 / 移除锁

• 自动清除 KRC 的形态禁止/超时效果。
• 清除间隔可配置。
• 对不适用情况可以关闭。

七、HUD

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

八、命令系统

• /generic_henshin next：切换到下一个形态。
• /generic_henshin save：保存当前武器。
• /generic_henshin list：列出可用形态。
• /generic_henshin kickmode：开关骑士踢模式。
• /generic_henshin kick：触发骑士踢。
• /generic_henshin punch：触发骑士拳。
• /generic_henshin reload：重载配置。
• /generic_henshin diagnose：诊断 KRC 兼容状态。

九、KRC 兼容层

• 自动检测 KRC 是否安装。
• 反射适配 KRC 腰带、形态道具、能力条、冷却、动画。
• 缓存腰带基础形态列表，减少重复反射。

十、右键道具滚轮（新增）

• Shift+Z：把主手拿着的可右键使用道具保存到当前形态。
• 按住 Shift+V：进入道具选择模式。
• 滚动滚轮：切换已保存的道具。
• 松开 Shift+V：自动使用当前选中的道具。
• 每个形态可以保存多个道具。
• 同一个道具重复保存会覆盖旧记录。
• 每个保存道具都有独立冷却，默认 10 秒。
• 使用时不消耗/不复制真实物品。

十一、删除保存道具（新增）

• 空手时按住 Shift+Z：进入删除选择模式。
• 滚动滚轮：选择要删除的道具。
• 松开 Shift+Z：删除当前选中的道具。
• HUD 会显示“删除”标识，避免误删。

十二、性能优化（0.1.110/0.1.112 新增）

• 怪物骑士类名判断缓存，减少每 tick 反射开销。
• 腰带基础形态列表缓存。
• 实体卸载/玩家登出时自动清理 Map，防止内存泄漏。
• 不改变武器/形态切换的核心逻辑。

十三、配置

配置文件：

config/generic\_henshin/settings.json （原版通用变身配置）  
config/generic\_henshin\_item\_wheel.json （道具滚轮配置）  

道具滚轮配置项：

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