Back to mods
NPC-Werkstatt project artwork

CurseForge · Minecraft mod

NPC-Werkstatt

Data-driven NPCs with branching dialogues, quests and spawn rules – in-game editor, JSON, server-side.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which NPC-Werkstatt release should I use?

Updated today
Latest stable file npcwerkstatt-1.2.0.jar
Game version 26.3
Loader Fabric

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.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

All 1 required mods have matching files

Install Fabric API first. We found matching files for this game-version and loader setup.

Fabric API Needed by NPC-Werkstatt npcwerkstatt-1.2.0.jar
required
Matching file found Matched file: [26.3] Fabric API 0.166.2+26.3
Borderland / Start 5x5 Area Optional for NPC-Werkstatt npcwerkstatt-1.2.0.jar
optional
Matching file found Matched file: borderland-1.7.0.jar

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.

  1. 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.

  2. 02

    Bring the mods it needs

    Install Fabric API first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 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

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).

Story-style dialog window


✨ 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.

Quests with difficulty levels

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 reload checks 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.

In-game editor

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

  1. Put npcwerkstatt-<version>.jar and Fabric API into the server's mods folder (optional: also into the clients' mods folder for the nicer dialog window).
  2. Start the server once. The mod creates config/npcwerkstatt/:
    • npcs/ – your NPC files (one JSON file per NPC)
    • editor/npc-editor.html – the sandbox editor
    • AI-GUIDE.md – the data format
    • vorlagen/ – templates
  3. 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).
  4. Without the client mod: copy vorlagen/beispiel-haendler.json to npcs/my_npc.json, change the id, 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.md explains 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.

2 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

NPC-Werkstatt versions and loaders

3 of 3 releases match

Looking for an older file? The official CurseForge project page is in Resources.