NPCs & Housing

NPCs & Housing brings Terraria's beloved town-building mechanics to Minecraft. Build suitable housing and helpful NPCs will move in, offering useful services and trades.

Each NPC has specific requirements to spawn — some need you to defeat certain bosses, others need you to collect specific items. Build a thriving town and watch it come alive!

Valid Housing

For a room to be considered valid housing, it must meet these requirements:

• Size — Minimum 60 blocks, maximum 750 blocks of interior space
• Walls — Fully enclosed with player-placed blocks (not natural caves)
• Door — At least one door or trapdoor for entry
• Light Source — At least one torch, lantern, or other light source
• Furniture — One comfort item (bed, chair) and one surface (table, workbench)
• Background Walls — Player-placed walls covering all interior space

Housing Query

Craft the Housing Query item to check if housing is valid:

• Recipe: 1 Stick + 1 Paper + 1 Redstone
• Right-click inside a room to query it
• Displays whether housing is valid and what's missing
• Shows which NPC (if any) is assigned to the room

Example Housing Layout

A simple valid house:

• 7 blocks wide by 5 blocks tall interior
• Wooden walls on all sides
• Wooden door for entrance
• One torch on the wall
• One bed and one crafting table inside
• Player-placed wooden background walls

Various NPCs will move in as you meet their requirements. Each offers unique trades and services:

NPC	Unlock Requirement	Services
Guide	Always available	Shows crafting recipes and tips
Merchant	Have 50 emeralds	Sells basic items, tools, and supplies
Nurse	Have a heart container	Heals health for emeralds
Arms Dealer	Have a gun (dispenser)	Sells ammunition and ranged weapons
Demolitionist	Have explosives (TNT)	Sells bombs and explosive items

NPC Trades

Each NPC has a rotating stock of items they sell. Right-click an NPC to open their trade menu. Prices are in emeralds, and happy NPCs offer discounts!

NPC Safety

NPCs can be hurt by mobs and environmental hazards:

• NPCs will defend themselves with basic attacks
• If an NPC dies, they respawn the next day if housing is still valid
• Build walls and defenses to protect your town
• NPCs cannot despawn once they've moved in

Happiness System

NPCs have preferences for biomes and neighbors. Happy NPCs offer better prices and sell special items. Unhappy NPCs have higher prices.

Biome Preferences

NPC	Loves	Dislikes
Guide	Forest	Ocean
Merchant	Forest	Desert
Nurse	Plains	Swamp
Arms Dealer	Desert	Snow
Demolitionist	Mountains	Ocean

Neighbor Preferences

NPCs like having certain neighbors nearby (within 25 blocks):

• Guide likes living near Merchant
• Merchant likes living near Nurse
• Nurse likes living alone or with 1 neighbor
• Arms Dealer likes living near Demolitionist
• Most NPCs dislike crowding (3+ neighbors)

Happiness Benefits

• Very Happy — 15% price discount, sells rare items
• Happy — 5% price discount
• Neutral — Normal prices
• Unhappy — 5% price increase
• Very Unhappy — 15% price increase, limited stock

NPCs & Housing can be configured via the config file located at:

config/iggymods/npcs-housing.toml

Option	Default	Description
minHousingSize	60	Minimum blocks for valid housing
maxHousingSize	750	Maximum blocks for valid housing
enableHappiness	true	Enable NPC happiness system
npcRespawnTime	1	Days until NPC respawns after death
requireBackgroundWalls	true	Require player-placed walls
happinessMultiplier	1.0	Multiplier for happiness effects

Supported Versions

• Minecraft 1.20, 1.20.1, 1.20.4
• Forge

Known Compatible Mods

• All IggyMods — Designed to work together
• Villager mods — NPCs are separate from villagers
• Building mods — All blocks work for housing construction
• Biome mods — NPC happiness works with modded biomes
• Economy mods — Compatible with emerald-based systems