Games

Adding new games

The control panel supports the launch and basic control of any game servers and applications. If the panel does not contain a game you need, you can add it.

To add a new game, go to “Administration” -> “Games”, then select “Add Game”.

After adding the game, add the first mod of this game and specify the the game server start parameters.

Fields

Code

Game code is a unique value. Usually, this is a game name abbreviation, for example for “7 Day To Die”, the code is 7d2d. The code must be unique. You can enter any, but it must be unique.

Start code

Start code is usually specified in the start parameters. This value can be anything, but more often it matches the game code. It may match with other games.

Game name

Just enter the full game name.

Game engine

Game engine is the system where the game is written. Half-Life, Counter-Strike are written in the GoldSource engine.

Half-Life 2, Counter-Strike Source are written in Source. Sometimes you do not know the game engine, in this case, you can enter the game code or some game abbreviation.

For games written in GoldSource and Source, enter the exact engine name. For games written in Unity, it’s better to enter some game abbreviation, for example Rust is written in Unity, but the engine name is rust. Minecraft is written without using any engine, so the engine name is also “Minecraft”.

Engine version

Numeric or string value of the engine version. You can specify any semantic value, for example, “legacy”, “beta”, and so on.

Steam App ID

Game server ID on Steam. Used to install the server through SteamCMD. You can find SteamID on [Steam official wiki] (https://developer.valvesoftware.com/wiki/Dedicated_Servers_List), or in the SteamDB.

Steam App Set Config

Additional options for installing the server through SteamCMD. You can find some values on Steam official wiki

Local repository

Path on the dedicated server to the archive or to the directory with the game build used as a template. This path must exist on the dedicated server where a new game server is installed. When adding a new game server, the archive will be unpacked into the game server working directory.

The following archives are supported: Zip, 7z, Tar, XZ, Bzip, GZip.

RAR archives are not supported.

Examples

Example game server working directory /srv/gameap/servers/example-server

Local Repository field value Value validity Installation result
/srv/gameap/repo/cs16_gungame.zip Valid, if the archive exists on the dedicated server The cs16_gungame.zip archive contents will be unzipped into /srv/gameap/servers/example-server
/srv/gameap/repo/cs16_public Valid, if the directory exists on the dedicated server The directory contents will be copied to /srv/gameap/servers/example-server
/srv/gameap/repo/cs16_gungame.rar Invalid. RAR archives not supported Installation method from the local repository will be skipped or the server will not be installed
http://files.gameap.ru/cstrike-1.6/rehlds-amxx-reunion.tar.xz Invalid. Value for remote repository is specified Installation method from the local repository will be skipped or the server will not be installed

Remote repository

Link to a remote source. This must be a URL to an HTTP or FTP resource. Archive must be accessible via direct link without any intermediate pages that require waiting or additional action. Links to Yandex Disk, Google Drive, etc. are not supported.

You can find some builds on the [official GameAP repository] (http://files.gameap.ru/).

Examples

Example game server working directory /srv/gameap/servers/example-server

Remote Repository field value Value validity Installation result
http://files.gameap.ru/cstrike-1.6/rehlds-amxx-reunion.tar.xz Valid The rehlds-amxx-reunion.tar.xz will be loaded and unzipped to /srv/gameap/servers/example-server
/srv/gameap/repo/cs16_gungame.zip Invalid. The http or ftp resource must be specified Installation method will be skipped or the game server will not be installed.

Adding new mods

Each game can have many mods, each has its own features, settings, startup parameters, configuration files, etc.

To add a new game, go to “Administration” -> “Games”, then select “Add Mod”

Fields

Game

The game which the mod belongs to.

Name

Mod name. This may be the name of the addon, build, kernel, any feature, etc. Enter the full name at your discretion.

Repositories

The mod may have its own set of files and settings written over the files of the main build. You can include any additional plugins, additional content, sounds, music, etc., in the file archive. Local repository fields are optional.

The following archives are supported: Zip, 7z, Tar, XZ, Bzip, GZip.

RAR archives are not supported.

Local repository

Path on the dedicated server to the archive or to the directory with the game mod files used as a template. This path must exist on the dedicated server where a new game server is installed. When installing the game server, the archive will be unzipped over the main build into the game server working directory.

The following archives are supported: Zip, 7z, Tar, XZ, Bzip, GZip.

RAR archives are not supported.

Examples

Example game server working directory /srv/gameap/servers/example-server

Local Repository field value Correctness of value Installation result
/srv/gameap/repo/cs16_gungame.zip Valid, if the archive exists on the dedicated server The cs16_gungame.zip archive contents will be unzipped into /srv/gameap/servers/example-server
/srv/gameap/repo/cs16_cs16_gungame Valid, if the directory exists on the dedicated server The directory contents will be copied to /srv/gameap/servers/example-server
/srv/gameap/repo/cs16_gungame.rar Invalid. RAR archives not supported Archive unzipping will be skipped
http://files.gameap.ru/cstrike-1.6/rehlds-amxx-reunion.tar.xz Invalid. Remote repository value is specified Mod installation will be skipped
Remote repository

Link to a remote source. This must be a URL to an HTTP or FTP resource. Archive must be accessible via direct link without any intermediate pages that require waiting or additional action. Links to Yandex Disk, Google Drive, etc. are not supported.

You can find some builds on the official GameAP repository.

Examples

Example game server working directory /srv/gameap/servers/example-server

Remote Repository field value Value validity Installation result
http://files.gameap.ru/cstrike-1.6/rehlds-amxx-reunion.tar.xz Valid The rehlds-amxx-reunion.tar.xz will be loaded and unzipped to /srv/gameap/servers/example-server
/srv/gameap/repo/cs16_gungame.zip Invalid. Http or ftp resource must be specified Mod installation will be skipped

Editing mods

After making a mod, you can further configure it by specifying additional parameters such as “Default startup commands”, startup variables, various RCON commands.

Main settings

Main settings include parameters such as mod name, repositories, and default startup commands. Pay special attention to the startup commands.

Mod name

Repositories

Read more in Adding new mod, repositories

Default startup commands

When adding a new game server for the selected mod, this command will be automatically assigned to it. If the command is empty, nothing will be assigned and you should specify the startup command for each game server manually. The game server cannot be started without a startup command.

You can use shortcodes in startup commands, they will then be replaced with the values of server variables. Shortcodes are words without spaces in braces {, }, for example, {ip}, {port}, {maxplayers}, etc.

Basis shortcodes

These shortcodes are always available, they do not require adding additional variables in the mod settings.

Shortcode Description
{ip} Game server IP
{port} Game server main port. Sometimes called a connect port
{query_port} Query port
{rcon_port} Server communication port (RCON port)
{rcon_password} RCON password
{uuid} Server UUID
{uuid_short} Short server UUID
User-defined shortcodes

You can define these shortcodes for each specific game mod yourself. Depending on individual server settings, these shortcodes will be replaced with values of the game server parameters. Read more in Variables.

Variables

You can add individual settings for each game server. Then these settings can be edited by administrator or regular user on the settings page (“Server List” -> “Administration” -> “Settings”).

Field Description
Variable Variable name. No curly brackets.
Default Variable value by default. This value will be used if an individual value is not set for the game server.
Description Game server description on the settings page (“Server List” -> “Administration” -> “Settings”)
Admin variable If checked, only the administrator will be able to edit this setting for game servers.

Examples

Values Description
Variable: default_map

Default: de_dust

Description: Map at startup
For each game server of this mod, the shortcode {default_map} and a new parameter in settings called “Default Map” with the default value “de_dust” will appear.

Individually for each server, this parameter can be edited at “Server List” -> “Administration” -> “Settings”

RCON commands

These commands allow more advanced game server administration. If the game supports working with RCON or if the console is supported, you can do the following: kick players from the server, ban players, change the server map, send text messages to the common chat, set a password.

Some features may be limited by the game itself or by the mod. For example, not all game servers support server login with a password.

Kick command

You can set the RCON command to kick a player from the server.

You can set shortcodes for the command that will be replaced with the data of a certain player

Shortcode Description
{id} Server player ID
{name} Server player name

For many GoldSource/Source games, this is the command:

kick #{id}

Ban command

You can set a command that will be used for a temporary or permanent ban of a player on the server.

You can set shortcodes for the command that will be replaced with the data of a certain player

Shortcode Description
{id} Server player ID
{name} Server player name
{time} Ban time
{reason} Ban reason

For many GoldSource games (Half-Life, Counter-Strike 1.6, etc.) running AMX Mod X, this is the command:

amx_ban "{name}" {time} "{reason}"

Name (nickname) change command

With this command, you can change the selected player’s nickname.

You can set shortcodes for the command that will be replaced with the data of a certain player

Shortcode Description
{id} Server player ID
{name} Current server player name
{new_name} New server player name
{reason} Reason for change

For many GoldSource games (Half-Life, Counter-Strike 1.6, etc.) running AMX Mod X, this is the command:

amx_nick #{id} {new_name}

Restart command

You can set the command to soft restart the server, without restarting the game server process. Usually, this command restarts the game map or round. Not supported by many games.

For many GoldSource/Source games, this is the command:

restart

Map change command

With this command, you can change the game server map.

Shortcode Description
{map} Map name

For many GoldSource/Source games, this is the command:

changelevel {map}

Send message command

With this command, you can send a text chat message to all players on the server.

Shortcode Description
{msg} Message to be sent to the server

For many GoldSource games (Half-Life, Counter-Strike 1.6, etc.) running AMX Mod X, this is the command:

amx_say "{msg}"

Set/change password command

You can set a password for the game server, so only players who know this password, can log in.

Shortcode Description
{password} Server password

For many GoldSource/Source games, this is the command:

password {password}

FastRCON commands

You can specify your optional RCON commands. For example, server status command, receiving statistics, receiving list of recently disconnected players, etc.