EasyVillager
EasyVillager 是一款面向生产的村民存储与运输插件,适用于 Paper 服务器。
将村民捕获到可配置的胶囊中,安全地移动它们,通过原版的 Minecraft 商人界面与它们交易,保留其职业/等级/经验值/交易,并将它们放回世界,而不会让你的服务器的村民系统变成一堆脆弱的自定义物品栏。
专为现代生存、经济、SMP 和社区服务器打造。
✨ 功能
? 可配置的捕获物品
创建无限数量的捕获物品配置档案。
每个档案都可以独立定义:
- 材质
- 显示名称
- 描述文本(Lore)
- 已存储村民的描述文本
- 使用次数限制
- 发光效果
- 不可破坏状态
- 动态预览
- 捕获权限
- 释放权限
- 交易权限
创建专用物品,例如:
- 运输胶囊 — 捕获 + 释放
- 交易胶囊 — 捕获 + 交易
- 完整胶囊 — 捕获 + 交易 + 释放
- 你自己的自定义档案
?? 村民数据保留
EasyVillager 旨在保留被捕获村民的重要状态,包括:
- 职业
- 村民等级
- 经验值
- 交易列表
- 交易使用次数
- 交易进度
- 已存储村民的身份/状态
交易操作会更新已存储的村民,而不是创建一个断开的副本。
? 原版 Minecraft 交易
EasyVillager 使用真实的临时村民 + 原版 Minecraft 商人物品栏进行交易。
这使得 Minecraft 本身能够处理交易界面和村民进度。
优势包括:
- 原生交易 UI
- 原生村民等级/经验值显示
- 正常的交易进度
- 交易锁定
- 补货机制
- 交易使用次数更新
- 更好地兼容服务器端的村民机制
在交易会话活动期间,临时村民受到保护。
? Geyser / Bedrock 兼容
专为使用 Geyser/Floodgate 的混合 Java + Bedrock 服务器设计。
针对 Bedrock 的特有处理包括:
- 安全的商人开启时机
- 在需要时显示临时村民
- 减少客户端/服务器端物品不同步的风险
- 服务器权威的胶囊状态
无需单独的仅 Bedrock 交易插件。
?️ 领地保护
EasyVillager 旨在尊重主要的保护系统。
支持的集成包括:
- GriefPrevention
- Lands
- GriefDefender
- WorldGuard 区域过滤器
EasyVillager 不应成为玩家绕过受保护区域的手段。
捕获、交易和释放操作可以检查领地权限。
? 世界与区域过滤器
精确控制可以在哪里捕获村民。
世界过滤器支持:
- 黑名单 (BLACKLIST)
- 白名单 (WHITELIST)
WorldGuard 区域过滤器支持:
- 黑名单 (BLACKLIST)
- 白名单 (WHITELIST)
- 全局区域 ID
world:region 条目
示例:
worlds:
mode: BLACKLIST
list:
- world_nether
- event_world
⚔️ 战斗安全交易
EasyVillager 监控活跃的交易会话,以防止外部战斗插件或物品栏更改留下过期的临时村民。
如果交易会话变得无效:
- 会话将被清理
- 临时村民将被移除
- 存储的数据将同步
- 胶囊状态保持受保护
包含可选的 CombatLogX 集成。
♻️ 村民补货
已存储的村民支持可配置的补货行为。
配置:
- 工作时间
- 最小补货间隔
- 每天最大补货次数
- 启用/禁用补货
? 经验值与等级进度
交易可以更新已存储的村民:
进度阈值是可配置的。
♾️ 无限使用物品
设置:
use-limit: -1
以实现无限使用的捕获物品。
有限数量示例:
use-limit: 2
或者:
use-limit: 10
失败/被阻止的操作不会不必要地消耗一次成功使用的额度。
? 合成保护
EasyVillager 的捕获物品受到保护,不会被用作合成材料。
保护涵盖可配置配方的物品栏类型,例如:
- 合成台
- 工作台
- 锻造台
- 切石机
- 织布机
- 制图台
- 自动合成器 (Crafter)
- 熔炉
- 高炉
- 烟熏炉
- 酿造台
- 磨刀石
在玩家自己的物品栏内正常移动仍然可能。
? 原版物品保护
捕获物品可以使用不同的 Minecraft 材质,同时 EasyVillager 防止不需要的原版行为干扰自定义物品。
?️ 现代管理员 GUI
使用:
/easyvillager admin
在游戏中管理插件。
GUI 支持配置以下内容:
- 捕获
- 释放
- 交易
- 补货
- 进度
- 物品档案
- 使用限制
- 动态描述文本
- 合成保护
- 保护集成
- 存储
- 验证
- 世界/区域过滤
- 系统设置
GUI 布局可通过 gui.yml 进行配置。
? 动态 GUI 信息
GUI 按钮可以显示:
这使得管理面板更易于理解,无需频繁打开配置文件。
? 命令
/easyvillager admin
/easyvillager give <player> [profile] [amount]
/easyvillager reload
/easyvillager inspect
/easyvillager status
? 权限
| 权限 |
默认值 |
easyvillager.admin |
OP |
easyvillager.capture |
true |
easyvillager.release |
true |
easyvillager.trade |
true |
easyvillager.reload |
OP |
easyvillager.give |
OP |
easyvillager.inspect |
OP |
easyvillager.status |
OP |
⚙️ 配置
主要文件:
plugins/EasyVillager/
├── config.yml
├── items.yml
├── messages.yml
└── gui.yml
配置特意包含示例文档。
你可以从文件、游戏内管理员 GUI 或两者中配置 EasyVillager。
? 可选集成
EasyVillager 可以与以下插件共存:
- Geyser-Spigot
- Floodgate
- WorldGuard
- CombatLogX
- GriefPrevention
- Lands
- GriefDefender
这些集成是可选的。
? 推荐用于
EasyVillager 特别适用于:
- 生存服务器
- 经济服务器
- SMP(单人多人混合)服务器
- 交易服务器
- 基于村民的商店
- 社区服务器
- 使用 Geyser/Floodgate 的服务器
- 拥有领地/保护插件的服务器
- 需要可携带村民且不丢失其进度(经验、职业等)的服务器
? 安全重点
EasyVillager 包含针对常见滥用情况的防护机制:
- 胶囊复制
- 无效存储数据
- 制作物品滥用
- 原版物品交互
- 绕过受保护的领地
- 临时杀害村民
- 交易会话不同步
- 不安全的释放位置
- 无效/损坏的存储村民
? 安装
- 下载 EasyVillager JAR 文件。
- 将其放入服务器的
plugins 文件夹中。
- 启动或重启服务器。
- 查看
plugins/EasyVillager/config.yml。
- 在
items.yml 中配置物品配置文件。
- 使用
/easyvillager admin 进行游戏内配置。
❤️ 致谢
EasyVillager
由 Mr. Si!ent 创建
一款专注于让村民存储和运输变得简单、可配置且对现代 Minecraft 服务器安全的插件。
EasyVillager
EasyVillager is a production-focused Villager storage and transport plugin for Paper servers.
Capture Villagers into configurable capsules, move them safely, trade with them through the native Minecraft merchant interface, preserve their profession/level/XP/trades, and return them to the world without turning your server's Villager system into a collection of fragile custom inventories.
Built for modern survival, economy, SMP, and community servers.
✨ Features
? Configurable Capture Items
Create unlimited capture-item profiles.
Every profile can independently define:
- Material
- Display name
- Lore
- Stored Villager lore
- Use limit
- Glow
- Unbreakable state
- Dynamic preview
- Capture permission
- Release permission
- Trade permission
Create specialized items such as:
- Transport Capsule — capture + release
- Trade Capsule — capture + trade
- Full Capsule — capture + trade + release
- Your own custom profiles
?? Villager Data Preservation
EasyVillager is designed to preserve the important state of the captured Villager, including:
- Profession
- Villager level
- Experience
- Trades
- Trade uses
- Trade progression
- Stored Villager identity/state
Trading updates the stored Villager instead of creating a disconnected duplicate.
? Native Minecraft Trading
EasyVillager uses a real temporary Villager + native Minecraft merchant inventory for trading.
This allows Minecraft itself to handle the trade interface and Villager progression.
Benefits include:
- Native trade UI
- Native Villager level/XP display
- Normal trade progression
- Trade locking
- Restocking
- Trade-use updates
- Better compatibility with server-side Villager mechanics
The temporary Villager is protected while the trade session is active.
? Geyser / Bedrock Compatible
Designed for mixed Java + Bedrock servers using Geyser/Floodgate.
Bedrock-specific handling includes:
- Safe merchant opening timing
- Temporary Villager visibility when required
- Reduced client/server item desynchronization risk
- Server-authoritative capsule state
No separate Bedrock-only trading plugin is required.
?️ Claim Protection
EasyVillager is designed to respect major protection systems.
Supported integrations include:
- GriefPrevention
- Lands
- GriefDefender
- WorldGuard region filters
EasyVillager should not become a way for players to bypass protected areas.
Capture, trade, and release operations can be checked against claim permissions.
? World & Region Filters
Control exactly where Villagers may be captured.
World filters support:
WorldGuard region filters support:
- BLACKLIST
- WHITELIST
- Global region IDs
world:region entries
Example:
worlds:
mode: BLACKLIST
list:
- world_nether
- event_world
⚔️ Combat-Safe Trading
EasyVillager monitors active trade sessions so external combat plugins or inventory changes cannot leave stale temporary Villagers behind.
If a trade session becomes invalid:
- The session is cleaned up
- The temporary Villager is removed
- Stored data is synchronized
- Capsule state remains protected
Optional CombatLogX integration is included.
♻️ Villager Restocking
Stored Villagers support configurable restocking behavior.
Configure:
- Work time
- Minimum restock interval
- Maximum restocks per day
- Restocking enable/disable
? XP & Level Progression
Trading can update stored Villager:
- XP
- Level
- Trade progression
- Trade availability
Progression thresholds are configurable.
♾️ Unlimited Use Items
Set:
use-limit: -1
for unlimited-use capture items.
Finite examples:
use-limit: 2
or:
use-limit: 10
Failed/blocked operations do not unnecessarily consume a successful-use charge.
? Crafting Protection
EasyVillager capture items are protected from being used as crafting ingredients.
Protection covers configurable recipe inventory types such as:
- Crafting
- Workbench
- Smithing
- Stonecutter
- Loom
- Cartography
- Crafter
- Furnace
- Blast Furnace
- Smoker
- Brewing
- Grindstone
Normal movement inside the player's own inventory remains possible.
? Vanilla Item Protection
Capture items can use different Minecraft materials while EasyVillager prevents unwanted vanilla behavior from interfering with the custom item.
?️ Modern Admin GUI
Use:
/easyvillager admin
to manage the plugin in-game.
The GUI supports configuration of:
- Capture
- Release
- Trading
- Restocking
- Progression
- Item profiles
- Use limits
- Dynamic lore
- Crafting protection
- Protection integrations
- Storage
- Verification
- World/region filtering
- System settings
GUI layouts are configurable through gui.yml.
? Dynamic GUI Information
GUI buttons can display:
- Purpose
- Current status
- Current value
- Enabled/disabled state
This makes the administration panel easier to understand without constantly opening configuration files.
? Commands
/easyvillager admin
/easyvillager give <player> [profile] [amount]
/easyvillager reload
/easyvillager inspect
/easyvillager status
? Permissions
| Permission |
Default |
easyvillager.admin |
OP |
easyvillager.capture |
true |
easyvillager.release |
true |
easyvillager.trade |
true |
easyvillager.reload |
OP |
easyvillager.give |
OP |
easyvillager.inspect |
OP |
easyvillager.status |
OP |
⚙️ Configuration
Main files:
plugins/EasyVillager/
├── config.yml
├── items.yml
├── messages.yml
└── gui.yml
The configuration is intentionally documented with examples.
You can configure EasyVillager from files, the in-game admin GUI, or both.
? Optional Integrations
EasyVillager can work alongside:
- Geyser-Spigot
- Floodgate
- WorldGuard
- CombatLogX
- GriefPrevention
- Lands
- GriefDefender
These integrations are optional.
? Recommended For
EasyVillager is especially useful for:
- Survival servers
- Economy servers
- SMP servers
- Trading servers
- Villager-based shops
- Community servers
- Servers using Geyser/Floodgate
- Servers with claim/protection plugins
- Servers that need portable Villagers without losing their progression
? Safety Focus
EasyVillager includes protections against common abuse cases:
- Capsule duplication
- Invalid stored data
- Crafting-item abuse
- Vanilla item interactions
- Protected-claim bypass
- Temporary Villager killing
- Trade-session desynchronization
- Unsafe release locations
- Invalid/corrupted stored Villagers
? Installation
- Download the EasyVillager JAR.
- Put it in your server's
plugins folder.
- Start/restart the server.
- Review
plugins/EasyVillager/config.yml.
- Configure item profiles in
items.yml.
- Use
/easyvillager admin for in-game configuration.
❤️ Credits
EasyVillager
Created by Mr. Si!ent
A plugin focused on making Villager storage and transport simple, configurable, and safe for modern Minecraft servers.
评论 0
登录后参与评分
还没有评论,来抢沙发吧