NPC Director

NPC Director adds interactive quest NPCs, branching dialogue, patrol routes and persistent mission progression for custom adventure maps.

Players can talk to NPCs, choose story outcomes and follow mission flow. Operators in developer mode and Creative mode can edit and summon NPCs from an in-game panel. Dialogue and patrol paths are datapack JSON files that can be reused between NPCs.

Features:

• quest NPCs with a name, a relevance marker and protection from hostile mobs
• branching dialogue in a beige dialogue screen with the NPC name, a translucent text box, two-column options, scrolling and pages; answers can run commands
• patrol routes through checkpoints: paste coordinates as "X Y Z", pick a route with arrows and assign it to one NPC or to every NPC within 16 blocks
• NPCs that sit aligned to the block surface (stairs, slabs)
• custom skins: lookup by name with a clear error message, or import a 64x64 / 64x32 PNG file
• panel language button (Auto / English / Spanish)
• per-player, per-command and global quest states that persist across restarts
• developer mode and player mode, saved in config/npcdirector.properties; the edit panel only opens for operators in developer mode who are in Creative mode

Supported versions:

• Fabric: 26.3, 26.2, 1.21.4, 1.21.1, 1.20.1, 1.16.5 (requires Fabric API)
• Forge: 26.3, 1.21.4, 1.21.1, 1.20.1, 1.16.5, 1.12.2 (partial port: no path editor, no dialogue, equipment, scale or sound editors)

Java: 25 for 26.x, 21 for 1.21.x, 17 for 1.20.1, 8 for 1.16.5 and 1.12.2.

Testing: every file was tested on a dedicated server with automated checks. The graphical interface was tried in game on Fabric 26.2 by a tester; on the other versions the interface was compiled but not tested in game.

English and Spanish language files are included.