Arraial Brazilian colonial village mod for Minecraft
Found a hamlet in the backlands and watch it become a city. Villagers with trades, buildings raised block by block, markets, festas, politics, wars between villages, eras of Brazilian history and Brazilian wildlife.
Minecraft 26.3FabricJava 25version 1.0.0-beta.3
Overview
- 19 trades, each with its own workstation.
- Construction projects built block by block from the storehouse. The mayor orders works on their own.
- Stages: Povoado → Arraial → Vila → Prosperous Vila → Cidade.
- Economy: réis, a market stall with supply-and-demand prices, peddlers, orders, muleteers between villages, beaten roads and contracts.
- Calendar and festas: Saint John, the patron saint, the Great Fair and each village's traditions.
- Crises: drought, flood, pests, highwaymen, epidemics and fire.
- Politics: a council of interest groups, proposals, votes, taxes, corruption, protests and hereditary coronéis.
- A living world: caravans of settlers arrive and found hamlets before your eyes; neighbouring villages grow, migrate, trade, go to war and fall to ruin, where bandits move in.
- Territory and diplomacy: chunk borders, disputes, war and peace with tribute. At the Chancery you propose treaties, demand tribute and declare embargoes. There is also a Regional Map.
- Culture and personal life: flags and customs, personalities, friendships, favours, weddings, children and inheritance.
- Eras: Colonial, Imperial and Republican, with houses and streets reformed in each style.
- Fazendas: sugar mills (sugar, rapadura), coffee plantations (roasted coffee, cafezinho), queijo coalho and charque.
- Baroque: soapstone, gilded carving, the carver and the Mother Church; mining towns get white houses on soapstone.
- Spanish missions: some neighbours are missions, with their own names, flag, adobe and bell-gable church, and a tenser frontier.
- Brazilian wildlife: capybara, giant anteater, caiman, jaguar and macaw (red, blue-and-yellow, hyacinth) in warm biomes. The jaguar hunts corral animals and the caiman lurks at the riverbank.
- Armour from other mods: soldiers wear the best armour and weapon in the storehouse, from any mod.
- Items: machete, peixeira, sickle, vaqueiro leather, flask, Brazilian foods and colonial blocks.
- In-game guide: a 56-page manual with clickable contents.
Getting started
First steps
I. First daysBefore founding
• Cruzeiro: 5 logs of any wood in a cross
• Armazém: planks and a chest
• beds and food
Flat ground, with water and trees nearby.
Install
- Fabric Loader 0.20.1+, Fabric API and Java 25.
- Optional: JEI or REI, Jade, Xaero's Minimap, Mod Menu, Farmer's Delight Refabricated, Terralith.
- Required on both server and client.
The Guide
The same text as the Arraial Guide, the book you get when you place your first Cruzeiro (or craft with book + stick).
First days (6)
Before founding
• Cruzeiro: 5 logs of any wood in a cross
• Armazém: planks and a chest
• beds and food
Flat ground, with water and trees nearby.
Place the Cruzeiro: a Povoado is born, reaching 48 blocks. Another arraial must be 96+ blocks away.
Put the Armazém within reach and store food in it: the pantry of all.
Every free bed draws people: one villager comes at a time, about every minute.
Without a trade, they look for a free workstation within reach and take it.
1. Builder's Contract (paper, emerald, brick): use it on the ground.
2. Construction Marker (plank, stick, paper).
3. Book of Projects: pick the project and click the Marker.
Materials come from the Armazém.
Each villager eats 1 food a day from the Armazém. Hungry, they do not work; after 3 hungry days they leave.
Field + Basket: the farmer plants and bakes bread. Cassava cuttings turn up in the grass.
☐ Cruzeiro
☐ Armazém with food
☐ 2 or 3 beds
☐ Builder
☐ Huts
☐ Field and Sawmill
☐ Well
With 6 villagers, Armazém and Well: Arraial!
Growing (11)
The mayor
With 4 villagers, the eldest becomes mayor and orders works on their own, as needed: houses, food, defence.
Once the Town Hall stands, they govern from there.
Arraial: 6 villagers, Armazém, Well
Vila: 14, Town Hall, Market
Prosperous Vila: 24, Apothecary, Palisade
Cidade: 40, Muleteer Ranch, satisfaction 60
Rises with food, homes, health, safety, services and festas; falls with crises and taxes.
Low: people leave and the mayor loses trust (new election).
High: people arrive faster.
Réis: copper ingot and paper = 3 réis; gold ingot and paper = 12 réis.
At the Market Stall (by day, with a stallholder): réis in hand buys, goods in hand sells. Prices rise with scarcity and fall with plenty.
At night monsters hunt villagers.
Guardhouse: soldiers.
Palisade: a fence with gates.
Engineer's posts: light.
Vaqueiro leather: protection and speed.
Drought: a well saves the field.
Flood: only in storms.
Pests: chickens eat the caterpillars.
Highwaymen: raid the Armazém at night; killing them returns the loot.
Epidemic: the sick do not work; the apothecary cures with garrafada.
Fire: everyone runs with buckets.
In the morning the mayor orders repairs. Allies send food.
A year of 12 months of 2 days. April to October: dry season. November to March: rains.
Saint John (June 2), Patron Saint, Great Fair (Mar/Sep 1: 15% off) and each village's traditions.
Food to spare in the Armazém and Bunting make the festa better.
Go to the festa and bring sweets (pé-de-moleque, rapadura): you earn the people's recognition.
Settlements spring up near yours and grow on their own.
The muleteer trades surpluses; the envoy visits.
An ally (reputation 50+) helps in crises; an enemy (-50) sends highwaymen.
Council: Farming, Crafts, Order, Commerce and People.
Ballot box: see the council.
Ballot box + paper: you propose (tax, works, festa...).
Réis in the box: a campaign, with a risk of scandal.
Greatness (13)
Eras
Colonial: wattle and daub, dirt.
Imperial: Vila + Pottery + 40 réis.
Republican: Prosperous Vila + Chapel + Registry + 80 réis.
It changes on its own.
Every morning the builders reform houses and streets:
Imperial: brick, tiles, cobbles, lanterns
Republican: lime, azulejo, setts
Uses brick, clay and stone from the Armazém.
Imperial unlocks the Chapel (bell, cross).
Republican unlocks the Fountain on the square.
Both bring satisfaction. The mayor orders them when the era comes.
Each arraial owns the chunks around it; it grows with stage and people.
Border Marker: adds 3x3 chunks.
As you walk, the screen says: lands of X, disputed, or no one's.
Shared land, the same resources, bad blood and robberies raise tension: it becomes a dispute, and at reputation -50, war.
In war: roads close, skirmishes; the weaker sues for peace and pays tribute.
Escrivaninha: map and neighbours. Peace, Trade, Alliance, Border, Tribute, Break, Embargo.
1 paper per proposal, once a day; they may refuse.
Each village has its own flag, customs and traditions.
Go to festas, bring sweets:
known → friend of the festa (you get the flag) → child of the land (Medal).
Villagers who are friends marry at the Cruzeiro and share a surname.
A couple with a bed and food to spare has children, who grow up in 3 days.
Under a coronel, the child inherits command.
An abandoned village becomes a ruin; neighbours may resettle it, or bandits make a hideout.
Clear the hideout: réis, a loot chest, the Medal.
Your base left alone 8+ days may be taken too.
☐ 40 villagers
☐ Muleteer Ranch
☐ Satisfaction 60+
☐ Republican era
☐ Chapel and Fountain
☐ Allies and beaten roads
☐ Child of the land
And plenty of festas.
With 7 villagers and water: a Sugar Mill (cane, sugar, rapadura).
In the Imperial era: a Coffee Plantation.
The herder makes queijo coalho from the corral's milk and charque from spare beef.
In the Imperial era a Prosperous Vila (or a mining Vila) brings a carver and raises the Mother Church: lime, soapstone and gilded carving.
Mining towns get white houses on soapstone.
Some neighbours are missions: Spanish names, the cross of Burgundy, adobe walls and a church with a bell-gable.
On the frontier, tension rises more easily.
Commerce (5)
At the Stall
Réis in hand: buy what the stallholder shows.
Goods in hand: sell.
High reputation gives a discount. At the Great Fair, 15% off.
Comes from a neighbouring village with real goods, taken from its stock.
Click them: buy and sell with réis. They leave at dusk. Road closed: they do not come.
Stall + paper: the arraial orders something it lacks, with a deadline and a reward.
Deliver at the Stall in time: réis and reputation.
The muleteer takes the surplus and brings what is missing; they may be robbed.
Sword in hand as they leave: you escort (risk 1/4), paid later.
10+ trips: beaten road, 30% cheaper.
A neighbour with plenty makes things cheaper; a closed road, war or embargo makes them dearer.
Each village has a speciality (farming, mining...) and signs supply contracts with the others.
Tips (2)
Cruzeiro: report.
Sneaking: chronicle.
With a book: a copy of the chronicle.
Villager: talk, favours, card.
JEI: click a mod item to read what it does.
/arraial crise
/arraial festa
/arraial era
/arraial casamento
/arraial mundo
/arraial avancar
/arraial guerra
/arraial obra_pronta
Good luck, founder!
Trades
A villager without a trade takes the nearest free workstation. Each workstation comes with a building the mayor orders when the village needs it.
| Trade | Workstation | What they do |
|---|---|---|
| Mason | hired | Raises the buildings with material from the storehouse. A villager becomes a builder with the Builder's Contract or when the mayor needs one. |
| Woodcutter | WOODCUTTER post: a villager without a trade becomes a woodcutter and brings logs and planks. | |
| Farmer | FARMER post: plants and harvests wheat and cassava; wheat becomes bread. | |
| Potter | POTTER post: turns clay into bricks, tiles and pottery. | |
| Clay Digger | CLAY DIGGER post: digs clay in the direction the post faces. | |
| Quarryman Quarrywoman | QUARRYMAN post: opens a quarry (with a ladder) and brings stone. | |
| Herder | HERDER post: keeps the pen and brings wool, leather and meat. Animals near the trough are never hunted. | |
| Fisher | FISHER post: fishes in water within 28 blocks. | |
| Hunter | HUNTER post: hunts wild game (never pen, tame, leashed or named animals) and leaves 3 of each species. | |
| Flour Maker | FLOUR MAKER post: cassava becomes flour (yields more than wheat), beiju and paçoca. | |
| Market Seller | SELLER post and market: réis in hand buys, goods sell, paper takes a supply order. | |
| Muleteer | MULETEER post: takes surplus to other villages and brings back what is missing. Sword in hand: escort the troop. | |
| Apothecary | APOTHECARY post: makes remedies from flowers and cures the sick in an epidemic. | |
| Soldier | SOLDIER post: defends against monsters, bandits and militias; escorts the herder. | |
| Engineer | ENGINEER post: lays streets, builds bridges and lamp posts with materials from the Storehouse. | |
| Public Relations | Workstation of the RELAÇÕES PÚBLICAS. Click to open the Chancery: regional map, neighbours, treaties, tribute and embargo. | |
| Sugar Master | Workstation of the SUGAR MASTER. Cuts the cane around it, plants new cane by the water and grinds it: half becomes sugar, half rapadura. | |
| Coffee Grower | Workstation of the COFFEE GROWER. Picks ripe coffee bushes, plants new ones, and dries and roasts the cherries (2 cherries = 1 roasted coffee). | |
| Carver | Workstation of the CARVER. Makes gilded carving (planks and a gold nugget) for the Baroque Mother Church. | |
| Peddler | hired | A travelling peddler who passes through villages with goods from afar. |
Buildings & stages
Chosen in the Book of Projects and clicked on a Construction Marker, or ordered by the mayor. Builders raise them block by block from the storehouse; the style changes with the era and the village's culture.
- Well
- Wattle-and-Daub Hut
- Wooden Ranch House
- Sawmill
- Field
- Pottery
- Corral
- Watchtower
- Clay Pit
- Quarry
- Town Hall
- Stockade
- Flour House
- Market
- Muleteer's Shelter
- Apothecary
- Fishing Hut
- Hunter's Shelter
- Engineer's Workshop
- Registry Office
- Chapel
- Fountain
- Sugar Mill (Engenho)
- Coffee Plantation
- Carver's Workshop
- Mother Church (Matriz)
- Mission Church
Village stages
More people and more satisfaction move the hamlet up a stage:
- Hamlet
- Arraial
- Town
- Prosperous town
- City
Items & blocks
Everything the mod adds, with recipes. Hover an ingredient to see its name.
Blocks
Construction Marker
Site Marker: pick the project with the Book of Projects and builders build it with materials from the Storehouse.
Village Cross
Founds a village (48 block reach). Free beds draw villagers. Click: report; sneaking: chronicle; with a book: a copy of the chronicle.
Village Storehouse
The village's stock: everyone's food and building materials. Villagers store and take from here.
Woodcutter's Stump
WOODCUTTER post: a villager without a trade becomes a woodcutter and brings logs and planks.
Farmer's Basket
FARMER post: plants and harvests wheat and cassava; wheat becomes bread.
Potter's Kiln
POTTER post: turns clay into bricks, tiles and pottery.
Guard Post
SOLDIER post: defends against monsters, bandits and militias; escorts the herder.
Herder's Trough
HERDER post: keeps the pen and brings wool, leather and meat. Animals near the trough are never hunted.
Clay Digger's Tub
CLAY DIGGER post: digs clay in the direction the post faces.
Quarryman's Bench
QUARRYMAN post: opens a quarry (with a ladder) and brings stone.
Flour Oven
FLOUR MAKER post: cassava becomes flour (yields more than wheat), beiju and paçoca.
Market Stall
SELLER post and market: réis in hand buys, goods sell, paper takes a supply order.
Pack Saddle
MULETEER post: takes surplus to other villages and brings back what is missing. Sword in hand: escort the troop.
Apothecary Counter
APOTHECARY post: makes remedies from flowers and cures the sick in an epidemic.
Oil Lamp
Oil lamp with a flickering flame. Engineers use torch lamp posts.
Fish Trap (fisher's post)
FISHER post: fishes in water within 28 blocks.
Hunting Rack
HUNTER post: hunts wild game (never pen, tame, leashed or named animals) and leaves 3 of each species.
Engineer's Drafting Board
ENGINEER post: lays streets, builds bridges and lamp posts with materials from the Storehouse.
Writing Desk
Workstation of the RELAÇÕES PÚBLICAS. Click to open the Chancery: regional map, neighbours, treaties, tribute and embargo.
Festa Flags
Festa decoration. Four or more near the Cruzeiro make festas prettier.
Council Ballot Box
The village council: see the groups, propose with paper, campaign with réis.
Boundary Stone
Extends the nearest village's territory (3x3 chunks). Counts as a border post in conflicts.
Wattle and Daub
The colonial wall: clay packed into a lattice of sticks. Builders raise taipa houses in the Colonial era.
Clay Roof Tiles
Barrel clay roof tiles. In the Imperial era roofs become tiles (tile stairs and slabs).
Clay Tile Stairs
Clay Tile Slab
Whitewashed Wall
Lime-whitewashed wall. In the Republican era the walls turn white.
Azulejo Tiles
Blue and white glazed tiles: the lower band of Republican façades.
Sugar Mill
Workstation of the SUGAR MASTER. Cuts the cane around it, plants new cane by the water and grinds it: half becomes sugar, half rapadura.
Coffee Drying Yard
Workstation of the COFFEE GROWER. Picks ripe coffee bushes, plants new ones, and dries and roasts the cherries (2 cherries = 1 roasted coffee).
Carver's Bench
Workstation of the CARVER. Makes gilded carving (planks and a gold nugget) for the Baroque Mother Church.
Soapstone
The stone of the Baroque of Minas. In mining towns from the Imperial era, foundations and paving become soapstone.
Gilded Carving
Carved, gilded wood of the Baroque altars. Used in the altarpiece of the Mother Church.
Adobe
Sun-dried bricks of mud and straw: the wall of the Spanish missions.
Items
Book of Blueprints
Click a Site Marker to choose what to build (houses, fields, well, town hall...).
Mason's Contract
Click a villager to make them a builder.
Cassava Cutting
Cassava cutting: found by cutting grass or harvested from fields. Plant on farmland.
No recipe: it comes from the villagers' work, trade or the world.
Cassava Root
Harvested from ripe cassava. Smelt it into flour.
No recipe: it comes from the villagers' work, trade or the world.
Cassava Flour
Smelt cassava, or let the flour maker do it. Two flours make a beiju.
Beiju
Rapadura
Paçoca
Gourd Bowl
Gourd of Cane Juice
Cane juice in a gourd: speed for 45 s.
Leather Hat
The backlands leather hat (worn on the head).
Réis
The village currency. Earn it selling at the stall, filling orders, doing favours and escorting. Can also be minted from copper or gold.
Herbal Remedy
Remedy: cures a sick villager (click them).
Arraial Guide
Book with everything about the mod. The founder of a village gets one.
Quentão (spiced drink)
Hot festa drink: regeneration. Give it to villagers during a festa to earn recognition.
Pé-de-moleque
Machete
Backlands machete: hits hard. Pillagers sometimes carry one.
Peixeira Knife
Long knife: less damage, very fast strikes.
Sickle
Click a ripe crop: reaps 3x3 and replants.
Leather Jerkin
Part of the cowboy's leather. Hat + jerkin + chaps + alpargatas: cowboy agility.
Cowboy Chaps
Alpargatas
Flask (empty)
Click water to fill. Drunk, it removes hunger and poison.
Flask of Water
No recipe: it comes from the villagers' work, trade or the world.
Loot Sack
Carried by bandits and highwaymen. Click to open.
No recipe: it comes from the villagers' work, trade or the world.
Arraial Medal
The village's honour: for a child of the land or whoever clears a bandit hideout.
No recipe: it comes from the villagers' work, trade or the world.
Regional Map
Shows the arraiais around: the land of each (in its flag colour), disputed land, roads (beaten, closed, at war, under embargo), ruins, bandits, you and your base. At an Escrivaninha the same map becomes the Chancery.
Coffee Cherry
Picked from a ripe coffee bush. Planted in dirt it grows a new bush; smelted it becomes roasted coffee.
No recipe: it comes from the villagers' work, trade or the world.
Roasted Coffee
Cafezinho
Cuia, roasted coffee and sugar. Haste (faster mining and digging) for a minute and a half.
Queijo Coalho
The herder makes it every morning from the milk of the corral's cows (one cheese for two cows).
No recipe: it comes from the villagers' work, trade or the world.
Charque
Salted, dried beef: the herder makes it from spare beef in the storehouse, or you can at a campfire (slowly).
Baião de Dois (Rice and Beans with Cheese)
Moqueca (Fish Stew)
Vaca Atolada (Beef and Cassava Stew)
Wildlife
Five Brazilian animals live in the warm biomes. All have a spawn egg in the Arraial creative tab.

Capybara
Where it lives: Rivers, swamps, savannas and jungles
Capybara: lives in groups by rivers, lakes and swamps of warm lands. Tame, a good swimmer; breed with melon, sugar cane or wheat. Drops leather and meat.
Giant Anteater
Where it lives: Savannas and plains
Giant anteater: wanders slowly and alone through savannas and plains. Harmless; breed with sweet or glow berries.
Caiman
Where it lives: Swamps and rivers, at the water's edge
Caiman: lurks at the water's edge. On dry land it leaves you alone, but it bites whoever comes close to the bank and snatches chickens and young capybaras. Breed with fish.
Jaguar
Where it lives: Jungles (rare in savannas)
Jaguar: lord of the jungle. Slips away from people unless attacked, but now and then hunts capybaras and farm animals. A village near the jungle wants its soldiers.
Macaw
Where it lives: Jungles and savannas
Macaw: red, blue-and-yellow or hyacinth, in jungles and savannas. Flies, perches and dances like a parrot (tame it with seeds), but it is too big for your shoulder.
Integrations & config
Integrations (all optional)
- JEI and REI: recipes and information pages.
- Jade: trade, village, family and mood of villagers; stage, satisfaction and mayor on the Cruzeiro.
- Xaero's Minimap: the villages you know become waypoints in their flag colour.
- Mod Menu: a settings screen. Without it, edit
config/arraial.json. - Farmer's Delight Refabricated: baião de dois, moqueca and vaca atolada in the cooking pot; the peixeira works as a knife.
- Terralith: every biome recognised by the map and village cultures.
Settings
Through Mod Menu or the file config/arraial.json. On a server, the server's file applies.
- Neighbours nearby
- Autonomous villages appear near your arraial, so you have someone to trade, negotiate and quarrel with.
- Max autonomous villages
- How many autonomous villages may exist in the world at once.
- Mission chance
- Chance that a new autonomous village is a Spanish mission.
- Bandits in your base
- Your base, left alone for many days outside any territory, may be taken by bandits.
- Crises
- Drought, flood, pests, highwaymen, epidemics and fire.
- Crisis frequency
- 100% is normal; 0% almost never; 300% much more often.
- Villager arrivals
- Seconds between newcomers while there are free beds.
- Soldiers use the storehouse
- Soldiers wear the best armour and weapon in the storehouse, from any mod.
- Border notice
- Shows "Lands of..." when crossing a border.
- Villages on the minimap
- Villages you know appear as waypoints on Xaero's Minimap and World Map.
- Live founding
- New villages are founded before your eyes: a caravan of settlers arrives, plants the Cruzeiro and the builder raises the first works. Off: they appear ready.
Commands
Operator commands (level 2, cheats on). For testing, recording videos and getting unstuck. Use near a Cruzeiro.
/arraial diagnostico- Summary of the nearest village: people, beds, hunger, food, works, trades and the current request.
/arraial cronica- Shows the village chronicle (its history).
/arraial tesouro- Shows or changes the village treasury (réis).
/arraial colonos- Calls a caravan of settlers to found a hamlet in front of you.
/arraial vila_nova- Creates a neighbouring autonomous village.
/arraial crise- Starts or ends a crisis (drought, flood, pests, highwaymen, epidemic, fire).
/arraial festa- Starts a festa now.
/arraial era- Changes the village era and reforms the houses in the new style.
/arraial guerra- Turns a feud between two villages into war.
/arraial avancar- Advances days in distant (unloaded) villages.
/arraial tropa- Sends the muleteer on the road.
/arraial mascate- Calls a peddler.
/arraial conselho- Shows the council and the proposals being voted.
Gallery













FAQ
Which version?
Minecraft 26.3 with Fabric Loader 0.20.1+, Fabric API and Java 25.
Does the server need it?
Yes, both server and players. The server's settings apply.
Does it work in an existing world?
Yes. Just craft a Cruzeiro. Neighbouring villages and wildlife appear in new chunks.
My villagers build nothing.
Check the storehouse (it needs material and food), whether there is a builder and free flat ground. Click the Cruzeiro: the report says what is missing.
The village does not grow.
New villagers only arrive when there is a free bed. Low satisfaction (hunger, homelessness, crisis) also holds the stage back.
Can I use it in a modpack or video?
Videos and streams: go ahead. Modpacks: yes, as long as the mod is downloaded from CurseForge or Modrinth. See the licence on GitHub.
I found a bug!
Open an issue on GitHub with the version, your mods and the log.