CounterStrikeSharpのプラグインが読み込まれない原因と対処法

CounterStrikeSharp自体が動いているか確認する

プラグインを疑う前に、フレームワークが動作しているか確かめます。サーバーコンソールでmeta listと入力してください。一覧にCounterStrikeSharpが表示されるはずです。表示されない場合、原因はプラグインではなく、MetamodまたはCounterStrikeSharpのインストールにあります。この部分はMetamodのセットアップガイドで解説しています。

meta list

コンソールのエラーを読む

プラグインの読み込みに失敗すると、コンソールにどのプラグインがなぜ失敗したかが出力されます。プラグイン一覧の<ERROR>は、ファイルは見つかったものの読み込めなかったことを意味します。最初の1行だけでなく、メッセージ全体をコピーしてください。本当の理由は数行下に書かれていることが多いためです。

[META] Failed to load plugin addons/counterstrikesharp/bin/linuxsteamrt64/counterstrikesharp
Listing 1 plugin:
  [01] <ERROR>

サーバーを更新したら全部動かなくなった

Counter-Strike 2のアップデート後は、ゲーム側のファイルが変わるため、CounterStrikeSharpとMetamodも更新が必要になることがよくあります。すべてのプラグインが同時に動かなくなったなら、これが原因です。CounterStrikeSharpとMetamodを最新版に更新し、サーバーを再起動してください。安全な更新手順はCounterStrikeSharpの更新ガイドで説明しています。

サーバーが認識している内容を確認する

コンソールでcss_plugins listを実行します。フレームワークが見つけたプラグインが状態付きで一覧表示されます。自分のプラグインがまったく表示されない場合は、ファイルの置き場所が違うか、フォルダー名とDLL名が一致していません。エラー付きで表示される場合は、手順2に戻ってメッセージを読んでください。

css_plugins list

フォルダー構成を確認する

各プラグインには、pluginsの中に専用のフォルダーが必要で、メインのDLLの名前はそのフォルダー名と完全に一致していなければなりません。deps.jsonなど、DLLと同じ場所にあるファイルも一緒に置いてください。

コピーするのはプラグインのフォルダーだけ。dependenciesは不要

当社のコンパイラーはzipにプラグインのフォルダーとdependenciesフォルダーの2つを入れます。サーバーにコピーするのはプラグインのフォルダーだけです。dependenciesにはCounterStrikeSharpがすでに提供しているファイルが入っており、コピーするとバージョンの衝突を起こすことがあります。

重いフレームワークや別バージョンのAPIを使うプラグイン

古いCounterStrikeSharp.API向けに書かれたプラグインは、コンパイルできても新しいサーバーで失敗することがあります。逆の場合もあります。コンソールにメソッドや型が見つからないというメッセージが出るなら、APIのバージョンが合っていません。どのコンパイルオプションを選ぶべきかは、バージョン不一致のガイドで説明しています。また、ASP.NETのような大規模なフレームワークは、ゲームサーバー用プラグインの中ではサポートされません。

助けを求めるときに添える情報

それでも解決しない場合は、プラグインの作者やCounterStrikeSharpのコミュニティに質問しましょう。その際、meta listとcss_plugins listの出力、コンソールのエラー全文、CounterStrikeSharpのバージョン、プラグインのコンパイル方法を添えてください。これだけ揃っていれば、たいていの問題は1回の返信で解決します。