Server.json

注意:本页上的内容适用于 Unity Cloud 后台中的 Multiplay Hosting。如果您使用 Clanforge,请参阅 Clanforge 文档

server.json 文件是每个服务器上包含当前的分配 ID 等变量数据的文件。该文件是根据配置变量和服务器数据为每个服务器自动生成并填充的,其中包含所有内置配置变量和版本配置变量的所有自定义值。

server.json 文件位于每个服务器的服务器 ID 目录中。默认情况下,该文件包含所有内置配置变量,例如,连接端口和 Matchmaker 提供的分配 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/"
}

可以通过监控 server.json 的变化来跟踪服务器的分配 ID。要检测文件是否发生变化,可以设置一个事件触发器,也可以设置一个进程来进行定期检查。最好是使用事件触发器,因为定期检查会造成不必要的资源使用。

文件位置

server.json 文件位于磁盘上的以下位置:

  • 对于 Linux,该文件位于 $HOME 环境变量中。例如 $HOME/server.json