This guide covers the opforserver module in AlphaGSM.
opforserver 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 myopforser create opforserver
Run setup:
alphagsm myopforser setup
Start it:
alphagsm myopforser start
Check it:
alphagsm myopforser status
Stop it:
alphagsm myopforser 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 myopforser update
alphagsm myopforser backup
Notes
- Module name:
opforserver
- Default port: 27015
Server variables
After create opforserver, 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: op4_bootcamp. |
maxplayers |
users |
integer |
Maximum number of player slots. Example: 16. |
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 Opposing Force. |
serverpassword |
sv_password, password |
string |
Password required for players to join the server. Stored as a secret. |
Developer Notes
Run File
- Executable:
hlds_run
- Location:
<install_dir>/hlds_run
- Engine: GoldSrc (HLDS)
- SteamCMD App ID:
90
- Mod App ID:
gearbox
Server Configuration
- Config file:
gearbox/server.cfg
- Key settings:
hostname — Server name
sv_maxrate — Max network rate
rcon_password — Remote console password
- Default port:
27015
- Default map:
op4_bootcamp
- Max players:
16
- Ports:
- Game port:
27015 (UDP)
- Client port:
27005 (UDP)
- Template: See server-templates/opforserver/
Maps and Mods
- Map directory:
gearbox/maps/
- Mod directory:
gearbox/dlls/
- Workshop support: No
- Map install: Copy
.bsp files into gearbox/maps/ and add to gearbox/mapcycle.txt.
- Mod install: Use Metamod in
gearbox/dlls/ or AMX Mod X in gearbox/addons/amxmodx/.