DeerFolia

作品介绍

DeerFolia 是 LunaDeerMC 维护的 Minecraft 服务器核心，基于 Folia 的区域化多线程架构继续开发。它不是插件，而是需要直接替换服务器启动核心的完整服务端发行版。当前网页内容以仓库 26.2.0-bbeb1d1 tag、Minecraft 26.2 和 Java 25 的源码与构建配置为资料基准。

DeerFolia 的方向是保持对 Folia 与 Paper 上游修改的较小范围调整，同时补回部分原版机制，并把一组高开销场景的优化做成可由服主控制的配置。它更适合玩家分布在多个区域、需要同时处理多个独立活动区域的生存服、空岛服和大型社区服；对于只有少量玩家集中在同一地点的小型服务器，Folia 架构本身未必能带来收益。

当前能力

• 恢复刷沙相关的原版行为，并修正区域化线程环境下的相关末地传送处理。
• 提供 Dynamic Activation of Brain，降低远处实体 AI 的无效计算。
• 提供异步路径查找，并使用虚拟线程处理路径任务。
• 提供 Kaiiju 实体节流，按区域控制过量实体的更新频率，并可在超过移除阈值后逐步清理实体。
• 提供 VarInt 读写、帧编码、POI、Lithium 衍生热路径和 AFK 网络抑制等优化。
• 所有 DeerFolia 自有配置集中在 config/deer-folia.yml；实体节流另使用 config/kaiiju-entity-throttling.yml。

使用前需要知道

DeerFolia 继承 Folia 的核心约束：没有传统 Bukkit/Paper 意义上的单一主线程，插件必须明确支持 Folia 才适合直接使用。更换核心前应先确认服务器插件、脚本和管理面板是否支持 Folia，并完整备份世界、配置与数据库。

首次部署请从安装与首次启动开始；已经能启动核心后，再阅读配置文件总览和DeerFolia 配置详解。所有性能参数都应在备份和小范围验证后调整。

文档入口

• 安装与首次启动：Java、下载、目录、启动、升级和构建方式。
• 配置文件总览：两个配置文件的职责、修改顺序和重启边界。
• DeerFolia 配置详解：逐项解释 deer-folia.yml 的默认值、影响与调优建议。
• 实体节流配置：解释 kaiiju-entity-throttling.yml 的实体限制和移除规则。
• 功能与优化：了解各项优化的作用、默认开启状态和可能的游戏行为影响。
• 故障排查：启动失败、插件不兼容、刷怪场异常、配置错误和 AFK 同步问题。