Villager Ordinance

这是这款模组的核心功能。

• 直接从交易界面开始手动刷新或完整的自动循环。
• 搜索特定的理想配置，不再盲目刷新。
• 交易时可随时显示或隐藏 VO 覆盖界面。
• 设置刷新延迟、搜索时长和刷新次数上限，也可以完全不限次数。
• 通过强化循环加快刷新；动态模式还能根据服务器 TPS 调整速度，而不是一味蛮干。
• 如果你想采用更宽松的规则，可以在交易开始后继续搜索。
• 实时查看刷新次数、评分、匹配字段、匹配条件、已用时间和每刻刷新次数。
• 根据结果所需的刷新次数，查看简单的概率估算。

让它与众不同的是近似匹配系统：

• 每次刷新都会评分，而不仅仅关注完美结果。
• 更好的匹配会胜过较差的匹配，而不会被直接丢弃。
• 村民的初始交易也会作为第一个备选结果计入。
• 如果之后出现更好的近似匹配，它会自动替换已保存的结果。
• 你可以随时回滚到已保存的最佳近似匹配。
• 如果搜索结束时没有找到完美结果，你可以让村民自动恢复为已保存的最佳结果。
• 循环仍在进行时，你可以让当前最佳结果始终显示，实时观察搜索结果不断改善。
• 关闭界面、保存并重新加载，甚至将村民拾取后再放置，都不会丢失已保存的最佳匹配。

• 在村民升级前预览锁定的未来交易。
• 将可见和锁定的行清晰分开，让你始终知道哪些已经可用、哪些还需要经验值。
• 查看真实的物品预览，而不是模糊的占位符。
• 将鼠标悬停在行上即可查看提示信息，就像普通物品堆叠一样。
• 像查看正规附魔书一样阅读附魔书，而不是匿名的“仅书本”占位符。
• 查看可见报价的价格明细，包括基础价格、需求、折扣、声望、英雄加成和其他修正项。
• 可选在原版经验条附近显示距离下一村民等级还需要多少交易经验值。

这让村民升级变得深思熟虑而非冒险。你可以查看前方的完整路径，判断未来的层级是否值得，并在花费一颗绿宝石之前就锁定计划。

• 构建多条件搜索配置，而不是依赖单一简单目标。
• 使用完整的AND/OR分组来实现括号式逻辑。
• 快速重新排序条件、重新排序字段并合并分组。
• 保存、加载、重命名、删除、复制、拷贝、导入和重新排序命名配置。
• 一键将村民当前的交易克隆到新配置中。
• 使用NBT Clone模式从实际交易内容生成更深层的过滤器。
• 让克隆的配置自动使用村民的自定义名称或职业作为配置名称。
• 反转任意字段，以便搜索你想要的内容或明确排除你不想要的内容。

支持的过滤目标包括：

• 可见或锁定的交易
• 层级
• 交易行
• 出售物品
• 出售物品效果
• 出售物品附魔，包括最低等级
• 按路径和值的高级出售物品数据
• 第一个购买物品
• 第二个购买物品
• 价格比较

如果你喜欢构建精确的图书管理员搜索、黑名单式过滤器，或“找类似但不是这个”的设置，这个系统正是该模组真正大放异彩的地方。

• 在普通交易中打开完整的VO面板。
• 为无法正常交易的村民打开独立检查器，包括失业村民和没有工作站的繁殖者村民。
• 空手右键点击这些村民即可检查它们，而不会强制进入交易流程。
• 选择Shift+右键对你执行的操作：检查、拾取或忽略。
• 在你阅读时防止被检查的村民走开。

该检查器专为真正的诊断而构建，而不仅仅是琐事：

• 查看村民现在是否愿意繁殖
• 查看以秒为单位的繁殖冷却时间
• 查看以秒为单位的幼年村民成长时间
• 查看缺少什么繁殖条件
• 查看村民是否能工作并到达其工作站点
• 查看补货时间而不改变原版行为
• 查看声望和 gossip 值
• 查看村民的物品栏内容

这类界面让繁殖者调试和村民故障排查不再感觉像迷信。

无需一次一个村民地重新打开交易窗口，你可以从一个界面扫描当地村庄，决定谁真正值得交易。

• 打开专用浏览器，在你选定的半径范围内扫描附近的村民。
• 一次查看多名村民实际可见的交易选项。
• 查看物品渲染图和悬停提示，而不是纯文本摘要。
• 在浏览器中清楚显示附魔书的实际附魔名称，而不是将其折叠成含糊的占位文本。
• 搜索整个本地交易池中的物品、附魔和已同步的交易数据。
• 按你喜欢的方式排序列表，并保留偏好的浏览器布局。
• 刷新列表，无需经历闪烁、体验别扭的重新加载。

如果不适合直接远程交易，浏览器仍然能派上用场：

• 把村民叫到你身边，而不是立即打开交易界面
• 在村民走过来时持续标记该村民 En Route
• 村民到达正常距离后自动开启交易
• 使用 Look At 和 Keep Calling 风格的快捷方式，让你持续关注正确的村民

最终，你将拥有一套覆盖整个村庄的购物与寻路工具，能节省大量时间，同时不会把每个村民都变成没有名字的电子表格条目。

• 搜索附近拥有特定附魔的村民。
• 搜索出售特定物品的村民。
• 搜索收购特定第一或第二输入物品的村民。
• 按职业搜索村民。
• 使用客户端发光效果高亮匹配对象，方便你在游戏世界中找到对应村民。

这对于大型交易大厅、混乱的繁殖场溢出区，以及你知道某处有这笔交易、却想不起是哪位村民拥有它的村庄尤其有用。

