villager claim

插件

· 作者 Yenith

一款革命性的村民控制插件,让你可以用一根简单的木棍来认领、管理和控制村民!

0 本站下载 0 关注 更新于 1 年前

最新 1.0.0 · 1.21.10 · Paper

一键开服(送7天)

一款革命性的村民控制插件,让你能用一根简单的木棍来认领、管理和控制村民!

? 功能特性

核心功能

  • ?️ 基于木棍的交互 - 用 STICK(木棍)右键点击村民(不再需要碎碎念!)
  • ? 村民认领 - 使用自定义名称认领村民并获得完全控制权
  • ? 跟随系统 - 让村民跟随你在世界中移动
  • ? 冻结系统 - 在需要时将村民固定在原地
  • ? 基于权限的限制 - 控制玩家可以认领多少村民(8、16、32、64 或无限制)
  • ? 智能持久化 - 所有村民状态在服务器重启后保留
  • ? 视觉效果 - 粒子效果和流畅动画
  • ⚡ 性能优化 - 高效追踪与智能清理系统

高级功能

  • 注视冻结 - 当你注视村民时将其冻结(持续时间可配置)
  • 跨世界支持 - 在不同世界间搬运村民(可配置)
  • 物品栏系统 - 访问并管理村民的物品栏,支持完整的物品存储
  • 自动消失保护 - 当村民距离过远时防止其消失(性能优化)
  • 手动消失系统 - 使用 /vc away 手动使村民消失
  • 召回系统 - 使用 /vc bring 恢复已消失的村民
  • 物品栏保护 - 持有物品的村民变得无敌且无法被取消认领
  • 智能消失 - 当你使用鞘翅飞行过快时,村民会自动消失
  • 传送限制 - 通过冷却时间和数量限制防止滥用
  • 世界限制 - 控制村民可以被搬运到哪些世界
  • 命令冷却 - 通过可配置的冷却时间防止刷屏
  • 调试系统 - 全面的日志记录用于故障排除

? 安装

前置要求

  • 运行 Minecraft 1.21+ 的 Paper 或 Spigot 服务器
  • 服务器上安装了 Java 17 或更高版本

步骤

  1. 下载 最新的 VillagerClaim-1.0.0.jar 文件
  2. 停止 你的 Minecraft 服务器
  3. 放置 JAR 文件到服务器的 plugins 文件夹中
  4. 启动 服务器
  5. 插件将创建一个包含默认配置的 VillagerClaim 文件夹
  6. 配置 插件:编辑 plugins/VillagerClaim/config.yml
  7. 重载 插件,执行 /vc reload 或重启服务器

验证

安装完成后,验证插件是否正常工作:

> plugins
[10:00:00 INFO]: Plugins (1): VillagerClaim

⚙️ 配置

插件会在 plugins/VillagerClaim/ 目录下生成一个 config.yml 文件,包含广泛的自定义选项。

基础配置

常规设置

general:
  # 与村民交互的最大距离
  max-interaction-distance: 5.0
  
  # 注视村民时的冻结时间(秒)
  # 设置为 -1 表示无限持续时间(直到玩家移开视线)
  freeze-on-look-duration: 3
  
  # 交互工具 - 玩家必须手持 STICK(木棍)
  interaction-tool: STICK

世界限制

worlds:
  # 允许将村民带入特定世界
  allow-worlds:
    world: true          # 主世界(默认世界)
    world_nether: false  # 下界
    world_the_end: false # 末地
  
  # 跨世界村民管理
  cross-world-teleport: true

消息自定义

所有消息均支持 Minecraft 颜色代码(& 格式):

messages:
  # 认领消息
  villager-claimed: "&a&l✓ &a你已认领 &e{villager_name} &a作为你的村民!"
  villager-already-claimed: "&c&l✗ &c该村民已被 &e{owner_name}&c 认领!"
  
  # 命令消息
  villager-following: "&a&l✓ &a{villager_name} &a现在正在跟随你!"
  villager-frozen: "&b&l✓ &b{villager_name} &b现在已冻结在原地!"
  villager-unclaimed: "&c&l✓ &c{villager_name} &c已被取消认领!"

功能开关

features:
  # 启用注视村民时冻结的功能
  freeze-on-look: true
  
  # 启用村民跟随机制
  follow-mechanics: true
  
  # 启用村民冻结机制
  freeze-mechanics: true
  
  # 启用命令冷却时间(秒)
  command-cooldown: 2
  
  # 启用村民物品栏系统
  villager-inventory: true

高级设置

advanced:
  # 自动保存村民数据的时间间隔(分钟)
  auto-save-interval: 5
  
  # 村民名称最大长度
  max-name-length: 20
  
  # 传送限制
  max-teleports-per-minute: 3
  teleport-cooldown-seconds: 5
  
  # 消失设置
  max-follow-distance: 50
  despawn-distance: 100

配置示例

示例 1:基础设置(默认)

general:
  freeze-on-look-duration: 3
  max-interaction-distance: 5.0

