Documentation

Support

Multiplay Clanforge

Open Clanforge

Multiplay Clanforge

Configuration variables

Documentation for Configuration variables
Read time 1 minuteLast updated 3 hours ago

Configuration variables are variables you define that Clanforge uses to generate a server.json file for each server instance. Clanforge uses a set of built-in variables (listed below), but you can extend these variables with any custom data, such as a difficulty modifier or the game mode.
Note: If you need to load information before the configuration variables, consider using launch parameters instead.
Configuration variable
Description
allocationUUID
The unique UUID of the allocation.
serverID
The unique identifier of the server instance.
queryType
The query protocol the server instance uses.
queryPort
The port at which you can access the query protocol data.
port
The port at which the specific server instance is accessible.
serverLogDirectory
The file path to where the build stores logging information. It’s relative to the server ID folder.
Here’s an example of what a server.json file might look like when populated with the configuration variables from a server instance:
{
	“allocationUUID”: “434af841-586d-4403-939b-db19f77611a6”,
	“serverID”:12345,
	“queryType”: “sqp”,
	“queryPort”:9010,
	“port”:9000,
	“serverLogDirectory”:12345/logs/”
}

Example configuration variables

The following table has descriptions and example values for each built-in configuration variable.
Variable
Type
Description
Example
allocated\_uuid
uuid
The universally unique identifier for an allocation to the game server.
dd3eab96-1c6a-11ec-b4e5-93095e702b25
commandline
string
A string of the launch parameters passed to the game server or application on launch.
-config path/to/server.json
ConfigPath
string
The path to the directory that has the configuration files for the game server.
123456/cfg
fleetid
uuid
The universally unique identifier for the parent fleet of the game server.
5982cf5c-1c6b-11ec-b4e5-93095e702b25
GameExe
string
The name of the primary executable for the game server.
server-linux
log\_dir
string
The directory in which a game server should send log files.
logs
port
integer
The network port on which the game server should bind for traffic.
1234
profileid
string
The ID of the profile that's used to run a game server.
1076327
query\_port
integer
The network port on which the game server should bind for query protocol traffic.
5678
query\_type
string
The query protocol supported by the game server.
sqp
regionid
uuid
The universally unique identifier for the region the game server is running in.
7c123d14-1c6b-11ec-b4e5-93095e702b25
serverid
integer
The internal Clanforge ID for this instance of the game server.
123456