このガイドでは、Rust サーバーへの Oxide/uMod または Carbon の MOD フレームワークのインストール方法、コミュニティプラグインの追加方法、コンソールでの管理方法について説明します。サーバーの一般的な設定や起動変数については、Rust サーバー設定ガイドをご覧ください。

Oxide/uMod または Carbon のインストール

Oxide（現在は uMod として保守されています）と Carbon は、Rust 向けの MOD フレームワークで、コミュニティが作成したプラグインをインストールできます。これらのフレームワークは、経済システム、カスタムキット、投票報酬、PvE 保護ゾーンなど、さまざまな機能を追加します。

ファイルを手動でアップロードする必要はありません。MOD フレームワークは、単一の起動変数を設定するだけで自動的にインストールされます。

1. GPanel の Console タブからサーバーを停止します。
2. GPanel にログインし、Startup タブに移動します。
3. FRAMEWORK 変数を見つけ、次のいずれかに設定します。
   • oxide — Oxide/uMod 用（最も広く使用されているフレームワークで、最大のプラグインライブラリを備えています）
   • carbon — Carbon フレームワーク用（独自のプラグインエコシステムを持つ代替フレームワーク）
   • vanilla — MOD フレームワークなしで実行する場合
4. サーバーを起動します。フレームワークファイルは自動的にダウンロードされ、適用されます。Oxide での初回起動時に、oxide/ ディレクトリ構造が生成されます。
5. Oxide が有効になっていることを確認するには、コンソールログで Loaded plugin Oxide.Core のような行を確認します。

プラグインのインストール

プラグインは .cs（C# ソース）ファイルとして配布されます。Oxide は実行時にサーバー上でこれらをコンパイルするため、事前コンパイルは不要です。

1. umod.org またはその他の信頼できるソースからプラグインの .cs ファイルをダウンロードします。
2. SFTP または GPanel のファイルマネージャーを使用して、.cs ファイルをサーバーの oxide/plugins/ ディレクトリにアップロードします。SFTP のヘルプについては、SFTP でファイルをアップロードする方法をご覧ください。
3. サーバーが稼働中の場合、プラグインは数秒以内に自動的に検出されてコンパイルされます。読み込まれたことを確認するコンソール出力（例: Loaded plugin MyPlugin v1.2.3 by Author）が表示されます。
4. サーバーが稼働していない場合、プラグインは次回の起動時に読み込まれます。

Oxide ディレクトリ構造

oxide/
  plugins/
    MyPlugin.cs       <- place plugin files here
    AnotherPlugin.cs
  config/             <- auto-generated plugin config files
  data/               <- plugin data files
  logs/               <- plugin log files

プラグインの設定

ほとんどのプラグインは、初めて読み込まれたときに oxide/config/ 内に JSON 設定ファイルを生成します。プラグインをカスタマイズするには:

1. プラグインを少なくとも一度読み込ませて、デフォルトの設定ファイルを生成させます。
2. サーバーを停止します（一部のプラグインはライブでの設定リロードに対応していることに注意してください）。
3. GPanel のファイルマネージャーまたは SFTP を使用して、oxide/config/PluginName.json にあるプラグインの設定ファイルを開きます。
4. 設定を編集してファイルを保存します。
5. oxide.reload PluginName でプラグインをリロードするか、サーバーを再起動します。

コンソールでのプラグイン管理

これらのコマンドは、GPanel コンソールまたは RCON クライアントから実行できます。RCON のセットアップについては、Rust RCON アクセスと管理コマンドをご覧ください。

プラグインの更新

プラグインを新しいバージョンに更新するには:

1. umod.org のプラグインページから更新された .cs ファイルをダウンロードします。
2. 新しいファイルを oxide/plugins/ にアップロードし、既存のファイルを上書きします。
3. サーバーが稼働中の場合、Oxide はファイルの変更を検出し、プラグインを自動的に再コンパイルしてリロードします。あるいは、oxide.reload PluginName を実行します。
4. エラーがないかコンソールを確認します。プラグインの更新によっては、oxide/config/ 内の設定ファイルの変更が必要になる場合があります。

プラグインの削除

プラグインを完全に削除するには:

1. oxide.unload PluginName を実行して、サーバーが稼働している間にプラグインをアンロードします。
2. oxide/plugins/ から .cs ファイルを削除します。
3. 不要になった場合は、必要に応じて oxide/config/ からプラグインの設定ファイルを、oxide/data/ からデータファイルを削除します。

人気のプラグイン

プラグインの問題のトラブルシューティング

プラグインが読み込まれない場合は、次の点を確認してください。

• Oxide がインストールされ、有効になっていることを確認します。GPanel の Startup タブで、FRAMEWORK 変数が oxide に設定されている必要があります。コンソールログには起動中に Loaded plugin Oxide.Core が表示されるはずです。
• プラグインファイルは、正確な .cs 拡張子を付けて oxide/plugins/ に直接配置する必要があります。サブディレクトリ内のファイルや拡張子が間違っているファイルは無視されます。
• コンパイルエラーがないか、コンソールと oxide/logs/ を確認します。構文エラーのあるプラグインは読み込みに失敗し、エラーメッセージに問題が記載されます。
• 一部のプラグインは他のプラグインに依存しています（例: 多くのショップ系プラグインは Economics を必要とします）。必要な依存関係をすべて先にインストールしてください。

その他のよくあるサーバーの問題については、Rust サーバーのトラブルシューティングをご覧ください。

サポートが必要ですか？

このガイドで扱われていない問題が発生した場合は、当社のサポートチームがお手伝いします。サポートチケットを送信し、サーバー ID、問題の説明、および関連するコンソール出力を記載してください。