features:
  freeze-on-look: true
  follow-mechanics: true
  freeze-mechanics: true

示例 2:无限注视冻结

general:
  freeze-on-look-duration: -1  # 无限持续,直到移开视线

示例 3:禁用注视冻结

general:
  freeze-on-look-duration: 0  # 禁用
features:
  freeze-on-look: false

示例 4:禁用跨世界

worlds:
  cross-world-teleport: false
  allow-worlds:
    world: true
    world_nether: false
    world_the_end: false

? 命令

所有命令均使用 /vc 前缀(/villagerclaim 的别名)。

玩家命令

命令 描述 权限
/vc list 列出你认领的所有村民 villagerclaim.use
/vc despawned 列出已消失的村民 villagerclaim.use
/vc follow <name> 让一个村民跟随你 villagerclaim.use
/vc unfollow <name> 停止村民跟随 villagerclaim.use
/vc freeze <name> 将村民原地冻结 villagerclaim.use
/vc unfreeze <name> 解冻村民 villagerclaim.use
/vc unclaim <name> 释放一个村民 villagerclaim.use
/vc bring <name> 找回一个已消失的村民 villagerclaim.use
/vc away <name> 使一个村民消失(手动消失) villagerclaim.use
/vc inventory <name> 打开村民的物品栏 villagerclaim.use
/vc inv <name> inventory 命令的简写形式 villagerclaim.use
/vc worlds 显示允许村民存在的维度 villagerclaim.use

管理员命令

命令 描述 权限
/vc reload 重新加载配置 villagerclaim.admin
/vc check <player> 查看玩家的村民情况 villagerclaim.admin
/vc reset <player> 重置玩家的村民数据 villagerclaim.admin

命令详情

/vc list

显示你认领的所有村民及其状态:

你的村民:
- Steve (跟随中)
- Bob (已冻结)
- Alice (空闲)

/vc follow <name>

让一个村民跟随你移动:

✓ Steve 现在正在跟随你!

/vc freeze <name>

将村民原地冻结:

✓ Steve 现在被冻结在原地了!

/vc unclaim <name>

释放一个村民(使其变为普通村民):

✓ Steve 已被释放!

/vc despawned

显示所有已消失的村民:

已消失的村民:
- Steve (已消失)
- Bob (已消失)

/vc bring <name>

找回一个已消失的村民:

✓ Steve 已被找回!

/vc away <name>

使一个村民消失(手动消失):

✓ Steve 已被遣送离开!

/vc inventory <name>

打开一个村民的物品栏:

✓ 已打开 Steve 的物品栏!

/vc worlds

显示允许村民存在的维度:

允许的维度:
- world (主世界)
- world_nether (下界) - 已禁用
- world_the_end (末地) - 已禁用

? 权限

权限 描述 默认值
villagerclaim.use 使用基础村民命令 true (所有人)
villagerclaim.admin 访问管理员命令 op (仅限管理员)
villagerclaim.limit.8 最多可认领 8 个村民 true (默认)
villagerclaim.limit.16 最多可认领 16 个村民 false
villagerclaim.limit.32 最多可认领 32 个村民 false
villagerclaim.limit.64 最多可认领 64 个村民 false
villagerclaim.limit.unlimited 无限认领村民 false

权限示例

给玩家设置 16 个村民上限:

# 使用 LuckPerms
/lp user Player permission set villagerclaim.limit.16 true

给 VIP 用户无限村民上限:

# 使用 LuckPerms
/lp user VIP permission set villagerclaim.limit.unlimited true

组权限配置(在你的权限插件中):

groups:
  default:
    permissions:
      - villagerclaim.use
      - villagerclaim.limit.8
  vip:
    permissions:
      - villagerclaim.limit.32
  admin:
    permissions:
      - villagerclaim.admin
      - villagerclaim.limit.unlimited

? 使用指南

玩家篇

入门指南

  1. 手持一根 STICK(木棍)
  2. 用木棍右键点击村民
  3. 在提示时输入名称
  4. 使用命令控制你的村民

基本交互

  • 认领村民: 手持木棍右键 → 输入名称
  • 令其跟随: /vc follow <name>
  • 原地冻结: /vc freeze <name>
  • 释放村民: /vc unclaim <name>

高级功能

  • 注视冻结: 注视你的村民即可将其冻结
  • 跨维度旅行: 将村民带到不同的维度
  • 物品栏访问: 右键打开村民物品栏,或使用 /vc inventory <name>
  • 防自动消失保护: 距离过远时村民不会自动消失
  • 手动消失: 使用 /vc away <name> 使村民消失
  • 找回系统: 使用 /vc bring <name> 恢复已消失的村民
  • 物品栏保护: 持有物品的村民将变得无敌
  • 智能消失机制: 当你使用鞘翅高速飞行时,村民会自动消失

管理员篇

监控玩家

检查任何玩家的村民情况:

/vc check PlayerName

管理上限

通过权限设置村民上限:

/lp user Player permission set villagerclaim.limit.32 true

