マイクラサーバーのプラグインが反映されない！原因と確認方法を解説

プラグインを入れてサーバーを再起動したのに、コマンドが使えないまま…
/pluginsで確認したら赤く表示されている、でも何が原因か分からない
そもそも/pluginsに名前すら出てこない

プラグインが動かないとき、焦ってファイルを入れ直しても解決しません。

見るべき場所は決まっています。

原因の大半は、次の4つのどれかです。

フォルダの置き場所
サーバーの種類の不一致
バージョン違い
前提プラグインの不足

この記事では、/pluginsコマンドとサーバーログの読み方から、各原因の確認手順まで解説します。

読み終えると、赤く表示されている原因を特定して、具体的な修正に進める状態になります。

まず確認する2つのこと

プラグインが動かないとき、まず見るのはこの2つです。

ここで9割の原因は見えてきます。

プラグインの読み込み状態を確認する

プラグインが緑色なら正常、赤色ならログ、表示なしなら配置と種類を確認することを示した図解

サーバーのコンソールまたはゲーム内で /plugins を実行すると、読み込まれたプラグインの一覧が表示されます。

/plugins

緑色：正常に動いている
赤色：読み込まれたが、起動に失敗している
表示されない：プラグインファイル自体が読み込まれていない

赤色のプラグインは、サーバーログにエラーが出ています。

表示すらされない場合は、ファイルの置き場所かサーバーの種類に問題があります。

サーバーログでエラーを探す

サーバーを起動したときのログに、プラグイン名と一緒に ERROR や WARN が出ていないか確認してください。

ログは logs/latest.log に保存されています。

エラー文の中に ClassNotFoundException、NoClassDefFoundError、Unknown dependency などが含まれていれば、バージョン違いか前提プラグインの不足が原因です。

/pluginsで赤くなっているときは、サーバーログを見れば原因のヒントが書いてあります。エラー文をそのまま検索すると解決策が見つかりやすいです。

ログに出るエラー文の意味と対処は、こちらでも解説しています。

原因は4つ：フォルダ・種類・バージョン・依存関係

プラグインが動かない原因は、突き詰めると数えられるほどしかありません。

下の表は、よくある原因と、そのときに出る症状、確認する場所をまとめたものです。

自分の症状がどの行に当てはまるかを先に見当づけてから、各見出しで詳しい手順を確認すると早く解決できます。

原因	症状	確認方法
pluginsフォルダへの配置ミス	/pluginsに表示されない	フォルダの中身を確認
サーバーの種類が違う	起動エラー、/pluginsに出ない	jarファイルの対応サーバーを確認
バージョン不一致	赤色表示、起動エラー	プラグインの対応バージョンを確認
前提プラグインの不足	赤色表示、Unknown dependency	プラグインページで依存関係を確認
サーバー再起動していない	コマンドが使えない	サーバーを完全に再起動する
ファイルが破損・非対応	起動エラー	公式サイトから再ダウンロード

「サーバー再起動していない」に当てはまりそうなら、停止から起動までの手順をこちらで確認してください。

プラグインフォルダへの配置を確認する

plugin.jarをpluginsフォルダ直下へ置き、zipやサブフォルダ内のjarは読み込まれないことを示した図解

プラグインは必ず plugins フォルダの直下に置きます。

サブフォルダの中に入れたり、別のフォルダと間違えたりすると、サーバー起動時に読み込まれません。

見るのはこの3つだけです。

ファイルは .jar 形式か（zipのままだと動かない）
plugins フォルダの直下にあるか（サブフォルダの中ではない）
plugins フォルダがサーバーの起動ファイルと同じ階層にあるか

ZIPファイルをダウンロードした場合は、解凍してから .jar ファイルだけを plugins フォルダへ入れてください。

補足

Spigot・Paper・Purpurのサーバーでは、起動ファイル（server.jar）と同じ場所に plugins フォルダが作られます。別の場所に別の plugins フォルダを作っても読み込まれません。

PaperまたはSpigot対応か確認する

プラグインにはサーバーの種類の指定があります。

プラグインの種類	動作するサーバー
Spigot対応	PaperとSpigotで動く
Paper専用	Paperでのみ動く
Bukkit対応	Spigot・Paperどちらでも動くことが多い
Fabric MOD	Fabricサーバーで動く。Paper・Spigotでは動かない

バニラサーバーやForgeサーバーにSpigot向けプラグインを入れても、読み込まれません。

プラグインを配布しているSpigotMCやHangar、Modrinthのページで対応サーバーを確認してください。

Paper向けのプラグインなのに、Forgeで使おうとしていたのかもしれません。

サーバーの種類が違うと、どれだけ正しいフォルダに置いても動きません。まずサーバーの種類を確認してください。

プラグインサーバーの準備から始める場合はこちらで確認できます。

バージョン違いを確認する

ModrinthのVersionsタブでGame versionとPlatformsを確認する画面

プラグインにはマイクラのバージョン指定があります。

バージョンが一致しないプラグインは起動に失敗し、/pluginsで赤く表示されます。

サーバーコンソールで version を実行してサーバーのバージョンを確認する
プラグインの配布ページで「対応バージョン」または「Supported Versions」を見る
サーバーバージョンと一致するプラグインのバージョンをダウンロードし直す

サーバーのバージョンを確認するコマンドはこれです。

version

バージョンが合わない場合は、プラグインの配布ページで「All Versions」を開いて、サーバーと同じバージョン向けのファイルを探してください。

