CurseForge · Minecraft mod
Hassium
Hassium is a high-performance Minecraft optimization mod providing efficient storage, network optimization, chunk caching, beyond-view rendering, and lighting optimization.
Quick answer
Which Hassium release matches Fabric?
Hassium 2.0.1 — 1.21.11 Fabric targets 1.21.11 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. All 1 required mods have matching files.
Where it goes
Is Hassium required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does Hassium 2.0.1 — 1.21.11 Fabric need?
Hassium 2.0.1 — 1.21.11 Fabric on Fabric. Every mod below is checked against that same setup.
Install Fabric API first. We found matching files for this game-version and loader setup.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add Hassium without breaking your instance.
Built for Hassium 2.0.1 — 1.21.11 Fabric on Fabric. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use Hassium 2.0.1 — 1.21.11 Fabric. It targets 1.21.11 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Fabric API first. We found matching files for this game-version and loader setup.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside Hassium 2.0.1 — 1.21.11 Fabric. It opens that exact file at the source.
About this project
What does Hassium add?
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
Project description from CurseForge.
Pick your setup
Hassium by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
1.21.11
2 loader builds1.21.10
3 loader builds1.21.9
3 loader builds1.21.8
3 loader builds1.21.7
3 loader builds1.21.6
3 loader builds1.21.5
3 loader builds1.21.4
3 loader builds1.21.3
3 loader builds1.21.2
2 loader builds1.21.1
3 loader builds1.20.1
3 loader buildsCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Hassium versions and loaders
Hassium 2.0.1 — 1.21.11 Fabric
hassium-fabric-2.0.1-1.21.11.jar
22 Sept 2026
Hassium 2.0.1 — 1.21.10 Fabric
hassium-fabric-2.0.1-1.21.10.jar
22 Sept 2026
Hassium 2.0.1 — 1.21.9 Fabric
hassium-fabric-2.0.1-1.21.9.jar
22 Sept 2026
Hassium 2.0.1 — 1.21.8 Fabric
hassium-fabric-2.0.1-1.21.8.jar
22 Sept 2026
Hassium 2.0.1 — 1.21.7 Fabric
hassium-fabric-2.0.1-1.21.7.jar
22 Sept 2026
Hassium 2.0.1 — 1.21.6 Fabric
hassium-fabric-2.0.1-1.21.6.jar
22 Sept 2026
Hassium 2.0.1 — 1.21.5 Fabric
hassium-fabric-2.0.1-1.21.5.jar
22 Sept 2026
Hassium 2.0.1 — 1.21.4 Fabric
hassium-fabric-2.0.1-1.21.4.jar
22 Sept 2026
Hassium 2.0.1 — 1.21.3 Fabric
hassium-fabric-2.0.1-1.21.3.jar
22 Sept 2026
Hassium 2.0.1 — 1.21.2 Fabric
hassium-fabric-2.0.1-1.21.2.jar
22 Sept 2026
Hassium 2.0.1 — 1.21.1 Fabric
hassium-fabric-2.0.1-1.21.1.jar
22 Sept 2026
Hassium 2.0.1 — 1.20.1 Fabric
hassium-fabric-2.0.1-1.20.1.jar
22 Sept 2026
Looking for an older file? The official CurseForge project page is in Resources.