StoryNPCs

Next-generation NPC and narrative framework for NeoForge 1.21.1: YAML-first dialogue graphs, quests, factions and a visual editor.

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 me shows 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.

StoryNPCs Team

profile avatar
Owner
  • 11
    Projects
  • 3.6K
    Downloads

Making mods to fix issues

More from dwurdyView all

  • ItemGraph project image

    ItemGraph

    A server-side forensic moderation mod for NeoForge 1.21.1. Reconstructs item movement, stack splits, and transformations through time from authoritative evidence.

    • 242
    • November 17, 2026
  • Create: Contour project image

    Create: Contour

    114 paintable shape blocks for Create that copy the material of any block, plus the Contour Placer and Codex.

    • 27
    • November 16, 2026
  • Dawnmine project image

    Dawnmine

    A shared daily mine for your server. Every 24 hours a new cave world is generated, and every player enters the same one.

    • 34
    • November 16, 2026
  • Rustic Craft 2 project image

    Rustic Craft 2

    The official modpack for Rustic Craft 2

    • 2.3K
    • November 15, 2026
  • ItemGraph project image

    ItemGraph

    A server-side forensic moderation mod for NeoForge 1.21.1. Reconstructs item movement, stack splits, and transformations through time from authoritative evidence.

    • 242
    • November 17, 2026
  • Create: Contour project image

    Create: Contour

    114 paintable shape blocks for Create that copy the material of any block, plus the Contour Placer and Codex.

    • 27
    • November 16, 2026
  • Dawnmine project image

    Dawnmine

    A shared daily mine for your server. Every 24 hours a new cave world is generated, and every player enters the same one.

    • 34
    • November 16, 2026
  • Rustic Craft 2 project image

    Rustic Craft 2

    The official modpack for Rustic Craft 2

    • 2.3K
    • November 15, 2026