Hassium
- By
Hassium is a high-performance Minecraft optimization mod providing efficient storage, network optimization, chunk caching, beyond-view rendering, and lighting optimization.
Hassium is a high-performance Minecraft optimization mod providing efficient compression, network optimization, chunk cache, local generation, and lighting optimization. Covers Minecraft 1.20.1–1.21.11 on Fabric / Forge / NeoForge.
Hassium 是 Minecraft 的高性能优化模组，提供高效压缩、网络优化、区块缓存、本地生成与光照优化。覆盖 Minecraft 1.20.1–1.21.11，支持 Fabric / Forge / NeoForge。
GitHub Repository · Wiki 中文 · Wiki English
English
Quick start
- Download the JAR matching your Minecraft version and loader from the Files tab.
- Put it in
mods/on the client and/or server. Fabric additionally requires Fabric API; Forge and NeoForge need no extra dependency. - Install on both client and server for negotiated compression and cache hits. Vanilla clients can still join by default.
- Back up existing worlds before first enabling storage. Storage compression rewrites on-disk chunk payloads.
Full instructions: Installation · FAQ
Features
| Category | Feature | Description |
|---|---|---|
| Efficient compression | Storage compression | World chunks are ZSTD-compressed on disk for significantly smaller saves; keeps the vanilla Region (.mca) layout |
| Channel compression | On-wire compression lowers bandwidth and download waits; never touches the vanilla compression layer, no cross-mod conflicts | |
| Network optimization | Smooth push | Chunks are rate-limited per tick and encode/compress work is offloaded; joins and view expansion never stall the main thread |
| Entity optimization | Distance-tiered rates, hotspot density throttle, packet-budget backpressure, and phase stagger; replication-only — vanilla clients can join | |
| Chunk cache | World save | Chunks you visit are saved to a local cache automatically; saved on disconnect, reused on reconnect — no full re-download |
| Section delta | On stale cache only changed blocks or whole sections are fetched instead of the whole chunk | |
| Local generation | With both sides on the same version, unexplored terrain is generated locally to save bandwidth; enabling on the server sends the world seed to clients | |
| Beyond-view render | When client render distance exceeds server view distance, the outer ring is backfilled from locally cached terrain; render-only, never requested from the server; mutually exclusive with Bobby | |
| Heat eviction | Over-capacity caches are cleaned by region heat automatically | |
| World export | /hassiumc export copies the local cache into a standalone save directory |
|
| Lighting optimization | Unified lighting | An in-process engine computes chunk lighting and packs it back; the main thread is no longer occupied by lighting on load; auto-degrades on startup failure |
| Light stripping | The server may strip light data to save bandwidth; the client computes and writes it back | |
| Light cache | Computed lighting is saved with the chunk and reused on reconnect, skipping recomputation | |
| Utilities | Traffic monitoring | /hassium stats (server) and /hassiumc stats (client) show compression and cache effectiveness |
Clients without the mod can connect by default (compat.requireClientMod = false); install on both sides for full compression and cache benefits.
Supported versions
| Minecraft | Fabric | Forge | NeoForge |
|---|---|---|---|
| 1.20.1 | Yes | Yes | — |
| 1.21.1 | Yes | Yes | Yes |
| 1.21.2 | Yes | — | Yes |
| 1.21.3–1.21.10 | Yes | Yes | Yes |
| 1.21.11 | Yes | — | Yes |
Complete matrix: Support Matrix
Documentation
| Need | Wiki page |
|---|---|
| Setup and dependencies | Installation |
| Every configuration option | Configuration |
| Server and client commands | Commands |
| Cache, section delta, light optimization and more | Features |
| Beyond-view render (OVD) and world export | Beyond-view render · World export |
| Compatibility and diagnostics | Compatibility · Troubleshooting |
| Network architecture (direct topology) | Network Architecture |
简体中文
快速开始
- 在 Files 页下载与你的Minecraft 版本和加载器匹配的 JAR。
- 放入客户端或服务端的
mods/。Fabric 另需 Fabric API；Forge / NeoForge 无额外前置。 - 推荐服务端与客户端都安装，以启用协商压缩和缓存命中；未装 Hassium 的客户端默认仍可连接。
- 已有世界首次启用存储前务必备份。 存储压缩会改写区块落盘 payload。
功能
| 分类 | 能力 | 说明 |
|---|---|---|
| 高效压缩 | 存储压缩 | 世界区块 ZSTD 落盘，存档体积显著减小；仍兼容原版 Region（.mca）布局 |
| 通道压缩 | 传输通道压缩，降低带宽与下载等待；不触碰原版压缩层，无跨 mod 冲突面 | |
| 网络优化 | 平滑推送 | 区块按每 tick 上限限速下发，编码与压缩后台化；进服与扩展视野不卡主线程 |
| 实体优化 | 按距离分档降频、热点密度降频、包量反压、错峰发送；只改下发节拍，原版客户端可直接连 | |
| 区块缓存 | 世界保存 | 进服区块自动落盘本地缓存，断连保存、重连复用，少传全量区块 |
| 分段增量 | 缓存过期时只补变更方块或整段，避免整块重传 | |
| 本地生成 | 双端同版本时，大片未探索地形由本地生成，节省带宽；服务端开启会向客户端下发世界种子 | |
| 超视渲染 | 客户端渲染距离大于服务端视距时，用本地已有地形回填视距外环带；仅渲染，不向服务端请求；与 Bobby 互斥 | |
| 热度淘汰 | 缓存超容量时按 region 热度自动清理旧区块 | |
| 世界导出 | /hassiumc export 将本地缓存导出为独立存档目录 |
|
| 光照优化 | 统一算光 | 客户端进程内统一计算区块光照并打包回传，加载阶段主线程不再被算光占用；启动失败自动降级 |
| 光照剥离 | 服务端可剥离光照数据省流量，由客户端统一计算后写回 | |
| 光照缓存 | 算好的光照随区块一体落盘，重连复用，跳过重算 | |
| 实用工具 | 流量监控 | /hassium stats（服务端）、/hassiumc stats（客户端）查看压缩与缓存效果 |
未安装本模组的客户端默认可连接（compat.requireClientMod = false）；双端都装才能吃满压缩与缓存。
支持版本
| Minecraft | Fabric | Forge | NeoForge |
|---|---|---|---|
| 1.20.1 | ✅ | ✅ | — |
| 1.21.1 | ✅ | ✅ | ✅ |
| 1.21.2 | ✅ | — | ✅ |
| 1.21.3–1.21.10 | ✅ | ✅ | ✅ |
| 1.21.11 | ✅ | — | ✅ |
完整矩阵见：支持矩阵
文档导航
| 需要了解的内容 | Wiki 页面 |
|---|---|
| 安装和前置依赖 | 安装 |
| 全部配置项 | 配置 |
| 服务端和客户端命令 | 命令 |
| 缓存、分段增量、光照优化等 | 特性 |
| 超视渲染（OVD）与缓存世界导出 | 超视渲染 · 世界导出 |
| 兼容性与故障排查 | 兼容性 · 排查 |
| 网络架构（直连拓扑） | 网络架构 |
许可证：GPL-3.0-or-later
The Hassium Team
