🇬🇧 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

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

⚙️ Quick Setup

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

📄 Example config

🇪🇸 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

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

⚙️ Instalación rápida

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