Hirelings
Hire villagers as your crew. Give them jobs, gear and homes, mark work areas, and watch them farm, mine, build, craft and trade. Run a company with wages, a bank, market stalls, guard dogs and rivals who can poach your best workers.
Utility & QoL
Configuration
One config file, a server config: <world>/serverconfig/hirelings-server.toml. Sections and options:
| Section | Option | Default | Range | What it changes |
| bubbles | proximityRange | 16 | 1 to 128 | How close a player must be to see thought bubbles or witness a theft |
| training | apprenticeDays | 7 | 1 to 1000 | Days worked to reach Apprentice in a job |
| training | journeymanDays | 30 | 1 to 1000 | Days worked to reach Journeyman |
| training | masterDays | 90 | 1 to 1000 | Days worked to reach Master |
| training | statGrowthDays | 3 | 1 to 1000 | Every this many days worked, one of the job's stats goes up 1 (max +5) |
| hiring | tempContractDays | 3 | 1 to 30 | Temp contract length for a local hire |
| hiring.localRarityWeights | common / uncommon / rare / unlucky | 50 / 30 / 8 / 12 | 0 to 1000 each | Rarity chances for a local hire |
| adverts | minDelayTicks | 6000 | 0 to 240000 | Shortest wait before someone answers an advert |
| adverts | maxDelayTicks | 24000 | 0 to 240000 | Longest wait (must be at least minDelayTicks) |
| adverts | maxPending | 6 | 1 to 20 | Adverts one player can have waiting |
| adverts | applicationWaitDays | 2 | 1 to 30 | Days an applicant waits for an answer |
| adverts.cheap | feeCredits | 20 | 0 to 100000 | Cost of a Cheap advert |
| adverts.cheap.rarityWeights | common / uncommon / rare / unlucky | 45 / 20 / 3 / 32 | 0 to 1000 each | Rarity chances, Cheap advert |
| adverts.standard | feeCredits | 40 | 0 to 100000 | Cost of a Standard advert |
| adverts.standard.rarityWeights | common / uncommon / rare / unlucky | 50 / 30 / 8 / 12 | 0 to 1000 each | Rarity chances, Standard advert |
| adverts.premium | feeCredits | 75 | 0 to 100000 | Cost of a Premium advert |
| adverts.premium.rarityWeights | common / uncommon / rare / unlucky | 35 / 35 / 25 / 5 | 0 to 1000 each | Rarity chances, Premium advert |
| danger | zombiesAttack | true | true/false | Whether zombies (and husks, drowned and zombie villagers) hunt hirelings |
| areas | maxSize | 128 | 8 to 512 | Longest side of a Builders Wand area |
| drying | dryTicks | 6000 | 20 to 240000 | How long fish, meat or flesh takes to dry on a rack |
| needs | hungerPerDay | 50.0 | 0.0 to 1000.0 | Hunger lost per day, out of 100 (Gluttons x1.5) |
| needs | hungryBelow | 25 | 1 to 100 | A worker eats from their lunch below this, until full |
| needs | foodValue | 10 | 1 to 100 | Hunger restored per point of nutrition |
| needs | lunchboxRange | 64 | 4 to 128 | How far a hungry worker walks to a Lunchbox (or a Storage Chest with food) |
| needs | starvingMoralePenalty | 10 | 0 to 100 | Morale lost by a starving worker when a day begins |
| needs | hirelingFallDamage | false | true/false | Whether hirelings take fall damage |
| thieves | theftsPerDay | 0.3 | 0.0 to 20.0 | Average items a Thief pockets per day near storage (rolled 20 times a day) |
| thieves | storageRange | 6 | 1 to 16 | How close a thief must be to storage to steal |
| thieves | crewWitnessChance | 0.35 | 0.0 to 1.0 | Chance a hireling who sees a theft reports it |
| thieves | unfairFiringMorale | 5 | 0 to 100 | Morale every other crew member loses when one is fired on reports alone |
| equipment | supplyRange | 96 | 8 to 512 | How far from a worker the Equipment tab looks for the Storage Chest |
There is no client or common config.
Last updated November 9, 2026