Recruits: Village Expansion – Addon for Recruits

To report bugs or suggest features click here

For test builds click here

FAN MADE ADDONS

Recruits: Village Expansion is an addon for Recruits (also requires workers!) that introduces a fully autonomous village system. Each settlement has its own center, faction, and internal logic, allowing villages to function as living communities capable of organizing themselves, growing, and defending their territory without player involvement.

Villages created by this addon are not static structures: they are active entities that manage recruits, assign roles, maintain their identity, and react to world events. Each village can expand, build functional structures, establish territory, and maintain internal balance between civilians, soldiers, and resources.

The goal is to turn villages into autonomous factions, consistent and believable, interacting dynamically with the world and the player. The result is a more alive, emergent, and strategic experience that integrates seamlessly with Recruits.

NEW UPDATE Make your custom factions!( for now no special buildings for a singular faction will be added later)

to start creating a faction do /vrfaction (everything is explained in the game after you do the command) also if you don't have items and wanna exit the menu just press esc grab what you need and then redo /vrfaction even tho it is explained in game its better to know that your progress will be kept after exiting the faction creating menu.

to test your special faction do /vrspecial next then the tips should tell you what to write and after doing it the next village to spawn will have your special faction!

📦 ADD NEW BUILDINGS INSTRUCTIONS

How to Make Custom Structures for the Village Recruits Addon

This guide explains how to build and save your own structures so they show up in villages. There are two kinds of structure you can make:

• Tower replacements – the big central building of a village (the "town hall").
• Normal buildings – the ordinary houses and workplaces scattered around it.

Each kind has its own rules. Read the rule box for the kind you are making. If you get the rules wrong, your village will spawn broken (no soldiers, no villagers, or duplicate town halls), so please follow them carefully.

You do not need to know how to code. Everything here is done in‑game with the vanilla Structure Block. The only "special" parts are two blocks and one command, all explained below.

The two special blocks you need to know

Block	Where it comes from	What it does	Item/ID
Recruit block	The base Recruits mod	Turns villagers into recruits and becomes the village center for the village	recruits:recruit_block
Villager spawn block	This addon	Pops out 16 villagers to populate the village, then disappears	village_recruits:basic_villager_spawner

You place these blocks inside your build like normal blocks. When the village is generated in a real game, they automatically turn into the recruit / villagers.

⚠️ The villager spawn block self‑destructs!

The moment it ticks in the world, the villager spawn block spawns its villagers and removes itself. If you try to save a structure with it still in place, it will already be gone — your structure ends up with no villagers. The fix is one command, explained in Step 0 below. Do this first, every time.

Step 0 — Freeze the villager spawn block (DO THIS FIRST)

Before you place a villager spawn block in your build, run this command once:

/vr disable_spawner

This stops every villager spawn block from activating, so it will sit still in the world and let you save it into your structure. You will see