Fofserver

Fistful of Frags

This guide covers the fofserver module in AlphaGSM.

fofserver is currently PASSED on the documented Ubuntu 24.04 Linux baseline. The current GitHub integration lane still exercises both process and Docker runtime selection, and the validated Linux lifecycle stays aligned across both backends while local runs remain process-backed by default unless you opt into the Docker backend.

Requirements

• screen
• SteamCMD runtime libraries (lib32gcc-s1, lib32stdc++6)
• Python packages from requirements.txt

Quick Start

Create the server:

alphagsm myfofserve create fofserver

Run setup:

alphagsm myfofserve setup

Start it:

alphagsm myfofserve start

Check it:

alphagsm myfofserve status

Stop it:

alphagsm myfofserve stop

Setup Details

Setup configures:

• the game port (default 27015)
• the install directory
• the executable name
• SteamCMD downloads the server files
• default configuration and backup settings

Useful Commands

alphagsm myfofserve update
alphagsm myfofserve backup

Notes

• Module name: fofserver
• Default port: 27015

Server variables

After create fofserver, inspect or change these with set:

alphagsm myserver set --list
alphagsm myserver set KEY --describe
alphagsm myserver set KEY VALUE

Key	Aliases	Type	What it does
map	gamemap, startmap, level, worldname	string	The currently selected map or level. Example: fof_depot.
maxplayers	users	integer	Maximum number of player slots. Example: 20.
port	gameport	integer	The primary game port. Example: 27015.
rconpassword	rconpass, querypassword, query_administrator_password	string	Remote console password for administrative access. Stored as a secret.
servername	hostname, name	string	The server's public name shown to players. Example: AlphaGSM Fistful of Frags.
serverpassword	sv_password, password	string	Password required for players to join the server. Stored as a secret.

Developer Notes

Run File

• Executable: srcds_run
• Location: <install_dir>/srcds_run
• Engine: Source
• SteamCMD App ID: 295230

Server Configuration

• Config file: fof/cfg/server.cfg
• Key settings:
  • hostname — Server name
  • sv_maxrate — Max network rate
  • rcon_password — Remote console password
• Default port: 27015
• Default map: fof_depot
• Max players: 20
• Ports:
  • Game port: 27015 (UDP)
  • Client port: 27005 (UDP)
  • SourceTV port: 27020 (UDP)
• Template: See server-templates/fofserver/

Maps and Mods

• Map directory: fof/maps/
• Mod directory: fof/addons/
• Workshop support: No
• Mod notes: AlphaGSM now supports manifest, direct archive url, gamebanana, and moddb addon sources for this server through the shared Source addon flow. The built-in manifest currently includes metamod and sourcemod. mod cleanup removes only AlphaGSM-tracked addon files and keeps cache/state under .alphagsm/mods/fof/.
• Map install: Copy .bsp files into fof/maps/ and add to fof/cfg/mapcycle.txt.
• Mod install: Copy addon folders into fof/addons/.