• Step 1: Installing AMXX
• Step 2: Installing GunGame
• Step 3: Configuring GunGame
  • Step 3a: Configuration File
  • Step 3b: GunGame Map Cycle
  • Step 3c: Random Spawn Points
  • Step 3d: MySQL Database
• Step 4: Read Up!

Step 1: Installing AMXX (back to top)

GunGame AMXX requires AMXX 1.80 or later and the AMXX Counter-Strike Addon.

You can download the latest version of AMXX and the Counter-Strike Addon from the AMX Mod X website. You can find installation and upgrade instructions on the AlliedModders Wiki.

If you already have AMXX installed, you can determine what version you're running by typing amxx version in your server console. You can determine whether you have the Counter-Strike Addon based on the presence of a file named named cstrike_amxx_i386.so (Linux) or cstrike_amxx.dll (Windows) in your addons/amxmodx/modules/ directory.

Step 2: Installing GunGame (back to top)

To install GunGame, first download an archive from the Download page.

As of GunGame AMXX 2.13, each release has two variations which store player stats differently: the gg_VERSION_full.zip archive stores player stats in a flat-file database, whereas the gg_VERSION_full_sql.zip archive stores player stats in a MySQL database. You only need to download one archive depending on how you want to store player stats. The flat-file variation is how stats were traditionally stored in previous versions. For more detailed information about using SQL stats, see the SQL Stats page.

After downloading an archive, unzip it and copy the contents into your server's mod directory (cstrike/ or czero/).

Finally, enable the plugin by adding a line to your addons/amxmodx/configs/plugins.ini file that reads gungame.amxx.

For example, if the end of your plugins.ini file looks like this:

; Custom - Add 3rd party plugins here
some_plugin.amxx
some_other_plugin.amxx

Then after adding a gungame.amxx line it should look like this:

; Custom - Add 3rd party plugins here
some_plugin.amxx
some_other_plugin.amxx
gungame.amxx

Step 3: Configuring GunGame (back to top)

Step 3a: Configuration File (back to top)

GunGame has a large list of configurable cvars. You can customize them by editing your addons/amxmodx/configs/gungame.cfg file. In order to understand what each cvar does, you should read the Cvar List page.

It's strongly recommended that you read the cvar list and configure your gungame.cfg!

Step 3b: GunGame Map Cycle (back to top)

If you wish to have a custom map cycle that is used only while GunGame is running, create a new file named gungame_mapcycle.txt in either the mod directory (cstrike/ or czero/) or in the addons/amxmodx/configs/ directory. There should be one map name per line, just like AMXX's maps.ini file or the default mapcycle.txt file. The GunGame map cycle goes down the list until it reaches the end, and then starts back at the top.

If you use the GunGame map cycle, GunGame will not attempt to start any map votes.

Here's an example of a (small) gungame_mapcycle.txt file:

fy_iceworld2k
fy_grid2_cz
fy_iceworld_cz
fy_pool_day

Step 3c: Random Spawn Points (back to top)

As of GunGame AMXX 1.10, you can enable random spawn points by installing spawn config files (*.spawns.cfg files). GunGame doesn't come with any spawn config files pre-installed.

There are two good sources of spawn config files:

1. Counter-Strike Deathmatch (CSDM) by BAILOPAN. You can download CSDM from the CSDM website and then take just the *.spawns.cfg files from CSDM's addons/amxmodx/configs/csdm/ directory.
2. A spawn config file package produced by ToT | V!PER. You can download the package from this post on the AlliedModders forums.

Install the spawn config files by placing them in an addons/amxmodx/configs/csdm/ directory on your server. Once installed, if you have gg_dm set to 1 and gg_dm_spawn_random set to either 1 or 2, then players will respawn at these random spawn points instead of at their bases. See the Deathmatch Cvars section of the Cvar List page for more information about deathmatch mode.

Note: You don't need to install the CSDM plugin in order to enable random spawn points in GunGame. GunGame comes with its own deathmatch mode. However, you can still install the CSDM plugin if you prefer CSDM over GunGame's deathmatch mode. If you choose to do so, you should disable CSDM's weapon menu and disable GunGame's deathmatch mode (set gg_dm to 0).

Step 3d: MySQL Database (back to top)

As of GunGame AMXX 2.13, you can elect to store player stats in a MySQL database instead of the traditional flat-file storage. If you choose to use SQL stats then you should have downloaded the gg_VERSION_full_sql.zip archive. You must then configure your MySQL connection via the SQL cvars.

You can learn more about the database tables on the SQL Stats page.

Step 4: Read Up! (back to top)

After the initial installation is complete, it's recommended that you read the Cvar List page and the FAQ page for a better understanding of GunGame. If you have any lingering questions, you can try asking in the AlliedModders forums, although there's no guaranteed support.