AMS Simulator を使用してローカルで AMS サーバーをテスト実行する - ゲームサーバー統合 - (Unity モジュール)

Last updated on May 25, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要

AccelByte Multiplayer Servers (AMS) サーバーをローカルでテストできるように、AccelByte では AMS Simulator というシミュレーターを提供しています。このシミュレーターは、AMS の Watchdog が実行する専用サーバー (DS) の管理および監視プロセスをシミュレートします。AMS Simulator を使用することで、サーバービルドを AMS にアップロードすることなく、AMS 実装を検証できます。

Windows 専用サーバーのパッケージ化

ゲームサーバーをローカルで実行するには、プロジェクトを Windows 専用サーバーとしてビルドする必要があります。

新しいウィンドウで、Platform に Dedicated Server を選択し、Target Platform として Windows を選択します。また、サーバービルドにログを表示するために Development Build を有効にします。
次に、Build ボタンをクリックします。
新しいポップアップウィンドウで、サーバービルドに ByteWars.exe という名前を付けます。その後、キーボードの Enter キーを押してビルドプロセスを開始し、完了するまで待ちます。

専用サーバーをローカルでテスト実行する

このセクションでは、パッケージ化されたゲームサーバーをローカルでテストし、AMS のライフサイクル内の状態変化を処理できるかどうかを確認する方法を学びます。

Admin Portal にログインし、ゲーム名前空間ダッシュボードに移動します。
Multiplayer > Multiplayer Servers > Download Resource に移動します。Windows 用の AMS Simulator を見つけ、ダウンロードボタンをクリックして amssim.exe ファイルをダウンロードします。
ダウンロードが完了したら、Windows PowerShell を開き、以下のコマンドを使用して AMS Simulator の実行可能ファイルを実行します。
```
.\amssim.exe run
```

以下が AMS Simulator の出力です。ローカル専用サーバーの ID 形式の例が提供されていることに注意してください。この例は ds_018c1f42-5eb6-7ca3-9650-a732ed75ce6a です。次のステップで必要になるため、コピーしておいてください。

AMS simulator url  ws://0.0.0.0:5555/watchdog
AMS simulator session id:  01hfaxxvfqhe9gkk2zesfx0b66.
AMS simulator session log path: session\01hfaxxvfqhe9gkk2zesfx0b66.log

Ready to accept local DS

Start the local DS with a valid DS ID that conforms to uuid standards
An example that can be copied and pasted is:

ds_018c1f42-5eb6-7ca3-9650-a732ed75ce6a

==================================Command list=================================================
    help                          show the command list again
    info                          show AMS simulator info
    ds
        status                    show status of the ds
        ready                     explicitly set ds into ready state.
        claim                     claim the ds for a game session.
        drain                     drain the ds
    exit, quit                    exit ams simulator
=============================================================================================

Windows PowerShell で以下のコマンドを使用してゲームサーバーの実行可能ファイルを実行します。前のステップの ds_018c1f42-5eb6-7ca3-9650-a732ed75ce6a をローカル専用サーバー ID として使用していることに注意してください。また、パスはサーバービルドの ByteWars.exe を指すように調整してください。
```
.\ByteWars.exe -log -OverrideSDKConfig "{'DsId': 'ds_018c1f42-5eb6-7ca3-9650-a732ed75ce6a'}"
```
備考
- -log はゲームサーバーのログを表示するためのオプションです。
- -OverrideSDKConfig は、DsId などの設定パラメータを注入するための Windows サーバー専用のパラメータです。
- DsId は、サーバーの識別情報を定義するための Windows サーバー専用のパラメータです。AMS Simulator が提供する例の ID を使用できます。この場合、それは ds_018c1f42-5eb6-7ca3-9650-a732ed75ce6a です。サーバーが AMS 上でホストされている場合、AMS は特定のサーバー ID を提供し、コマンドパラメータの値に置き換えます。
ゲームサーバーが実行されると、AMS Simulator の Windows PowerShell タブに「DS Connected」というメッセージが表示され、ローカル専用サーバーが AMS Simulator に接続されたことが通知されます。
```
amssim> DS Connected
```
ds status を実行して、AMS Simulator で専用サーバーのステータスを確認します。ゲームサーバーが正常に登録されていれば、以下のログが表示されます。DS State が Ready に変わっていることに注意してください。
```
ds status
```
AMS Simulator のログ:
```
amssim> ds status
ID: xxxxx
Connected at: 2023-XX-XX 10:00:00
Last Heartbeat: 2023-XX-XX 10:00:00
DS State: Ready
```
ds drain を実行することで、ゲームサーバーがドレイン状態を処理できるかどうかも確認できます。イベントを受信すると、ゲームサーバーはシャットダウンし、AMS Simulator は以下のログを表示します。
```
ds drain
```
AMS Simulator のログ:
```
amssim> ds status
no connected dedicated server
```
AMS Simulator を終了するには、以下のコマンドを実行します。
```
quit
```

概要​

Windows 専用サーバーのパッケージ化​

専用サーバーをローカルでテスト実行する​

概要

Windows 専用サーバーのパッケージ化

専用サーバーをローカルでテスト実行する