DeerFolia · 功能与优化

功能总览

功能	默认状态	主要目标	需要注意
原版机制恢复	开启	恢复部分原版行为	会改变部分上游默认行为
Dynamic Activation of Brain	开启	降低远处实体 AI 计算	刷怪塔和村民行为可能出现延迟
Async Pathfinding	开启	减少路径查找对区域 tick 的阻塞	线程数过大可能增加 GC 压力
Kaiiju Entity Throttling	开启	控制高密度实体更新	低 limit 会影响农场和交易所
Network Optimizations	开启	减少网络包处理开销	代理/协议问题时需单项排查
Lithium Optimize	开启	优化服务端高频热路径	修改后需要重启
POI Optimizations	开启	降低村民 POI 与铁傀儡检查 CPU	可能改变检查时序
AFK Network Optimization	开启	降低挂机玩家的下行流量	恢复活动时依赖同步

原版机制恢复

DeerFolia 在 Folia 环境中恢复与刷沙相关的原版行为，也调整末地传送的一部分逻辑。这些行为没有单独的开关。需要匹配上游 Folia 时，请先在服务器副本中测试。

Dynamic Activation of Brain

DeerFolia 会减少远处实体的 AI 计算。它使用距离和最大激活间隔控制更新频率。字段和调优步骤见 DeerFolia 配置详解。

Async Pathfinding

DeerFolia 会通过虚拟线程池异步执行部分路径查找。线程设置和回滚步骤见 DeerFolia 配置详解。

Kaiiju Entity Throttling

DeerFolia 会按区域节流选定的实体类型，并在超出阈值后逐步移除实体。请把它用于处理目标区域的高密度实体。不要给所有实体设置很低的限制。完整格式见 实体节流配置。

网络优化

DeerFolia 优化 VarInt 读写和网络帧编码。这些优化不应改变玩法。如果问题出现在代理、压缩插件或协议桥接中，请在测试副本中一次关闭一个选项。

Lithium 衍生优化

DeerFolia 使用部分 Lithium 服务端优化，并按 Paper、Moonrise 和 Folia 的线程模型做了适配。优化分为分配、AI、集合、实体、数学和世界路径。客户端专属逻辑和依赖单一主线程的代码不会直接带入核心。

POI 优化

POI 优化降低村民铁傀儡检查、次级传感器和村庄距离计算的频率。大型村民区域先使用默认值并观察 CPU。如果铁傀儡农场依赖时序，每次修改后都比较产出。

AFK 网络抑制

AFK 玩家仍参与服务端世界逻辑。DeerFolia 会抑制发送给该玩家的部分区块、方块、实体、世界效果和 UI 数据。玩家恢复活动后，DeerFolia 会重新同步所需区块和实体。管理员可以使用 /afknetstats 查看节省的流量。

为什么默认全部开启

默认值提供一个可启动的起点，不是适用于所有服务器的调优配置。出现行为差异时，不要一次关闭全部优化。每次修改一个功能组并记录结果，只保留对服务器有帮助的修改。