WorldMagic 支持两种 tuic-server 二进制文件的下载源，以适应不同网络环境。

两种下载源

foreign（国际源，默认）

直接从 GitHub Releases 下载：

https://github.com/Itsusinn/tuic/releases/download/v{version}/tuic-server-{arch}-linux-musl

适用场景：

• 服务器位于境外（美国、日本、新加坡等）
• 国内服务器但网络能正常访问 GitHub

---

china（国内镜像）

通过 gh-proxy.com 镜像下载：

https://gh-proxy.com/https://github.com/Itsusinn/tuic/releases/download/v{version}/tuic-server-{arch}-linux-musl

适用场景：

• 服务器位于中国大陆
• 服务器访问 GitHub 速度慢或超时

如何切换下载源

方式一：修改配置文件

在 application.properties 中设置：

download-source=china

方式二：使用命令

在游戏内或控制台执行：

/wm source china

或

/wm source foreign

命令执行后会立即修改 application.properties 文件中的对应字段。

架构支持

WorldMagic 会自动检测服务器 CPU 架构，选择对应的二进制文件：

CPU 架构	下载文件名
x86_64（amd64）	tuic-server-x86_64-linux-musl
ARM64（aarch64）	tuic-server-aarch64-linux-musl

下载失败处理

如果下载失败，服务器控制台会打印错误日志。常见原因：

错误	解决方案
连接超时	切换到 china 源，或检查服务器网络
404 Not Found	检查 tuic-version 配置是否对应实际存在的 Release 版本
权限错误	确保 .cache/ 目录有写入权限

手动下载

如果自动下载始终失败，你也可以手动处理：

1. 在本地下载对应版本的 tuic-server-x86_64-linux-musl
2. 上传到服务器并重命名为 tuic-server
3. 放置到服务器根目录的 .cache/ 目录
4. 赋予执行权限：chmod +x .cache/tuic-server
5. 重启服务器（插件会检测到文件已存在，跳过下载步骤）