古いプラグインのままサーバーを上げた場合も同様です。

補足

プラグインを更新したあとは、同じバージョン向けのものに替えたかも確認してください。サーバーを1.20から1.21に上げたとき、プラグインをそのままにすると赤く表示されます。

前提プラグインを確認する

知らないと引っかかりやすいのが前提プラグインです。

別のプラグインが先に入っていないと動かない仕組みで、これを「依存関係」と呼びます。

中でもよく出てくるのが次の3つです。

LuckPerms（権限管理系プラグインの多くが必要とする）
Vault（経済系・クリックインベントリ系プラグインに必要）
PlaceholderAPI（プレースホルダーを使うプラグインに必要）

サーバーログに Unknown dependency や Soft dependency と表示された場合は、前提プラグインが不足しています。

プラグインの配布ページの「Dependencies」または「Required plugins」を確認して、必要なプラグインを先に入れてください。

おすすめプラグインのまとめを見て複数まとめて入れたとき、依存関係のプラグインが抜けているパターンが多いです。エラーに出ているプラグイン名を検索して入れましょう。

よく使うプラグインと用途の一覧はこちらです。

赤色表示やコマンドエラーが出たときの確認順

/plugins で赤く表示されているプラグインは、ファイルは読み込まれているが起動に失敗している状態です。

この順番で見ていくと絞りやすいです。

サーバーログで ERROR や WARN の内容を確認する
バージョン不一致のエラー文が出ていないか確認する
前提プラグインのエラーが出ていないか確認する
上記で解決しない場合は、プラグインを削除して公式から再ダウンロードする

コマンドは使えるが、期待した動作をしないという場合は、プラグインのconfig.ymlが正しく設定されているかを確認してください。

config.ymlはプラグインを一度起動すると plugins/[プラグイン名]/ フォルダ内に生成されます。

補足

コマンドが Unknown command と表示される場合は、プラグインが正常に動いていない（赤色表示）か、オペレーター権限がないかのどちらかです。/pluginsで状態を確認してから原因を切り分けてください。

オペレーター権限の設定はこちらで確認できます。

解決しないときは1つずつ外す

プラグインを停止、1つ移動、再起動、/plugins確認の順で切り分ける図解

複数を一度に入れると、どれが原因か分からなくなりがちです。

僕も最初のころはここで詰まりました。1つずつ外して確認するのは遠回りに見えて、原因にたどり着くにはこれが確実です。

サーバーを停止する
入れたプラグインを1つだけ plugins フォルダから別の場所に移す
サーバーを再起動して /plugins と動作を確認する
問題が消えた → 移したプラグインが原因

サーバーを停止するときは、コンソールでこのコマンドを実行します。

stop

ここまで確認しても直らないときは、プラグイン側の不具合（バグ）も疑ってください。

僕もRPG系のプラグインで、バージョンも前提プラグインも合っているのに、エラーを吐き続けて使えなかったことがあります。

原因は自分の設定ではなく、プラグイン自体のバグでした。

こういうときは、プラグインの公式フォーラム（SpigotMCなど）でエラー文を検索してください。

同じ症状の報告や修正版が見つかることが多く、別のバージョンや代わりのプラグインに切り替えると解決します。

作業前にサーバーのワールドフォルダと plugins フォルダを別の場所にコピーしておくと、設定変更で問題が起きたときに元の状態へ戻せます。

よくある質問

プラグインを入れたのにコマンドが使えません

まず/pluginsで状態を確認してください。赤く表示されているならサーバーログにエラーが出ています。表示もされていない場合は、pluginsフォルダへの配置場所とサーバーの種類（PaperかSpigotか）を確認してください。

プラグインが赤く表示されるのはなぜですか？

ファイルは読み込まれているが起動に失敗している状態です。バージョン不一致、前提プラグインの不足、ファイルの破損が主な原因です。サーバーログのエラー文を確認すると原因が絞れます。

バニラサーバーにプラグインを入れられますか？

入れられません。プラグインはSpigotやPaperのようなプラグイン対応サーバーでのみ動きます。バニラサーバーのままではどのプラグインも読み込まれません。

サーバーを再起動したのにプラグインが反映されません

サーバーを停止して完全に終了してから、再起動してください。サーバーコンソールのstopコマンドで止めてから起動すると、プラグインが正しく読み込まれます。

前提プラグインはどこで確認できますか？

プラグインの配布ページ（SpigotMC・Hangar・Modrinthなど）の「Dependencies」または「Required plugins」に記載されています。サーバーログに「Unknown dependency」と出ている場合も、プラグイン名で検索して確認してください。

まとめ：プラグインの状態とログから原因を特定する

動かない原因のほとんどは、次の6ステップで特定できます。

/plugins でプラグインが緑か赤か、表示されているか確認する
サーバーログで ERROR や WARN の内容を確認する
plugins フォルダへの配置と .jar 形式であることを確認する
サーバーの種類（Paper・Spigotか）とプラグインの対応を確認する
マイクラとプラグインのバージョンが合っているか確認する
前提プラグインが入っているか確認する

複数を一度に入れた場合は、1つずつ外しながら原因を特定してください。

プラグインを1つ入れるたびに動作確認すると、問題が起きたときにどれが原因かすぐ特定できます。

おすすめのプラグイン選びで迷っている場合はこちらで確認できます。

spa この記事を書いた人

サーバーの構築と運用を繰り返して4年。その経験をもとに記事60本以上を執筆。

プロフィール詳細 →