WorldMagic 提供一个主命令 /worldmagic（别名 /wm），包含若干子命令。

命令总览

命令	别名	权限节点	默认可用	说明
/wm	—	worldmagic.use	仅 OP	显示帮助信息
/wm info	—	无	所有玩家	查看插件版本和说明
/wm status	—	worldmagic.status	所有玩家	查看运行状态
/wm reload	—	worldmagic.reload	仅 OP	重载配置文件
/wm source <china|foreign>	—	worldmagic.source	仅 OP	切换下载源
/wm restart	—	worldmagic.restart	仅 OP	重启代理服务

---

命令详解

/wm info

权限：无（所有玩家可用）

显示插件的基本信息，包括版本号、作者、功能描述和可用命令列表。

示例输出：

=== WorldMagic Plugin ===
版本: 1.0.0
作者: anzhuo
描述: 在 Minecraft 服务器内自动部署 Tuic 代理节点

可用命令:
  /wm reload   - 重载配置
  /wm status   - 查看状态
  /wm source   - 切换下载源
  /wm restart  - 重启服务
  /wm info     - 查看插件信息

---

/wm status

权限：worldmagic.status（默认所有玩家可用）

显示当前的运行状态，包括：

• 工作目录路径（.cache/ 目录）
• tuic-server 二进制文件是否存在
• tuic-config.json 配置文件是否存在
• Tuic 进程是否正在运行
• 当前配置信息（域名、端口、UUID、密码、下载源等）

示例输出：

=== WorldMagic Status ===
工作目录: /opt/mc/.cache
tuic-server: ✓ 存在
配置文件: ✓ 存在
进程状态: ✓ 运行中
---
域名: your-server.example.com
端口: 25565
UUID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
密码: abcd1234
订阅前缀: my-server
下载源: foreign

进程检测机制

• Linux/Unix：执行 pgrep -f tuic-server 检测
• Windows：执行 tasklist /FI "IMAGENAME eq tuic-server.exe" 检测

---

/wm reload

权限：worldmagic.reload（默认仅 OP）

重新从磁盘读取配置文件（config/ 目录中的加密配置），将新配置加载到内存中。

执行后会显示：

• 当前下载源
• 域名
• 端口

注意

reload 仅重新读取配置到内存，不会重启 tuic-server 进程。如需让新配置生效，需在 reload 后执行 /wm restart。

---

/wm source <china|foreign>

权限：worldmagic.source（默认仅 OP）

切换 tuic-server 二进制文件的下载源。

参数	说明	适用场景
foreign	直连 GitHub Releases	境外服务器或能直连 GitHub 的环境
china	通过 gh-proxy.com 镜像	国内服务器或 GitHub 访问受限的环境

示例：

/wm source china

输出：

下载源已更新为: china
请执行 /wm reload 使配置生效

执行后会直接修改服务器根目录下的 plugins/application.properties 文件中的 download-source 字段。

何时需要切换源？

如果你的服务器在国内，且安装时日志提示下载失败或超时，请先执行 /wm source china 切换到国内镜像，然后重启服务器重新触发安装。

---

/wm restart

权限：worldmagic.restart（默认仅 OP）

当前版本限制

restart 命令在当前版本（1.0.0）中为占位符实现，执行后仅会打印日志提示，不会真正重启 tuic-server 进程。

如需重启代理服务，目前的临时方法是：

1. 重启整个 Minecraft 服务器
2. 或手动 kill tuic-server 进程（插件会自动检测并重启，最多 10 次）

---

权限节点

权限节点	默认值	说明
worldmagic.use	op	基础命令使用权限
worldmagic.reload	op	允许重载配置
worldmagic.status	true	允许查看状态（所有玩家）
worldmagic.source	op	允许切换下载源
worldmagic.restart	op	允许重启服务

你可以通过权限管理插件（如 LuckPerms）自定义这些权限的分配。

示例（LuckPerms）：

# 给普通玩家赋予 reload 权限
/lp group default permission set worldmagic.reload true

# 禁止普通玩家查看 status
/lp group default permission set worldmagic.status false

---

Tab 补全

所有子命令和参数均支持 Tab 键自动补全：

/wm <Tab>         → reload  status  source  restart  info
/wm source <Tab>  → china  foreign