Magic NPCs

[0.8.0] — September 3rd, 2026

Magic NPCs now offers full, opt-in support for CustomNPCs (GBPort Unofficial). Existing NPCs will not automatically gain spells: each NPC must receive a datapack loadout, a School Tome assignment, or match an enabled CustomNPCs school rule.

Added

• Full CustomNPCs caster support that respects factions, owners, roles, jobs, movement settings, retaliation rules, and other configured AI behavior.
• Automatic repair when CustomNPCs rebuilds an NPC’s AI, preventing assigned casters from silently losing their spellcasting behavior.
• New datapack conditions for matching CustomNPCs roles, jobs, factions, movement modes, navigation types, and retaliation settings.
• Script support for checking or changing schools, forcing casts, reacting to cast events, and cancelling casts.
• Public events that allow other mods to react to spellcasting and school changes without directly depending on CustomNPCs or Iron’s Spells.
• CustomNPCs integration status and detected version are now shown by /magicnpcs config.
• New configuration options for AI repair, faction rules, dialogue pauses, blocked roles or jobs, scripts, and automatic school assignment.

Fixed

• Spells triggered through scripts or dialogue now obey the same mana, cooldown, allow-list, and casting requirements as AI-controlled spells.

Compatibility

• CustomNPCs support currently requires exactly GBPort Unofficial 1.20.1.20260711.
• Unsupported CustomNPCs versions are detected and safely disabled instead of being allowed to behave unpredictably.
• Existing worlds and modpacks are unaffected. Automatic CustomNPCs integration remains disabled until explicitly enabled, and authored NPCs will never begin casting without an assignment.
• Existing Magic NPCs integrations and adapters continue to work without changes.

Known Limitations

• Newly added or unknown CustomNPCs jobs may appear under fallback identifiers until Magic NPCs is updated.
• The School Tome does not yet integrate with the CustomNPCs recipe editor or creative tabs.