🏘️ Village Diplomacy

Villages are more than places to trade and sleep. With Village Diplomacy every villager has a name and a personality, every village keeps its own opinion of you, and villages that know each other negotiate, threaten each other and, if it comes to it, go to war.

Build your reputation, earn the trust of a settlement, or become the enemy of an entire village. Your actions have consequences — and the villagers remember them.

Current release: 1.5.1. A hotfix on top of 1.5.0: no more freeze when joining a world in large modpacks, and claiming your own village no longer costs reputation. Same features on Minecraft 1.20.1 and 1.21.1, on Forge, NeoForge, Fabric and Quilt.

🤝 Village Diplomacy & Warfare

Villages no longer live in isolation. Each pair of villages keeps its own relationship:

• Six diplomatic states: PEACE, TENSION, CRISIS, ULTIMATUM, WAR and TRUCE.
• Grievances: a village remembers the hostile things you did to it and turns them into a casus belli.
• War goals: tribute, border, submission and vengeance, stated in the declaration.
• Ultimatums: a village leader can send a three-day ultimatum before declaring war outright.
• Mobilization: when war breaks out, the bells of both villages ring for a day and villagers gather at the bell.
• The war itself: villagers caught outside are called back to their village, both sides have a military strength score (0–100), and clashes at the front move that score and announce their outcome.
• Truces: peace signs a three-day truce that leaves residual tension — and war memories that outlast the conflict.

Once two villages are linked, the relationship runs on its own: tension grows from grievances, an ultimatum expires into war, and a war runs out into a truce. You can watch it happen, take a side, or stay out of it.

👤 Unique Villager Personalities

Villagers are no longer generic NPCs:

• Unique names and personality types.
• Individual traits, emotions and reactions.
• Contextual messages influenced by your reputation.
• Individual trade prices.
• Different ways of reacting to your actions and to village events.

🛡️ Iron Golem System

Iron golems have their own identities and behaviour:

• Unique names and personalities.
• Individual temperaments and loyalty.
• Reactions influenced by your actions and reputation.

⭐ Dynamic Reputation System

Your actions decide how each village sees you:

• Reputation per village and per player — never a single global number.
• Witness system: a crime only counts if a villager actually sees it (real line of sight).
• 12 ranks, from LEGENDARY HERO to WANTED CRIMINAL, each one changing trade prices (from −25% to +30%) and how villagers talk to you.
• Villages react to your rank: doors, chests, beds, bells and workstations can be restricted, and building inside a village that does not trust you costs reputation.
• Reach WANTED CRIMINAL and the guards come for you.

🏡 Villages, Claims & Inns

• Claim your own village with /diplomacy claim <name>: building inside it no longer costs reputation.
• Individual village names and village-to-village relations.
• On-screen panel when you enter a village: its name, your reputation and your standing.
• Inns and hostels with a named innkeeper and their own level, who tells you where the inn is.
• Villagers hold mourning for their dead.
• Extra interactions and village information through the commands.

🧩 Compatibility

• MCA Reborn — optional, detected automatically. Their guards get names, greet you depending on your rank, and hunt you down if you become WANTED.
• Guard Villagers — optional, detected automatically. Their guards follow the same reputation rules.
• Works with both mods present, with only one of them, or with neither. No extra download and no "compat version": the integration ships inside every jar.
• No required dependencies on Forge or NeoForge. Fabric API is required on Fabric and Quilt.

⚙️ Commands

• /diplomacy info — the village you are in, your reputation and your trade prices.
• /diplomacy state, relations, grievances, warreadiness — how two villages stand.
• /diplomacy declare, ultimatum, war, peace — start and end a conflict.
• /diplomacy claim, unclaim, name, rename — your own village.
• /diplomacy setrep, setstate, settension, setrelation, setlevel — server management.
• /diplomacy test … — check guards, raids, grievances and the integration with MCA and Guard Villagers.
• Tab completion for village names (id or name) after a space.

⚙️ Configuration

71 options, all of them in config/villagediplomacy-common.toml: reputation values for every action, fire and griefing penalties, rank thresholds, restrictions, witnesses, guard behaviour, module toggles and more.

On Forge and NeoForge you can edit them in game: Mods → Village Diplomacy → Config. On Fabric and Quilt, edit the file and restart.

🌍 Languages

Fully translated into:

• English
• Spanish
• Russian

📦 Minecraft Versions & Mod Loaders

The same code and the same features on 1.20.1 and 1.21.1:

Minecraft Version	Supported Loaders	Java
1.20.1	Forge, NeoForge, Fabric, Quilt	Java 17
1.21.1	Forge, NeoForge, Fabric, Quilt	Java 21

Download the file that matches your Minecraft version and your loader, and install only one Village Diplomacy jar. The same jar goes on the client and on the server.

💬 Join the Community

Suggestions, bugs, or village wars worth telling: join the Discord.

https://discord.gg/8bDPJ7WarQ

📥 Downloads & Source

• CurseForge: https://www.curseforge.com/minecraft/mc-mods/village-diplomacy
• Modrinth: https://modrinth.com/mod/village-diplomacy
• GitHub: https://github.com/CesarMed06/Village-Diplomacy

Created by Cesoti.