FastChunk

FastChunk

一个适用于 Minecraft 1.21.11 (Fabric) 的服务端模组，让已生成区块的重新加载更快更流畅。

⚠️ 仅限服务端（专用服务器）。该模组不在客户端运行，客户端也无需安装：它加速的是服务端的区块加载。将其放入服务器的 mods/ 文件夹即可。

在世界中奔跑时，游戏是否会卡顿一秒，且区块加载延迟？FastChunk 通过两种简单方式解决此问题：

1. 记住您已访问过的区块。 重新加载相同区域的速度提升多倍——已完成的区块从内存（热缓存）中获取，而不是再次从磁盘读取和解压。
2. 预先准备您前方的区块。 该模组会跟踪您的移动，并预加载前方的已有区块，这样世界就能在您到达之前准备好。

✅ 开箱即用——安装，启动，无需其他配置。

---

您能获得什么

• 返回已探索区域时卡顿更少——重新加载通过缓存而非磁盘进行。
• 批量重新加载更快——例如按 F3+A：每个区块都经过快速读取层和缓存，因此重新加载已生成区域的速度显著提升。
• 沿移动方向预取——您即将前往的区块会提前准备好。
• /fastchunk status 和 /fastchunk benchio 命令——查看模组运行状态，并在服务器上直接测量区块读取速度。

---

💡 给玩家的重点提示

FastChunk 加速的是已生成区块的重新加载（即已在区域磁盘上的区块）。它对新世界的生成没有影响——新地形仍由原版（或您的地形生成模组）生成。

在 Minecraft 1.21.11 中，客户端有自己的平滑区块淡入效果，由视频设置控制。即使服务器瞬时传送区块，客户端仍可能平滑淡入。这是客户端限制，并非服务器所致。

---

安装

1. 下载模组，将 .jar 文件放入服务器的 mods/ 文件夹。
2. 确保已安装 Fabric API 和 Minecraft 1.21.11。
3. 启动服务器。就这样——无需其他配置。

要求

• 运行 Minecraft 1.21.11 (Fabric) 的专用服务器
• Java 21——常规发布的 JDK，无需实验性参数
• Fabric API

---

兼容性

FastChunk 可与许多流行模组正常共存：遇到冲突时，它会在不崩溃的情况下干净地禁用自身重叠的部分，仅回退到接近原版的行为。

• Lithium ✅ — 完全兼容。
• C2ME — FastChunk 会禁用其 IO 钩子。这并非两个模组间的“较量”：C2ME 加速新世界的生成，而 FastChunk 加速已生成区块的重新加载。 两者相辅相成。
• Starlight、地形生成器（Terralith、BYG）— 同理：冲突部分会被禁用。

---

速度有多快？

测试方法（数据如何收集）

在活跃服务器上运行内置基准测试：

• 硬件/环境： Xeon E5-1650v4，4 GB 堆内存，本地 SSD。
• 命令： /fastchunk benchio — 选取出生点周围529 个已生成区块，并在三种模式下，调用与原版区块加载器完全相同的读取方法（getNbt）。
• 模式：vanilla（钩子关闭）、fc-cold（通过快速层从磁盘读取）、fc-warm（重复读取——已从热缓存中提供）。
• 单区块加载时间：

模式	中位数	95% 分位数	吞吐量
原版（无 FastChunk）	0.18 毫秒	0.34 毫秒	~5,300 区块/秒
FastChunk — 磁盘读取	0.18 毫秒	0.34 毫秒	~5,600 区块/秒
FastChunk — 缓存重新加载	0.02 毫秒	0.035 毫秒	~41,000 区块/秒

在重复加载时（从缓存加载已生成区块），提速约为10 倍。

适用范围——何时有效，何时无效

• 在重新访问已探索区域时效果最大（热缓存）。首次加载新地形（或磁盘极快且系统缓存大时）差异可能很小。
• 在较慢的磁盘（HDD、网络存储）和更大的世界上，收益远比上述 SSD 测试更显著。
• 实际数值取决于硬件、服务器负载和世界大小。上述数据是在指定基准上的单次可复现运行结果，并非对任何机器的保证。
• 该模组不会加速新区块生成，也不会改变客户端淡入效果（那是每位玩家的视频设置）。

技术实现细节可在项目的源码/版本文件页面查看。

---

配置（供定制参考）

文件 config/fastchunk.json 在首次启动时创建，并在每次启动时读取。无效值会自动回退到默认值。

键名	默认值	作用
crossDimension	true	穿越传送门时进行预取
markov	true	移动路线预测
hotCacheRadius	512	热区块存储半径
warmCacheSizeMb	256	每维度的热缓存预算
warmCachePath	fastchunk/warm	热缓存文件夹
maxSpeculativeGenerations	4	传送门预取限制
predictionTicks	10	移动历史记录长度