📜 Village Contracts

Place a contract board anywhere and found your own settlement. Take on contracts, earn the villagers' trust and watch a few shacks grow into a Thriving Town.

A contract board is the heart of your settlement. Every morning it posts new jobs: hunt monsters, bring supplies, explore far-off structures or defend the village through the night. Each finished contract earns emeralds and reputation. As your reputation grows, villagers move in, prices drop, iron golems arrive and new perks unlock. Fail too often and your residents pack up and leave.

🛠️ Getting started

1. Craft a Contract Board: 3 paper on top, 3 planks of any wood in the middle, 2 sticks below as legs.
2. Place it where you want your settlement. Rename it in an anvil first to give the settlement a name.
3. Right-click the board, accept a contract and get going.
4. Build beds so newcomers have somewhere to sleep, and put a barrel next to the board for taxes.

✨ Features

📋 The contract board

Place it and a settlement is founded around it. Every morning it offers new contracts:

• Hunt: slay a number of a certain monster, anywhere.
• Deliver: bring supplies to the board.
• Explore: find a far-off structure and step inside.
• Defend: protect the settlement from monsters until dawn.

🏘️ Grow your settlement

• Reputation and 9 tiers: from Shunned and Distrusted through Outpost, Hamlet, Village, Market Village, Town and Bustling Town up to a Thriving Town.
• Residents move in: newcomers arrive every day while you have the reputation and a free bed. Villagers already living there join the settlement.
• From rags to fine cotton: residents dress according to how well the settlement is doing, from torn, dirty rags to fine clothes with gold embroidery.
• Fireworks shoot up from the board every time your settlement reaches a new tier.

❓ Favors

Now and then a resident asks for a small favor, shown by a question mark above their head. Each one comes with a little story, like a fisherman whose net was torn by a big fish. Once you've said yes, a speech bubble shows what they need and turns green when you have it.

💬 Your residents

• Talk to them: every resident has a name and a job. Right-click to trade as usual, or ask them to follow you or go home.
• Quest book (key B, can be changed): every contract and favor in progress, with progress bars, who's asking and which way to go.
• HUD notice: when someone in your settlement is asking for a favor, a short note appears above your hotbar.

🎁 Perks

Your settlement unlocks perks as it grows. Hover over them on the board's Perks page to see what they do.

💚 Village Tax

You set the tax yourself on the board's Settlement page, from None to Crushing. The board shows how much it brings in and how your residents feel about it:

• 🟢 Glad: lower than they accept. Now and then you gain a little reputation.
• ⚪ Fine: exactly what they accept.
• 🟠 Grumbling: one step too high. Someone may move out.
• 🔴 Too much: residents leave every morning and your reputation drops.

The bigger your settlement, the more tax your residents accept. Put a barrel next to the board to collect it.

⌨️ Commands

⚙️ Configuration

Everything can be tweaked in game: open Mods → Village Contracts → Config, or edit config/villagecontracts-common.toml.

• Settlement size, contracts in progress at once, reputation and reward multipliers
• Residents: reputation per resident, maximum residents, free beds, how often they leave, tiered clothes
• Favors: how often they're asked and how much reputation they give
• Every perk can be turned off, plus tribute chance and days between market days
• Which monsters, structures and items contracts may ask for, and the bonus loot tables

📋 Info

• Minecraft: 1.20.1
• Loader: Forge (47.x)
• Works in: singleplayer and multiplayer. Install it on both client and server.
• Language: English

Put up a board, sign the first contract... and see how far your little outpost can go. 🏘️