EasyVillager

插件

· 作者 MrSilentOffical

捕获、运输、交易和释放村民,同时支持可配置的道具配置,并保留村民数据、进度、补货机制以及服务器保护规则。

0 本站下载 0 关注 更新于 3 个月前

最新 1.0.0 · 26.2 · Folia / Paper

一键开服(送7天)

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 包含针对常见滥用情况的防护机制:

  • 胶囊复制
  • 无效存储数据
  • 制作物品滥用
  • 原版物品交互
  • 绕过受保护的领地
  • 临时杀害村民
  • 交易会话不同步
  • 不安全的释放位置
  • 无效/损坏的存储村民

? 安装

  1. 下载 EasyVillager JAR 文件。
  2. 将其放入服务器的 plugins 文件夹中。
  3. 启动或重启服务器。
  4. 查看 plugins/EasyVillager/config.yml。
  5. 在 items.yml 中配置物品配置文件。
  6. 使用 /easyvillager admin 进行游戏内配置。

❤️ 致谢

EasyVillager
由 Mr. Si!ent 创建

一款专注于让村民存储和运输变得简单、可配置且对现代 Minecraft 服务器安全的插件。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源