🇬🇧 English

Mine Mine no Mi NPC Compat

Give any CustomNPCs mob the full power of Mine Mine no Mi abilities — no coding required.

MMNM NPC Compat is a bridge mod between Mine Mine no Mi (and its addons) and CustomNPCs, allowing you to configure any named NPC as a fully-featured One Piece boss with phase-based ability rotations, permanent haki passives, and combat conditions — all through simple JSON files.

✨ Features

JSON-driven configuration — drop a file in config/mmnm_npc_compat/ and any NPC with a matching name becomes a boss
Full ability support — works with instant, charge-based, and continuous abilities from Mine Mine no Mi, cartaddon, fruitreworks, and any MMNM-compatible addon
Phase system — unlock abilities at specific HP thresholds (e.g. only use the ultimate move below 40% HP)
Permanent passives — keep haki hardening, logia immunities, zoan transformations, or any buff active at all times
Combat conditions — control ability usage by player distance, nearby player count, and health range
Per-ability cooldowns — replace MMNM's player-only cooldown system with your own timings (in milliseconds)
Spawn stagger — startDelayMs prevents all abilities from firing simultaneously on spawn
Haki bar support — automatically grants max haki EXP to NPC bosses so the haki bar never blocks their abilities
Goal persistence — re-injects ability goals if CustomNPCs clears them during its own AI ticks
Force charge/continuous — forceChargeDuration and forceContinuousDuration fields for abilities whose use events have player-only guards

📦 Requirements

Mod	Version
Minecraft Forge	1.16.5
Mine Mine no Mi	0.10.10+
CustomNPCs	1.16.5

Compatible with: cartaddon, fruitreworks, awakenawakennomi, fightingstyles, and any mod that registers abilities in the MMNM ModRegistries.ABILITIES registry.

⚙️ Quick Setup

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

📄 Example config

{

"matchType": "entity_name_equals",

"matchValue": "Whitebeard",

"abilities": [

{

"abilityId": "mineminenomi:shima_yurashi",

"goalPriority": 3,

"bypassCanUse": true,

"abilitySlot": 0,

"startDelayMs": 4000,

"cooldownMs": 60000,

"maxContinuousTicks": 10,

"conditions": {

"healthBelowPercent": 100,

"healthAbovePercent": 0,

"maxPlayerDistance": 20.0,

"minNearbyPlayers": 1,

"maxNearbyPlayers": 100

}

{

"abilityId": "mineminenomi:busoshoku_haki_internal_destruction",

"goalPriority": 2,

"bypassCanUse": true,

"permanent": true,

"abilitySlot": 5,

"startDelayMs": 500,

"cooldownMs": 500,

"conditions": {

"healthBelowPercent": 100,

"maxPlayerDistance": 999.0,

"minNearbyPlayers": 0,

"maxNearbyPlayers": 100

}

]

}

🇪🇸 Español

Mine Mine no Mi NPC Compatibilidad

Dale a cualquier mob de CustomNPCs el poder completo de Mine Mine no Mi — sin programar nada.

MMNM NPC Compat es un mod puente entre Mine Mine no Mi (y sus addons) y CustomNPCs, que te permite configurar cualquier NPC con nombre como un jefe de One Piece con fases, pasivos de haki permanentes y condiciones de combate — todo mediante archivos JSON simples.

✨ Características

Configuración por JSON — coloca un archivo en config/mmnm_npc_compat/ y cualquier NPC con el nombre correcto se convierte en un boss
Soporte completo de habilidades — funciona con habilidades instantáneas, de carga y continuas de Mine Mine no Mi, cartaddon, fruitreworks y cualquier addon compatible con MMNM
Sistema de fases — desbloquea habilidades según el porcentaje de vida (por ejemplo, el movimiento definitivo solo por debajo del 40% HP)
Pasivos permanentes — mantén el endurecimiento de haki, inmunidades de logia, transformaciones zoan o cualquier buff activo en todo momento
Condiciones de combate — controla el uso de cada habilidad por distancia al jugador, número de jugadores cercanos y rango de vida
Cooldowns individuales — sustituye el sistema de cooldown de MMNM (pensado solo para jugadores) por tus propios tiempos en milisegundos
Stagger en spawn — startDelayMs evita que todas las habilidades se disparen a la vez al aparecer el NPC
Compatibilidad con la Haki Bar — concede automáticamente experiencia de haki máxima a los NPCs boss para que la barra de haki nunca bloquee sus habilidades
Persistencia de goals — reinyecta los goals de habilidades si CustomNPCs los borra durante sus propios ticks de IA
Forzar carga/continuidad — campos forceChargeDuration y forceContinuousDuration para habilidades cuyo evento de uso tiene guardas exclusivas para jugadores

📦 Requisitos

Mod	Versión
Minecraft Forge	1.16.5
Mine Mine no Mi	0.10.10+
CustomNPCs	1.16.5

Compatible con: cartaddon, fruitreworks, awakenawakennomi, fightingstyles y cualquier mod que registre habilidades en el registro ModRegistries.ABILITIES de MMNM.

⚙️ Instalación rápida

Coloca el JAR en la carpeta mods/
Inicia el servidor una vez para generar la carpeta de configuración
Crea un archivo JSON en config/mmnm_npc_compat/ con el nombre que quieras
Establece matchValue con el nombre exacto del NPC en el juego
Añade entradas de habilidades con sus IDs de registro, cooldowns y condiciones
Reinicia el servidor — listo

CustomNPC x MMNM Compat