このガイドでは、Legion Hosting 上の BeamMP サーバーの管理者設定、サーバーサイドリソース、カスタムマップ、車両管理、トラブルシューティングについて説明します。初期のサーバーセットアップ、認証キー、基本設定については、BeamMP サーバーセットアップガイドを参照してください。
管理者設定
BeamMP には従来型の管理者ログインやパスワードシステムはありません。代わりに、管理者コマンドはサーバーコンソールから、またはプレイヤー識別子をチェックするサーバーサイドの Lua プラグインを通じて実行されます。
コンソールコマンド
GPanel のサーバーコンソールでは、組み込みのサーバーコマンドに直接アクセスできます。コンソールの入力欄に直接コマンドを入力してください:
| コマンド | 説明 |
|---|---|
kick <player_id> <reason> |
任意の理由メッセージとともにプレイヤーをサーバーからキックします。 |
ban <player_name> |
プレイヤーをサーバーから BAN します。BAN されたプレイヤーは再接続できません。 |
unban <player_name> |
プレイヤーの BAN を解除し、再接続を許可します。 |
list |
現在接続しているすべてのプレイヤーを ID とともに一覧表示します。 |
say <message> |
コンソールからサーバー全体にチャットメッセージを送信します。 |
status |
プレイヤー数や稼働時間を含むサーバーのステータス情報を表示します。 |
help |
利用可能なすべてのコンソールコマンドを一覧表示します。 |
list コマンドを使用してください。これらの ID は kick などのコマンドに必要です。
Resources フォルダの構造
BeamMP はサーバーサイドのコンテンツを整理するために Resources フォルダを使用します。このフォルダには、それぞれ異なる目的を持つ 2 つのサブディレクトリが含まれています:
Resources/
Client/ <-- Client-side mods (maps, vehicles) synced to players
Server/ <-- Server-side Lua plugins (not sent to players)クライアントリソース
Resources/Client/ に配置されたファイルは、プレイヤーが接続時に自動的にダウンロードします。これは以下の用途に使用されます:
- カスタムマップ — プレイヤーがサーバーのマップを読み込むために必要なマップ MOD の .zip ファイル。
- カスタム車両 — 新しい車を追加したり既存の車を変更したりする車両 MOD の .zip ファイル。
- その他のクライアント MOD — クライアント側に存在する必要があるあらゆる BeamNG.drive MOD。
Resources/Client/ 内のすべてのファイルは、参加するすべてのプレイヤーがダウンロードします。大きなファイルや多数の MOD があると、接続時間が大幅に増加します。最良のプレイヤー体験のために、クライアントリソースは軽量に保ってください。
サーバーリソース（Lua プラグイン）
Resources/Server/ ディレクトリには、サーバーサイドの Lua プラグインが含まれます。これらはサーバー上でのみ実行され、プレイヤーには送信されません。各プラグインは main.lua ファイルを持つ独自のサブフォルダ内に存在します:
Resources/
Server/
MyPlugin/
main.lua <-- Plugin entry point
AnotherPlugin/
main.luaサーバーサイドプラグインでできること:
- プレイヤーのイベント（参加、退出、チャットメッセージ、車両スポーン）に応答する。
- チャットでトリガーされるカスタムコマンドを実装する（例:
/tp、/give）。 - 車両の権限と制限を管理する。
- 経済システム、テレポート、その他のカスタムゲームプレイ機能を追加する。
- プレイヤーのアクティビティを記録し、ルールを強制する。
カスタムマップの追加
BeamMP サーバーでカスタム（デフォルト以外の）マップを実行するには:
- BeamNG.drive MOD のソース（例: BeamNG.drive MOD リポジトリ）からマップ MOD を
.zipファイルとしてダウンロードします。 - GPanel でサーバーを停止します。
- Files タブまたは SFTP を通じて
.zipファイルをResources/Client/にアップロードします。zip は展開しないでください。 MAP起動変数（またはServerConfig.tomlのMap）を、そのカスタムマップの正しいマップパスに更新します。このパスは通常/levels/map_name/info.jsonの形式です — 正確なパスは MOD のドキュメントを確認してください。- サーバーを起動します。
Map の値が MOD の .zip ファイル内の実際のパスと一致しない場合、サーバーはマップの読み込みに失敗します。正しい /levels/ パスを見つけるには、MOD のドキュメントを確認するか、.zip の構造を調べてください。
Resources/Client/ 内のプレイヤーがまだ持っていないファイルを自動的にダウンロードします。プレイヤーがマップ MOD を手動でインストールする必要はありません。
車両管理
BeamMP サーバーでの車両管理は、MaxCars 設定と、必要に応じてサーバーサイドの Lua プラグインによって制御されます。
MaxCars 設定
ServerConfig.toml の MaxCars 設定（または MAX_CARS 起動変数）は、各プレイヤーが同時にスポーンできる車両の数を制御します:
1— 各プレイヤーは一度に 1 台の車両を持てます（大規模なサーバーに推奨）。2–3— プレイヤーが数台の車両を持てるようにします。小規模なサーバーやカーミートに便利です。- 値を高くすると、それに比例してサーバー負荷が増加します。
カスタム車両 MOD
サーバーにカスタム車両を追加するには:
- 車両 MOD を
.zipファイルとしてダウンロードします。 - それを
Resources/Client/に配置します。 - サーバーを再起動します。プレイヤーは接続時に車両 MOD を自動的にダウンロードします。
プラグインによる車両の制限
より細かい制御（例: 特定の車両の禁止、車両タイプの制限）には、サーバーサイドの Lua プラグインが必要です。これらのプラグインは車両のスポーンイベントをインターセプトし、カスタムルールに基づいてそれらを許可または拒否できます。車両管理プラグインについては BeamMP フォーラムを確認してください。
プラグインのインストールと管理
サーバーサイドの Lua プラグインは、サーバーの機能を拡張します。インストールと管理の方法は次のとおりです:
プラグインのインストール
- プラグインファイル（通常は
main.luaとその他のファイルを含むフォルダ）をダウンロードします。 - サーバーを停止します。
- Files タブまたは SFTP を通じて、プラグインフォルダを
Resources/Server/にアップロードします。 - フォルダ構造が正しいことを確認します:
Resources/Server/PluginName/main.lua。 - サーバーを起動します。プラグインの読み込み時にコンソールにメッセージが表示されます。
プラグインの削除
- サーバーを停止します。
Resources/Server/からプラグインフォルダを削除します。- サーバーを起動します。
トラブルシューティング
認証キーのエラー
AUTH_KEY起動変数にキーが正しく貼り付けられていることを確認してください — 余分なスペースや改行がないこと。- BeamMP Keymaster でキーが取り消されたり期限切れになったりしていないことを確認してください。
- 各キーは一度に 1 つのサーバーでのみ使用できます。同じキーを他の場所で使用している場合は失敗します。
- キーが無効な場合、起動時にコンソールに認証エラーが表示されます。
プレイヤーが接続できない
- サーバーが完全に起動し、GPanel でオンラインとして表示されていることを確認してください。
- プレイヤーが標準の BeamNG.drive ランチャーではなく BeamMP ランチャーを使用していることを確認してください。
- サーバーが
Private = trueに設定されている場合、プレイヤーは正しい IP とポートを使ってダイレクト接続する必要があります。サーバーの IP とポートを確認する方法を参照してください。 - プレイヤーの BeamMP ランチャーのバージョンがサーバーのバージョンと互換性があることを確認してください。古いランチャーは接続に失敗することがあります。
- サーバーが満員（
MaxPlayersに達している）の場合、誰かが退出するまで追加のプレイヤーは参加できません。
MOD 同期の問題
- プレイヤーがダウンロードで止まったり MOD が見つからないというエラーが出たりする場合は、
Resources/Client/内の MOD の .zip ファイルが破損していないことを確認してください。 - .zip が破損している場合は、MOD ファイルを再ダウンロードして再アップロードしてください。
- 非常に大きな MOD ファイルは、接続の遅いプレイヤーにとってタイムアウトの原因となることがあります。不要な大きな MOD の削除を検討してください。
- MOD の .zip ファイルがネストされていないこと（つまり、別の .zip 内のフォルダ内の .zip）を確認してください。
多数のプレイヤー/車両によるパフォーマンスの問題
- プレイヤーあたりの
MaxCarsを1に減らしてください。 - サーバーで継続的なラグが発生している場合は、
MaxPlayersを下げてください。 - 多人数でのパフォーマンス向上のために、よりシンプルなマップ（Grid Map または Industrial）に切り替えてください。
- ダウンロード時間とメモリ使用量を減らすために、
Resources/Client/から不要なクライアント MOD を削除してください。 - GPanel のリソース使用状況グラフを確認してください — CPU または RAM が常に限界に達している場合は、サーバープランのアップグレードを検討してください。サポートチケットを開くと、選択肢について相談できます。
サーバーがブラウザに表示されない
- 設定で
Privateがfalseに設定されていることを確認してください。 - 認証キーが有効で、別のサーバーで使用されていないことを確認してください。
- サーバーが BeamMP バックエンドに登録されるまで、起動後 1–2 分待ってください。
- マスターサーバー接続に関連するエラーがないか、コンソールを確認してください。
関連記事
- BeamMP サーバーセットアップガイド — 初期セットアップ、認証キー、設定、接続手順
- サーバーの IP とポートを確認する方法
- SFTP でファイルをアップロードする方法
- サーバー起動ガイド — Legion Hosting であらゆるゲームサーバーを起動するための一般的なガイド
さらにサポートが必要ですか?
このガイドで扱われていない問題が発生している場合は、サポートチームがお手伝いします。legionhosting.net/submitticket.php で、サーバーの詳細、問題の説明、GPanel コンソールの関連するエラーメッセージを添えてチケットを開いてください。
