WorldMagic 安装完成后会自动生成一个 Tuic 节点订阅链接，你可以将其导入到主流代理客户端中使用。

订阅文件位置

订阅文件存放在服务器工作目录下的 .cache/<uuid> 路径，文件内容为单行 Base64 编码字符串。

your-minecraft-server/
└── .cache/
    ├── tuic-server          # tuic-server 二进制
    ├── tuic-config.json     # tuic 服务配置
    ├── startup.sh           # 启动脚本
    └── xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx   # ← 订阅文件（文件名为 UUID）

获取订阅内容

方式一：SSH 直接读取

cat /path/to/minecraft/.cache/<your-uuid>

方式二：通过 /wm status 查看 UUID 后读取文件

1. 在游戏内或控制台执行 /wm status，记录输出中的 UUID
2. SSH 到服务器，读取 .cache/<uuid> 文件

订阅链接格式

解码后的订阅内容为标准 Tuic 协议 URI：

tuic://<uuid>%3A<password>@<domain>:<port>?sni=<domain>&alpn=h3&insecure=1&allowInsecure=1&congestion_control=bbr#<prefix>-tuic

参数说明：

参数	说明
uuid	认证用户 UUID
password	认证密码
domain	服务器域名
port	Tuic 监听端口（UDP）
sni	TLS SNI（与 domain 相同）
alpn=h3	HTTP/3 ALPN 协议
insecure=1	跳过证书验证（自签名证书必须）
allowInsecure=1	同上（兼容不同客户端参数名）
congestion_control=bbr	使用 BBR 拥塞控制
#<prefix>-tuic	节点名称（显示在客户端节点列表）

导入到客户端

v2rayN（Windows）

1. 打开 v2rayN，点击「服务器」→「从剪贴板导入」
2. 将订阅链接（Base64 编码的原始内容）粘贴进去
3. 或点击「订阅分组」→「添加订阅」，配置订阅 URL（需要你将文件托管到 HTTP 服务器）

Clash.Meta / Mihomo

Tuic v5 配置示例：

proxies:
  - name: "my-server-tuic"
    type: tuic
    server: your-server.example.com
    port: 25565
    uuid: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    password: abcd1234
    alpn: [h3]
    skip-cert-verify: true
    sni: your-server.example.com
    congestion-controller: bbr

Sing-box

{
  "type": "tuic",
  "tag": "my-server-tuic",
  "server": "your-server.example.com",
  "server_port": 25565,
  "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "password": "abcd1234",
  "tls": {
    "enabled": true,
    "insecure": true,
    "server_name": "your-server.example.com",
    "alpn": ["h3"]
  },
  "congestion_control": "bbr"
}

注意事项

UDP 端口

Tuic 基于 QUIC 协议，使用 UDP 传输。请确保：

1. 服务器防火墙/安全组已开放对应端口的 UDP 流量
2. 客户端网络环境不封锁 UDP（部分企业/校园网络会封锁 UDP）

更换凭据

如果需要更换 UUID 或密码：

1. 修改服务器根目录的 application.properties（如果已被删除，重新创建）
2. 删除 config/ 目录下的加密配置文件
3. 重启服务器，插件将读取新的明文配置并重新加密存储