Server.json

ノート: このページのコンテンツは、Unity Cloud Dashboard で使用可能な Multiplay Hosting に関連しています。Clanforge を使用している場合は、Clanforge のドキュメント を参照してください。

server.json は、現在の割り当て ID など、各サーバーの変数データを格納するファイルです。これは自動的に生成され、構成変数 とサーバーデータに基づいてサーバーごとに設定されます。すべての ビルトイン構成変数 と、ビルド構成変数のカスタム値があります。

server.json ファイルは、各サーバーのサーバー ID ディレクトリ内に存在します。デフォルトでは、マッチメーカーが提供する割り当て ID や接続ポートなど、すべてのビルトイン構成変数があります。ただし、いくつかの構成変数を追加して、ビルド設定 設定で追跡することもできます。

サーバーから構成変数を設定したときに server.json ファイルがどのようになるかの例を示します。

{
	"ipv6": "::1",
	"port": "9000",
	"allocatedUUID": "1a04a1ac-a31a-11ed-a5e3-00155d4f1a62",
	"serverID": "12345",
	"machineID": "6789",
	"fleetID": "c0a3e2a1-6955-415c-b1d4-af9199833e6a",
	"regionID": "f15a6c27-de2a-4848-abc3-9579fbfd2259",
	"regionName": "North America",
	"queryPort": "9010",
	"ip": "127.0.0.1",
	"queryType": "sqp",
	"serverLogDir": "/mnt/unity/logs/"
}

allocatedID

allocatedID 変数は、サーバーが割り当てまたは割り当て解除されるたびに変化する特殊なビルトイン構成変数です。サーバーが割り当てられると、allocatedUUID フィールドにはサーバーの割り当て ID が入ります。サーバーが割り当て解除されると、allocatedUUID フィールドには空の文字列が入ります。

ノート: その他の構成変数は、サーバーの割り当て状況にかかわらず、それらの値を保持します。

割り当て済みサーバーの server.json ファイルの例を示します。

{
	"ipv6": "::1",
	"port": "9000",
	"allocatedUUID": "1a04a1ac-a31a-11ed-a5e3-00155d4f1a62",
	"serverID": "12345",
	"machineID": "6789",
	"fleetID": "c0a3e2a1-6955-415c-b1d4-af9199833e6a",
	"regionID": "f15a6c27-de2a-4848-abc3-9579fbfd2259",
	"regionName": "North America",
	"queryPort": "9010",
	"ip": "127.0.0.1",
	"queryType": "sqp",
	"serverLogDir": "/mnt/unity/logs/"
}

未割り当てサーバーの server.json ファイルの例を示します。

{
	"ipv6": "::1",
	"port": "9000",
	"allocatedUUID": "",
	"serverID": "12345",
	"machineID": "6789",
	"fleetID": "c0a3e2a1-6955-415c-b1d4-af9199833e6a",
	"regionID": "f15a6c27-de2a-4848-abc3-9579fbfd2259",
	"regionName": "North America",
	"queryPort": "9010",
	"ip": "127.0.0.1",
	"queryType": "sqp",
	"serverLogDir": "/mnt/unity/logs/"
}

サーバーの割り当て ID を追跡するには、server.json の変更を監視 します。変更を検出するには、ファイルの変更を検出するイベントトリガーを設定するか、定期的な間隔でファイルの変更を確認します。定期的な確認は不必要なリソース使用の原因となるため、イベントトリガーを使用することがベストプラクティスです。

ファイルの場所

server.json ファイルは、以下の場所にあるディスクで使用可能です。

  • Linux の場合は、$HOME 環境変数内にあります。例えば $HOME/server.json などです。