
?️ VillagerVault
Minecraft 终极村民管理插件
无限库存 · 村民拾取 · 保护机制 · 拴绳绑定 · 交易折扣
发光效果 · 冻结移动 · 备份与恢复 · 数据统计 · 基岩版支持 —— 全部集成在一个插件中。
✨ 功能概览
以下列出的所有功能均可在 config.yml 中独立启用或禁用。
? 无限村民库存
交易永远不会耗尽。每次打开菜单时自动重置。适用于所有职业及流浪商人。支持按世界单独切换。
? 村民拾取与放置
Shift + 右键进行拾取 · 右键点击方块将其放回。
- ✅ 职业、等级、经验值、生物群系类型
- ✅ 所有交易及其定价和需求数据
- ✅ 自定义名称与健康值
- ✅ 支持 CustomModelData 以适配 3D 资源包模型
- ✅ 基岩版玩家手持可配置物品(默认:木棍)并右键即可拾取
?️ 村民保护
阻止来自 13 种以上的伤害来源——玩家、怪物、闪电、熔岩、火焰、爆炸、窒息、溺水、摔落、投射物、仙人掌、凋灵——或直接开启全部防护。
? 村民拴绳绑定
手持拴绳右键点击即可将村民拴住。这是原版不允许的操作,但 VillagerVault 可以实现。
? 防止僵尸化
村民永远不会变成僵尸村民。在感染发生前即予以取消。
? 交易价格折扣
基于权限的等级体系:10%、25%、50%、75%——或添加自定义比例。最高等级自动应用。关闭界面后恢复原价。
|
?️ 村民名牌
自动格式化的名牌:{profession}(职业)、{level}(等级)、{health}(健康值)。支持配置更新间隔。可选支持流浪商人。
? 冻结 / 禁止漫游
/vv freeze 锁定指定村民的位置。PDC 持久化存储——重启后依然生效。可选择默认冻结所有村民。
? 村民信息面板
手持时钟 + 右键 → 显示详细信息的聊天面板,包含职业、等级、经验值、交易列表、可视化血条及坐标。
✨ 村民发光
/vv glow 高亮显示附近的村民,发出彩色光芒并可穿透墙壁可见。具有自动过期机制。
? 死亡备份与恢复
村民死亡后自动备份。执行 /vv restore list 可查看带有可点击恢复按钮的列表。完整保留数据及死亡位置。
? 统计信息与 PlaceholderAPI
按玩家追踪:拾取次数、放置次数、交易次数。自动保存至磁盘。
%villagervault_pickups% · %villagervault_placements% · %villagervault_trades% · %villagervault_carrying%
|
? 基岩版支持
| ? |
自动检测——启动时自动检测 Floodgate/Geyser,无需任何配置 |
| ? |
基于物品的拾取——基岩版玩家手持可配置物品(默认:木棍)并右键即可拾取村民,无需潜行 |
| ? |
安全格式化——无乱码符号,无不可见文本,血条显示清晰 |
| ? |
无点击事件——帮助菜单和恢复菜单对基岩版渲染为纯文本 |
| ? |
全功能兼容——所有功能在两个版本中表现完全一致 |
? 命令
| 命令 |
描述 |
权限 |
/vv help |
显示所有可用命令 |
— |
/vv reload |
重新加载配置文件 |
villagervault.reload |
/vv tp |
将最近的传送至你身边 |
villagervault.teleport |
/vv tphere [radius] |
将半径内所有村民传送到你身边 |
villagervault.teleport |
/vv heal [radius] |
治疗半径内所有村民 |
villagervault.heal |
/vv freeze |
冻结/解冻目标村民 |
villagervault.freeze |
/vv glow [radius] |
高亮显示附近发光的村民 |
villagervault.glow |
/vv stats [player] |
查看村民统计数据 |
villagervault.stats |
/vv restore list |
列出所有已死亡村民的备份 |
villagervault.restore |
/vv restore [index] |
恢复某位已死亡的村民 |
villagervault.restore |
? 权限
点击展开完整权限列表
| 权限 |
描述 |
默认值 |
villagervault.admin |
访问所有命令 |
OP |
villagervault.reload |
重载插件配置 |
OP |
villagervault.infinitestock |
该玩家拥有无限库存 |
Everyone |
villagervault.pickup |
拾取和放置村民 |
OP |
villagervault.pickup.bypass-cooldown |
绕过拾取冷却时间 |
OP |
villagervault.pickup.bypass-limit |
绕过最大携带限制 |
OP |
villagervault.protect |
受到攻击时显示保护通知 |
Everyone |
villagervault.leash |
给村民拴上拴绳 |
Everyone |
villagervault.teleport |
传送命令 |
OP |
villagervault.heal |
治疗命令 |
OP |
villagervault.info |
查看村民信息面板 |
Everyone |
villagervault.freeze |
冻结/解冻村民 |
OP |
villagervault.glow |
发光高亮显示 |
OP |
villagervault.stats |
查看个人统计数据 |
Everyone |
villagervault.stats.others |
查看其他玩家的统计 |
OP |
villagervault.restore |
复活已死亡的村民 |
OP |
villagervault.discount.10 |
交易折扣 10% |
No one |
villagervault.discount.25 |
交易折扣 25% |
No one |
villagervault.discount.50 |
交易折扣 50% |
No one |
villagervault.discount.75 |
交易折扣 75% |
No one |
? 安装方法
1. 下载 VillagerVault 并将 .jar 文件放入 plugins/ 文件夹
2. 重启服务器
3. 编辑 plugins/VillagerVault/config.yml 进行自定义设置
4. 运行 /vv reload 应用更改 — 无需重启
前置要求
|
要求 |
备注 |
| ? |
Paper 1.21+ |
或任何分支版本,如 Purpur、Pufferfish 等 |
| ☕ |
Java 21+ |
Paper 1.21 所需 |
| ? |
PlaceholderAPI |
可选 — 启用 %villagervault_...% 占位符 |
| ? |
Geyser + Floodgate |
可选 — 启用基岩版玩家支持 |
? 资源包支持
VillagerVault 支持携带的村民物品使用 CustomModelData。在 config.yml 中设置 custom-model-data 以匹配你的资源包,玩家将在背包中看到自定义的 3D 村民模型。支持任何基础材质,默认为 VILLAGER_SPAWN_EGG。

?️ 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