
NPC-Werkstatt – data-driven NPCs, dialogues & quests for Fabric 26.2
NPC-Werkstatt ("NPC workshop") lets you build NPCs with branching dialogues, quests, rewards and spawn rules without writing a single line of Java. Everything lives in simple JSON files that you can edit right inside Minecraft with the in-game editor, in a node-based browser editor, by hand – or let an AI assistant write them for you using the included format guide.
The mod runs on the server. Players can join with a completely vanilla client – they get Minecraft's built-in dialog screen. Players who also install the mod get a dedicated story-style dialog window (NPC portrait, conversation history, typewriter text, keyboard shortcuts).

✨ Features
NPCs
- NPCs are real player-shaped figures (Minecraft's Mannequin): custom skin (any player name or the built-in default skins), armor and items in hand, name tag.
- Invulnerable, immovable, and they turn to look at the player they are talking to.
- Appear temporarily (with a puff of smoke) or are placed permanently with one command.
Dialogues
- Every dialogue is a graph of nodes: text, branch, action, wait and end.
- Answers can be friendly, neutral or rude (+1 / 0 / −1). The NPC remembers it: a per-player reputation that survives restarts.
- Conditions on lines, answers and branches (
ruf >= 2,laune == genervt,item:minecraft:diamond >= 3, time of day, group size …). - Placeholders such as
{spieler},{namen}, quest goals and time limits. - Group variants for every text: "you" for one player, "you all" for a group.
- Wait nodes: the conversation pauses until something happens in the game, e.g. a chat/actionbar message from another mod. It can send reminders and hand out replacement items.
Quests
- Any number of difficulty levels per quest (e.g. easy / normal / hard), chosen by the player in the dialogue.
- Objectives: kill mobs · deliver items · trade with merchants (also modded traders) · open untouched loot chests · use or place blocks · react to messages from other mods.
- Time limits in Minecraft days (they only count while the players are online) or "until sunrise". Optional rules such as "don't die".
- Rewards depend on how the player behaved (mood levels, e.g. 100 % + bonus / 100 % / 75 % / 50 %).
- Rude players can be given a harder quest for the same pay.
- Items, commands and per-level extras are supported.
- Offline group members receive their reward on their next login.
- Group quests: goals scale with the number of players, and every member gets the reward.

Spawn rules
- On a mod message, e.g. a welcome dialogue right after a new player's first join.
- On join, with a chance.
- Random solo visits, e.g. a 20 % chance every 2 online hours.
- Random group visits, e.g. at least 3 players who are all within 238 blocks of each other, with a 20 % chance per hour together.
- The NPC waits until everybody is free: not fighting, not in another conversation, in the Overworld.
Tools
- In-game editor (
/npcw editor, for OPs with the mod on their client). Create and edit NPCs without leaving the game:- node list, NPC lines and answers with tone (+1 / 0 / −1) and target node;
- "+ New node" straight from an answer, and renaming that updates every reference;
- an appearance tab with "take item from hand", plus a JSON tab for rules, quests and spawn rules;
- Test saves and starts the dialogue instantly, Place puts the NPC in front of you;
- every save is validated, and the previous version is backed up.
- Sandbox editor (an HTML file, opens in any browser). Every dialogue step is a box, and you drag answers to the next box to connect them.
- Live validation.
- Test-play mode.
- Editing of skin, rules, quests and spawn rules.
/npcw reloadchecks every file against the real game registries (missing items, mobs or nodes) and lists each problem with file, dialogue and node.- AI guide (
AI-GUIDE.md/KI-ANLEITUNG.md): the complete data format, written so that ChatGPT, Claude & co. can create new NPCs for you.

Optional: Grenzland integration
With the Grenzland mod installed, the bundled example NPC "Grenzwart Bruno" becomes active. He greets new players, explains the server, gives them a border stone, and visits players and groups with 10 quests. Group quests then require a shared Grenzland area. Without Grenzland, Bruno is only copied as a template.
🚀 Quick start
- Put
npcwerkstatt-<version>.jarand Fabric API into the server'smodsfolder (optional: also into the clients'modsfolder for the nicer dialog window). - Start the server once. The mod creates
config/npcwerkstatt/:npcs/– your NPC files (one JSON file per NPC)editor/npc-editor.html– the sandbox editorAI-GUIDE.md– the data formatvorlagen/– templates
- In game (OP, with the mod on your client):
/npcw editor→ NPC ▾ → + Neuer NPC (new NPC). Write the greeting, press ▶ Testen (test), then Aufstellen (place). - Without the client mod: copy
vorlagen/beispiel-haendler.jsontonpcs/my_npc.json, change theid, edit it in the browser editor, then/npcw reload→/npcw platzieren my_npc gruss→ right-click the NPC.
⌨️ Commands (OP)
| Command | What it does |
|---|---|
/npcw editor [npc] |
Open the in-game editor |
/npcw reload |
Reload and validate all NPC files |
/npcw dialog <npc> <dialog> [players] |
Start a dialogue right now |
/npcw aufgabe <npc> <quest> [players] |
Let the NPC appear with a specific quest |
/npcw zufall <npc> [players] |
Let the NPC appear with a random quest |
/npcw platzieren <npc> <dialog> / /npcw entfernen |
Place / remove a permanent NPC |
/npcw liste · /npcw gruppen · /npcw status [player] |
Overview, detected groups, quest progress |
/npcw abbrechen <player> · /npcw vergessen <player> |
Cancel a quest / reset a player's NPC data |
/npcw fenster vanilla|mod |
Switch your own dialog window (for testing) |
Every player can use /npcw status to see their own quest progress.
📋 Requirements
- Minecraft 26.2, Fabric Loader 0.19+, Fabric API, Java 25
- Server-side. The client mod is optional: it adds the custom dialog window and, for OPs, the in-game editor.
ℹ️ Good to know
- Built-in system messages and both editors are currently in German. All dialogue texts are whatever you write, in any language.
- The JSON field names are German (
knoten,antworten,weiter…).AI-GUIDE.mdexplains every field in English. - No new blocks, items or entities are registered, so vanilla clients can always join.
Made by AwenHD for the Grenzland community server · noralix.eu