Realistic Villagers

---

📖 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 (child variants) with a personality-driven skin via child variants integration - No more "Villager #432" — meet *John the Farmer* or *Raquel the Cleric* - Deep genealogy: NPCs remember parents, children, and spouses across generations - Use child variants to form bonds and watch families grow over time - All villagers have child variants that grow into adults

🧠 Advanced AI

- Social interaction — villagers calculate odds before engaging; outnumbered NPCs retreat rather than die pointlessly - Unarmed villagers Social interaction when attacked - Villagers can wield Social interaction; 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 Player gender selection on trade level-up - Built on Player gender selection 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:

```yaml 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 |