{"id":166619,"date":"2026-06-09T21:28:49","date_gmt":"2026-06-09T18:28:49","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/villagervault\/"},"modified":"2026-06-09T21:28:49","modified_gmt":"2026-06-09T18:28:49","slug":"villagervault","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/villagervault\/","title":{"rendered":"VillagerVault"},"content":{"rendered":"
\n

![lgoo](https:\/\/cdn.modrinth.com\/data\/cached_images\/34e06e44ebff4f7295f2ab3f3e52d5b5ba0e86c5.png)<\/p>\n

# \ud83c\udfd8\ufe0f VillagerVault<\/p>\n

**The Ultimate Villager Management Plugin for Minecraft**<\/p>\n

![Paper 1.21+](https:\/\/papermc.io)
\n![Java 21+](https:\/\/adoptium.net)
\n![Bedrock Support](https:\/\/geysermc.org)
\n![PlaceholderAPI](https:\/\/placeholderapi.com)<\/p>\n

—<\/p>\n

*Infinite stock \u00b7 Villager pickup \u00b7 Protection \u00b7 Leashing \u00b7 Trade discounts*
\n*Glow \u00b7 Freeze \u00b7 Backup & restore \u00b7 Stats \u00b7 Bedrock support \u2014 all in one plugin.*<\/p>\n<\/div>\n

—<\/p>\n

## \u2728 Features at a Glance<\/p>\n

> Every feature listed below can be **independently enabled or disabled** in `config.yml`.<\/p>\n\n\n
\n

### \ud83d\udd04 Infinite Villager Stock
\nTrades never run out. Uses reset every time the menu opens. Works with all professions & wandering traders. Per-world toggle.<\/p>\n

### \ud83d\udce6 Villager Pickup & Placement
\n**Shift + right-click** to pick up \u00b7 **Right-click** a block to place back.
\n– \u2705 Profession, level, XP, biome type
\n– \u2705 All trades with pricing & demand data
\n– \u2705 Custom names & health
\n– \u2705 CustomModelData for 3D resource pack models
\n– \u2705 Bedrock players hold a **configurable item** (default: Stick) and right-click to pick up<\/p>\n

### \ud83d\udee1\ufe0f Villager Protection
\nBlock damage from 13+ sources \u2014 players, mobs, lightning, lava, fire, explosions, suffocation, drowning, fall, projectiles, cactus, wither \u2014 or just **ALL**.<\/p>\n

### \ud83e\udea2 Villager Leashing
\nRight-click with a **lead** to leash villagers. Something vanilla doesn’t allow \u2014 VillagerVault does.<\/p>\n

### \ud83e\udddf Anti-Zombie Conversion
\nVillagers **never** become zombie villagers. Infection cancelled before it happens.<\/p>\n

### \ud83d\udcb0 Trade Price Discounts
\nPermission-based tiers: `10%`, `25%`, `50%`, `75%` \u2014 or add your own. Highest tier auto-applies. Originals restored on close.<\/p>\n<\/td>\n

\n

### \ud83c\udff7\ufe0f Villager Nametags
\nAuto-formatted nametags: `{profession}`, `{level}`, `{health}`. Configurable update interval. Optional wandering trader support.<\/p>\n

### \ud83e\uddca Freeze \/ No Wandering
\n`\/vv freeze` locks a villager in place. **PDC-persistent** \u2014 survives restarts. Option to freeze ALL by default.<\/p>\n

### \ud83d\udd0d Villager Info Panel
\nHold a **Clock** + right-click \u2192 detailed chat panel with profession, level, XP, trades, visual health bar, coordinates.<\/p>\n

### \u2728 Villager Glow
\n`\/vv glow` highlights nearby villagers with **colored glow** visible through walls. Auto-expires.<\/p>\n

### \ud83d\udc80 Death Backup & Restore
\nDead villagers auto-backed up. `\/vv restore list` shows clickable restore buttons. Full data + death location preserved.<\/p>\n

### \ud83d\udcca Statistics & PlaceholderAPI
\nPer-player tracking: pickups, placements, trades. Auto-saves to disk.
\n`%villagervault_pickups%` \u00b7 `%villagervault_placements%` \u00b7 `%villagervault_trades%` \u00b7 `%villagervault_carrying%`<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

—<\/p>\n

## \ud83c\udfae Bedrock Edition Support<\/p>\n\n\n\n\n\n\n
\ud83d\udfe2<\/td>\nAuto-detected<\/b> \u2014 Floodgate\/Geyser detected at startup, zero config needed<\/td>\n<\/tr>\n
\ud83d\udfe2<\/td>\nItem-based pickup<\/b> \u2014 Bedrock players hold a configurable item (default: Stick) and right-click to pick up villagers \u2014 no sneaking needed<\/td>\n<\/tr>\n
\ud83d\udfe2<\/td>\nSafe formatting<\/b> \u2014 No broken symbols, no invisible text, clean health bars<\/td>\n<\/tr>\n
\ud83d\udfe2<\/td>\nNo click events<\/b> \u2014 Help & restore menus render as plain text for Bedrock<\/td>\n<\/tr>\n
\ud83d\udfe2<\/td>\nFull feature parity<\/b> \u2014 Every feature works identically on both editions<\/td>\n<\/tr>\n<\/table>\n

—<\/p>\n

## \ud83d\udcac Commands<\/p>\n

| Command | Description | Permission |
\n|:——–|:————|:———–|
\n| `\/vv help` | Show all available commands | \u2014 |
\n| `\/vv reload` | Reload the configuration | `villagervault.reload` |
\n| `\/vv tp` | Teleport the nearest villager to you | `villagervault.teleport` |
\n| `\/vv tphere [radius]` | Teleport all villagers within radius | `villagervault.teleport` |
\n| `\/vv heal [radius]` | Heal all villagers within radius | `villagervault.heal` |
\n| `\/vv freeze` | Freeze\/unfreeze targeted villager | `villagervault.freeze` |
\n| `\/vv glow [radius]` | Highlight nearby villagers with glow | `villagervault.glow` |
\n| `\/vv stats [player]` | View villager statistics | `villagervault.stats` |
\n| `\/vv restore list` | List all dead villager backups | `villagervault.restore` |
\n| `\/vv restore [index]` | Restore a dead villager | `villagervault.restore` |<\/p>\n

—<\/p>\n

## \ud83d\udd10 Permissions<\/p>\n

\nClick to expand full permissions list<\/b><\/summary>\n

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

—<\/p>\n

## \ud83d\udce5 Installation<\/p>\n

“`
\n1. Download VillagerVault and drop the .jar into your plugins\/ folder
\n2. Restart your server
\n3. Edit plugins\/VillagerVault\/config.yml to customize
\n4. Run \/vv reload to apply \u2014 no restart needed
\n“`<\/p>\n

### Requirements<\/p>\n

| | Requirement | Note |
\n|:–|:————|:—–|
\n| \ud83d\udcc4 | **Paper 1.21+** | Or any fork \u2014 Purpur, Pufferfish, etc. |
\n| \u2615 | **Java 21+** | Required by Paper 1.21 |
\n| \ud83d\udd0c | **PlaceholderAPI** | *Optional* \u2014 enables `%villagervault_…%` placeholders |
\n| \ud83c\udfae | **Geyser + Floodgate** | *Optional* \u2014 enables Bedrock Edition player support |<\/p>\n

—<\/p>\n

## \ud83c\udfa8 Resource Pack Support<\/p>\n

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 \u2014 default is `VILLAGER_SPAWN_EGG`.<\/p>\n

—<\/p>\n

\n

### \ud83d\udcd6 Links<\/p>\n

\u00b7 [[Discord]](https:\/\/discord.com\/invite\/SG8jvb9WU5) \u00b7<\/p>\n

—<\/p>\n

**Made by Anonventions**<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

Pick’em up! Easy to use plugin to manage your vanilla villagers!<\/p>\n","protected":false},"featured_media":166620,"template":"","meta":{"_minecraft_slug":"villagervault","_minecraft_project_id":"FnUDWMgJ","_minecraft_author":"Anonventions","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":233,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"villagervault.zip","_minecraft_size_bytes":70839,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:21:41.098382Z","_minecraft_date_created":"2026-03-12T09:12:17.250088Z","_minecraft_date_modified":"2026-02-28T17:45:46.956608Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/villagervault","_minecraft_icon_attachment_id":166620,"_minecraft_imported_at":"2026-06-09T18:28:49+00:00","_minecraft_import_hash":"11298df1c56448b646a85d7f2de106f1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,89,127,129],"mod_loader":[130,132,134],"minecraft_version":[40,41,38,78,79,80,81,82],"class_list":["post-166619","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-game-mechanics","mod_category-paper","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nVillagerVault - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/villagervault\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"VillagerVault - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Pick'em up! Easy to use plugin to manage your vanilla villagers!\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/villagervault\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/villagervault\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/villagervault\\\/\",\"name\":\"VillagerVault - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/villagervault\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/villagervault\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/villagervault-icon-34e06e44ebff4f7295f2ab3f3e52d5b5ba0e86c5.png\",\"datePublished\":\"2026-06-09T18:28:49+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/villagervault\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/villagervault\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/villagervault\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/villagervault-icon-34e06e44ebff4f7295f2ab3f3e52d5b5ba0e86c5.png\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/villagervault-icon-34e06e44ebff4f7295f2ab3f3e52d5b5ba0e86c5.png\",\"width\":32,\"height\":32},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/villagervault\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"VillagerVault\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"VillagerVault - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/villagervault\/","og_locale":"en_US","og_type":"article","og_title":"VillagerVault - Minecraft","og_description":"Pick'em up! Easy to use plugin to manage your vanilla villagers!","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/villagervault\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/villagervault\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/villagervault\/","name":"VillagerVault - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/villagervault\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/villagervault\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/villagervault-icon-34e06e44ebff4f7295f2ab3f3e52d5b5ba0e86c5.png","datePublished":"2026-06-09T18:28:49+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/villagervault\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/villagervault\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/villagervault\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/villagervault-icon-34e06e44ebff4f7295f2ab3f3e52d5b5ba0e86c5.png","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/villagervault-icon-34e06e44ebff4f7295f2ab3f3e52d5b5ba0e86c5.png","width":32,"height":32},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/villagervault\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"VillagerVault"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/166619","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/166620"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=166619"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=166619"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=166619"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=166619"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}