VillagerVault

Minecraft 版本： 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： bukkit paper spigot

标签： adventure game-mechanics

---

✨ 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.

---