what-is-world-magic
约 554 字大约 2 分钟
2026-05-23
WorldMagic 是一款运行在 PaperMC 1.21+ 上的 Minecraft 服务端插件。它的核心功能是在 Minecraft 服务器内部自动下载、安装并运行 Tuic Server 代理服务，将你的 Minecraft 服务器复用为代理节点。
Tuic 是什么？
Tuic 是一个基于 QUIC 协议的轻量级代理协议，具有低延迟、高并发的特点，适合在网络受限环境下使用。
关于此项目
设计目标
利用已有的 Minecraft 服务器资源，零额外成本部署代理节点。
如果你拥有一台对外开放的 Minecraft 服务器，WorldMagic 可以让这台服务器同时承担代理节点的职责，而无需：
- 购买额外的 VPS
- 手动配置 Nginx/TLS 证书
- 学习复杂的代理协议部署流程
插件在服务器启动时全自动完成以下工作：
1. 下载 tuic-server 二进制文件
2. 生成并填充配置文件
3. 启动 tuic-server 进程
4. 生成代理客户端订阅链接适用场景
| 场景 | 说明 |
|---|---|
| 已有 Minecraft 服务器 | 利用现有服务器资源，零成本扩展代理能力 |
| 服务器在境外 | 境外 MC 服务器本身就是优质代理出口 |
| 希望快速部署 | 放入 plugins/ 目录，配置一个文件即可 |
技术栈
| 组件 | 详情 |
|---|---|
| 插件平台 | PaperMC 1.21+ |
| Java 版本 | Java 21 |
| 代理内核 | tuic-server（linux-musl 二进制） |
| 代理协议 | Tuic v5（基于 QUIC/UDP） |
| TLS 模式 | 自签名证书（self_sign: true） |
| 加密算法 | RSA-1024（配置文件加密存储） |
局限性
注意事项
- 目前仅支持 Linux 服务器（下载的是
linux-musl二进制，startup.sh为 Linux shell 脚本） - 代理服务监听独立端口（默认与 MC 端口一致），需确保该端口在防火墙中开放 UDP 流量
- TLS 使用自签名证书，客户端连接时需启用
allowInsecure=1选项