Pufferfish 动态 Brain 激活DAB实体 AI 调度优化的原理与实现完整剖析【免费下载链接】PufferfishA high-performance fork of Paper designed for large servers.项目地址: https://gitcode.com/gh_mirrors/puf/PufferfishPufferfish 是一款面向大型 Minecraft 服务器的高性能 Paper 发行版fork其核心优化特性动态 Brain 激活Dynamic Activation of Brain简称 DAB会根据实体与玩家的实时距离动态调整每个实体的 AI 计算频率。本文将用最通俗的方式带你彻底看懂它的原理、实现细节与配置方法帮助大型服务器轻松降低实体 AI 带来的 CPU 压力。一、为什么实体 AI 是大型服务器最容易卡顿的环节Minecraft 服务器以每秒 20 次20 TPS的频率心跳。每一次心跳服务器都要对每一个在线实体执行一次完整的逻辑计算——移动、攻击判定、寻路、AI 决策……实体数量一旦上千群系农场、刷怪塔、下界枢纽、NPC 村庄实体 AI 就会成为 CPU 负载的最大来源。Minecraft 中有两套 AI 系统都需要在每个 tick 中处理AI 系统工作机制典型使用者Goal目标系统GoalSelector / TargetSelector 中按优先级排列的行为列表每 tick 重新评估僵尸、骷髅、苦力怕等大多数生物Brain大脑系统状态机 行为集Activity/Behavior逻辑更复杂每 tick 计算量更大村民、猪灵、疣猪兽、监守者、山羊、美西螈、蛙等原版和 Paper 的解法对激活范围之外的非激活实体AI 逻辑统一降为每 3 个 tick 才执行一次。问题在于这是一刀切的固定频率——128 块外的生物和 16 块外的生物AI 计算频率完全相同玩家身边的生物却得不到加急处理。DAB 的思路让 AI 频率像距离感应一样连续变化——离玩家越近AI 越灵敏离得越远AI 越慵懒。远处的生物玩家根本看不到它在发呆省下的 CPU 却非常可观。二、DAB 核心原理一个高尔夫比分式的动态优先级 ⛳这个特性的思想源自 Airplane 项目Pufferfish 的前身之一最初按 32 / 45 / 55 块三档距离划分 tick 频率Pufferfish 将其进化为一条连续的距离曲线。2.1 计算公式服务器每个 tick 扫描玩家周围的实体时会为每个 DAB 启用的实体计算一个activatedPriority激活优先级距离 ≤start-distance默认 12 块→ 优先级为1AI 每 tick 全速运行与原版行为一致距离更远 → 优先级 距离² 右移activation-dist-mod位即距离² ÷ 2^activation-dist-mod并被max-tick-freq默认 20封顶。优先级数值越小越好补丁作者幽默地称之为 golf score高尔夫比分。AI 逻辑只在计数达到优先级的倍数时才真正执行。2.2 直观效果默认参数下与玩家距离激活优先级实际 AI 频率10 块1每 tick 执行20 次/秒16 块1每 tick 执行32 块4约 5 次/秒64 块16约 1.25 次/秒128 块及更远20封顶1 次/秒这意味着远处大量看不见的生物AI 负载最多只有全速的 1/20而玩家身边的生物行为响应毫无缩水。三、实现剖析四个关键挂载点 完整实现见补丁文件 patches/server/0013-Dynamic-Activation-of-Brain.patch它向引擎注入了四个精准的小改动1️⃣ 激活扫描时动态计算优先级在实体的激活范围扫描Spigot 的ActivationRange机制即玩家靠近实体时将其从休眠唤醒的环节中Pufferfish 插入了距离计算读取玩家与实体的坐标差算出平方距离按上述公式写入实体的activatedPriority字段。同时 patches/server/0013-Dynamic-Activation-of-Brain.patch 中在ServerLevel的实体 tick 循环开头重置activatedPriorityReset标记保证该值每个 tick 只计算一次避免重复开销。2️⃣ Goal 系统把固定每 3 tick改为每 N tick原版的GoalSelector.inactiveTick()返回curRate % 3 0固定三分之一频率。Pufferfish 将其改为接收实体的动态优先级作为模数// GoalSelector.inactiveTick(tickRate) 核心逻辑伪代码 tickRate Math.min(tickRate, 3); // 内置频率上限防止极端情况 curRate; return curRate % tickRate 0;注意这里有一个巧妙的上限即使实体很近Goal 重评估频率也不会超过每 3 tick 一次因为 Goal 的重新评估本身就较昂贵全速交给移动/视线等轻量逻辑即可。3️⃣ Brain 系统行为计数器门控村民、猪灵、监守者等 Brain 系实体不走 GoalSelector它们的 Brain tick 写在各自的customServerAiStep()中。Pufferfish 为这 9 类实体各加了一个behaviorTick计数器实体类说明村民 Villager村庄经济核心Brain 计算极重猪灵 Piglin / 疣猪兽 Hoglin下界生物批量刷新生存压力大监守者 Warden复杂感知行为山羊 Goat、美西螈 Axolotl、蛙 Frog、蝌蚪 Tadpole、悦灵 Allay各类 Brain 系小动物每个 tick 计数器自增只有behaviorTick % activatedPriority 0时才真正调用getBrain().tick(...)。改动极其克制——不动 Brain 内部逻辑只在门口限流因此与 Paper 完全兼容任何 Paper 插件均可直接使用。4️⃣ 修复铁傀儡恐慌被降频坑掉的 Bug 这是一个体现工程细腻度的细节原版村民的VillagerPanicTrigger行为用时间 % 100 0判断是否呼叫铁傀儡保护。但 Brain 降频后该行为的执行时机会整体平移可能永远跳不到恰好整百的那个 tick导致铁傀儡永远不生成Pufferfish 把整百取模改成了每个村民独立的倒计时器nextGolemPanic每次 Brain 真正执行就减一到点即触发。无论 Brain 降频多少铁傀儡依然会准时出现——性能优化不能以隐性改变玩法为代价这是 DAB 设计上最值得称道的部分。四、pufferfish.yml 中的 DAB 配置速查 ⚙️Pufferfish 拥有独立的配置文件pufferfish.yml位于服务器根目录可执行/pufferfish reload热重载。DAB 相关配置项及默认值如下dab: enabled: true # 总开关关闭后回退到 Paper 的固定 1/4 频率 start-distance: 12 # 此距离内实体全速运行玩家感觉不到任何差异 max-tick-freq: 20 # 最远实体的最低频率20 每秒 1 次 activation-dist-mod: 8 # 距离敏感度频率 距离² ÷ 2^此值 blacklisted-entities: [] # 豁免名单中的实体保持原版行为调参小贴士想让远处生物反应更灵敏把activation-dist-mod调大到 9想榨取极限性能调小到 7若某些生物如重要 NPC必须时刻保持活跃加入blacklisted-entities即可对其完全豁免。五、搭配使用的配套实体优化 DAB 并非孤军奋战Pufferfish 中还有多个补丁与之协同降低实体开销补丁作用patches/server/0029-Throttle-goal-selector-during-inactive-ticking.patch非激活 tick 中额外限流 GoalSelector再省几个百分点 CPUpatches/server/0030-Entity-TTL.patch实体寿命上限雪球、岩浆弹等投射物超龄自动清除防止实体泄漏patches/server/0019-Cache-climbing-check-for-activation.patch缓存是否在可攀爬方块上判定激活扫描不再每 tick 重复查方块patches/server/0026-Reduce-entity-allocations.patch缓存可变坐标对象、消除无谓分配降低 GC 压力与停顿六、总结谁最该开启 DAB✅适用场景实体数量多的服务器——刷怪农场、大型村庄、下界猪灵枢纽、刷怪塔集群、多人在线的生存服。这类场景下实体 tick 常占总 CPU 的 30% 以上DAB 能让远处实体的 AI 开销下降最多 95%每 tick → 每 20 tick而玩家身边的行为体验与原版完全一致。收益总结近处零感知12 块内实体全速运行玩法体验与原版无差异远处大幅省 CPU负载最高的 Brain 系实体村民、猪灵优先受益完全兼容不改插件生态任何 Paper 插件可直接使用精细可控4 个配置项 实体黑名单一条曲线自由调节。配合 README.md 中介绍的其他特性更快速的地图渲染、30% 更快的漏斗、零开销内置性能分析器等Pufferfish 正是为既要人多、又要流畅的大型服务器而生。一句话理解 DAB把每个实体每 tick 都全力以赴变成离你越近的实体越全力以赴——用玩家感知不到的 1 秒/20 次降频换回大型服务器最宝贵的 TPS 余量。【免费下载链接】PufferfishA high-performance fork of Paper designed for large servers.项目地址: https://gitcode.com/gh_mirrors/puf/Pufferfish创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Pufferfish 动态 Brain 激活（DAB）：实体 AI 调度优化的原理与实现完整剖析
Pufferfish 动态 Brain 激活DAB实体 AI 调度优化的原理与实现完整剖析【免费下载链接】PufferfishA high-performance fork of Paper designed for large servers.项目地址: https://gitcode.com/gh_mirrors/puf/PufferfishPufferfish 是一款面向大型 Minecraft 服务器的高性能 Paper 发行版fork其核心优化特性动态 Brain 激活Dynamic Activation of Brain简称 DAB会根据实体与玩家的实时距离动态调整每个实体的 AI 计算频率。本文将用最通俗的方式带你彻底看懂它的原理、实现细节与配置方法帮助大型服务器轻松降低实体 AI 带来的 CPU 压力。一、为什么实体 AI 是大型服务器最容易卡顿的环节Minecraft 服务器以每秒 20 次20 TPS的频率心跳。每一次心跳服务器都要对每一个在线实体执行一次完整的逻辑计算——移动、攻击判定、寻路、AI 决策……实体数量一旦上千群系农场、刷怪塔、下界枢纽、NPC 村庄实体 AI 就会成为 CPU 负载的最大来源。Minecraft 中有两套 AI 系统都需要在每个 tick 中处理AI 系统工作机制典型使用者Goal目标系统GoalSelector / TargetSelector 中按优先级排列的行为列表每 tick 重新评估僵尸、骷髅、苦力怕等大多数生物Brain大脑系统状态机 行为集Activity/Behavior逻辑更复杂每 tick 计算量更大村民、猪灵、疣猪兽、监守者、山羊、美西螈、蛙等原版和 Paper 的解法对激活范围之外的非激活实体AI 逻辑统一降为每 3 个 tick 才执行一次。问题在于这是一刀切的固定频率——128 块外的生物和 16 块外的生物AI 计算频率完全相同玩家身边的生物却得不到加急处理。DAB 的思路让 AI 频率像距离感应一样连续变化——离玩家越近AI 越灵敏离得越远AI 越慵懒。远处的生物玩家根本看不到它在发呆省下的 CPU 却非常可观。二、DAB 核心原理一个高尔夫比分式的动态优先级 ⛳这个特性的思想源自 Airplane 项目Pufferfish 的前身之一最初按 32 / 45 / 55 块三档距离划分 tick 频率Pufferfish 将其进化为一条连续的距离曲线。2.1 计算公式服务器每个 tick 扫描玩家周围的实体时会为每个 DAB 启用的实体计算一个activatedPriority激活优先级距离 ≤start-distance默认 12 块→ 优先级为1AI 每 tick 全速运行与原版行为一致距离更远 → 优先级 距离² 右移activation-dist-mod位即距离² ÷ 2^activation-dist-mod并被max-tick-freq默认 20封顶。优先级数值越小越好补丁作者幽默地称之为 golf score高尔夫比分。AI 逻辑只在计数达到优先级的倍数时才真正执行。2.2 直观效果默认参数下与玩家距离激活优先级实际 AI 频率10 块1每 tick 执行20 次/秒16 块1每 tick 执行32 块4约 5 次/秒64 块16约 1.25 次/秒128 块及更远20封顶1 次/秒这意味着远处大量看不见的生物AI 负载最多只有全速的 1/20而玩家身边的生物行为响应毫无缩水。三、实现剖析四个关键挂载点 完整实现见补丁文件 patches/server/0013-Dynamic-Activation-of-Brain.patch它向引擎注入了四个精准的小改动1️⃣ 激活扫描时动态计算优先级在实体的激活范围扫描Spigot 的ActivationRange机制即玩家靠近实体时将其从休眠唤醒的环节中Pufferfish 插入了距离计算读取玩家与实体的坐标差算出平方距离按上述公式写入实体的activatedPriority字段。同时 patches/server/0013-Dynamic-Activation-of-Brain.patch 中在ServerLevel的实体 tick 循环开头重置activatedPriorityReset标记保证该值每个 tick 只计算一次避免重复开销。2️⃣ Goal 系统把固定每 3 tick改为每 N tick原版的GoalSelector.inactiveTick()返回curRate % 3 0固定三分之一频率。Pufferfish 将其改为接收实体的动态优先级作为模数// GoalSelector.inactiveTick(tickRate) 核心逻辑伪代码 tickRate Math.min(tickRate, 3); // 内置频率上限防止极端情况 curRate; return curRate % tickRate 0;注意这里有一个巧妙的上限即使实体很近Goal 重评估频率也不会超过每 3 tick 一次因为 Goal 的重新评估本身就较昂贵全速交给移动/视线等轻量逻辑即可。3️⃣ Brain 系统行为计数器门控村民、猪灵、监守者等 Brain 系实体不走 GoalSelector它们的 Brain tick 写在各自的customServerAiStep()中。Pufferfish 为这 9 类实体各加了一个behaviorTick计数器实体类说明村民 Villager村庄经济核心Brain 计算极重猪灵 Piglin / 疣猪兽 Hoglin下界生物批量刷新生存压力大监守者 Warden复杂感知行为山羊 Goat、美西螈 Axolotl、蛙 Frog、蝌蚪 Tadpole、悦灵 Allay各类 Brain 系小动物每个 tick 计数器自增只有behaviorTick % activatedPriority 0时才真正调用getBrain().tick(...)。改动极其克制——不动 Brain 内部逻辑只在门口限流因此与 Paper 完全兼容任何 Paper 插件均可直接使用。4️⃣ 修复铁傀儡恐慌被降频坑掉的 Bug 这是一个体现工程细腻度的细节原版村民的VillagerPanicTrigger行为用时间 % 100 0判断是否呼叫铁傀儡保护。但 Brain 降频后该行为的执行时机会整体平移可能永远跳不到恰好整百的那个 tick导致铁傀儡永远不生成Pufferfish 把整百取模改成了每个村民独立的倒计时器nextGolemPanic每次 Brain 真正执行就减一到点即触发。无论 Brain 降频多少铁傀儡依然会准时出现——性能优化不能以隐性改变玩法为代价这是 DAB 设计上最值得称道的部分。四、pufferfish.yml 中的 DAB 配置速查 ⚙️Pufferfish 拥有独立的配置文件pufferfish.yml位于服务器根目录可执行/pufferfish reload热重载。DAB 相关配置项及默认值如下dab: enabled: true # 总开关关闭后回退到 Paper 的固定 1/4 频率 start-distance: 12 # 此距离内实体全速运行玩家感觉不到任何差异 max-tick-freq: 20 # 最远实体的最低频率20 每秒 1 次 activation-dist-mod: 8 # 距离敏感度频率 距离² ÷ 2^此值 blacklisted-entities: [] # 豁免名单中的实体保持原版行为调参小贴士想让远处生物反应更灵敏把activation-dist-mod调大到 9想榨取极限性能调小到 7若某些生物如重要 NPC必须时刻保持活跃加入blacklisted-entities即可对其完全豁免。五、搭配使用的配套实体优化 DAB 并非孤军奋战Pufferfish 中还有多个补丁与之协同降低实体开销补丁作用patches/server/0029-Throttle-goal-selector-during-inactive-ticking.patch非激活 tick 中额外限流 GoalSelector再省几个百分点 CPUpatches/server/0030-Entity-TTL.patch实体寿命上限雪球、岩浆弹等投射物超龄自动清除防止实体泄漏patches/server/0019-Cache-climbing-check-for-activation.patch缓存是否在可攀爬方块上判定激活扫描不再每 tick 重复查方块patches/server/0026-Reduce-entity-allocations.patch缓存可变坐标对象、消除无谓分配降低 GC 压力与停顿六、总结谁最该开启 DAB✅适用场景实体数量多的服务器——刷怪农场、大型村庄、下界猪灵枢纽、刷怪塔集群、多人在线的生存服。这类场景下实体 tick 常占总 CPU 的 30% 以上DAB 能让远处实体的 AI 开销下降最多 95%每 tick → 每 20 tick而玩家身边的行为体验与原版完全一致。收益总结近处零感知12 块内实体全速运行玩法体验与原版无差异远处大幅省 CPU负载最高的 Brain 系实体村民、猪灵优先受益完全兼容不改插件生态任何 Paper 插件可直接使用精细可控4 个配置项 实体黑名单一条曲线自由调节。配合 README.md 中介绍的其他特性更快速的地图渲染、30% 更快的漏斗、零开销内置性能分析器等Pufferfish 正是为既要人多、又要流畅的大型服务器而生。一句话理解 DAB把每个实体每 tick 都全力以赴变成离你越近的实体越全力以赴——用玩家感知不到的 1 秒/20 次降频换回大型服务器最宝贵的 TPS 余量。【免费下载链接】PufferfishA high-performance fork of Paper designed for large servers.项目地址: https://gitcode.com/gh_mirrors/puf/Pufferfish创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考