LunaNPC is a Fabric-first NPC framework for building and controlling custom NPCs.
It supports combat, factions, spawning, trading, dialog, and custom models straight from in-game menus, and developers get the exact same features through a public API.
⚠️ Alpha — LunaNPC is in early alpha and it's a big, complex mod. With a project this size, bugs can occur and edge cases may behave unexpectedly. Bug reports are always welcome.
🔧 Dependencies
- Fabric Loader: 0.19.3 or higher
- Fabric API: 0.154.2+26.2 or higher
✨ Feature Overview
- Combat — melee, ranged, and a node-based advanced combat editor with rules, triggers, timed attacks, and projectile accuracy curves.
- Factions — built-iCs choose allies andenemies, and can belong
- Spawning — place NPCs in biomes, structures, or custom zones, on the ground, in water, or in the air, with respawn and persistence control.
- Navigation — ground, swimming, and flight movement, backed by multiple A* pathfinders.
- Trading & Jobs — trading, quests, farming, and branching dialog trees with action triggers.
- Custom models — imimations, with automatichitboxes.
- Full customization — health, equipment, per-slot enchanting, drops, sounds, and behavior, all tunable.
- In-game or in code — everything is available through menus and mirrored in a developer API.
🧩 Developer API
Everything LunaNPC does in-game is also available in code through a public API.
📖 Documentation: api.lunacore.dev/LunaNPC
