This guide covers the bb2server module in AlphaGSM.
bb2server 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 mybb2serve create bb2server
Run setup:
alphagsm mybb2serve setup
Start it:
alphagsm mybb2serve start
Check it:
alphagsm mybb2serve status
Stop it:
alphagsm mybb2serve 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 mybb2serve update
alphagsm mybb2serve backup
Notes
- Module name:
bb2server
- Default port: 27015
Server variables
After create bb2server, 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: bba_barracks. |
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 BrainBread 2. |
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:
475370
Server Configuration
- Config file:
brainbread2/cfg/server.cfg
- Key settings:
hostname — Server namesv_maxrate — Max network ratercon_password — Remote console password
- Default port:
27015
- Default map:
bba_barracks
- Max players:
20
- Ports:
- Game port:
27015 (UDP)
- Client port:
27005 (UDP)
- SourceTV port:
27020 (UDP)
- Template: See server-templates/bb2server/
Maps and Mods
- Map directory:
brainbread2/maps/
- Mod directory:
brainbread2/addons/
- Workshop support: Anonymous dedicated map items by ID/URL and same-game collections.
- 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/brainbread2/.
- Map install: Copy
.bsp files into brainbread2/maps/ and add to brainbread2/cfg/mapcycle.txt.
- Mod install: Copy addon folders into
brainbread2/addons/.
Workshop multiplayer maps
Add a public dedicated map item or a Steam Community item URL. Collections expand
into a snapshot of same-game item IDs:
alphagsm myserver mod add workshop 710060895
alphagsm myserver mod add workshop-collection YOUR_COLLECTION_ID
alphagsm myserver mod apply
alphagsm myserver set map bbc_frozenheart
alphagsm myserver start
SteamCMD downloads these maps anonymously using the game's AppID 346330.
AlphaGSM validates Source BSP headers and map-family names, then publishes map
assets into each brainbread2/workshop/content/346330/ITEM_ID/ tree. The
upstream game already mounts these directories. Packages
must contain dedicated maps; client-only reskins and other-game maps are rejected.
The original archive-backed addon commands remain available.
Apply and clean up while the server is stopped. AlphaGSM refuses unowned file
collisions and removes only unchanged files recorded by its Workshop map owner.
If you edit a managed asset, restore its installed bytes before reapplying or
cleaning up. Download caches remain in .alphagsm/workshop/.
This activates native server map assets. Players must subscribe to the matching
Workshop item or receive the required map assets through your own supported
content delivery configuration. AlphaGSM does not configure automatic Workshop
client delivery for these maps.
The public Frozen Heart fixture
was checked against Valve metadata for AppID 346330 on 2026-10-13. Process and
Docker Workshop lifecycles passed on 2026-10-15 in
CI run 38748333313,
with real A2S reporting bbc_frozenheart, verified shutdown and owned-asset
cleanup. Opt-in lifecycle tests load this custom map
through the running engine and require real A2S info --json to report its name;
file staging alone cannot pass the load check.
ALPHAGSM_WORK_DIR=/path/on/large/disk \
ALPHAGSM_RUN_INTEGRATION=1 ALPHAGSM_RUN_STEAMCMD=1 \
ALPHAGSM_RUN_BB2SERVER_WORKSHOP=1 \
python3 -m pytest tests/integration_tests/test_bb2server.py -k workshop
ALPHAGSM_WORK_DIR=/path/on/large/disk BB2_WORKSHOP_ITEM=710060895 \
make smoke-test SMOKE_TEST=run_bb2server.sh
The checks accept ALPHAGSM_BB2SERVER_WORKSHOP_COLLECTION and
ALPHAGSM_BB2SERVER_WORKSHOP_MAP overrides. Smoke uses
BB2_WORKSHOP_COLLECTION and BB2_WORKSHOP_MAP. Process and Docker
checks use the same AlphaGSM lifecycle; Docker uses the steamcmd-linux image
and Source console terminal relay. Set
ALPHAGSM_BACKEND_DOCKER_IMAGE_STEAMCMD_LINUX to the branch-local image tag when
validating repository changes.