Villager Optimizer

Villager Optimizer 是一个面向 Minecraft Forge 的高级服务端实用工具，旨在缓解村民实体在大规模环境中造成的显著性能影响。

概述

在拥有大型交易大厅或人口密集村庄的服务器中，村民持续不断的 AI 处理会导致 CPU 使用率大幅飙升。

本模组通过在各村民 AI 子系统上实现基于 tick 的智能节流系统解决了这一问题。其结果是服务器每 tick 毫秒数（MSPT）大幅降低，同时不损害交易、繁殖或工作循环的核心机制。

工作原理

本模组用一套精细的基于间隔的系统取代了原版高频的村民行为处理。

主引擎会拦截 LivingTickEvent，并为每个村民使用独立的计数器。模组不会每 tick 都执行复杂的寻路与检测计算，而是将这些检查分摊到不同时间进行。在其最激进的优化级别下，如果村民没有任何需要立即处理的任务，系统可以完全取消该村民的原生 tick 事件。

特性

• 动态 AI 节流：每个行为子系统（大脑、工作、睡眠、繁殖）都独立管理，可对性能影响进行细粒度控制。
• 寻路优化：智能限制路径重算，这是封闭空间中服务器卡顿的主要原因之一。
• 智能检测：内置原生排除系统，可自动识别并管理村民，允许将特定的模组村民类型排除在优化之外，以防止兼容性问题。
• 仅服务端：可仅安装在服务器上，无需修改玩家客户端。

配置与命令

本模组经过精心挑选的默认值设计，开箱即可完美运行，这些值可通过 config/villageroptimizer-server.toml 文件修改。

管理员还可以在游戏内使用 /villageroptimizer 命令（或 /vo 别名）来管理和监控该系统。

可用命令（需要管理员等级 2）：

/vo stats
/vo stats <dimension>
/vo reload
/vo set <pathfinding|brain|work|sleep|breeding|food> <value>

默认预设：

• 寻路：100 tick（5 秒）
• 大脑/AI：40 tick（2 秒）
• 工作/补货：200 tick（10 秒）
• 睡眠：200 tick（10 秒）
• 繁殖：400 tick（20 秒）
• 分享食物：200 tick（10 秒）

兼容性

• Minecraft 版本：1.20.1
• 模组加载器：Forge
• 端：服务端

为什么选择本模组？

在狭小区域内拥有数十或数百个村民是多人服务器最大的性能杀手之一。与完全移除 AI 或永久影响行为的方案不同，Villager Optimizer 保留了所有基本功能。它只是规定了这些逻辑在何时以及以何种频率进行计算，让你能够以高稳定性和 TPS 维持大型交易中心。

致谢与支持

作者：SatDPhoe