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

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

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

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

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

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

spaこの記事を書いた人

マイクラサーバーの構築と運用を繰り返して4年。今も経済サバイバル「spa77.works SMP」を運用中で、その経験をもとに記事100本以上を執筆。

まず確認する2つのこと

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

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

どちらもサーバーを止めずに確認できます。

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

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

/plugins

表示色・状態	サーバー内の状態	対処の方向性
緑色	有効になっている	機能が動くかは別です。コマンドや権限設定を確認します。
赤色	読み込まれたが、いまは無効	ログのエラーを見て、前提プラグインの不足やバージョン不整合を確認します。
表示されない	読み込みに失敗した	ログのエラーを見て、配置場所、サーバーの種類、前提プラグイン、ファイルの破損を確認します。

赤色でも表示されない場合でも、まずサーバーログを見ます。表示されない原因は置き場所やサーバーの種類だけでなく、前提プラグインの不足やplugin.ymlの誤り、jarの破損でも起きます。

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

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

エラー文の中にClassNotFoundException、NoClassDefFoundError、Unknown dependencyなどが含まれていれば、サーバーバージョンの不一致か、先に入れておく必要があるプラグインの不足が原因です。

latest.logでERRORを検索して、最初に出てきた行をそのまま検索窓に貼ると、同じエラーの解決策が見つかりやすいです。

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

プラグインが動かないときは、以下の表から当てはまる症状を見つけて原因を切り分けましょう。

再起動していないだけかもしれないなら、停止から起動までの手順を先に確認してください。

以下では、特に発生しやすい上位4つの原因について詳しい対処法を解説します。

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

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

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

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

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

補足

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

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

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

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

配布元のSpigotMCやHangar、Modrinthで対応サーバーを先に確認すると、読み込まれないプラグインで時間を使う失敗を避けられます。