経済サバイバルサーバー、参加者募集中

2026.07.31

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

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

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

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

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

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

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

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

管理人spaのアイコン
spaこの記事を書いた人

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

まず確認する2つのこと

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

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

  • プラグインの読み込み状態を確認する
  • サーバーログでエラーを探す

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

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

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

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

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

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

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

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

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

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

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

spa

エラー文をそのまま検索すると、解決策が見つかりやすいです。

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

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

プラグインが動かない主な原因は次の4つで、それぞれ見出しを分けて手順を解説します。

下の表には、この4つに加えて、見落としやすい2つの確認項目(再起動忘れ、ファイル破損)も一緒にまとめました。

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

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

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

マイクラサーバーを手動・自動で安全に再起動する方法を示すサムネイル

【初心者向け】マイクラサーバーを再起動する方法!手動・自動の両方を解説

詳しく扱うのは次の4つです。

  • プラグインフォルダへの配置を確認する
  • PaperまたはSpigot対応か確認する
  • バージョン違いを確認する
  • 前提プラグインを確認する

表で見当を付けたら、当てはまる項目の手順へ進みます。

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

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 MODFabricサーバーで動く。Paper・Spigotでは動かない

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

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

初心者

Paper向けのプラグインをForgeで使おうとしているケースです。

spa

サーバーの種類が違うと動かないので、まず種類を確認します。

プラグインサーバーの準備からやり直す場合は、構築記事へ戻ります。

PaperMCでプラグイン対応マイクラサーバーを立てる手順

マイクラプラグインサーバーの立て方!Paperで導入する手順を初心者向けに解説

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

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

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

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

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

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

version

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

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

補足

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

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

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

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

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

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

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

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

spa

エラーに出っているプラグイン名を検索して、依存プラグインを入れます。

よく使うプラグインと用途は、プラグインの入れ方の一覧で確認できます。

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

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

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

  1. サーバーログでERRORWARNの内容を確認する
  2. バージョン不一致のエラー文が出ていないか確認する
  3. 前提プラグインのエラーが出ていないか確認する
  4. ここまでで解決しない場合は、プラグインを削除して公式から再ダウンロードする

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

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

補足

コマンドがUnknown commandと表示される場合は、プラグインが正常に動いていない(/pluginsで確認すると名前が赤表示になっている)か、オペレーター権限がないかのどちらかです。

オペレーター権限の設定はOP権限の付け方で確認できます。

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

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

複数を一度に入れると、どれが原因かわからなくなりがちで、僕も最初のころはここで詰まりました。1つずつ外して確認するのは遠回りに見えて、原因にたどり着くにはこれが確実です。

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

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

stop

ここまで確認しても直らない場合、疑うべきはプラグイン側の不具合(バグ)です。

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

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

こういうときは、プラグインの公式フォーラム(SpigotMCなど)でエラー文を検索します。

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

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

マイクラサーバーのバックアップ復元を示すサムネイル

【マイクラ】自宅・レンタルサーバーのバックアップ方法!復元・自動化まで解説

よくある質問

Qプラグイン更新後は/reloadで読み直しても大丈夫ですか?
A

Paperでは/reloadは非推奨です。サーバーを完全に停止してから起動し直し、プラグインと設定を正しく読み込ませます。

QログにUnsupportedClassVersionErrorが出た場合は何を確認しますか?
A

サーバーで使っているJavaが古い可能性があります。java -versionで現在の版を確認し、プラグインとサーバーソフトが要求するJavaへ更新してから再起動します。

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

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

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

複数を一度に入れた場合は、1つずつ外しながら原因を特定します。

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

自分で原因を切り分けきれない場合は、構築の相談することもできます。