LinearReader

模组

· 作者 Bugfunbug

减小 Minecraft 世界在磁盘上的占用大小。

0 本站下载 0 关注 更新于 2 个月前

最新 1.3.0 · 26.3 · NeoForge

一键开服(送7天)

LinearReader

Minecraft Range Loaders Server-side

Compression Wiki

LinearReader 是一款服务端 Minecraft 模组,它能在不影响游戏体验的前提下减小你的世界文件体积。这主要通过使用 Xymb 的 线性区域文件格式 替代 Minecraft 原有的 Anvil 文件格式,并利用 Zstd 压缩算法取代原版使用的 Zlib 压缩算法来实现。

如何减小世界体积?

Xymb 的 线性区域文件格式 相比原版 Minecraft 的区域文件格式已经有了巨大的提升,能够显著减小世界体积。

另一个必要的改进在于压缩算法及其压缩级别。更高程度的压缩需要更多的资源和时间,这对于活跃的服务端来说并不理想;而较低的压缩级别显然无法节省那么多存储空间。因此,挑战在于:LinearReader 如何既能提供低级别压缩的速度,又能实现高级别压缩带来的存储节省?

LinearReader 通过将工作负载分为两个独立的阶段来解决这个问题。实时的写入操作会使用较低级别的 Zstd 压缩进行快速压缩,从而为运行 Minecraft 留出充足的 CPU 资源。随后,当服务器处于空闲状态时,LinearReader 会以更深的压缩程度安全地重新压缩这些区域文件。

压缩基准测试

为了展示 LinearReader 在存储方面的增益,并解释为何不在实时写入时使用高级别压缩,我对使用 Java 默认压缩级别(即 Vanilla Minecraft 所使用的)的 Zlib 压缩 Anvil 文件格式、通常用于实时写入的 Zstd 4 级压缩(LinearReader 默认设置),以及用于重新压缩的 Zstd 22 级压缩进行了基准测试。有关基准测试的更深入分析,请参阅 benchmarks/ 目录。

数据集 格式 原始大小 压缩后大小 压缩率 压缩速度 解压速度
主世界 (Overworld) Anvil/Zlib 6 9.51 GB 8.38 GB 5.44x 75.7 MB/s 1271.3 MB/s
主世界 (Overworld) LinearReader (Zstd 4) 9.51 GB 6.21 GB 7.39x 585.5 MB/s 1412.8 MB/s
主世界 (Overworld) LinearReader (Zstd 22) 9.51 GB 4.28 GB 10.71x 4.4 MB/s 1589.2 MB/s
末地 (End, 大部分虚空) Anvil/Zlib 6 2.33 GB 2.16 GB 3.66x 188.4 MB/s 1576.4 MB/s
末地 (End, 大部分虚空) LinearReader (Zstd 4) 2.33 GB 244 MB 33.20x 1811.1 MB/s 4062.7 MB/s
末地 (End, 大部分虚空) LinearReader (Zstd 22) 2.33 Gb 141 MB 57.50x 10.1 MB/s 6166.9 MB/s
Tectonic + Terralith Anvil/Zlib 6 2.89 GB 2.56 GB 5.97x 84.1 MB/s 1338.1 MB/s
Tectonic + Terralith LinearReader (Zstd 4) 2.89 GB 1.80 GB 8.49x 735.8 MB/s 1742.8 MB/s
Tectonic + Terralith LinearReader (Zstd 22) 2.89 GB 1.24 GB 12.37x 4.4 MB/s 1787.3 MB/s

如上表所示,LinearReader + Zstd 能够在保持正常游戏过程中快速压缩和解压速度的同时,实现更好的压缩效果(Zstd 22 仅用于重新压缩器,不会在正常游戏过程中激活)。

其他功能

LinearReader 不仅仅替换了 Minecraft 的文件格式和压缩算法,它还包含许多其他功能,例如:

  • 备份系统:LinearReader 可以自动创建区域文件的备份,以备不时之需。
  • 缓存系统:可配置数量的最近使用的区域文件将保留在内存中作为缓存,从而减少磁盘读取和解压操作。
  • 区块清理系统:LinearReader 可以搜索并安全删除那些空白的、无用的区块。系统设有严格的规则,以确保只清理真正无用的区块。
  • 自适应运行时策略:LinearReader 可以调整某些设置,以保持游戏的流畅运行。

专为服务端设计

作为一款服务端模组,LinearReader 力求为服务器管理员提供最有帮助且信息丰富的支持。提供了如 bench 和 health 等命令,用于查看基准测试结果和内部指标,同时还配有配置文件,以便根据服务器需求定制设置。

(LinearReader 也适用于单人游戏,单人游戏中的玩家也可以访问所有服务器管理员可用的功能。)

模组化服务端

LinearReader 致力于与尽可能多的模组兼容。大多数模组只需安装即可正常工作,但任何更改 Minecraft 存储系统部分或需要在磁盘上读取文件的模组可能无法正常工作。从 RAM 中读取区块数据的模组很可能可以正常工作。

兼容/不兼容模组的列表可以在 wiki 中找到。

如果你发现某个模组与 LinearReader 不兼容(且尚未在列表中列为不兼容),请在我 GitHub 仓库提交一个 issue。

安装与卸载

要安装,只需从 CurseForge 或 Modrinth 下载 LinearReader,将 .jar 文件放入 mods 文件夹即可,一切就绪。之后 LinearReader 会自动处理所有后续工作。

要卸载,请先运行命令 /linearreader export-mca start 将世界中的 .linear 文件转换回 .mca 格式,然后用新的 .mca 区域文件替换原有的 .linear 区域文件,最后移除 LinearReader。

数据安全

建议在安装 LinearReader 之前备份你的世界,因为 LinearReader 会改变 Minecraft 内部存储引擎的许多机制,任何与存储相关的错误都可能导致你的世界损坏。因此,请务必 备份你的世界。

了解更多

本 README 并未提供对 LinearReader 所有功能的全面深入说明。强烈建议阅读 wiki 以全面了解 LinearReader 的所有功能。

此外,你也可以通过留下 issue 在 GitHub 仓库中提问。你还可以使用 CurseForge 的评论区。

开发状态

LinearReader 1.3.0 很可能是最后一个重大更新。

我不再计划为 LinearReader 添加太多新功能。不过,我计划在不久的将来保持 LinearReader 与最新的 Minecraft 版本同步。

我仍会尝试回复 GitHub 上的 issue,如有需要可能会进行热修复或小版本更新,但我打算在发布 1.3.0 版本后停止对 LinearReader 的重大开发(由我主导)。

AI 免责声明

本模组的代码使用了 AI 辅助编写。每次发布前都会进行手动测试。如果遇到任何问题,请在 GitHub 上报告,我会尽快尝试解决。

有关本模组中使用 AI 的更多信息,请参阅 AI_USAGE.md。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源