This guide covers the pvkiiserver module in AlphaGSM.
pvkiiserver 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
AlphaGSM prefers the installed Source launch wrapper so its library search paths
are set before the dedicated engine loads. Explicit executable overrides are
still honored.
If an existing installation saved srcds_linux64, use
alphagsm mypvkiiser set exe_name srcds_run before starting it to restore the
wrapper's library setup (replace mypvkiiser with your server name).
screen
- SteamCMD runtime libraries (
lib32gcc-s1, lib32stdc++6)
- Python packages from
requirements.txt
Quick Start
Create the server:
alphagsm mypvkiiser create pvkiiserver
Run setup:
alphagsm mypvkiiser setup
Start it:
alphagsm mypvkiiser start
Check it:
alphagsm mypvkiiser status
Stop it:
alphagsm mypvkiiser 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 mypvkiiser update
alphagsm mypvkiiser backup
Notes
- Module name:
pvkiiserver
- Default port: 27015
Server variables
After create pvkiiserver, 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: bt_island. |
maxplayers |
users |
integer |
Maximum number of player slots. Example: 24. |
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 Pirates Vikings & Knights II. |
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:
17575
Server Configuration
- Config file:
pvkii/cfg/server.cfg
- Key settings:
hostname — Server name
sv_maxrate — Max network rate
rcon_password — Remote console password
- Default port:
27015
- Default map:
bt_island
- Max players:
24
- Ports:
- Game port:
27015 (UDP)
- Client port:
27005 (UDP)
- SourceTV port:
27020 (UDP)
- Template: See server-templates/pvkiiserver/
Maps and Mods
- Map directory:
pvkii/maps/
- Mod directory:
pvkii/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/pvkii/.
- Map install: Copy
.bsp files into pvkii/maps/ and add to pvkii/cfg/mapcycle.txt.
- Mod install: Copy addon folders into
pvkii/addons/.