VillagerVault

--- ## ✨ Features at a Glance > Every feature listed below can be **independently enabled or disabled** in `config.yml`.

### 🔄 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.

### 🏷️ 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%`

--- ## 🎮 Bedrock Edition Support

🟢	Auto-detected — Floodgate/Geyser detected at startup, zero config needed
🟢	Item-based pickup — Bedrock players hold a configurable item (default: Stick) and right-click to pick up villagers — no sneaking needed
🟢	Safe formatting — No broken symbols, no invisible text, clean health bars
🟢	No click events — Help & restore menus render as plain text for Bedrock
🟢	Full feature parity — Every feature works identically on both editions

--- ## 💬 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 [radius]` | Teleport all villagers within radius | `villagervault.teleport` | | `/vv heal [radius]` | Heal all villagers within radius | `villagervault.heal` | | `/vv freeze` | Freeze/unfreeze targeted villager | `villagervault.freeze` | | `/vv glow [radius]` | Highlight nearby villagers with glow | `villagervault.glow` | | `/vv stats [player]` | View villager statistics | `villagervault.stats` | | `/vv restore list` | List all dead villager backups | `villagervault.restore` | | `/vv restore [index]` | Restore a dead villager | `villagervault.restore` | --- ## 🔐 Permissions

Click to expand full permissions list

| Permission | Description | Default | |:-----------|:------------|:--------| | `villagervault.admin` | Access to all commands | OP | | `villagervault.reload` | Reload plugin configuration | OP | | `villagervault.infinitestock` | Infinite stock for this player | Everyone | | `villagervault.pickup` | Pick up and place villagers | OP | | `villagervault.pickup.bypass-cooldown` | Bypass pickup cooldown | OP | | `villagervault.pickup.bypass-limit` | Bypass max carry limit | OP | | `villagervault.protect` | Protection notification on hit | Everyone | | `villagervault.leash` | Attach leads to villagers | Everyone | | `villagervault.teleport` | Teleport commands | OP | | `villagervault.heal` | Heal command | OP | | `villagervault.info` | View villager info panel | Everyone | | `villagervault.freeze` | Freeze/unfreeze villagers | OP | | `villagervault.glow` | Glow highlight | OP | | `villagervault.stats` | View own statistics | Everyone | | `villagervault.stats.others` | View other players' stats | OP | | `villagervault.restore` | Restore dead villagers | OP | | `villagervault.discount.10` | 10% trade discount | No one | | `villagervault.discount.25` | 25% trade discount | No one | | `villagervault.discount.50` | 50% trade discount | No one | | `villagervault.discount.75` | 75% trade discount | No one |

--- ## 📥 Installation ``` 1. Download VillagerVault and drop the .jar into your plugins/ folder 2. Restart your server 3. Edit plugins/VillagerVault/config.yml to customize 4. Run /vv reload to apply — no restart needed ``` ### Requirements | | Requirement | Note | |:--|:------------|:-----| | 📄 | **Paper 1.21+** | Or any fork — Purpur, Pufferfish, etc. | | ☕ | **Java 21+** | Required by Paper 1.21 | | 🔌 | **PlaceholderAPI** | *Optional* — enables `%villagervault_...%` placeholders | | 🎮 | **Geyser + Floodgate** | *Optional* — enables Bedrock Edition player support | --- ## 🎨 Resource Pack Support VillagerVault supports **CustomModelData** on the carried villager item. Set `custom-model-data` in `config.yml` to match your resource pack and players will see your custom 3D villager model in their inventory. Any base material works — default is `VILLAGER_SPAWN_EGG`. ---