---

📖 The Vision

Forget the days of "Hmmmm" and blank stares. Realistic Villagers is the ultimate overhaul for Minecraft villagers. Every villager is disguised as a dynamic, skin-aware NPC — same vanilla AI and trading underneath, a face and a life on top — bringing a level of depth and immersion previously unseen, from genealogy and marriage to region-aware personalities, whole player-run settlements, and a brand-new hologram-based interface. Whether it's building a family legacy, running a village's economy, or defending your home, every villager has a story.

---

🌐 Visual Config Website

⚠️ Heads up: The config editor is only guaranteed to work with the latest plugin version — configs generated for older releases may be missing options or out of sync with newly added settings.

---

✨ Features

🧬 The Human Factor

• Dynamic Identity: Every NPC is uniquely gendered (Male/Female) with a personality-driven skin via MineSkin.
• Professional Names: No more "Villager #432". Meet John the Farmer or Raquel the Cleric.
• Family Legacies: A deep genealogy system. NPCs remember their parents, children, and spouses across generations.
• Marriage & Procreation: Use Wedding Rings to form bonds and watch families grow over time. Child variants grow into adults.
• Gender Freedom: Disable the gender system entirely, or assign a custom gender to each player individually.

🌍 Regionality System

• Villagers are shaped by where they live. A desert biome breeds villagers with darker skin tones, Arabic names, and conversations typical of desert dwellers.
• Snowy biomes dress villagers in warm robes, give them Nordic names, an accent, and a habit of complaining about the cold.
• Every part of this system — skins, names, dialogue — is fully customizable or can be disabled if you prefer vanilla-style consistency.

🎭 Appearance Traits (requires 1.21.4+)

• Every Villager Her Own Body: Height varies per villager — and, for women, so does a figure drawn from the colours of her own skin — rather than everyone sharing one model.
• Players Get One Too: Optionally gives players the same figure, worn so it turns and moves with them and is visible in third person, not just to onlookers.
• Self-Hosted Resource Pack: The shapes live in a pack the plugin writes and serves over HTTP itself as players join — nothing to host separately, nothing to paste into server.properties.
• Fails Safe: If the pack can't reach a player — or can't be served at all — that player simply keeps the plain vanilla model instead of a broken placeholder. Heights still apply regardless, since they need no pack at all.

🏰 Settlements

• Real Villages: A bell makes a genuine settlement — named, bordered, with its own residents — drawn live on an in-world radar map that's private to whoever is looking at it.
• Mayors & Elections: Residents stand for office with electoral programmes that change what commissioning a building costs and how fast it goes up. Players and villagers both vote.
• A Working Economy: All 13 vanilla professions produce real goods for the settlement's shared stores — raw materials get refined into whatever its buildings are actually made of.
• Commission Buildings: Preview a building as a ghost before committing, then watch it rise gradually, course by course, with clearance and collision checks so settlements don't overlap themselves.
• Blueprints From Anywhere: Reads vanilla .nbt structures and WorldEdit .schem files with zero added dependencies, sorted by the region they suit — a desert village is offered desert architecture, never a snow cabin. Walk into any village, including ones this plugin never designed, and its buildings become blueprints your own settlements can raise.
• Village Storage: A shared stockpile players can deposit into and withdraw from, either from the chest GUI or the hologram menu.
• Graves: A villager who dies without a cross on hand gets a real grave — built from block and text displays, recording her parents and how she died.

🧠 Advanced Artificial Intelligence

• Strategic Combat: Villagers weigh the odds before engaging — outnumbered NPCs retreat instead of dying pointlessly, and unarmed villagers panic and flee.
• Armed & Dangerous: NPCs can wield maces and spears, with custom melee weapons configurable per profession.
• Calls for Backup: Villagers call family members for help when threatened.
• Social Interaction: Talk, joke, flirt, or insult — your reputation changes based on every word.
• Interactive Needs: Hunger, inventory management, and daily activities like looting and fishing.
• Atmospheric Revive Ritual: Lose a beloved villager? A lightning bolt striking within 2 blocks of the head begins the sacred revival ritual.

🐫 Life on the Move

• Villagers can now ride camels and llamas, wandering and traveling the world instead of standing still.

🏠 Villager Housing

• Turn any chest or barrel into a villager's personal storage by placing a sign with [Villager] on it.
• Assign specific items the villager is allowed to take from it — no more raiding the wrong chest.

🎨 Visual & Technical Excellence

• All-New Hologram Menu: A completely redesigned interactive villager menu built on holograms — prefer the classic look? Switch back to the old chest GUI with a single config toggle.
• Real-Time Nametags: Live updates as your villagers level up their trades.
• Modular Configuration: The configuration file has been split into focused parts, making it far easier to navigate and customize.
• Optional Recipes: Disable the plugin's custom trade recipes entirely if you only want the NPC/behavior systems.
• Optimized Performance: Built on PacketEvents for minimal server impact and high stability.

---

🚀 Installation

1. Dependencies: Ensure you have PacketEvents installed.
2. Plugin: Drop RealisticVillagers.jar into your /plugins/ folder.
3. Setup: Restart the server to generate the default configuration and skin cache.
4. Go! Witness the transformation of every village in your world.

---

⚙️ Configuration

The plugin is highly customizable, and the config has been split into multiple files (config.yml, gui.yml, holograms.yml, loot.yml, variable-text.yml, and more) so each system is easy to find and tweak. Prefer a visual approach? Check out the Visual Config Website above.

# procreation settings
procreation-cooldown: 6000
baby-grow-cooldown: 12000

# Social settings
villager-farm:
  allow-procreation-between-family-members: false
  ignore-sex-when-procreating: false

---

💻 Commands

Command	Description
/gender <male|female>	Set your player gender (mandatory unless disabled in config).
/rv reload	Hot-reload all configurations and messages.
/rv skins	Manage and preview NPC skin categories.
/rv genderset <player> <gender>	Admin command to override a player's gender.

Settlements have no commands of their own — right-click a village's bell or its mayor to open the settlement menu, and right-click any villager for its own hologram or chest GUI.

---

🤝 Compatibility

We play nice with others:

• PacketEvents: ✅ Required.
• ViaVersion / ViaBackwards / ViaRewind: ✅ Full support from 1.18 to 1.21.11.
• Geyser-Spigot: ✅ Bedrock players supported.
• EliteMobs: ✅ NPCs recognize and react to elite threats — elite and boss entities are left alone entirely rather than disguised as villagers.
• MythicMobs: ✅ Same idea — a Mythic-tagged entity is never mistaken for one of this plugin's own villagers.
• VillagerTradeLimiter: ✅ Its own trade limits are respected instead of raced against — this plugin defers to it rather than opening its menu on top of it.
• ValhallaMMO (premium, if installed): ✅ The villager menu's "Trade" button opens Valhalla's own custom-merchant interface instead of vanilla trading, converting the villager the first time it's used. Falls back to ordinary trading for any villager Valhalla has nothing configured for.
• ProtocolLib / ProtocolSupport: ✅ Enhanced packet handling for smooth skin transitions.

---