CustomNPC x MMNM 兼容

Mine Mine no Mi NPC 兼容模组

赋予任何 CustomNPCs 生物完整的 Mine Mine no Mi 能力 —— 无需编码。

MMNM NPC Compat 是 Mine Mine no Mi（及其附属模组）与 CustomNPCs 之间的桥梁模组，允许你将任何指定名称的 NPC 配置为功能齐全的海贼王 Boss，具备基于阶段的技能轮换、永久霸气被动、战斗条件，以及——自 1.0.5 版本起——实时 JavaScript 脚本集成。所有配置均通过简单的 JSON 文件完成。

---

✨ 特性

• JSON 驱动配置 —— 在 config/mmnm_npc_compat/ 目录中放置一个文件，任何名称匹配的 NPC 都将成为 Boss
• 完整技能支持 —— 兼容 Mine Mine no Mi、cartaddon、fruitreworks 及任何 MMNM 兼容附属模组中的即时、蓄力及持续型技能
• 阶段系统 —— 在特定生命值阈值解锁技能（例如仅在生命值低于 40% 时使用终极技能）
• 永久被动 —— 始终保持武装色霸气硬化、自然系免疫、动物系变身或任何增益效果
• 战斗条件 —— 根据玩家距离、附近玩家数量和生命值范围控制技能使用
• 每技能独立冷却 —— 用你自定义的计时（毫秒）取代 MMNM 仅限玩家的冷却系统
• 生成间隔 —— startDelayMs 防止所有技能在生成时同时触发
• 霸气条支持 —— 自动为 NPC Boss 提供最大霸气经验值，确保霸气条永不阻碍其技能释放
• 目标持久性 —— 若 CustomNPCs 在其自身 AI 循环中清除技能目标，则重新注入
• 强制蓄力/持续 —— forceChargeDuration 和 forceContinuousDuration 用于带有玩家专用使用限制的技能
• CustomNPCs 脚本集成 （1.0.5 新特性） —— 你的 NPC 的 JS 脚本将在每次技能触发或结束时收到 onMMNMAbility(event) 和 onMMNMAbilityEnd(event) 回调，让你无需接触 Java 即可动态调整伤害、触发对话或对任何阶段变化做出反应

---

📦 前置要求

模组	版本
Minecraft Forge	1.16.5
Mine Mine no Mi	0.10.10+
CustomNPCs	1.16.5

兼容：cartaddon、fruitreworks、awakenawakennomi、fightingstyles 以及任何在 MMNM 的 ModRegistries.ABILITIES 注册表中注册技能的模组。

CustomNPCs 对于脚本集成是可选的——若其不存在，所有回调将静默无操作，模组其余功能正常运作。

---

⚙️ 快速设置

1. 将 JAR 文件放入你的 mods/ 文件夹
2. 启动服务器一次以生成配置文件夹
3. 在 config/mmnm_npc_compat/ 中创建一个以你的 NPC 命名的 JSON 文件
4. 将 matchValue 设置为 NPC 的准确游戏内名称
5. 添加技能条目，包含其注册 ID、冷却时间和条件
6. 重启服务器——完成

---

🧩 脚本集成（1.0.5）

如果 NPC 附加了 CustomNPCs 脚本，你可以在 JavaScript 中响应技能事件：

function onMMNMAbility(event) {
  // event.abilityId, event.slot, event.fireCount, event.cooldownMs, event.isPermanent
  // event.damageMultiplier（可读/写）—— 缩放该 NPC 的所有弹射物伤害
  if (event.abilityId == "mineminenomi:yasakani_no_magatama") {
    event.damageMultiplier = 3.0;
  }
}

function onMMNMAbilityEnd(event) {
  event.damageMultiplier = 1.0; // 技能结束时重置
}

该桥梁使用纯反射机制——对 CustomNPCs 无编译时依赖。

---

CustomNPC × MMNM 兼容团队