All features

Numpad 8 (rebindable in Settings > Controls) opens Hunt Wild Traits: tick any traits from the trait list, and every wild settler near you - one who is not in anyone's base - who has one of them glows purple, with the matched traits written above their head. Only you see it.

Setting hunt_wild_traits

The settlers in your adventure party (the party that follows you) get the buffs of the trinkets you are wearing. Nobody else: not players, not your base's other settlers, not a teammate's party. Resilience trinkets (Clockwork Heart...) are never shared - on settlers they cause lag.

Setting settler_trinket_share

Settlers prefer to walk on floors and paths instead of grass when they plan a route, so they keep to your corridors. A floor step counts as half a grass step - matching the faster floors setting - so they take the quicker way rather than a long detour. Settlers under orders (guard, follow) keep the shortest.

Setting settlers_prefer_floors

Settlers walk twice as fast on floors and paths. In vanilla only path tiles give a bonus (+10%, to everyone) and floors give none; this gives settlers +100% on both, so a base with real floors is a faster base. Players keep the normal speeds.

Setting faster_paths

Settler room-sharing gives +10 happiness instead of a penalty

Setting roommates

Settlers say short phrases in a speech bubble when they start a new task, with emotes and item icons. Only you see them.

Setting settler_chat

Raise settler sell-inventory caps (hunter arrows/throwables, alchemist potions, farmer saplings, mage scrolls)

Setting settler_sell_cap

Settlers with one of the four class traits (Warrior, Ranger, Magician, Summoner) prefer gear that actually serves that class - a Summoner reaches for a summon staff and summon-damage armor instead of just grabbing the highest-tier item in storage. It's a preference, not a rule: class gear beats anything of similar tier, but a much better off-class item still wins, so nobody gets stuck with a rusty staff. Your per-settler equipment restrictions and the "prefer full sets" option still apply.

Setting settler_class_gear

Settlers keep the Cooling Box (and Vending Machine) stocked with up to 250 Iceblossom instead of vanilla's 10, so it stops running dry and letting your food spoil. 500 is the box's real capacity (2 fuel slots x 250 per stack). Settlers need the Iceblossom in settlement storage they can reach, and a settler assigned to hauling. Takes effect for cooling boxes registered after a restart.

Setting cooling_box_fuel

Exotic merchant shows full item list every visit

Setting exotic_merchant

The Soulweaver: a stationary NPC bought from the Elder for 50,000 coins. Paying gives you a placeable item that can only be placed inside a settlement you own, one per settlement. Talk to the Soulweaver to swap one of a settler's traits for another: the price follows the new trait's rank (50,000 coins for the top rank, 10,000 less for each rank below), and the bonus-perk traits cost 75,000.

Setting soulweaver

Collector settlers (Gem Collector, Flower Collector, Hired Hand Collector) take the gifts their trait wants straight from settlement storage, instead of you having to hand each one over in person. The game already has this option - you normally have to talk to every settler to switch it on. This just makes it the default for a settler that has no saved choice yet; the game saves the per-settler value and restores it after this runs, so anything you set by hand (or with the Happiness tab button) sticks.

Setting collector_auto_gift

Pay a settler 1000 coins to reroll their favorite dish. Some settlers have a trait that wants one specific food, and it can be something you cannot get outside a seasonal event - this lets you buy a different one instead of being stuck with it. Talk to the settler; the option only appears if they have the trait. The new dish is picked from the normal foods of the game, never seasonal event items.

Setting dish_reroll

Every settler is carried to quality of life 20. Quality of life is the settler's standard of living: it rises while they are happy and falls while they are not, and the game charges 30 happiness for every level they already have, so a settler normally has to earn it with rooms, food and amenities. With this on they each gain a 'Safe Haven Happiness' bonus large enough to hold level 20, and are moved straight to 20 rather than climbing there over 100 minutes. They can still go higher than 20 on their own amenities - 20 is a floor, not a cap, and a settler already above it is left alone. off by default: it is a large balance change and that is the server owner's call.

Setting settler_qol_boost

Adds a happiness tab to the settlement (C) menu, next to Settings / Settlers / Command / Equipment / Diet. It lists every settler with what is currently making them unhappy (and happy), worst first, so you can see at a glance who is missing crafting stations, plants, paintings and so on. A Filter button narrows the list to settlers with the traits you pick. Read-only - it changes nothing about your settlement.

Setting settlement_happiness

A "Furnish" button in the settlement (C) menu's Happiness tab. Press it and the mod instantly places whatever a settler's traits want in their room - plants, paintings, crafting stations, a music player - taking the items out of your settlement storage. There is a button on each settler and a "Furnish All" for every room at once, so a big settlement does not have to be decorated room by room. It only ever adds things. It never removes or replaces anything you built, and it never touches floors. You must be standing in a settlement you own (or are on the team of) to use it.

Setting settlement_furnish

Furnish also strips the constructed floors out of an Ecologist's room, back to the biome's bare ground - that trait wants to feel the grass, and floors are what it is complaining about. This is the only destructive thing Furnish does, which is why it has its own switch. It is not lossy: each floor drops its item first, exactly like the Builder Eraser, and natural ground is never touched.

Setting settlement_furnish_floors

Furnish also dresses a Fashionista settler in a full cosmetic outfit from settlement storage (that trait wants all three cosmetic slots filled). Only cosmetic armor is used, never real armor, so it cannot interfere with the gear settlers pick for their class.

Setting settlement_furnish_cosmetics

When you hire a settler whose trait is about a kind of work, that work is set to the highest priority for them straight away, so you don't have to open the settlement menu and do it by hand. Only two traits actually qualify: Lumberjack (forestry) and Gardener (farming and fertilizing). It is applied once, when they are hired - you are free to change it afterwards and it will stay.

Setting trait_job_priority

In the settlement (C) menu's Work priorities tab, a settler's own work is shown as a red square instead of the normal gray one, so you can see at a glance which job each settler is naturally better at. Only two traits are marked, one square each: Lumberjack (forestry) and Gardener (farming). Purely visual - it does not change any priority by itself.

Setting trait_job_highlight

Openable settler-trait ranking panel (Settler Trait List keybind, default Numpad 3 - rebindable in Controls). Ranks every settler personality by the happiness it can produce, color-coded gold (best) to gray (little or none); bonus-perk traits are shown in purple. Purely informational.

Setting trait_tier_list

Color the personality chips shown on a settler (when talking to them, and in the settler panel) using the same rank colors as the trait list above - gold for the best, gray for the worst, purple for bonus perks.

Setting trait_chip_colors