Описание
# English
Provides a **high-compression Zstd data stream** for Minecraft multiplayer, replacing the vanilla Zlib compression pipeline to significantly reduce bandwidth usage. Supports cooperative operation between a client-side Mod and a Velocity server plugin.
## How It Works
All game packets exchanged between the client and server are batched together before encryption and compressed using the [Zstd](https://github.com/facebook/zstd?utm_source=chatgpt.com) algorithm. Compared to vanilla Zlib, Zstd can reduce data size by **50%–80%** at the same compression speed. Automatic dictionary training is also supported to further improve compression ratios.
## Supported Versions
* Fabric: 1.21.1, 1.20.1
* Forge: 1.20.1
* Neoforge: 1.21.1
* Velocity: 3.4.0+
## Compatibility
Known compatible with:
* ViaVersion
* limboauth
## Features
* **Transparent Replacement**: Seamlessly takes over the vanilla compression pipeline without requiring server configuration changes
* **Batch Compression**: Aggregates small packets within a 10ms time window to reduce TCP fragmentation overhead, with a 32MB sliding window
* **Adaptive Bypass**: Automatically sends raw batched data if compression does not reduce packet size
* **Real-Time Statistics HUD**: Displays TX/RX byte counts and compression ratio in the top-left corner (toggle with F8)
* **Highly Configurable**: YAML configuration file with support for compression level, window size, statistics interval, and more
## Usage
1. **Velocity**: Place the plugin into the `plugins/` directory and restart the proxy
2. **Client**: Install the corresponding Fabric / Forge mod for your Minecraft version
3. Press **F8** to toggle the HUD display
## Notes
* Both the client and server must install compatible versions to enable Zstd compression
* If no Zstd-compatible client is detected, Velocity automatically falls back to vanilla transmission
* If no Zstd-compatible server is detected, the client automatically falls back to vanilla transmission
---
# 简体中文
为 Minecraft 多人游戏提供 **Zstd 高压缩率数据流**，替代原版 Zlib 压缩，显著降低带宽占用。支持客户端 Mod + Velocity 服务端插件协同工作。
## 原理
客户端与服务端之间的所有游戏数据包在加密前被批量合并，使用 [Zstd](https://github.com/facebook/zstd) 算法压缩。相比原版 Zlib，Zstd 在同等压缩速度下可降低 **50%-80%** 数据量。支持自动训练字典进一步提升压缩比。
## 版本支持
* Fabric: 1.21.1、1.20.1
* Forge: 1.20.1
* Neoforge: 1.21.1
* Velocity: 3.4.0+
## 兼容性
已知兼容
* Viaversion
* limboauth
## 特性
* **透明替换**：无缝接管原版压缩管线，无需修改服务端配置
* **批量压缩**：10ms 时间窗口内聚合小包，减少 TCP 分段开销，32MB 滑动窗口
* **自适应跳过**：若压缩后体积未减小，自动发送原始批量数据
* **实时统计 HUD**：左上角显示 TX/RX 字节数与压缩率（F8 开关）
* **可配置**：YAML 配置文件，支持压缩等级、窗口大小、统计间隔等
## 使用方法
1. **Velocity**：放入 `plugins/`，重启代理端
2. **客户端**：安装对应 MC 版本的 Fabric / Forge Mod
3. 按 **F8** 切换 HUD 显示
## 注意事项
* 客户端与服务端均须安装对应版本才能启用 Zstd 压缩
* 未检测到 Zstd 客户端时，Velocity 自动回退为原版传输
* 未检测到 Zstd 服务端时，客户端自动回退为原版传输