CustomNPC x MMNM Compat: One Piece Boss NPCs for Minecraft

CustomNPC x MMNM Compat

Building a memorable One Piece boss fight in Minecraft used to mean wrestling with Java code, custom AI goals, and endless debugging. The CustomNPC x MMNM Compat add-on changes that completely. This bridge mod connects Mine Mine no Mi (MMNM) with CustomNPCs, letting you turn any named NPC into a fully-featured boss with phase-based ability rotations, permanent haki passives, and combat conditions — all configured through simple JSON files. No coding required, no compile-time headaches.

What CustomNPC x MMNM Compat Actually Does

At its core, the mod reads JSON files from the config/mmnm_npc_compat/ folder. Drop in a file named after your NPC, set matchValue to the exact in-game name, and that NPC instantly becomes a boss. The bridge supports instant, charge-based, and continuous abilities from Mine Mine no Mi and any MMNM-compatible addon, including cartaddon, fruitreworks, awakenawakennomi, and fightingstyles.

The phase system is where things get interesting. You can unlock abilities at specific HP thresholds, so a boss only fires its ultimate move below 40% health. Permanent passives keep haki hardening, logia immunities, or zoan transformations active at all times. Combat conditions let you control ability usage based on player distance, nearby player count, and health range, while per-ability cooldowns replace MMNM's player-only cooldown system with your own timings in milliseconds.

Key Features at a Glance

• JSON-driven configuration — no coding needed
• Phase system with HP-threshold ability unlocks
• Permanent passives for haki, logia, and zoan effects
• Combat conditions based on distance, player count, and health
• Per-ability cooldowns and spawn stagger via startDelayMs
• Haki bar support that grants max haki EXP to NPC bosses
• Goal persistence that re-injects ability goals during AI ticks
• Force charge and continuous duration overrides
• JavaScript script integration with onMMNMAbility and onMMNMAbilityEnd callbacks

Supported Versions and Requirements

CustomNPC x MMNM Compat for Minecraft currently targets Minecraft Forge 1.16.5. You will need Mine Mine no Mi 0.10.10 or newer and CustomNPCs 1.16.5. CustomNPCs is technically optional for the script integration — if it is absent, all callbacks silently no-op and the rest of the mod keeps working normally. The bridge uses pure reflection, so there is no compile-time dependency on CustomNPCs itself.

If you prefer skipping manual file juggling, the foxygame.net launcher handles the whole setup for you. Its add-on catalog lists CustomNPC x MMNM Compat alongside the required dependencies, so one click installs the mod, matches your Forge version automatically, and keeps everything updated without you touching a single JAR file.

How to Install CustomNPC x MMNM Compat

Getting started is straightforward. Here is the quick setup process:

• Place the JAR in your mods/ folder
• Start the server once to generate the config folder
• Create a JSON file in config/mmnm_npc_compat/ named after your NPC
• Set matchValue to the exact in-game name of the NPC
• Add ability entries with their registry IDs, cooldowns, and conditions
• Restart the server — done

Once configured, the mod handles the heavy lifting. It automatically grants max haki EXP to NPC bosses so the haki bar never blocks their abilities, and it re-injects ability goals if CustomNPCs clears them during its own AI ticks. Spawn stagger via startDelayMs prevents every ability from firing simultaneously the moment a boss appears, which keeps fights readable instead of chaotic.

Script Integration for Advanced Bosses

Since version 1.0.5, NPCs with a CustomNPCs script attached can react to ability events in JavaScript. Your script receives onMMNMAbility(event) and onMMNMAbilityEnd(event) callbacks every time an ability fires or ends. That means you can dynamically scale damage, trigger dialogue, or react to any phase change without touching Java. The event.damageMultiplier value is read and write, so scaling all projectile damage from a boss is as simple as setting it to 3.0 inside the callback and resetting it when the ability ends.

Final Thoughts

CustomNPC x MMNM Compat fills a gap that has frustrated One Piece fans in Minecraft for years: making CustomNPCs bosses that genuinely feel like devil fruit users rather than reskinned mobs. Whether you want a single dramatic raid boss or an entire island of escalating encounters, the JSON workflow keeps configuration accessible while the script layer offers depth for builders who want it. If you are running Forge 1.16.5 with Mine Mine no Mi, this add-on is the missing piece for serious boss design.

===ARTICLE===