Townbuilder: a town mod for Minecraft
A free unofficial fan mod for Minecraft: Java Edition (Fabric), from Riverbend Worldworks LLC.
NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.
Townbuilder is there so you can have a fiefdom of loyal followers working to enrich your life, fill your treasury, and fund your war effort. Plant a Mayor Flag (or the older four corner flags) to found a town. Once it's established, your people get to work. They raise houses, farms, mines, and walls. They bring in food and ore. They stand watch. And if you place a Royal Guard Flag, two bodyguards will follow you out into the map and fight whatever comes for you.
As the town levels, so does its production — not just one or two steps, but three. Each level adds something new, from a sturdier workshop to a scavenger who can go look for loot. If you don't watch them, though, they might starve, so keep food in the chests and don't let raiders wipe the place out. If the village takes damage, your workers should repair it. If they don't, send a bug report and we'll get after 'em. We know how to handle them unruly villagers.
When the chests start bursting, a Town Trader comes by to buy the surplus and sell the rarities your people haven't found yet. And if you want a little trouble on your doorstep, a Level 3 Mayor will raise a Monster Flag that draws ordinary monsters to town. For a full monster siege, light a Siege Altar from Monster Wave Madness.
Townbuilder is free. It is not sold, and it has no paid features, ads, or donation gates. You need your own genuine copy of Minecraft: Java Edition, plus Fabric Loader and Fabric API.
Founding a town
- A single Mayor Flag founds a 101×101 town centered on that flag. The flag is the Town Hall, and a Town Founder levels the land at the same pace as other workers: one block every two seconds.
- After the Hall is up, the Mayor can plant the next role flags himself, one building at a time, so one flag can grow into a full town.
/townbuilder growthshows progress. - The older method still works: plant four Town Boundary Flags at the corners of a square.
- Place role flags inside the town to bring in workers. Every structure is built by a visible worker, by hand, at most one block every two seconds.
- A town stays founded if you later remove the corner flags. Operators use
/townbuilder dissolveand/townbuilder restore.
The people who work for you
Workers are original town workers with their own outfits and work sounds, not stock villagers. Each role flag raises its own house and job:
- Farmer — farmhouse, barn, stall, and fields. Plants, harvests, breeds, and butchers surplus into the farm chest. You can set up to two farm products (crops or animals) with a farm sign, chest tokens, or
/townbuilder farm. - Lumberjack — a house and log yard, plus a tree farm. Chops trees at the worker pace, replants a sapling where each tree stood, and stores the logs.
- Miner — a mine house, then a staircase shaft with torches, a powered minecart track the miner rides, and ore branches once the shaft is deep. The miner will not cut into other towns, spawn protection, or player-built blocks outside the claim. He seals exposed water or lava before he digs, and he will swim for air if he gets wet.
- Cook — a kitchen with a smoker. Turns raw food from town chests into cooked food and stocks the houses.
- Supply Master — a pack-horse runner who moves food, tools, and materials between houses, the kitchen, the hall, and the farm, and walks loose items in town to the Town Hall chest (the Mayor does this if you have no Supply Master).
- Blacksmith — smelts iron from town stock and crafts wooden, stone, or iron tools, alternating two tools with one armor piece. One furnace per shop level. Custom orders jump the queue (
/townbuilder order, or a sign or sample in the smithy). - Builder — the Construction Company office. Builds or captures blueprint designs (
/townbuilder build,/townbuilder capture). Sharing is file-only. - Mayor — the Town Hall, sorted storage, a Town Needs board, and a running list of what the town needs (
/townbuilder needs). - Guard — a barracks for up to 5 soldiers and 5 archers, each with a town dog. Soldiers patrol the ground inside the town and around the outside of the walls; archers take the wall tops, towers, and high points. When attacked they gather, then counterattack together. They stay leashed to the town (they hunt creepers before the creepers reach the walls, and they will defend a worker under attack).
- Royal Guard — two bodyguards in the best armor the town can spare. They follow the player who placed the flag, including as you travel the map, and they fight hostiles that hurt you, that you hit, or that come near you, then go back to following. If they fall far behind, they catch up the way a tamed pet does.
- Mage — a Mage Tower and a friendly mage with ranged area damage that does not hurt players, villagers, town workers, or town dogs.
Type /townbuilder help in game, or read the Riverbend Guide book you get on first join.
Three building levels
Every role building starts as a Level 1 timber-frame cottage. When the town's chests hold the upgrade materials, it is rebuilt in place. Chests, beds, and workstations are kept. /townbuilder levels shows each building's level.
- Level 1 — the starting workplace: log posts and beams, a pitched roof, and a 2-wide door.
- Level 2 — stone-brick trim, a chimney, flower boxes, a door awning, and banners. The Blacksmith gains a second furnace, so smelting keeps up better as the town grows.
- Level 3 — an attic with stairs, a bigger chimney, lanterns, and a role yard when it fits. The Blacksmith gains a third furnace. A Level 3 Town Hall can send a Scavenger who takes a pickaxe, loots structure chests (never player chests), and brings the haul home. Higher-level walls use stone bricks. A tabard cabinet is also built at Level 3; wearing a town tabard lets a player take over as owner.
Floors also change with the building level. Older houses from before levels existed keep working and are not force-upgraded.
Economy and the Town Trader
Workers post what they need; the producer queues that work first, and the Supply Master or the Mayor hauls the goods. Open requests show on the Town Needs board (/townbuilder requests, /townbuilder gaps).
A Town Trader visits a town that has a Hall, buys surplus above a keep level (default four stacks) for gold nuggets or emeralds into the Hall chest, and sells a short rotating list of rarities at steep prices. Trades go through the Hall chest, and only while the trader is in town. /townbuilder trader and /townbuilder trader buy <n>.
The Monster Flag
At a Level 3 Town Hall, the Mayor places a Monster Flag near the far edge of town. It draws ordinary zombies and skeletons — about one every 30 seconds, up to six within 48 blocks. Put any stone-type block on top to cap it and make it inert; take the cap off to wake it.
This is not how a Monster Wave Madness siege starts. Those ten-wave sieges still begin when you light a Siege Altar from Monster Wave.
Protection, hunger, and repairs
- Hunger starts once the town has a working Farm or Cook. Workers eat from house, kitchen, and Town Hall chests. If one starves, that role flag breaks; right-click to repair it, replace the flag, or wait until the town has food in its chests again. In a town with no food production, a starved role comes back on its own. After an ordinary death, a replacement comes back in about five minutes by default.
- An original alarm horn sounds when hostiles are in or just outside the claim, or when Monster Wave Madness signals that the town is under attack. Civilians head for shelter; guards rally.
- If Monster Wave Madness wrecks town blocks, builders claim that damage the next morning, gather real materials from town chests, and rebuild. Wave repairs are never free. Finished walls are also checked for holes and mended at the normal building pace.
- Walls can be laid with wall flags (two flags make a straight wall between them; more flags close a ring). Towers stand at the flags, with 4-wide, 8-tall gateways. Roads keep a 4:1 grade, run from doors to the town center with lamp posts, and can join nearby towns. Long roads end at a stone tower with two guards.
Abandoned towns
The owner or an operator can abandon a town by double right-clicking the center Town Flag (or a corner flag on an older four-flag town). Work stops. After a while the old residents wander the quiet streets, and later the place turns into a spooky ruin. Plant a new Mayor Flag on the same spot to take it back. /townbuilder ruin.
What's new in 0.11.1
0.11.1 is a bug-fix update on 0.11.0. Worlds from 0.11.0 load as they are.
- Walls mend holes that used to stay open for good, including cells blocked by a torch, a ladder, or loose cobblestone, without stalling the rest of the town.
- Royal bodyguards no longer loop inside their house. When they fall far behind you they catch up like a tamed pet, instead of digging staircases through the ground.
- A guard who keeps swinging at a monster without hurting it leaves that target for 30 seconds and helps elsewhere.
- The Miner seals exposed water or lava before he digs, closes off cave gaps across his staircase, and swims for air instead of drowning.
How the three mods work together
Townbuilder, Monster Wave, and Banner Wars are designed to work together and also run just fine on their own.
- With Monster Wave Madness 0.2.3, a lit Siege Altar can put your town under siege. Townbuilder sounds the alarm, records wrecked blocks, and rebuilds them after the waves. Villagers can carry hoard loot into the Town Hall.
- With Banner Wars 0.2.3, your Townbuilder towns become the cities, your guards are the troops, and the founder's team tabard picks the town's side. Capture a rival flag and escort their Loot Train home.
- Load all three for the full set (Townbuilder 0.11.1, Monster Wave Madness 0.2.3, and Banner Wars 0.2.3): a living town, waves of monsters, and wars with a friend.
Bugs and feedback
If a building is left in ruins, a worker gets stuck, or a bodyguard forgets how to swing a sword, send a bug report to riverbendworldbuilders@gmail.com or use the issue tracker on this page. We'll get after 'em.
Inspired by (idea level only)
All Townbuilder code, art, and sounds are original. These projects are credited as inspiration for the general idea of a living town, not as a source of code, assets, or designs. Townbuilder and Riverbend Worldworks LLC are not affiliated with, endorsed by, or partnered with them or their authors.
- Helpful Villagers — https://www.curseforge.com/minecraft/mc-mods/helpful-villagers
- MineColonies — https://minecolonies.com/ and https://www.curseforge.com/minecraft/mc-mods/minecolonies
- Millenaire — https://www.millenaire.org/ and https://www.curseforge.com/minecraft/mc-mods/millenaire
Disclaimer
NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.
License: MIT. Published by Riverbend Worldworks LLC.
Code for this mod was written with AI assistance under Riverbend Worldworks direction. Textures and the icon are original (made with scripts and pixel art, not a generative image model).