跳到正文
故障排除

常见平台错误

运行 Codexe 结果时出现错误的解决方法：插件无法加载、模组崩溃、数据包不生效、Skript 解析错误，以及为什么面向 Java 17 的模组要用 Java 21 构建。

更新于

本页内容
  1. 插件
  2. 模组
  3. 为什么我的模组面向 Java 17，却用 Java 21 构建？
  4. 数据包
  5. Skript
  6. Discord 机器人

#插件

症状解决方法
插件没有出现在 /plugins 中在启动日志中查找插件的名称。“Invalid plugin.yml”或“main class not found”表示描述文件有误：请让聊天修复 plugin.yml。
“Unsupported API version”插件是针对比你的服务器更新的 Minecraft API 构建的。请说明你的服务器版本，并要求针对该版本重新构建。
出现提到另一个插件的 NoClassDefFoundError某个依赖（Vault、PlaceholderAPI……）没有安装。
重启后正常，/reload 之后出问题很多插件不支持 /reload。请改为重启服务器。

#模组

症状解决方法
游戏在专用服务器上崩溃通用代码或主代码中有仅限客户端的代码。请让聊天把客户端代码分离出来。
“Incompatible mod set” / 游戏版本不对模组面向的 Minecraft 或加载器版本不同。请明确写出两者。
启动时缺少依赖（Fabric）把 Fabric API（以及其他列出的依赖）安装到 mods/ 中。

#为什么我的模组面向 Java 17，却用 Java 21 构建？

对于 1.20.5 之前的 Minecraft 版本，模组面向的是 Java 17。然而，Fabric 的构建工具（Loom）只能在 Java 21 或更新版本上运行。Codexe 用 Java 21 运行 Gradle，同时仍然按 Java 17 编译你的模组，所以 JAR 可以在 Java 17 的服务器或客户端上运行。这是正常现象，这也是为什么 Fabric 1.20.1 的构建日志中会提到 Java 21。

#数据包

症状解决方法
/datapack list 中没有显示它ZIP 的顶层必须包含 pack.mcmeta，并且要放在 world/datapacks/ 中。
已加载，但某个配方或函数没有效果pack_format 或文件夹名称与你的版本不符。请说明你确切的 Minecraft 版本。

#Skript

症状解决方法
/sk reload 时出现解析错误通常是缺少附加组件。检查脚本用到了哪些附加组件（不确定的话可以问聊天），然后安装它们。
player's balance 这样的表达式不存在安装 Vault 和一个经济插件。

#Discord 机器人

参见 Discord 机器人：常见问题。

常见平台错误 | Codexe Docs