Hassium

Hassium 是一款高性能 Minecraft 优化模组，提供高效存储、网络优化、区块缓存、超视渲染与光照优化。覆盖 Minecraft 1.20.1–1.21.11，支持 Fabric / Forge / NeoForge。

GitHub 仓库 · Wiki 中文 · Wiki English

---

简体中文

快速开始

1. 在文件（Files）标签页下载与你的Minecraft 版本和加载器匹配的 JAR 文件。
2. 将其放入客户端和/或服务端的 mods/ 文件夹中。Fabric 额外需要 Fabric API；Forge 和 NeoForge 不需要额外依赖。
3. 建议在客户端和服务端同时安装，以启用协商压缩和缓存命中。默认情况下，原版客户端仍可加入服务器。
4. 首次启用存储功能前，请务必备份现有世界。存储压缩会改写磁盘上的区块数据。

完整说明：安装 · 常见问题

功能

功能	描述
高效存储	对世界区块进行更高压缩率的压缩，以减小存档体积；保持原版区域文件（.mca）布局
网络压缩	对区块和数据包进行更高效的压缩，减少带宽占用和等待时间
区块缓存	已加载的区块保存在本地；再次访问相同区域时优先使用缓存，而非完整下载
分段增量	当缓存不匹配时，仅获取更改的分段（sectionDelta）而非整个区块
超视渲染	当客户端的渲染距离（RD）超过服务器视距（多人游戏）时，使用本地缓存填充外围区域（仅渲染；不会向服务器请求范围外的区块）
世界导出	/hassiumc export 命令将本地缓存写入为原版 Anvil 格式的单人游戏世界
光照剥离	服务器可以省略光照数据；客户端在本地重新计算光照，以节省更多带宽
光照缓存	首次重新计算后缓存光照数据；缓存命中时直接应用预计算的光照，跳过昂贵的重复计算
控制故障转移	如果 TCP 控制连接停滞或断开，将自动通过候选端点重新连接；缓存保持有效，隐藏断连界面（数据面故障转移）
加权分配	多个 UDP/KCP 端点承载数据面，采用基于权重的轮询调度；控制面保留在原版 TCP 上
平滑加载	在加入服务器和视野扩展期间限制主线程工作，以减少卡顿尖峰
客户端友好	默认情况下，未安装此模组的客户端可以连接；在两侧安装可获得完整的压缩和缓存优势
流量统计	/hassium stats（服务器）和 /hassiumc stats（客户端）用于查看压缩和缓存效果

支持版本

Minecraft	Fabric	Forge	NeoForge
1.20.1	✅	✅	✅
1.20.2–1.20.5	✅	—	✅
1.20.6	✅	✅	✅
1.21.1	✅	✅	✅
1.21.2	✅	—	✅
1.21.3–1.21.10	✅	✅	✅
1.21.11	✅	—	✅

完整支持矩阵：支持矩阵

文档

需求	Wiki 页面
设置与依赖	安装
所有配置选项	配置
服务器和客户端命令	命令
缓存、分段增量、光照优化等	功能
超视渲染与世界导出	超视渲染 · 世界导出
兼容性与问题诊断	兼容性 · 故障排查
UDP 数据面与控制故障转移	数据面与故障转移

许可证：GPL-3.0-or-later