CustomNPC x MMNM Compat

Mine Mine no Mi NPC Compat

开发中！如果你遇到任何问题，可以在 Discord 或评论区告诉我。

无需编写代码，即可让任意 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 代码，即可动态调整伤害、触发对话或响应任意阶段变化

📦 前置要求

兼容： 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 中响应能力事件：

该桥接采用纯反射机制，无需在编译时依赖 CustomNPCs。

CustomNPC × MMNM 兼容团队