更改配置

  1. 编辑 plugins/VillagerClaim/config.yml
  2. 运行 /vc reload
  3. 更改立即生效

? 数据存储

创建的文件

plugins/
└── VillagerClaim/
    ├── config.yml       # 插件配置
    ├── villagerdata.yml  # 村民认领数据
    └── bypass.yml       # 豁免玩家数据

村民数据结构

villagerdata.yml 文件存储以下内容:

  • 村民 UUID 和名称
  • 所有者 UUID 和名称
  • 当前状态(跟随/冻结/空闲)
  • 位置数据
  • 物品栏内容
  • 维度信息

数据持久化

村民数据会自动保存:

  • 当玩家断开连接时
  • 每 5 分钟一次(可配置)
  • 当服务器关闭时
  • 当村民状态改变时

? 故障排除

常见问题

问题:无法与村民交互

解决方案:

  1. 确保你手中拿着的是 STICK(木棍)
  2. 检查你是否在交互距离内(5 格方块)
  3. 确认该村民未被其他玩家认领
  4. 检查权限:/vc list

问题:村民不跟随

解决方案:

  1. 检查村民是否已被你认领:/vc list
  2. 验证跟随命令:/vc follow <name>
  3. 检查村民是否被冻结:/vc unfreeze <name>
  4. 确保你没有离得太远(50 格限制)

问题:命令无效

解决方案:

  1. 确认权限设置正确
  2. 查看控制台是否有报错
  3. 确保使用了正确的命令格式
  4. 尝试使用完整命令:/villagerclaim 而不是 /vc

问题:村民消失

解决方案:

  1. 检查生成距离设置
  2. 验证世界限制
  3. 检查村民是否死亡(它们会受到伤害)
  4. 查找控制台错误

问题:跨世界功能无效

解决方案:

  1. 检查配置中的 cross-world-teleport: true
  2. 验证该世界是否在 allow-worlds 列表中
  3. 检查玩家权限
  4. 确保村民正在跟随你

问题:村民消失(未刷新)

解决方案:

  1. 检查村民是否已消失:/vc despawned
  2. 使用以下命令将其召回:/vc bring <name>
  3. 检查你是否使用了鞘翅飞得太快
  4. 验证村民未被怪物杀死

问题:无法取消认领村民

解决方案:

  1. 检查村民是否有物品:/vc inventory <name>
  2. 先清空村民的物品栏
  3. 持有物品的村民受保护,无法取消认领
  4. 如需移除,可使用 /vc away <name> 使其消失

问题:村民物品栏未保存

解决方案:

  1. 检查村民是否已被你认领
  2. 确保你是该村民的所有者
  3. 尝试关闭并重新打开物品栏
  4. 查看控制台是否有报错

获取帮助

如果需要额外支持:

  1. 检查控制台日志以查找错误信息
  2. 验证你的配置是否为有效的 YAML 语法
  3. 加入我们的 Discord 服务器:

? 性能

资源占用

  • 内存: 极低(典型服务器小于 10MB)
  • CPU: 非常轻量(高效的追踪系统)
  • 磁盘: 小型数据文件(YAML 格式)
  • 网络: 无网络操作

优化建议

  1. 根据村民数量调整 auto-save-interval
  2. 设置合适的 despawn-distance
  3. 使用 max-follow-distance 减少不必要的检查
  4. 考虑使用世界限制以提升性能

测试性能

  • ✅ 可高效处理超过 100 名被认领的村民
  • ✅ 对 TPS 无明显影响
  • ✅ 数据保存速度快(小于 100ms)
  • ✅ 内存占用极小

? 路线图

未来版本的可能功能:

  • 村民交易集成
  • 村民职业管理
  • 村民繁殖系统
  • 村民管理 GUI
  • 村民群组与团队
  • 高级村民 AI
  • 村民市场
  • 村民统计追踪
  • 增强的物品栏管理
  • 村民工作分配
  • 自动化村民任务

? 支持

Bug 报告

如果发现 Bug,请提供以下信息进行报告:

  • 插件版本
  • 服务器软件及版本
  • 复现步骤
  • 控制台错误(如有)

功能请求

有新想法?请分享包含以下详情的建议:

  • 你想要实现什么
  • 它将如何惠及用户
  • 示例用例

Discord 社区

加入我们的 Discord 服务器以获取支持、更新和社区讨论:


? 许可证

本插件可免费用于你的服务器并进行修改。

条款

  • ✅ 允许在任何服务器上使用
  • ❌ 禁止个人用途的修改
  • ❌ 禁止再分发,即使注明出处
  • ❌ 禁止商业转售
  • ❌ 不提供任何保修或保证

?‍? 作者

Yenith


⭐ 感谢!

感谢你使用 VillagerClaim!如果你喜欢这个插件:

  • 分享给其他服务器管理员
  • 留下反馈和建议
  • 报告 Bug 以帮助改进它
  • 考虑支持未来的开发
  • 加入我们的 Discord 社区:

为 Minecraft 社区 ❤️ 制作

最后更新:2025 年 10 月 8 日

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源