How to Add Mods to Your Fistful of Frags Server

Plugins on a Fistful of Frags server run through Metamod:Source and SourceMod. You need both: Metamod:Source hooks into the Source Engine, and SourceMod builds on top of it to provide the plugin environment and the admin features. SourceMod officially supports Fistful of Frags and already ships the matching game data.

Install Metamod:Source

1. Download Metamod:Source
   Download the current stable version of Metamod:Source as a Linux package (.tar.gz).

2. Stop the server
   Stop your server via the dashboard.

3. Connect via SFTP
   Connect to your server via SFTP.

4. Upload the files
   Extract the archive and upload the addons folder it contains to the following directory:

   /fof/
   

   Afterwards the folder /fof/addons/metamod/ exists.

5. Start the server
   Start your server and check in the server console with meta version whether Metamod:Source was loaded.

Install SourceMod

1. Download SourceMod
   Download the current stable version of SourceMod as a Linux package (.tar.gz).

2. Stop the server
   Stop your server via the dashboard.

3. Upload the files
   Extract the archive and upload the addons and cfg folders it contains via SFTP to the following directory:

   /fof/
   

   Existing folders are merged, not replaced. Afterwards the folder /fof/addons/sourcemod/ exists.

4. Start the server
   Start your server and check in the server console with sm version whether SourceMod was loaded.

Install plugins

1. Download the plugin
   Download the plugin you want. Ready-to-use plugins come as a .smx file.

2. Stop the server
   Stop your server via the dashboard.

3. Upload the plugin
   Upload the .smx file via SFTP to the following directory:

   /fof/addons/sourcemod/plugins/
   

4. Start the server
   Start your server and check with sm plugins list whether the plugin was loaded.

Add custom maps

1. Download the map
   Custom maps come as a .bsp file.

2. Stop the server
   Stop your server via the dashboard.

3. Upload the map
   Upload the .bsp file via SFTP to the following directory:

   /fof/maps/
   

4. Load the map
   Start your server and switch to the new map in the server console with changelevel <map name>. The map name is entered without the .bsp extension.

Adjust the map rotation

The mapcycle files are not located in the cfg folder but directly in the game folder:

/fof/mapcycle.txt         <- default rotation
/fof/mapcycle_12.txt      <- rotation for small servers
/fof/mapcycle_32.txt      <- rotation for large servers
/fof/mapcycle_tp.txt      <- Teamplay

Each file contains one map name per line, without the .bsp extension. Which file is used is defined in /fof/cfg/server.cfg:

mapcyclefile "mapcycle.txt"

Deliver custom maps to your players

Players who do not own a custom map cannot join the server. With a download server (FastDL) they download the files automatically when connecting. Add the following lines to /fof/cfg/server.cfg:

sv_allowdownload 1
sv_downloadurl "https://your-domain.com/fastdl/"

Folder structure at a glance

/fof/addons/metamod/
/fof/addons/sourcemod/
/fof/addons/sourcemod/plugins/     <- .smx plugin files
/fof/addons/sourcemod/configs/     <- configurations, e.g. admin lists
/fof/cfg/                          <- server.cfg and other configurations
/fof/maps/                         <- .bsp map files
/fof/mapcycle.txt                  <- map rotation

Verify the installation

Enter the following commands in the server console: