StoryNPCs
An NPC and storytelling framework for NeoForge 1.21.1. You define NPCs, branching dialogue, quests and factions in YAML files, and edit them in game with a graph editor. No Java needed.
What it does
- Content in YAML. NPCs, dialogues, quests and factions are plain, versioned YAML files you can read, diff and share.
- Dialogue graphs. Branching, loops, options that only appear when conditions are met, and actions that fire on a choice. Write them in YAML or in the graph editor.
- One path for changes. Commands, GUI actions and the Java API all go through the same validation, with permission checks and protection against overwriting someone else's edit.
- Progress is stored apart from content. Definitions do not change at runtime. Player progress is saved separately with atomic writes.
- Events. NeoForge events let other mods react to quests, dialogues and NPC behavior.
Getting started
- A new world gets a starter NPC, dialogue, quest and faction.
/storynpcs npc create <id> [name]writes the YAML, registers the NPC and spawns it at your feet.- IDs tab-complete, command output has clickable links, and
/storynpcs meshows your quest progress and faction standing. - If a reload fails, validation errors show the file and line in game as well as in the console.
Status
StoryNPCs is in public beta. It is not a verified replacement for CustomNPCs. Behavior parity with that mod has not been checked against its runtime, and some performance targets are still being tuned on real servers. Beta reports are welcome.
Source and issues: https://github.com/DurdeuVlad/dwurdys-storynpcs
Found a bug, or have an idea for this mod? Tell us in the Dwurdy Workshop Discord, where we maintain it. Developers, testers, 3D modellers and 2D artists are welcome, and any help is appreciated.
We also maintain: Create: Contour, Dawnmine, Dungeon World, Dwurdy Sharks, Gatehouse, HeapHammer, ItemGraph, Lifepath, Straja.