村民牧者

Villager Wrangler — 项目摘要

Villager Wrangler 是一个小巧轻量的 Minecraft 1.21.1 NeoForge 实用模组，旨在让村民的搬运更加便捷，同时保留原版村民的正常行为。

该模组添加了两个专注的机制：

• 村民牵引： 手持原版拴绳，按住 Shift 并右键点击成年或幼年村民即可将其拴住。绳索的渲染、移动、栅栏连接、断裂距离以及拴绳行为均由原版 Minecraft 处理。正常的右键交易仍然可用。

• 绿宝石跟随： 村民会被附近手持绿宝石的玩家吸引，并在可配置的范围内跟随该玩家。绿宝石不会被消耗。

绿宝石吸引刻意并非绝对控制。村民会优先处理重要的原版行为，例如睡觉、恐慌、袭击、战斗/安全行为、繁殖、交易以及现有的拴绳行为。一旦绿宝石吸引结束，它们便会恢复正常的日程与活动。

流浪商人刻意不受影响。

技术 / 发布信息

发布版本： 0.1.0-alpha.1
Minecraft： 1.21.1
加载器： NeoForge
NeoForge： [21.1.250,21.2)
Java： 21
模组 ID： villagerwrangler
作者： Brian Brown
许可证： MIT

该模组完全独立，与 ButcherCraft 没有任何关系或依赖。

实现刻意保持轻量：没有自定义实体、自定义物品、自定义网络、mixin、访问转换器，也没有替换村民 AI 系统。它与原版拴绳机制以及现有的村民 Brain 集成。

配置

服务端配置可独立控制村民牵引与绿宝石跟随。绿宝石跟随范围默认为 10 格，支持 1–16 格。

目前应在世界/服务器停止时更改配置，因为实时更改牵引设置可能会导致已连接的客户端在重连/重启前保留过期配置。

验证状态

该候选版本已通过 38 项 GameTest、干净的生产构建、专用服务器测试、打包 JAR 客户端/服务端冒烟测试、村民生命周期测试，以及一个 100 村民的性能测试装置。

已知的 alpha 局限主要是尚未确立与主要村民 AI 大修模组的兼容性，且尚未测试两个同时运行的图形化 Minecraft 客户端。

发布基线： d0ca6ff40f16e3b0e3533e1f1ea67c3212d51ed5

该项目功能已完成，并已获准进行首次公开 alpha 发布；发布/打标签是剩余的步骤。