Features

特性

---

English: Features-en · 中文

Hassium 用一套客户端 + 服务端配合，从存档体积、网络带宽、进服流畅度三个维度优化 Minecraft。本页给出每条功能的速览与适用条件。

---

高效存储

• 目标：缩小世界存档体积，仍兼容原版 .mca 布局
• 怎么做的：服务端把每个 chunk payload 用 ZSTD 压缩并标记为 type 126；外层 Region（32×32）数据结构不变
• 配置：storage.enabled（默认 true）、storage.zstdLevel（默认 9）
• 注意：首次启用会改写区块落盘格式，备份世界。详见 FAQ。

---

网络压缩

• 目标：进服与跑图时下载等待更短、带宽占用更低
• 怎么做的：
  • 自定义 hassium:* 通道用 ZSTD 传区块等数据
  • 可选全局管道 ZSTD 替换原版 Zlib（globalPacketCompression）
  • 聚合 + 紧凑包头 + 上下文压缩提升压缩比
• 配置：network.enabled、network.globalPacketCompression、network.compressionLevel、network.enablePacketAggregation

---

客户端区块缓存

• 目标：再次进入同一区域少传全量区块
• 怎么做的：服务端在推送前算 chunkHash；客户端用本地缓存里的 contentHash 比对，命中直接走本地解压 apply，跳过原版全量下载
• 配置：clientCache.enabled（默认 true）
• 细节：客户端缓存以磁盘 NBT（HBT1 magic + CompoundTag）存于 hassium_cache；按热度淘汰（不整文件删除 .mca）

---

分段增量

• 目标：缓存过期（MISMATCH）时避免整块重传
• 怎么做的：客户端拿 sectionHashes 与服务端比对，只请求变更分段（SectionHashRequest / SectionDeltaS2C），在本地与缓存 NBT 合并后写入磁盘；失败/超时自动回退全量
• 配置：clientCache.sectionDeltaEnabled（默认 true；需同时 clientCache.enabled）

比对结果	关闭分段增量	开启（默认）
HIT	缓存队列	缓存队列
MISS	全量请求	全量请求
MISMATCH	全量请求	SectionHashRequest → NBT merge（失败回退全量）

---

超视渲染

• 目标：多人服客户端 RD > 服务端视距时，本地缓存回填视距外环带，仅渲染不参与模拟
• 怎么做的：解锁客户端滑块的 serverVD 钳制；本地缓存命中区块以 renderOnly 标记装配，不向服请求视距外区块/BE；真实区块到达时覆盖回正常
• 配置：clientCache.viewDistanceExtensionEnabled（默认 true）、clientCache.maxRenderDistance（默认 32，范围 2–64）、clientCache.ovdUnloadDelaySecs（默认 5）
• 限制：与 Bobby 互斥；单人服不启用；RD>32 时雾距跟随扩大可能穿帮（Fog Mixin 未实现）
• 专文：Beyond-View-Render

---

光照优化

• 目标：服务端省下光照数据传输；客户端避免每次同步重算
• 怎么做的：
  1. 服务端可剥离光照，首次加载时空光照 → 客户端本地重算并回写缓存（is_light_on=1）
  2. 缓存命中：直接 apply 已存光照，跳过同步重算
  3. SectionDelta 合并后强制 is_light_on=0 避免假命中
• 配置：clientCache.lightCacheEnabled（默认 true）
• 指标：/hassiumc stats 显示 光照优化：xx%（命中 N，重算 M）

---

世界导出

• 目标：把本地缓存导出为可进单机的原版 Anvil 世界
• 命令：/hassiumc export [<serverIp>] [seed]
• 专文：World-Export

---

主控热切

• 目标：TCP 主控断或卡时按候选自动重连，缓存暖续、隐藏断连界面
• 怎么做的：服务端预先把控制面候选端点列表随握手下发客户端；主控硬断或卡顿超过阈值且 UDP 数据面健康时，客户端按候选自动连下一个可达端点，不弹"连接丢失"。切会话期间磁盘缓存、保存队列、任务执行器全保留，新会话直接续上——命中率不掉、地形不需重下
• 默认：关闭（network.dataPlane.enabled = false，模组默认走原版 TCP 单连接）。需运维能力，启用前请确认 Nginx / 公网防火墙 / NAT 规则
• 配置：network.dataPlane.controlStallMs（默认 6000，主控卡顿多久触发 failover）、failoverPermitTtlMs（默认 30000，服务端下发 FailoverPermit 有效期）
• 专文：主控热切与加权分流

---

加权分流

• 目标：高人数服区块下行的带宽瓶颈，用多线路分担
• 怎么做的：区块下载走 UDP/KCP 数据面，可配多个 endpoint（多条线路），按 weight 加权轮询承载。一条线路打满或降级时流量自动压到其余线路；登录、命令、实体同步等"控制类"流量仍走原版 TCP，不受数据线路波动影响
• 默认：关闭（与主控热切同开关 network.dataPlane.enabled = false）。需按线路配公网 UDP 端点
• 配置：每个 endpoint 在 network.dataPlane.udpEndpoints 配置 weight（默认 100），可设 priority 控制候选顺序
• 专文：主控热切与加权分流

---

平滑加载

• 目标：进服与视野扩展时降低卡顿尖峰
• 怎么做的：
  • 服务端每玩家每 tick 序列化上限 network.maxChunksPerTick（默认 10）
  • 客户端每帧主线程 apply 预算 clientCache.mainThreadChunkBudgetMs（默认 15）
  • 进服约 10 秒走 JoinBoost 临时抬高预算，再线性退坡到默认
• 指标：/hassium stats 与 /hassiumc stats 看吞吐与缓存

---

流量监控

命令	侧	输出
/hassium stats	服务端	原始字节 / 发送字节 / 压缩节省 / 推送统计
/hassiumc stats	客户端	接收字节 / 缓存命中 / 超视渲染 / 光照优化

完整命令参考见 Commands。

---

← Commands · Home · → Beyond-View-Render