トラブルシューティング

コンパイルの失敗

準備完了だったプロジェクトで手動のコンパイルが失敗することがある理由、エラーの読み方、AIで修正が無料になる場合。

更新日 2026年9月27日

このページの内容

#準備完了のプロジェクトでコンパイルが失敗したのはなぜ?

コンパイルは現在のファイルをビルドします。プロジェクトが準備完了になったあとに失敗する主な理由は次のとおりです。

検証のあとにファイルが変わった: 何かを編集した、またはチャットでの変更の検証がまだ終わっていない。
コードの外側の問題: 依存関係のリポジトリが利用できなかった、またはビルドがタイムアウトした(プラグインは5分、MODは10分)。再チェックを試してください。

ファイルがCodexeの届けたものとまったく同じなのにビルドが失敗する場合、それはCodexeが直すべき問題で、修正は無料です。

コンパイルの結果にあるエラーの一覧を読みます。各エラーにはファイルと行が表示されます。
AIで修正を押します。
- Codexeが届けてからファイルが変わっていない場合: 無料の内部修復が実行されます(「問題を修正中…」と表示されます)。
- ファイルが変わっている場合: エラーが通常のメッセージとしてチャットに送られます(トークンを使います)。
自分で直すためにファイルを編集した直後なら、再チェックを押します。

エラー	意味
`cannot find symbol`	ビルド対象のAPIのバージョンに、そのクラス、メソッド、変数が存在しないか、importが足りません。サーバーのバージョンを伝えてください。
`package … does not exist`	`pom.xml` / `build.gradle`に依存関係がありません。使っているプラグインやライブラリの名前を伝えてください。
`incompatible types`	このAPIのバージョンでは、メソッドが別のものを返します。
`Could not resolve …`	依存関係のバージョンが存在しないか、そのリポジトリがCodexeからアクセスできるものではありません。
`release version 21 not supported`	プロジェクトが、ビルドで使ったものより新しいJavaを対象にしています。JavaのバージョンはMinecraftのバージョンから決まるので、それをはっきり書いてください。

コンパイルで証明できるのはコードがビルドできることで、機能が正しく動くことではありません。ゲーム内での動きをチャットで説明してください。プラットフォームのよくあるエラーを参照してください。