ガイド
Minecraftプラグインのエラーの直し方
2026年10月18日に更新
プラグインが読み込まれないとき、サーバーはほぼ必ず理由を教えてくれます。理由は起動中のコンソールの、プラグイン名の数行上か下にあります。ログのその部分を読めるようになれば、ほとんどのエラーは1分で直せます。よくあるエラーとその意味を紹介します。
サーバーのバージョンと、プラグインにしてほしいことを書いてください。
Codexeでこれを生成手順
1.起動時のログを開く
コンソール、またはサーバーフォルダの
logs/latest.logを読みます。ホスティングのパネルなら、そのコンソールかファイルマネージャーを使います。2.プラグインの名前で検索する
その名前が出てくる最初のエラーを探します。重要なのは、
[ERROR]や[WARN]で始まる行と、その下のスタックトレースです。3.最初の行と「Caused by」の行を読む
最初の行は何が失敗したかを示し、最後の
Caused by:の行がたいてい理由を示します。プラグイン自身のパッケージ名がある行は、コードのどこで起きたかを示します。4.下の一覧と照らし合わせる
起動時のエラーのほとんどは、バージョン、Java、依存関係のいずれかの問題で、メッセージにどれなのかが書かれています。
5.1つ直して再起動する
1つだけ変えて再起動し(
/reloadではなく)、もう一度ログを読みます。1つのプラグインのエラーが、ほかのプラグインのエラーを引き起こすこともあります。
よくあるエラー
| 表示される内容 | 意味 | 対処法 |
|---|---|---|
Unsupported API version 1.21 | プラグインのapi-versionがサーバーより新しい。 | サーバーに合ったバージョンを入手するか、サーバーをアップデートする。 |
Invalid plugin.ymlまたはJar does not contain plugin.ymlを伴うCould not load 'plugins/X.jar' | プラグインの記述ファイルがないか、YAMLのエラーがある。またはファイルがプラグインではない。 | ソース、MOD、zipではなく、プラグインをダウンロードしたか確認する。自分でビルドしたなら、plugin.ymlを直す。 |
UnsupportedClassVersionError、「class file version 65.0」 | プラグインが、サーバーで動いているものより新しいJavaを必要としている(61 = Java 17、65 = Java 21、69 = Java 25)。 | そのJavaでサーバーを動かすか、自分のJava向けにプラグインをビルドし直す。 |
NoClassDefFoundErrorまたはClassNotFoundException | プラグインが必要とするクラスがない。依存プラグインがないか、ライブラリが.jarにシェーディングされていないか、そのAPIがこのバージョンに存在しない。 | エラーに書かれたプラグイン(Vault、ProtocolLib)をインストールするか、自分のバージョン用のビルドを使う。 |
Unknown/missing dependency plugins | dependに書かれたプラグインがインストールされていない。 | plugins/にインストールする。 |
Error occurred while enabling X (Is it up to date?) | プラグインは読み込まれたが、onEnableでクラッシュした。 | Caused byの行を読む。多くは設定のエラーか、依存関係の不足。 |
Ambiguous plugin name | 同じプラグインの.jarファイルがplugins/に2つある。 | 古いほうを削除する。 |
読み込み以外のエラー
- プラグインは緑なのに、コマンドで「Unknown command」と出る: コマンドが
plugin.ymlにないか、別のプラグインが同じ名前を使っています。 - 「I'm sorry, but you do not have permission」: プレイヤーに権限ノードがありません。プラグインのページでノードを確認し、権限プラグインで付与してください。
- config.ymlを編集した後のエラー: YAMLではタブではなくスペースを使い、
:を含むテキストや&で始まるテキストは引用符で囲む必要があります。 - 再起動後は動くのに、/reloadの後に壊れる: プラグインが
/reloadに対応していません。代わりに再起動してください。
サーバーに必要なJava
Minecraft 1.20.5以降はJava 21、26.xはJava 25、1.18から1.20.4まではJava 17が必要です。サーバーと同じJavaでjava -versionを実行してください(ホスティングのパネルでは、たいてい「Dockerイメージ」や「Javaバージョン」という設定です)。古いJava向けにビルドしたプラグインは新しいJavaでも動きますが、その逆は動きません。
Codexeで作ったプラグインを直す
Codexeで作ったプラグインは、選んだバージョン向けにコンパイルされ、準備完了になる前に有効なplugin.ymlがあるか確認されます。テストサーバーでは、ログタブにエラーを強調したログがリアルタイムで表示され、ログをエクスポートでファイルとして保存できます。見えたことをプロジェクトのチャットで説明すれば(「/pluginsでプラグインが赤く、ログには……と出ています」)、Codexeがコードを変えてもう一度ビルドします。Codexeが届けたままのファイルでコンパイルが失敗した場合は、AIで修正が無料で修復します。
よくある質問
サーバーログはどこにありますか?
サーバーフォルダのlogs/latest.logが、現在の起動のログです。以前の起動のログは、同じフォルダに.log.gzファイルとして残っています。
あるプラグインがほかのプラグインを壊すことはありますか?
はい。依存関係がなかったり壊れていたりすると、それを必要とするすべてのプラグインが止まります。ほかのエラーより先に、ログの最初のエラーを直してください。
ログを共有しても安全ですか?
おおむね安全ですが、先に確認してください。ログにはIPアドレスが含まれることがあり、プラグインによってはエラーにデータベースのパスワードが出ることもあります。
壊れたプラグインを自分のサーバー向けに作り直す
このプロンプトは、そのまま送信できる状態で開きます:
“読み込まれなくなった古いプラグインの代わりになる、SimpleWarpsという名前のPaper 1.21.4プラグイン: 名前を指定する/setwarp、/warp、/delwarp、/warpsでGUIに一覧表示、設定と削除には権限warps.admin、ワープは再起動後も保存、メッセージはconfig.yml。”
Codexeでこれを生成