This guide covers the warbandserver module in AlphaGSM.
warbandserver is currently PASSED in the checked-in support tracker on the
documented Ubuntu 24.04 Linux baseline. The validated Linux lane uses the
Windows-only dedicated archive through Wine or Proton, and the current GitHub
integration lane validates both process and Docker runtimes for this module.
Requirements
screen
- Wine or Proton-GE on Linux hosts (the official TaleWorlds archive is Windows-only)
- Python packages from
requirements.txt
Quick Start
Create the server:
alphagsm mywarbands create warbandserver
Run setup:
alphagsm mywarbands setup
Start it:
alphagsm mywarbands start
Check it:
alphagsm mywarbands status
Stop it:
alphagsm mywarbands stop
Setup Details
Setup configures:
- the game port (default 7240)
- the install directory
- downloads and extracts the official
mb_warband_dedicated_1174.zip archive
- syncs
Sample_Battle.txt so set_port, set_steam_port, and set_max_players match the configured AlphaGSM server settings
Useful Commands
alphagsm mywarbands update
alphagsm mywarbands backup
Notes
- Module name:
warbandserver
- Default port: 7240
- AlphaGSM uses the direct TaleWorlds archive URL because the public Warband page is now fronted by a Cloudflare challenge that blocks automated version scraping.
- The official
1.174 dedicated archive installs Mount&Blade Warband Dedicated/mb_warband_dedicated.exe, so Linux hosts run it through Wine or Proton-GE.
- Headless Linux runs use
xvfb-run when it is available so Wine can create the minimal virtual display Warband expects at startup.
- Smoke and integration readiness now wait on
info --json reporting protocol tcp, because the dedicated server does not emit reliable startup markers into the outer screen log and AlphaGSM currently observes Warband through generic TCP reachability.
Server variables
After create warbandserver, inspect or change these with set:
alphagsm myserver set --list
alphagsm myserver set KEY --describe
alphagsm myserver set KEY VALUE
This module does not declare schema-backed keys. set --list after
create is still the live source of truth.
Developer Notes
Run File
- Executable:
mb_warband_dedicated.exe
- Location:
<install_dir>/Mount&Blade Warband Dedicated/mb_warband_dedicated.exe
- Engine: Custom
Server Configuration
Maps and Mods
- Map directory: Check game documentation
- Mod directory: Check game documentation
- Workshop support: No