The Server configuration will be saved in YAML Format. The configuration file is located in the root directory of the dedicated server and named config.yml.
Parameters
| Parameter | Description | Default Value |
|---|---|---|
| Name | This is a name given to the server. It will be displayed to users on the server list. | New MadBomber Server |
| Public | This defines if the server will report itself to the API and use JoinToken validation to ensure authenticity of Players. | True |
| EnableShell | Enable the shell server used for sending commands to the server. | False |
| MaxPlayers | Determines how many players are allowed to join the lobby at the same time. Connections for Downloading content are not affected by this. | 8 |
| TrustRequirement*** | The minimum Trust Score required for Joining this Server. Only used for public Servers. | 100 |
| ServerUUID*** | This property is only used if the server is registered on the API. It contains a unique ID that is essentially like a Username for the Server. | (blank) |
| ServerAuthKey*** | A 512-bit Key generated by the MadBomber API for public servers. Used like a Password for authenticating against the MadBomber API. | (blank) |
| OwnerUUID*** | If both OwnerUUID and OwnerAuthKey are defined, the Server will attempt to authenticate the Player to claim ownership of this Server for said Player. | (blank) |
| OwnerAuthKey*** | If both OwnerUUID and OwnerAuthKey are defined, the Server will attempt to authenticate the Player to claim ownership of this Server for said Player. | (blank) |
| Port | This specifies the port the server will listen on. | 14242 |
| ShellPort | This specifies the port the shell server will listen on (if enabled). | 14250 |
| Region*** | Specifies the Region in which the Server is hosted. This allows users to select a server close to them. | Europe |
| VoteTimer | This specifies the amount of seconds Votes will last for on this server. | 30 |
| PlayerShuffle | Enabling this will make the server shuffle the player order after every match, effectively assigning everyone another spawn point and color. | True |
| IgnoreGameTypeLink | Setting this will cause the server to ignore game type links in maps, always choosing a random game type. | False |
| TameMapRandomization* | Prevents the same map from being picked twice in a row. | False |
| TameGameTypeRandomization* | Prevents the same Game Type from being picked twice in a row. | False |
| UseMapWhitelist | Determines if the Map Whitelist should be used. | False |
| MapWhitelist | Defines a list of maps that should exclusively be used. | (List) |
| UseMapBlacklist | Determines if the Map Blacklist should be used. | False |
| MapBlacklist | Defines a list of maps that shouldn’t be used. | (List) |
| UseGameTypeWhitelist | Determines if the Game Type Whitelist should be used. | False |
| GameTypeWhitelist | Defines a list of gametypes that should exclusively be used. This setting will be ignored if a Map contains a Game Type Link and IgnoreGameTypeLink is disabled. | (List) |
| UseGameTypeBlacklist | Determines if the Game Type Blacklist should be used. | False |
| GameTypeBlacklist | Defines a list of gametypes that shouldn’t be used. This setting will be ignored if a Map contains a Game Type Link and IgnoreGameTypeLink is disabled. | (List) |
| UseFixedOrder | Setting this will make the Server always use the map/gametype combinations from FixedOrder. | False |
| FixedOrder | Which maps and gametypes should always be used together and in what order. | (List) |
| UseComboBlacklist | Determines if the Combo Blacklist should be used. | False |
| ComboBlacklist | Defines a list of map/gametype combinations that shouldn’t be used. | (List) |
| GrabMaps*** | Defines a list of Maps as UUID/version from the MadBomber API, which should be downloaded on startup**. Can be specified as either a plain UUID to get the latest version or a UUID with a specific version tag, such as: 1dd42bbc-dbc1-4fdc-95d7-6694a4c44fe5/v2 | (List) |
| GrabGameTypes*** | Defines a list of GameTypes as UUID/version from the MadBomber API, which should be downloaded on startup**. Can be specified as either a plain UUID to get the latest version or a UUID with a specific version tag, such as: 08a2a786-3cf7-4ac2-aec8-65e18e0cc0a8/v1 | (List) |
*Be careful with TameRandomization settings, if your Server has any condition which requires selecting the same Map or GameType twice in a row, encountering these will cause the Server to crash. Only use if you’re absolutely sure there will always be multiple valid Maps or GameTypes at any given time.
**Be aware that automatically downloading another version of a Map/GameType when a file with the same name is already present will cause the local file to be overwritten. Make sure you have any unsubmitted maps backed up whenever you use this feature.
***This setting is only used on public servers.