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.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Hassium release matches 1.20.6?

Updated today

beta file Hassium 1.1.2 — 1.20.6 Forge

Game version 1.20.6

Loader Forge

Hassium 1.1.2 — 1.20.6 Forge targets 1.20.6 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

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.

Client Source doesn’t say

Dedicated server Source doesn’t say

Loader for this release Forge

Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

Understand client and server requirements Read the Minecraft installation guide

What else does Hassium 1.1.2 — 1.20.6 Forge need?

Hassium 1.1.2 — 1.20.6 Forge on 1.20.6. Every mod below is checked against that same setup.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Hassium without breaking your instance.

Built for Hassium 1.1.2 — 1.20.6 Forge on 1.20.6. Pick another file and the loader, install side or required mods may change.

01
Stick to this file

Use Hassium 1.1.2 — 1.20.6 Forge. It targets 1.20.6 with Forge; another release may have different loader, side or dependency requirements.
02
Bring the mods it needs

This file does not list any required mods. Do not add a library just because a different file uses it.
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 1.1.2 — 1.20.6 Forge. 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 storage, network optimization, chunk caching, beyond-view rendering, 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

Feature	Description
Efficient storage	Higher-ratio world chunk compression for smaller saves; keeps vanilla Region (`.mca`) layout
Network compression	More efficient compression for chunks and packets — less bandwidth and wait time
Chunk cache	Loaded chunks are kept locally; revisiting an area prefers the cache instead of full downloads
Section delta	On cache mismatch, fetch only changed sections (`sectionDelta`) instead of the whole chunk
Beyond-view render	When client RD exceeds server view distance (multiplayer), fill the outer ring from local cache (render-only; no out-of-range server requests)
World export	`/hassiumc export` writes the local cache as a vanilla Anvil singleplayer world
Light stripping	Server can omit light data; the client recomputes lighting locally to save more bandwidth
Light cache	Light data is cached after first recompute; cache hits apply pre-computed lighting directly, skipping expensive recomputation
Control failover	If the TCP control connection stalls or drops, reconnect automatically through candidate endpoints; the cache stays warm and the disconnect screen is hidden (data-plane failover)
Weighted distribution	Multiple UDP/KCP endpoints carry the data plane with weight-based round-robin; the control plane stays on vanilla TCP
Smooth loading	Caps main-thread work during join and view expansion to reduce hitch spikes
Client-friendly	Clients without the mod can connect by default; install on both sides for full compression and cache benefits
Traffic metrics	`/hassium stats` (server) and `/hassiumc stats` (client) to inspect compression and cache results

Supported versions

Minecraft	Fabric	Forge	NeoForge
1.20.1	Yes	Yes	Yes
1.20.2–1.20.5	Yes	—	Yes
1.20.6	Yes	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 and world export	Beyond-view render · World export
Compatibility and diagnostics	Compatibility · Troubleshooting
UDP data plane and control failover	Data Plane and Failover

简体中文

快速开始

在 Files 页下载与你的Minecraft 版本和加载器匹配的 JAR。
放入客户端或服务端的 mods/。Fabric 另需 Fabric API；Forge / NeoForge 无额外前置。
推荐服务端与客户端都安装，以启用协商压缩和缓存命中；未装 Hassium 的客户端默认仍可连接。
已有世界首次启用存储前务必备份。 存储压缩会改写区块落盘 payload。

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

功能

能力	说明
高效存储	世界区块用更高压缩率落盘，显著减小存档体积；仍兼容原版 Region（`.mca`）布局
网络压缩	区块与数据包用更高效压缩传输，降低带宽占用与下载等待
区块缓存	曾加载过的区块写入本地；再次进入同一区域时优先用本地数据，少传全量包
分段增量	缓存过期时仅拉取变更分段（`sectionDelta`），避免整块重传
超视渲染	多人服客户端 RD 大于服务端视距时，用本地缓存回填视距外地形（仅渲染、不向服索要视距外区块）
世界导出	`/hassiumc export` 将本地缓存导出为可进单机的原版 Anvil 世界
光照剥离	服务端可不传光照数据，由客户端本地重算，进一步省流量
光照缓存	首次加载重算后缓存光照数据，后续缓存命中直接应用，跳过同步重算
主控热切	TCP 主控断或卡时按候选自动重连，缓存暖续、隐藏断连界面（数据面 failover）
加权分流	多 UDP/KCP endpoint 按 weight 加权轮询承载数据面，控制面留原版 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 数据面与主控 Failover	数据面与主控 Failover