跳到正文

ChunkSqueeze

作者:TheFlareStar

无损压缩 Minecraft 地形区块,减少 30% 的存储空间占用。

收藏

介绍

介绍由机器翻译自 CurseForge 原页面,仅供参考。

无损 Minecraft 区块压缩,平均可将地形存储空间减少约 30%。

探索越多,世界就越大。ChunkSqueeze 专为整合包、长期生存世界和服务器设计。它结合紧凑的存储格式与共享数据,减少地形区块占用的磁盘空间。

它会完整保留方块坐标、所有方块属性、光照、生物群系,以及地形区块中存储的模组 NBT 数据,不会更改世界内容或玩法。

功能

  • 紧凑的区域文件:使用 .cqs 区域格式,减少原版 .mca 文件以 4 KiB 为分配单位所造成的空间浪费。
  • 共享方块状态:在每个区域内共享方块状态及其属性,避免在多个区块中重复存储相同信息。
  • 无损区段去重:仅在整个区段数据完全相同时共享存储,同时保留区段高度、光照、生物群系及所有其他字段。
  • 后台优化:先将完整区块数据写入磁盘,再通过后台线程优化存储大小,减少压缩操作对前台保存的阻塞。
  • 迁移现有世界:提供管理员命令,用于转换现有地形区域、查看进度并安全取消迁移。
  • 标准世界导出:提供离线工具,可将紧凑格式的世界还原为标准 MCA 格式。

能节省多少空间?

在 Tensura Neo Otherworld 的官方服务器上,使用 ChunkSqueeze 后,世界文件夹总大小从 150 GB 降至 90 GB。

以下数据来自版本 0.6.0 的固定样本测试,测试范围为每个维度 20 个区域、20,480 个区块。文件大小包含索引、字典、内部碎片及其他存储开销。

测试样本 原始地形文件 后台优化并正常刷新后 额外执行显式压缩后
主世界 281.64 MiB 227.53 MiB 191.54 MiB
下界 283.37 MiB 227.29 MiB 204.93 MiB
暮色森林 141.52 MiB 98.44 MiB 89.12 MiB

显式压缩后,地形文件大小分别减少约 32%、28% 和 37%。正常保存会根据碎片阈值触发压缩,因此日常使用不一定会立即达到最后一列的大小。

实际节省空间取决于地形、模组内容以及区域的填充密度。上述数据仅适用于地形区域文件,不代表整个世界文件夹。仅含少量区块的稀疏区域可能会因固定索引开销而变大。

压缩会增加 CPU 和 I/O 负载。后台优化可以缩短前台等待时间,但不保证提高 FPS、TPS 或地形生成速度。

命令

命令 用途 权限等级
/chunksqueeze status 查看存储、后台任务和故障保护状态 2
/chunksqueeze migrate 在没有玩家在线时开始迁移现有地形区域 4
/chunksqueeze migrate force 断开在线玩家并开始迁移 4
/chunksqueeze migrate status 查看迁移进度 4
/chunksqueeze migrate cancel 请求安全取消,并保留已完成的迁移 4

迁移期间玩家无法加入。迁移仅处理服务器当前已加载维度中的地形 MCA 文件,并跳过无法净节省空间的区域。

迁移前请备份整个世界。每个区域通过验证并成功提交后,其原始 MCA 文件及关联的 MCC 文件都会被删除。迁移不会自动创建备份。在单人游戏中,强制断开本地玩家可能会关闭集成服务器,因此建议对单人世界使用离线转换工具。

兼容性与移除

ChunkSqueeze 负责处理地形区块存储。实体和 POI 区域仍使用原有格式。方块状态使用注册表名称和完整属性存储,不依赖运行时方块 ID。版本 0.6.0 已在 ATM10 8.5 的生产服务器环境中通过跨重启的方块状态和持久化检查,但这并不涵盖所有模组组合或游戏场景。

移除模组前,必须先将世界还原为标准 MCA 格式。原版 Minecraft 以及仅支持 MCA 的地图编辑器无法直接读取 CQS 文件。若要降级到不支持当前格式的版本,也必须先还原世界。仅停用 compactRegions 并不会转换现有的 CQS 文件。

停止游戏或服务器后,使用项目源码中附带的 tools/restore_world.py 导出标准世界。该工具需要 Python 3.10 或更高版本,无需安装第三方依赖。目标目录必须尚不存在,且源世界不会被修改。请在项目目录中运行:

python -I -X utf8 tools/restore_world.py "D:/CompactWorld" "D:/StandardWorld"

备份世界目录中的所有文件,并确认备份工具包含 CQS 文件及其配套文件。游戏或服务器运行时,请勿使用外部工具修改世界文件。

常见问题

ChunkSqueeze 支持哪些 Minecraft 版本?

ChunkSqueeze 支持 Minecraft Java 版 1.20.1–1.21.1,共 2 个版本,可用的加载器:Fabric / Forge / NeoForge。下载时注意选择和你游戏版本一致的文件。

ChunkSqueeze 怎么安装?

先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric / Forge / NeoForge,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。

评论

登录后评论和评分

TheFlareStar 的其他作品

查看全部 →