CurseForge · Minecraft mod
NPC Workshop
Build your own NPCs in game — skins, conversations, quests, shops, lore books and personalities that remember players — with no code or datapacks.
Quick answer
Which NPC Workshop release matches Forge?
NPC Workshop npcworkshop-1.1.8-beta targets 1.20.1 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.
Where it goes
Is NPC Workshop 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 Workshop npcworkshop-1.1.8-beta need?
npcworkshop-1.1.8-beta on Forge. Every mod below is checked against that same setup.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add NPC Workshop without breaking your instance.
Built for NPC Workshop npcworkshop-1.1.8-beta on Forge. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use npcworkshop-1.1.8-beta. It targets 1.20.1 with Forge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 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 npcworkshop-1.1.8-beta. It opens that exact file at the source.
About this project
What does NPC Workshop add?
Official Partners
Proudly partnered with Kinetic Hosting who help support the continuous development of this mod. Truly, a great host with really good prices and support.
SETTLERS UPDATE OUT NOW!
# NPC Workshop - A all in one jar: NPC maker, dialogue editor, quest system, shops, lore books and a library, reputation and memory, NPC chatter, gifts, voices, daily routines, world spawning, cutscene commands, a map for editors, an in-game guide, and 5,500+ lines of NPC dialogue ready to use, or create your own from scratch. No add-ons, no library mods, nothing else to install.
✦ Design a world, not just a save
Most NPC tools tie your work to one map. NPC Workshop doesn’t. You build your characters, their stories and the rules for where they live — then every world created afterwards is populated with them automatically.
Build your own NPCs inside the game. Press N and the workshop opens: skins, behaviors, conversations, quests, quest boards, shops, lore books, personalities, reputation and spawning — all in menus. No JSON, no datapacks, no code.
NPC Workshop is made for modpack makers, map makers and server owners who want a world that feels lived-in: villagers with names and stories, guards who remember what you did, traders who give you a better price once they trust you, and strangers who turn up in ruins you haven't explored yet.
New: quest boards that fill with daily jobs, and settlers — NPCs you can turn into their own person, who build a home, work, keep a diary and remember everything you do (experimental).
Every player also gets an in-game Guide book that explains everything, chapter by chapter, with a search box.
✦ What you can build
- A living village — a blacksmith with a shop, a guard who patrols by day and goes home at night, neighbors who gossip about the player, and prices that drop once the town trusts you.
- A village notice board — NPCs pin up fresh jobs every morning: wolves to hunt, wheat to bring, a lost ruin to find.
- A settler who moves in — picks a spot by the trees, builds a camp, then a home in its land's style, and slowly becomes your neighbor.
- A quest chain across the map — a letter to deliver to the next town, a key handed over for a crypt, a boss to hunt, and a reward that unlocks new NPCs in the world.
- A horror story — torn diary pages dropped by zombies, a creepy stranger who remembers your name, candle-lit NPCs who whisper about something in the fog.
- A traveling merchant who only appears in deserts at night, sells rare books, and is gone by morning.
- An adventure map with cutscenes — NPCs that walk to the gate, turn to you, wave, speak, and open their conversation, all from command blocks.
- A modpack’s whole lore — characters who talk about the other mods’ monsters and places, books to collect, and a Library to track them.
✦ You decide when the world wakes up
Every world has its own switch. Pick On or Waiting right on the Create World screen — then build your base, test your pack or just explore first. When you’re ready, press Turn on in the menu (or run /npcw world on from a command block or quest reward) and the NPCs start arriving. Nothing you explored in the meantime is missed.
✦ By the numbers
- 7 behaviors, switchable by day and night, melee or ranged
- 16 quest goal types and 9 reward types, with steps, chains, time limits and team quests
- Quest boards in 9 woods, with jobs from Easy to Boss
- 36 remark situations — from what you’re holding to the mob behind you
- 11 personalities × 13 themes of ready-made lines, plus lines for 21 other mods
- 5 reputation levels, memory, gifts, voices, routines and NPC-to-NPC chatter
- Settler homes for 11 lands, 7 craft skills, and a diary for every settler
- 23 emotes, from a wave to a dance
- 20+ commands for map makers, with results for execute store
- 32 menu themes and 5 fonts
- A 30+ chapter in-game Guide book with search
- Zero lines of code needed
✦ The NPC Creator
Every NPC is a profile you build once and spawn as often as you like. Change the profile and every NPC made from it updates.
- Skins: press Browse (or drag a PNG onto the window) to upload a 64×64 skin. It's sent to every player automatically. Steve or Alex arms.
- Look: size from 0.3 to 3 (hitbox too), name tag always / when looking / hidden, name color, glowing outline, invisible, and a Female body option.
- Sounds: hurt, death and idle sounds from the game, other mods or resource packs — with a preview button.
- Stats: health, speed, and damage as a set number or like a player hitting with its weapon (Sharpness and Power count).
- Gear: every armor and hand slot, with a searchable item picker that includes modded items.
- Attitude: Friendly (never fights), Neutral (fights back) or Hostile, plus invulnerable.
- Behavior: Stationary, Wandering, Patrol, Guard, Follow, Flee or Attack — and a different one at night if you like. Fighters can be melee or ranged (arrows, fireballs, snowballs), and they sprint after monsters that are far off.
- Emotes: wave, bow, salute, cheer, sit, sleep, dance and more — from the menu or
/npcw emote. - Death: respawn timer, XP, last words in chat, drop its gear, and a loot table with amounts and chances.
- Unspawn: take an NPC out of the world without deleting it, and bring it back later exactly as it was.
- Safe editing: every save keeps older versions you can bring back, and leaving with unsaved changes asks first.
- Easy to learn: hover over any button for help, every long list has a scroll bar you can drag, and the Guide book covers the rest.
Conversations and quests — in one menu
A conversation editor that looks like the real talk window: write the NPC's line, add answer buttons, press Go > to write the reply.
- Several lines per page — one is picked at random, so greetings never get stale.
- Answers that think: show an answer only when a quest is (not) started, the player carries an item, has a flag, hasn't picked it before, or has earned enough reputation.
- Answers that do things: give or take items and books, start / complete / reset quests, set flags, change reputation, give advancements, add to scores or run commands.
- Page map shows the whole conversation as a tree, with broken links in red. Test plays it like a player, with pretend quest progress.
- Templates: simple chat, fetch quest, one-time gift, rumors and shopkeeper.
- Translations:
lang:lines are read from resource-pack language files. - The talk window scrolls instead of growing huge, and has a compact look players can pick.
✦ Quest cards
- Make a quest in seconds: Fetch, Hunt, Deliver, Explore or blank, with ready-made NPC lines in three wordings.
- 16 goal types: bring, kill, mine, place, craft, smelt, pick up, use, go to, talk to, read, advancement, statistic, flag, score or command — modded IDs, tags and "anything" work. Limit them to biomes, dimensions, night or a held item.
- Given at start: the NPC hands the player something when they accept — a sealed letter to deliver, a key for the crypt, a diary to read — and takes it back if the quest fails.
- Steps for longer quests, chains ("needs this quest first"), time limits, repeatable with cooldowns.
- Rewards: items, library books, XP, levels, flags, advancements, scores, commands and reputation.
- Team quests: share with nearby teammates (vanilla teams or FTB Teams), with an optional [Join] invite.
- In game: a gold ! in the talk window to accept, a grey ? for progress, a gold ? to hand in, and optional ! / ? markers over NPCs' heads.
- Journal (J): active quests with live progress and time left, finished quests, and the Library.
✦ Quest boards
- A notice board block in 9 woods. NPC Workshop NPCs nearby pin up fresh jobs every day: hunt, bring, find or deliver.
- Difficulty seals from Easy to Boss — the hard ones need the town to like you, and bosses get a health bar.
- A Boards editor: make your own board types and jobs, with live example notices.
- Spawn rules can place boards in villages — by the bell, at a crossroads, on the road.
- A settler standing nearby may ask to keep the board and post its own jobs — and it'll tell you which one it wants done most.
✦ Shops
- The familiar villager trade screen: the player pays one or two items and gets an item or a lore book.
- Sold out after X buys and restock timers.
- Optional: prices follow reputation — friends pay less, enemies can't trade at all.
✦ Books, lore and the Library
- Write books in game with colors and
{player}, or turn a Book and Quill you're holding into a library book. - Sell them in shops, give them from answers and quests, hide them in structure chests (vanilla and modded, picked from a list), or have mobs drop them — with a "killed by a player" option so farms don't count.
- Torn pages: split a book into 2–8 pages that players collect and put back together.
- The Library (journal > Lore) lists every lore book: found ones readable again, missing ones as ??? with a hint about where to look.
✦ Persona — NPCs with a life of their own
Every Persona feature has its own switch and is off by default, so your server only runs what you turn on. (Settlers are separate — only NPCs you turn on become settlers.)
Remarks: NPCs comment on what you hold, your health, the weather, the night, nearby mobs, biomes and your quests.
- 11 personalities (Friendly, Grumpy, Guard, Merchant, Scholar, Creepy, Shy, Noble, Jolly, Veteran, Cultist) and 13 themes (Horror, Fantasy, Pirate, Western, Sci-fi, Steampunk, Cozy, Apocalypse, Military, Mystery, Magic, Tech, Adventure). Mix them — a shy pirate, a creepy cozy innkeeper.
- Mod lines react to other mods' mobs and places, only when that mod is installed. (you can find the list of compatible mods in settings)
- Reputation with five levels — Hated, Wary, Neutral, Liked, Trusted — per NPC type or shared by a group, like a whole town. Personality changes how fast it moves: grumpy NPCs warm up slowly, jolly ones forgive fast.
- Quests and answers that need trust, with a grey locked ! and "not yet" lines in the NPC's own voice.
- Memory: NPCs remember when you were away, hit them, did their quests or gave gifts, and bring it up in their own voice — "Gone 4 days. Didn't miss you. Much." If they don't like you, they only remember the bad things.
- NPC-to-NPC chatter: nearby NPCs talk to each other in speech bubbles, in character. They face each other, stand still and nod, and may gossip about players they like or hate.
- Gifts: favorite, liked and disliked items, with hearts and reactions.
- Voices: a little mumble while the talk window types — built-in, any game or mod sound, or your own .ogg files.
- Routines: spots with hours ("06:00–18:00 work, 18:00–22:00 tavern"); far from players they simply appear there.
- The Phrasebook: every line is editable, and you can make your own personalities and themes.
✦ Settlers — their own person (Experimental)
Turn any NPC into its own person and it starts a life:
- It rolls a personality, job, traits, quirks and a backstory — and every so often, a hidden talent.
- It picks a spot, builds a camp, then a home in its land's style (11 lands — a cottage in the plains, a stilt house in the swamp, a lantern-lit cabin in the dark forest), and grows its yard over time.
- It has needs and moods, eats, sleeps, shelters from storms and stands up to monsters. Knocked down, it gets back up.
- It remembers what you do, likes or dislikes you, makes friends with the other settlers, and talks in its own words — how you answer matters.
- A pet, hobbies, a house sign, notes when you visit while it's out, and a diary on a lectern — don't get caught reading it.
- It learns from you: farm, hang lanterns or put up fences near its home and it may start doing the same.
- Craft skills that grow with practice — based on who it is, not just its personality:
- Enchanting: sets up a table and bookshelves, enchants its own gear and yours.
- Brewing: keeps a brewing stand, drinks potions when hurt, throws healing at you on a trip.
- Smithing: mends, strips and puts books on your gear at its anvil.
- Trading and cooking: buys things it can use (for emeralds or goods) and cooks meals for friends.
- It can keep a quest board and post jobs from what it needs.
- It can come with you as a companion (see below).
✦ Companions (Experimental)
Once a settler likes you, ask **"Want to come with me?"** and it packs up and joins you.
- **It follows you anywhere** — through caves, over mountains and through portals.
- **It fights its own way:** guards and veterans charge in front, shy ones hang back, and it never hits you or your pets.
- **It carries a pack** — 9 slots for whatever you hand it — and eats from its own bag.
- **It looks after the road:** puts up torches where it's dark, and when you stop for a while it lights a campfire and sits by it.
- **It looks after you:** a settler good at brewing throws healing potions at you when you're hurt.
- **Tell it what to do:** Wait here, Come with me, Let me see your pack, or Go home.
- **It has feelings about the trip:** chats on the way, gets uneasy deep underground or up high (some more than others), and gets homesick after a while. Knocked out too often, it'll tell you it's had enough and head home — always with a warning first.
*One companion at a time, and it needs a roof over its head before it'll leave.*
Experimental: settlers are new and will keep changing — expect the odd bug and back up your worlds. Each part (learning, diaries, enchanting, brewing, smithing, buying, cooking) has its own switch.
✦ The Blueprint Wand
Spawn any settler building for any land, watch it go up piece by piece, edit it block by block and save your version — for one world or as the default everywhere.
✦ Spawning
- Spawn rules place NPCs at real generated structures — vanilla and modded, picked from a searchable list — or out in biomes, on the surface or in caves. They can place quest boards too.
- Chance, count, world maximum, time of day, weather, dimension, and where to stand (inside, around, by the wall or an exact offset).
- Safe spots only (solid ground, head room, no lava), never generates chunks, never spawns twice in the same place.
- Test here tells you what each rule would do where you're standing.
✦ Build once — works in every new world
- Everything you make — NPCs, skins, conversations, quests, books, boards, Phrasebook lines, building designs and spawn rules — is saved for the whole game, not one world.
- Create a new world and it’s ready: spawn rules place your NPCs at villages, ruins, modded structures and biomes as players explore, so every world gets its own spread of the same characters.
- Each world keeps its own story: quest progress, reputation, flags, settlers and which NPCs have already appeared are saved per world, so a fresh world is a fresh start.
- Modpacks: ship the
config/npcworkshop/folder and every player’s new worlds come with your full cast, quests and lore — no setup, no commands. - Servers: the same setup works on a dedicated server; players just join and explore.
✦ Commands for map makers
Every command starts with /npcw (or the full /npcworkshop) and needs an operator. The only exception is /npcwjoin, which any player can use. <npcs> means a selector like @e[type=npcworkshop:npc,limit=1,sort=nearest] — or an NPC's name.
Setup
/npcw help– lists every command in chat/npcw editor– opens the NPC Workshop menu (same as the N key)/npcw list– lists all NPC profiles by ID/npcw reload– re-reads every file in config/npcworkshop/ (NPCs, rules, quests, books, Phrasebook, settings)
This world
/npcw world– shows whether NPC Workshop is on or waiting in this world (result 1 or 0)/npcw world on– turns it on: spawn rules start and the Guide book is handed out/npcw world off– pauses it: nothing spawns by itself until it’s turned on again
Placing NPCs
/npcw spawn <profile> [x y z] [count]– spawns an NPC where you stand, or at a position, up to 32 at once/npcw despawn <npcs>– removes NPCs from the world/npcw unspawned– lists NPCs taken out with Unspawn, with [Bring back here] and [Delete for good]
Making NPCs act (cutscenes and maps)
/npcw talk <player> <npc>– opens that NPC’s conversation, quests or shop for the player/npcw say <npcs> <text>– the NPC says something in a speech bubble/npcw nod <npcs>– the NPC nods at the nearest player/npcw emote <npcs> <emote>– wave, bow, salute, cheer, sit, dance and more;stopends one,allshows every emote/npcw look <npcs> <target> [seconds]– the NPC looks at a player or mob (5 seconds by default)/npcw goto <npcs> <x y z> [stay]– the NPC walks there; stay makes that spot its new home/npcw chat <npc> <npc>– two NPCs have a chat right now, even with chatter switched off/npcw behavior <npcs> <behavior>– switches what it does: stationary, wandering, patrol, guard, follow, flee or attack; reset goes back to the profile’s
Quests
/npcw quest list– lists all quest cards by ID/npcw quest start <player> <quest>– starts a quest for a player/npcw quest complete <player> <quest>– finishes it and gives the rewards/npcw quest fail <player> <quest>– fails it (handed-over items are taken back)/npcw quest reset <player> <quest>– forgets it, so it can be taken again/npcw quest status <player> <quest>– result 0 = not started, 1 = doing it, 2 = finished/npcw quest progress <player> <quest> <goal> <amount>– adds progress to a goal (for scripts and command blocks)
Quest boards
/npcw board place <x y z> <facing> [wood] [type]– puts a quest board there/npcw board type | refresh | clear <x y z>– switch its type, post new notices now, or empty it until morning/npcw board types– lists the board types
Settlers
/npcw person list– every settler in this world/npcw person on <npcs>/off <npcs>– turns it on or off (it keeps its memories when off)/npcw person forget <id>– frees a spot if a settler is lost for good/npcw trace <name> on|off– the trace recorder, for reporting settler problems
Players
/npcw rep <player>– lists what every NPC thinks of the player/npcw rep <player> <npc> get– the reputation score as a result (-100 to 100)/npcw rep <player> <npc> set <n>– sets the reputation/npcw rep <player> <npc> add <n>– raises or lowers it/npcw flag <player> list– lists the player’s flags/npcw flag <player> add <flag>– gives the player a flag/npcw flag <player> remove <flag>– removes a flag/npcw flag <player> clear– removes all their flags/npcw flag <player> has <flag>– result 1 or 0 (fails on 0, so execute store success works too)
Books
/npcw book list– lists all library books by ID/npcw book give <player> <book> [page]– gives a library book, or one torn page of it
Spawn rules
/npcw spawnrule list– lists all spawn rules and which are off/npcw spawnrule enable <rule>– turns a rule on (saved)/npcw spawnrule disable <rule>– turns a rule off (saved)
Any player
/npcwjoin <id>– joins a teammate’s shared quest (the [Join] link in chat runs this)
✦ For modpacks and servers
- Permissions: only operators (or the level you choose) see the workshop; everyone else just plays.
- Share: export one NPC (skin included), one spawn rule, or everything as a pack, and import it anywhere.
- Automatic backups of NPCs, quests, books, rules and Phrasebook packs.
- Ship
config/npcworkshop/with your pack and everything comes along — it works in every new world. - Server settings with a search box, plus My settings for each player (32 menu themes, 5 fonts, voices, hover tips).
- Settler switches: limits per server and per player, themes, Hardcore, and an on/off for each settler system — learning, diaries, enchanting, brewing, smithing, buying from players, cooking.
- Light on performance: NPCs with no player nearby rest, spawn rules work in small slices, and quests only run for players who have one.
- Editor tools: a map and minimap of every NPC, a Problems scan for broken links and missing items after mod updates, a player inspector for quests, flags and reputation, "What's on its mind?" for every settler, and a trace recorder for bug reports.
--- Experimental note ---
- Settlers are an experimental feature. Expect changes between updates and the odd rough edge, and keep backups. Everything about them can be turned off.
- ⚠ Experimental: settlers are the newest and biggest part of the mod and are still being polished. Please report bugs, and back up worlds you care about.
--- Blueprint Wand --- Don't like how a settler builds? Change it. The wand spawns every building, for every land, and lets you save your own designs.
*Planned, not promised — the order may change.*
**Settlers**
- **Letters:** settlers write to you, and to each other.
- **Falling in love:** crushes, courting, and settlers moving in together , plus bonuses for companionship.
- **Reacting to effects:** poisoned settlers go home sick, blinded ones feel their way, and they'll remember who threw that splash potion.
- **Hot and cold weather:** settlers who feel the heat, bundle up in the snow, and play in the rain.
- **Homes that keep growing:** second floors, lean-tos and balconies added over time.
- **More to learn from you:** wall lanterns, beehives, fishing, building in stone.
- **Pay in more than emeralds:** iron, gold, diamonds or a settler's favourite things for enchanting, potions and repairs.
- **Portraits:** a keepsake picture after a big adventure together.
- **One-of-a-kind requests:** rare quests only one settler in your world will ever ask.
**New places**
- **The Nether and the End:** settlers who survive there — and, in time, settle there.
- **More buildings for every land:** the camp, yard pieces and workplaces in each land's own style.
**For creators**
- **Emotes in conversations:** make an NPC wave, bow or laugh on a line of dialogue.
- **A new routine editor:** easier daily schedules for your NPCs.
- **Quest board lines for your own NPCs:** NPCs you make can talk about the jobs they posted.
- **Faster loading.**
If you make a video with this mod tag me and let me know, i'd love to see what you make!
**Bugs and ideas:** *post in comments or send message*
Fonts: Liberation Sans / Liberation Serif (SIL Open Font License 1.1) and GNU FreeMono (GPL with font exception).
Project description from CurseForge.
Pick your setup
NPC Workshop by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
NPC Workshop versions and loaders
npcworkshop-1.1.8-beta
npcworkshop-1.1.8-beta.jar
17 Nov 2026
npcworkshop-1.0.0-Forge-1.20.1-beta
npcworkshop-1.0.0-Forge-1.20.1-beta.jar
6 Nov 2026
Looking for an older file? The official CurseForge project page is in Resources.