Skip to main content

Getting started

The shortest path between "I installed the mod" and "I have a living village".

1. Bring in an NPC​

You need to invite a resident to start your village. Craft an Immigration Contract at a Fieldcraft bench using:

  • 1x Map/Scroll (Deco_Scroll)
  • 1x Inkwell (Deco_Inkwell)
  • 1x Light Leather (Ingredient_Leather_Light)

Use the contract to spawn a new resident.

The generated NPC receives one of 800 distinct visual models and is instantiated with randomized properties for name, personality matrix, behavioral traits, occupation, hobbies, and dietary preferences.

2. Build a house​

An NPC without a house wanders aimlessly and never sleeps properly. The minimum that counts as a house:

  • walls and a roof enclosing the space
  • a door (47 variants)
    View all doors & trapdoors (47)
    Ancient DoorAncient TrapdoorCrude DoorCrude TrapdoorDesert DoorDesert TrapdoorDungeon Air Door LargeFeran DoorFeran TrapdoorFrozen Castle DoorFrozen Castle TrapdoorGrand Wizard Medium DoorHuman Ruins DoorHuman Ruins Door LargeHuman Ruins Door MediumHuman Ruins TrapdoorJungle DoorJungle TrapdoorKweebec DoorKweebec TrapdoorLumberjack DoorLumberjack TrapdoorRoyal Magic Medium DoorScarak Hive Door LargeScarak Hive Door MediumTavern DoorTavern TrapdoorTemple Dark DoorTemple Dark Door LargeTemple Dark Door MediumTemple Dark TrapdoorTemple Earth DoorTemple Emerald DoorTemple Emerald Door MediumTemple Emerald TrapdoorTemple Light DoorTemple Light Door LargeTemple Light Door MedilumTemple Light TrapdoorTemple Scarak Door LargeTemple Scarak Door MediumTemple Wind DoorTemple Wind Door LargeTemple Wind Door MediumTemple Wind TrapdoorVillage DoorVillage Trapdoor
  • a light source (44 variants)
    View all light sources (44)
    Bench CampfireCampfire New1Campfire New2Campfire New CartoonDeco CampfireDeco Campfire OffDeco LanternAncient CandleAncient TorchCrude CandleCrude TorchDesert LanternDesert Lantern TallDesert TorchFeran CandleFeran ChandelierFeran TorchFeran Torch TallFrozen Castle LampFrozen Castle Secondary LampHuman Ruins CandleHuman Ruins LanternHuman Ruins TorchJungle CandleJungle TorchKweebec CandleKweebec LanternLumberjack LampLumberjack LanternScarak Hive LampScarak Hive LanternTavern CandleTavern ChandelierTemple Dark CandleTemple Emerald TorchTemple Light LanternTemple Scarak LampTemple Scarak LanternTemple Wind CandleTemple Wind ChandelierPrototype NumericalState CandlePrototype NumericalState Candle2Prototype NumericalState Candle3Wood Torch Wall
  • a seat (49 variants)
    View all chairs, stools & benches (49)
    Bench AlchemyBench AnvilBench ArcaneBench ArchitectsBench ArmoryBench ArmourBench CarpenterBench CookingBench FurnaceBench Furnace SimpleBench FurnitureBench LoomBench LumbermillBench MemoriesBench SalvageBench TanneryBench TroughBench WeaponDeco Scrap ChairAncient BenchAncient ChairCastle BenchCrude StoolDesert ChairFaun StoolFeran BenchFeran StoolFrozen Castle BenchFrozen Castle ChairGrand Wizard BenchGrand Wizard ChairHuman Ruins BenchHuman Ruins ChairHuman Ruins StoolJungle BenchJungle ChairKweebec StoolLumberjack ChairTavern BenchTavern ChairTavern StoolTemple Dark StoolTemple Emerald StoolTemple Light BenchTemple Light StoolTemple Wind StoolVillage BenchVillage ChairVillage Stool
  • a table (19 variants)
    View all tables, desks & counters (19)
    Food Skewer VegetableAncient TableCrude TableDesert TableFeran TableFrozen Castle TableGrand Wizard TableHuman Ruins DeskHuman Ruins TableJungle TableKweebec TableLumberjack TableTavern TableTemple Dark TableTemple Emerald TableTemple Light TableTemple Wind TableVillage CounterVillage Table
  • a bed (16 variants)
    View all beds (16)
    Ancient BedCrude BedDesert BedFeran BedFrozen Castle BedGrand Wizard BedHuman Ruins BedJungle BedKweebec BedLumberjack BedRoyal Magic BedTavern BedTemple Dark BedTemple Emerald BedTemple Light BedVillage Bed

To verify your build, point a House Blueprint at the bed.

House Blueprint

The tool tells you whether the structure is valid and what is missing. Details in Building a house.

3. Let her claim the bed​

Once the house is ready, the NPC walks to the bed and registers that place as hers. From then on she lives there: she comes back to sleep, eats from that house's chests, and opens the door on her way in.

Use the Innkeeper's Ledger to check who lives where.

Innkeeper Ledger

4. Put out food​

Place a chest inside the house and leave food in it. NPCs will search for a chest within a 24-block radius when hungry.

The chest must belong to a house

NPCs only use chests that belong to a recognised house. A chest dropped in an open field is ignored — which is also what keeps them out of the treasure chests scattered around the world.

See what they can actually reach by using the Quartermaster's Glass.

Quartermaster Glass

It lists every registered chest, the house it belongs to, and how much food is inside.

5. Talk to her​

Aim at the NPC and press F, or right-click. That opens the interaction panel, with hunger, energy, mood, traits, tastes, and the available actions.

NPC Interaction Panel

The outcomes of interactions are calculated based on relationship status, mood, and traits:

  • Flirt: Accepted by partners or shy NPCs; rejected by enemies and angry NPCs.
  • Joke: Fails on enemies, cheers up sad/angry partners.
  • Gift: Food given below 70 hunger will be eaten immediately, restoring health and altering fun.

See Interacting with NPCs.

6. Let time pass​

The mod is deliberately slow. Starting from 100 hunger, an NPC takes roughly seven in-game hours to get genuinely hungry. At 5 hunger, they begin to starve, crying and dropping all tasks until fed. Fifteen in-game hours without food will not kill them, but they will refuse to work.

Common early problems​

SymptomLikely cause
The NPC does not sleepThe bed is not registered, or there is no valid house. Check with the Innkeeper's Ledger.
The NPC does not eatThe chest does not belong to a house. Check with the Quartermaster's Glass.
No NPC appears on its ownNPCs no longer spawn automatically. You must craft and use an Immigration Contract.
The house is rejectedMissing furniture or the space is not enclosed. The House Blueprint says which.