• 在交易界面和检查界面中打开专用的工作站与床铺调试面板。
• 查看村民是否拥有有效的工作站。
• 查看工作站是否与村民的职业匹配。
• 查看工作站归谁所有。
• 查看关联床铺的详情。
• 查看补货失败的原因。
• 遇到异常情况时，查看额外的职业与 POI 状态文本。
• 滚动查看较长的调试信息，同时保持界面清晰易读。

需要时，可通过可选的修复操作直接进行干预：

• 解除工作站关联
• 重新扫描附近的工作站状态
• 重新检查已记录的 POI

对于繁殖场、交易大厅，以及移动方块后变得一团糟的村庄来说，这是这个模组最实用的功能之一。

• 打开所选村民的完整物品栏查看器。
• 查看村民物品栏中的所有已占用槽位。
• 点击即可取出单个物品堆。
• 将整个物品栏清空到玩家物品栏中。
• 如果你的物品栏已满，就把溢出的物品丢到世界中。

这非常适合清理繁殖场、排查食物问题，或处理那些总是拿走你希望它们从未碰过的东西的村民。

• 通过 VO 菜单将村民捕获为可携带的村民物品。
• 保留村民的外观，包括职业服饰和生物群系服饰。
• 保留村民的自定义名称（如有）。
• 正确保留幼年或成年状态。
• 之后可将物品中的村民放回游戏世界。

最重要的是，这并不是一个华而不实的简化版道具：

• 已存储的交易会恢复
• 已锁定的交易预览数据会恢复
• 最近匹配回滚数据会恢复
• 重要的村民存档状态会恢复

整个过程就像搬走了同一个村民，而不是用一个空白副本替换它。

• 允许或阻止交易开始后的重置。
• 启用无限交易，让交易选项不会耗尽。
• 强制补货，采用更积极的补货规则。
• 补货时完全或部分重置正向需求。
• 启用无缝即时村民升级，让新等级可在同一场交易过程中解锁。
• 启用定期重置，让村民随时间刷新交易；也可以彻底关闭此功能。
• 将定期重置与手动重置、自动轮换行为分开控制。
• 决定是否可以预览并匹配隐藏的锁定交易。

这样，你可以自由调整交易体验，从“接近原版但信息更完善”到“全面优化的村民实验室”。

• 让村民失去职业，方便重置其职业路径。
• 重置村民的职业生涯，同时保留其原有身份，不会让人觉得你毁掉了一个村民又生成了另一个。
• 让手持绿宝石的玩家可以引诱村民跟随。
• 允许用拴绳牵引村民。
• 让村民缓慢自然恢复生命值。
• 让村民免受甜浆果丛伤害。
• 这些辅助功能大多都可以选择启用，让你决定自己的世界应该宽松还是严苛。

• 让售罄的流浪商人安顿下来，变成普通的失业村民，而不是就此消失、白白浪费潜力。
• 调整流浪商人的拜访频率。
• 调整拜访间隔，以及拜访概率随时间变化的梯度。
• 将现有的傻子村民转变为失业村民。
• 在支持的情况下，阻止新的傻子村民出现。
• 需要从头培养村民时，可将其重置为失业状态。

这一部分旨在减少长期游玩时遇到的死胡同和村民浪费。

• 自定义僵尸村民的最短和最长治疗时间。
• 如果你喜欢这样的节奏，也可以启用即时治疗。
• 允许在没有虚弱效果时治疗僵尸村民。
• 恢复可叠加的治疗折扣，并设置可叠加的折扣上限。
• 即使原版难度规则通常会阻止感染，也让感染照常发生。
• 调整普通僵尸生成成僵尸村民的概率。
• 让僵尸刷怪笼也能按照同一套概率规则生成僵尸村民。

如果你喜欢治疗经济、治疗师村庄，或希望世界更注重村民恢复循环，这部分能提供丰富的自定义选项。

• 让僵尸围城之夜保持接近原版，也可以降低频率、大幅提高频率或将其禁用。
• 在挑战玩法或更严酷的村庄中，彻底关闭铁傀儡生成。
• 缩短或延长铁傀儡召唤冷却时间。
• 缩小或扩大村民召唤铁傀儡时的检测范围。
• 保留“村民近期必须睡过觉”的常规规则，或放宽限制以适配人工建造和技术型配置。

这样，你可以让村庄防御保持轻松惬意、变得残酷严苛，或支持原版规则难以适配的特殊村民设计。

• 直接在游戏内调整模组设置，无需总是编辑外部文件。
• 将个人界面偏好与影响世界的规则设置分开管理。
• 可从商人界面、独立查看器和菜单集成入口打开设置页面。
• 按清晰的类别浏览设置，不必面对一大堆选项。
• 快速重置单项设置或整个设置组。

面向玩家的自定义选项包括：

• 面板位置
• POI 调试界面是否默认打开
• POI 操作提示是否持续显示
• 是否在原版经验条附近显示升到下一级所需的经验值
• 定位扫描距离和发光持续时间
• 村民交易浏览器的半径、排序方式和布局
• 选中村民手持物品的旋转调整

Villager Ordinance 不只是一个重新刷新的按钮。

• 它让你在做出决定前看清情况。
• 当搜索结果差一点就完美时，它能为你提供备用选项。
• 它让你能够诊断那些通常什么信息都不会告诉你的村民。
• 它帮助你管理整座村庄，而不必一次只盯着一个界面。
• 移动村民时，它会保留重要的村民状态。
• 它兼顾便利与掌控，不必让你二选一。

如果你喜欢建造交易大厅、繁殖系统、技术型村庄、僵尸村民治愈循环，或是重视村民的生存世界，这款模组旨在让游戏中的这部分内容摆脱令人沮丧的体验，变得真正令人满足。