QUIC-MC
一款为 Minecraft 游戏流量提供 QUIC(UDP)传输的模组和插件,取代通常的 TCP 连接。
由两部分组成:
- Mod (Fabric, 客户端) — 由玩家安装。检测服务器是否支持 QUIC,并透明地将游戏连接重定向到本地隧道。浏览服务器列表时不会触发任何提示——信任对话框仅在您实际尝试加入服务器时出现。
- Plugin (Velocity, 服务端) — 由代理服务器所有者安装。监听单独的 UDP 端口并通过该端口接受运行了模组的客户端的游戏连接。
QUIC 基于 UDP 运行,与 TCP 不同,它不会因为单个数据包丢失而阻塞所有数据流,并且能更快地恢复连接。在不稳定的网络上,这可以降低延迟和断连次数——前提是服务器和客户端都使用 QUIC-MC。
安装前须知
- 该模组仅在与安装了 QUIC-MC 插件的服务器配合时使用。在普通服务器上它没有任何效果,流量仍像往常一样通过 TCP 传输。
- 如果您运行服务器,则必须在 Velocity 代理上安装插件——否则拥有模组的玩家将无法获得任何好处。
- 服务端插件目前仅适用于 Linux x86_64。Windows 构建尚未就绪(由于上游库问题),且暂不计划支持 macOS。
- 需要 Java 21。
给玩家
- 通过 Fabric Loader 为您的 Minecraft 版本安装模组。
- 照常加入服务器。如果服务器支持 QUIC,首次连接时会看到一个包含地址和简短身份代码的对话框——将其与服务器所有者发布的代码进行比较,然后输入一次发布的访问密钥。
- 启用 QUIC 的服务器在服务器列表中会用 ⚡ 图标标记。
访问密钥和身份代码与该特定服务器绑定,且仅请求一次——之后连接将自动进行。
给服务器所有者
- 在您的 Velocity 代理上安装插件。
- 首次启动时,插件会创建配置文件并为您的服务器生成唯一的访问密钥。
- 在防火墙中打开所需的 UDP 端口,并将访问密钥和身份代码发布在玩家可以看到的地方(例如在您的服务器描述或网站中)。
平台支持
| 平台 |
Mod (客户端) |
Plugin (服务端) |
| Linux x86_64 |
✅ |
✅ |
| Windows x86_64 |
✅ |
⏳ pending (Windows native build isn't ready upstream) |
| macOS |
⏳ planned |
❌ not planned |
要求
- Java 21
- 客户端: Fabric Loader
- 服务端: Velocity
了解更多
技术文档、架构细节、安全模型和构建说明见 GitHub 仓库的 README。
许可证
AGPL-3.0
QUIC-MC
A mod and plugin that add QUIC (UDP) transport for Minecraft game traffic instead of the usual TCP connection.
Made up of two parts:
- Mod (Fabric, client) — installed by the player. Detects whether a server supports QUIC and transparently reroutes the game connection through a local tunnel. Browsing the server list never triggers any prompts — the trust dialog only appears when you actually try to join a server.
- Plugin (Velocity, server) — installed by the proxy server owner. Listens on a separate UDP port and accepts game connections through it from clients running the mod.
QUIC runs over UDP and, unlike TCP, doesn't stall all data streams when a single packet is lost, and recovers connections faster. This can reduce latency and disconnects on unstable networks — provided both the server and the client are using QUIC-MC.
What to know before installing
- The mod only works with servers that have the QUIC-MC plugin installed. On regular servers it has no effect and traffic goes over TCP as usual.
- If you run a server, the plugin needs to be installed on the Velocity proxy — otherwise players with the mod won't get any benefit.
- The server-side plugin currently only works on Linux x86_64. A Windows build isn't ready yet (an upstream library issue), and macOS isn't planned.
- Requires Java 21.
For players
- Install the mod for your Minecraft version via Fabric Loader.
- Join the server as usual. If the server supports QUIC, on first connection you'll see a dialog with the address and a short identity code — compare it with the code published by the server owner, then enter the published access key once.
- QUIC-enabled servers are marked with a ⚡ icon in the server list.
The access key and identity code are tied to that specific server and only requested once — after that, connecting happens automatically.
For server owners
- Install the plugin on your Velocity proxy.
- On first startup the plugin creates a config file and generates a unique access key for your server.
- Open the required UDP port in your firewall and publish the access key and identity code somewhere players can see them (e.g. in your server description or website).
Platform support
| Platform |
Mod (client) |
Plugin (server) |
| Linux x86_64 |
✅ |
✅ |
| Windows x86_64 |
✅ |
⏳ pending (Windows native build isn't ready upstream) |
| macOS |
⏳ planned |
❌ not planned |
Requirements
- Java 21
- Client: Fabric Loader
- Server: Velocity
Learn more
Technical documentation, architecture details, the security model, and build instructions are in the repository's README on GitHub.
License
AGPL-3.0
评论 0
登录后参与评分
还没有评论,来抢沙发吧