启动报错排查

启动报错不要只看最后一行，先从控制台最早出现的红色内容开始检查。

常见原因

现象	常见原因
提示缺少插件或依赖	前置插件未安装、未启用或版本不匹配
提示 Java 版本不支持	当前 Java 版本不符合服务端或插件要求
更换插件后仍加载旧版本	目录中存在重复 Jar，或服务端仍在使用旧缓存
修改配置后无法启动	YAML 缩进、引号、列表或材质名称错误
只有正式服报错	与其他插件冲突，或正式服配置和测试服不同

检查 Java

控制台输入：

java -version

确认 Java 版本符合服务端和插件要求。

检查依赖

输入：

/plugins

确认依赖插件是绿色。

最小化测试

如果不知道是哪个插件冲突：

1. 备份服务器。
2. 只保留 GTCore 和目标插件。
3. 启动测试。
4. 逐个加回依赖。
5. 找到冲突点。