Bb2server

BrainBread 2

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 name
  • sv_maxrate — Max network rate
  • rcon_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.