跳到主要內容
疑難排解

常見平台錯誤

執行 Codexe 成果時出錯的解法：插件沒有載入、模組當機、資料包沒有套用、Skript 解析錯誤，以及為什麼模組用 Java 21 建置卻是給 Java 17。

更新於

本頁內容
  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）在 mods/ 中安裝 Fabric API（以及其他列出的相依套件）。

#為什麼我的模組目標是 Java 17，卻用 Java 21 建置？

Minecraft 1.20.5 之前的版本，模組的目標是 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