Arraial: my Minecraft mod where villagers build the village on their own
Introducing Arraial (working title), my Minecraft mod: hire a mason, pick a project and watch the village grow on its own, with trades, an economy and a mayor.
- #minecraft
- #mod
- #fabric
- #java
- #arraial
- #gamedev
After introducing Oxe, Meu Bar! and Ironhex here, today's topic is a different kind of project: a Minecraft mod.
For now it's called Arraial. It's a working title, but it fits the idea so well that it might stick. The concept fits in the mod's own description:
Villagers who build. Hire a mason, pick a project and watch your arraial grow, from wattle and daub to a metropolis.
There's already a video on the channel showing the mason at work (it's in Portuguese):
What Arraial is
In regular Minecraft, you're the one who builds everything. Villagers do have professions, but the village doesn't grow on its own.
In Arraial, the village belongs to its residents (moradores). You found the settlement, hire people and choose what to build. From there, they fetch materials, raise the buildings, farm, chop wood, tend the animals and defend the place at night.
You stop being the mason and become the one who plans the village.
How it works, in 3 steps
- Hire a mason: use the Mason's Contract on a resident.
- Pick a project: open the Book of Blueprints, choose a building (the chat shows its material list) and apply it to the Construction Marker, which marks where it will go.
- Supply and watch: leave the materials in a chest. The mason fetches them, walks to the site and places block after block. If something is missing, he tells you what it is.
That's the summary from the short I posted:
The inspiration: Brazil's arraiais
The name isn't random. Many Brazilian towns started out as an arraial: a small settlement, usually formed around a cross or a chapel, that grew house by house. Diamantina, in Minas Gerais, for example, began as Arraial do Tijuco.
The mod tries to capture that feeling:
- The arraial is born at the Village Cross. You place the Village Cross (Cruzeiro) block and the settlement is founded there, with a randomly picked period name: Arraial de Santa Luzia, do Bom Jesus, da Pedra Branca, do Tijuco…
- Buildings start simple: a well, a wattle-and-daub hut, a ranch house, a crop field. The goal is to reach a metropolis one day.
- Trades have local names: pedreiro (mason), lenhador (woodcutter), roceiro (farmer), oleiro (potter), pastor (herder), barreiro (clay digger), cavouqueiro (quarryman) and soldado (soldier).
- Residents have Brazilian names, men and women, each with their own look.
The village comes alive
Every resident has a routine. They look for a free bed, open doors, walk home when it gets dark, sleep and wake up in the morning to work. Spare beds in the arraial attract newcomers.
Trades work through workstations. A resident claims a free workstation the same way they claim a bed:
| Workstation | Trade | What they do |
|---|---|---|
| Woodcutter's Stump | Woodcutter | Fells only natural trees, always replants and stores the wood |
| Farmer's Basket | Farmer | Harvests, replants and sows the fields |
| Potter's Kiln | Potter | Makes bricks and whatever the building sites need |
| Herder's Trough | Herder | Shears, breeds and tends the flock |
| Clay Digger's Tub | Clay digger | Digs earth and clay |
| Quarryman's Bench | Quarryman | Cuts stone |
| Guard Post | Soldier | Patrols and fights monsters inside the arraial |
A real economy
This is my favorite part. Everything the residents produce goes to the Village Storehouse, a shared depot. The mason fetches materials from it when the site chest runs out.
And the village knows what it needs. It looks at what the ongoing builds are missing, breaks that down through the recipes (planks, doors, bricks…) and each craftsman makes what they can. It also keeps 3 days' worth of bread.
Food matters:
- Each resident eats once a day, taking food from the storehouse.
- Newcomers bring 2 days of provisions.
- A hungry resident doesn't work. After 3 hungry days, they leave.
All of this is recorded in the Arraial Chronicle: the founding, arrivals, trades, finished buildings, hunger, departures and deaths, each with its day. You can even get a written copy in a book.
The mayor and the dangers of the night
When the arraial reaches 4 residents, it elects a mayor. Every morning the mayor decides which building the village needs most, checks the materials can be obtained, looks for flat ground and hires a mason for the job.
The night got more dangerous too. Zombies, skeletons, spiders and raiders now hunt residents. They flee, heal when they eat and call the soldiers when they get hurt.
Where it stands
Arraial is at version 0.1.0, built with Fabric for Minecraft 26.3, in Java 25. Development is split into milestones:
| Milestone | What it delivers | Status |
|---|---|---|
| 1 | Mason who builds catalog projects from a chest | Tested in game (it's what the videos show) |
| 2 | The arraial lives: Village Cross, residents, beds, day and night routine | Implemented, not yet tested in game |
| 3 | Economy: storehouse, woodcutter, farmer, potter, food and Chronicle | Implemented, not yet tested in game |
| 4 | Mayor, soldiers, herder, clay digger, quarryman and monsters | Implemented, not yet tested in game |
The catalog currently has 10 buildings: well, hut, ranch house, sawmill, crop field, pottery, corral, watchtower, barrier and quarry.
The most recent improvements were recipes that respect the wood type, a minimum stock managed by the mayor and priorities between building sites. I also fixed some behaviors: the woodcutter now replants every stump the moment it's cut, and the farmer no longer gets stuck trying to sow without seeds.
The next step is to play a lot, test milestones 2, 3 and 4 in game and fix whatever shows up. There's no public version to download yet. When there is, I'll post it here.
Follow the development
I also post video content over there. Follow along:
- YouTube: @dev.gui01
- TikTok: @dev.gui1
If you play Minecraft and have an idea for a building or trade that would fit an arraial, let me know. Every idea helps.
See you in the next one. ⛏️