NPC-Werkstatt

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

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

NPC-Werkstatt Team

profile avatar
Owner
  • 1
    Followers
  • 5
    Projects
  • 1.4K
    Downloads

I am a content creator with my own website and Minecraft projects: Small projects like Minecraft Borderlands, Tombstone, Trampling Paths as a mod, and an overall modpack

More from AwenHDView all