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