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

Last updated on February 4, 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 Server Configuration > 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専用サーバーのパッケージ化

専用サーバーのローカルテスト実行