lgoo

🏘️ VillagerVault

The Ultimate Villager Management Plugin for Minecraft

Infinite stock · Villager pickup · Protection · Leashing · Trade discounts Glow · Freeze · Backup & restore · Stats · Bedrock support — all in one plugin.

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

📖 Links

· [Discord] ·

Made by Anonventions

VillagerVault