---

📖 Overview

Realistic Villagers is a complete overhaul of the vanilla villager system. Forget "Hmmmm" and blank stares — every NPC in this plugin has a name, a gender, a family, and a will to survive. Built on PacketEvents for high performance, it replaces standard entities with dynamic, skin-aware NPCs that live, work, fight, and die in ways that actually make sense.

---

✨ Features

🧬 Identity & Family System

• Every villager is uniquely gendered (male / female) with a personality-driven skin via MineSkin integration
• No more "Villager #432" — meet John the Farmer or Raquel the Cleric
• Deep genealogy: NPCs remember parents, children, and spouses across generations
• Use Wedding Rings to form bonds and watch families grow over time
• All villagers have child variants that grow into adults

🧠 Advanced AI

• Strategic combat system — villagers calculate odds before engaging; outnumbered NPCs retreat rather than die pointlessly
• Unarmed villagers panic and flee when attacked
• Villagers can wield maces and spears; custom melee weapons configurable per-profession
• NPCs call family members for backup when threatened
• Social interaction — talk, flirt, joke, or insult; your reputation changes accordingly
• Hunger, inventory management, and daily activities (looting, fishing)

🎨 Visuals & Performance

• Real-time nametag updates on trade level-up
• Built on PacketEvents for minimal TPS impact
• Player gender selection at game start — required for all player↔villager interactions

---

🔧 Fixes (latest patch)

• Villagers no longer disappear after trade level increase
• Villagers no longer disappear after splash potion hits
• Walking and running AI restored to normal
• Nametag level display now updates correctly

---

🚀 Installation

1. Install PacketEvents
2. Drop RealisticVillagers.jar into your /plugins/ folder
3. Restart the server — configs and skin cache generate automatically
4. Run /gender <male|female> to set your player gender and begin

---

⚙️ Configuration

Nearly every feature can be toggled in config.yml. Example:

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

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

---

💻 Commands

Command	Permission	Description
/gender <male|female>	—	Set your player gender (required)
/rv reload	rv.admin	Hot-reload all configs
/rv skins	rv.admin	Manage NPC skin categories
/rv genderset <player> <gender>	rv.admin	Override a player's gender

---

🤝 Compatibility

Plugin	Status
PacketEvents	✅ Required
ViaVersion	✅ 1.18 → 1.21.1
EliteMobs	✅ NPCs react to elite threats
ItemsAdder	✅ Custom item integration
ProtocolLib	✅ Enhanced packet handling