VillagerVault

<div align="center"> !(https://cdn.modrinth.com/data/cached_images/34e06e44ebff4f7295f2ab3f3e52d5b5ba0e86c5.png) # 🏘️ VillagerVault **The Ultimate Villager Management Plugin for Minecraft** (https://img.shields.io/badge/Paper-1.21%2B-2196F3?style=for-the-badge&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAAOCAYAAAAfSC3RAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAABDSURBVDhPYxgFgx0wMjD8B2IGID4AxEBBRkrNBGn8D8T/0cUZyNUI0vQfyP0PxFBNjOSaBdL4H8oGaWQkx6yhDhgYAHwbC/d0tcYUAAAAAElFTkSuQmCC)](https://papermc.io) (https://img.shields.io/badge/Java-21%2B-ED8B00?style=for-the-badge&logo=openjdk&logoColor=white)](https://adoptium.net) (https://img.shields.io/badge/Bedrock-Supported-00AA00?style=for-the-badge)](https://geysermc.org) (https://img.shields.io/badge/PlaceholderAPI-Optional-8A2BE2?style=for-the-badge)](https://placeholderapi.com) --- *Infinite stock · Villager pickup · Protection · Leashing · Trade discounts* *Glow · Freeze · Backup & restore · Stats · Bedrock support — all in one plugin.* </div> --- ## ✨ Features at a Glance > Every feature listed below can be **independently enabled or disabled** in `config.yml`. <table> <tr> <td width="50%" valign="top"> ### 🔄 Infinite Villager Stock Trades never run out. Uses reset every time the menu opens. Works with all professions & wandering traders. Per-world toggle. ### 📦 Villager Pickup & Placement **Shift + right-click** to pick up · **Right-click** a block to place back. - ✅ Profession, level, XP, biome type - ✅ All trades with pricing & demand data - ✅ Custom names & health - ✅ CustomModelData for 3D resource pack models - ✅ Bedrock players hold a **configurable item** (default: Stick) and right-click to pick up ### 🛡️ Villager Protection Block damage from 13+ sources — players, mobs, lightning, lava, fire, explosions, suffocation, drowning, fall, projectiles, cactus, wither — or just **ALL**. ### 🪢 Villager Leashing Right-click with a **lead** to leash villagers. Something vanilla doesn't allow — VillagerVault does. ### 🧟 Anti-Zombie Conversion Villagers **never** become zombie villagers. Infection cancelled before it happens. ### 💰 Trade Price Discounts Permission-based tiers: `10%`, `25%`, `50%`, `75%` — or add your own. Highest tier auto-applies. Originals restored on close. </td> <td width="50%" valign="top"> ### 🏷️ Villager Nametags Auto-formatted nametags: `{profession}`, `{level}`, `{health}`. Configurable update interval. Optional wandering trader support. ### 🧊 Freeze / No Wandering `/vv freeze` locks a villager in place. **PDC-persistent** — survives restarts. Option to freeze ALL by default. ### 🔍 Villager Info Panel Hold a **Clock** + right-click → detailed chat panel with profession, level, XP, trades, visual health bar, coordinates. ### ✨ Villager Glow `/vv glow` highlights nearby villagers with **colored glow** visible through walls. Auto-expires. ### 💀 Death Backup & Restore Dead villagers auto-backed up. `/vv restore list` shows clickable restore buttons. Full data + death location preserved. ### 📊 Statistics & PlaceholderAPI Per-player tracking: pickups, placements, trades. Auto-saves to disk. `%villagervault_pickups%` · `%villagervault_placements%` · `%villagervault_trades%` · `%villagervault_carrying%` </td> </tr> </table> --- ## 🎮 Bedrock Edition Support <table> <tr> <td>🟢</td> <td><b>Auto-detected</b> — Floodgate/Geyser detected at startup, zero config needed</td> </tr> <tr> <td>🟢</td> <td><b>Item-based pickup</b> — Bedrock players hold a configurable item (default: Stick) and right-click to pick up villagers — no sneaking needed</td> </tr> <tr> <td>🟢</td> <td><b>Safe formatting</b> — No broken symbols, no invisible text, clean health bars</td> </tr> <tr> <td>🟢</td> <td><b>No click events</b> — Help & restore menus render as plain text for Bedrock</td> </tr> <tr> <td>🟢</td> <td><b>Full feature parity</b> — Every feature works identically on both editions</td> </tr> </table> --- ## 💬 Commands | Command | Description | Permission | |:--------|:------------|:-----------| | `/vv help` | Show all available commands | — | | `/vv reload` | Reload the configuration | `villagervault.reload` | | `/vv tp` | Teleport the nearest villager to you | `villagervault.teleport` | | `/vv tphere ` | Teleport all villagers within radius | `villagervault.teleport` | | `/vv heal ` | Heal all villagers within radius | `villagervault.heal` | | `/vv freeze` | Freeze/unfreeze targeted villager | `villagervault.freeze` | | `/vv glow ` | Highlight nearby villagers with glow | `villagervault.glow` | | `/vv stats ` | View villager statistics | `villagervault.stats` | | `/vv restore list` | List all dead villager backups | `villagervault.restore` | | `/vv restore ` | Restore a dead villager | `villagervault.restore` | --- ## 🔐 Permissions <details> <summary><b>Click to expand f