CurseForge · Minecraft mod
NPC-Werkstatt
Data-driven NPCs with branching dialogues, quests and spawn rules – in-game editor, JSON, server-side.
Quick answer
Which NPC-Werkstatt release should I use?
NPC-Werkstatt npcwerkstatt-1.2.0.jar targets 26.3 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. All 1 required mods have matching files.
Where it goes
Is NPC-Werkstatt required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does NPC-Werkstatt npcwerkstatt-1.2.0.jar need?
npcwerkstatt-1.2.0.jar. Change the file and its required mods may change too.
Install Fabric API first. We found matching files for this game-version and loader setup.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add NPC-Werkstatt without breaking your instance.
Built for NPC-Werkstatt npcwerkstatt-1.2.0.jar. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use npcwerkstatt-1.2.0.jar. It targets 26.3 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Fabric API first. We found matching files for this game-version and loader setup.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside npcwerkstatt-1.2.0.jar. It opens that exact file at the source.
About this project
What does NPC-Werkstatt add?

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
Project description from CurseForge.
Pick your setup
NPC-Werkstatt by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.3
1 loader build26.2
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
NPC-Werkstatt versions and loaders
npcwerkstatt-1.2.0.jar
20 Nov 2026
NPC-Werkstatt 1.2.0
npcwerkstatt-1.2.0.jar
20 Nov 2026
NPC-Werkstatt 1.0.0
npcwerkstatt-1.0.0.jar
15 Nov 2026
Looking for an older file? The official CurseForge project page is in Resources.