This guide covers the jk2server module in AlphaGSM.
jk2server is currently ENABLED (BYO) on the documented Ubuntu 24.04 Linux
baseline. The current GitHub integration lane still exercises both process and
Docker runtime selection around that archive-or-staged-tree prerequisite,
while local runs remain process-backed by default unless you opt into the
Docker backend.
Requirements
screen- either a direct Jedi Outcast dedicated-server archive URL or a pre-staged
Jedi Outcast Linux dedicated server tree
- Python packages from
requirements.txt
Quick Start
Create the server:
alphagsm myjk2serve create jk2server
Run setup:
alphagsm myjk2serve setup
jk2server is supported in ENABLED (BYO) mode. Before setup or start,
either:
- set
url to a working Jedi Outcast dedicated-server archive, or
- stage
jk2mvded.x86_64 and the rest of the Jedi Outcast server files inside
your chosen <install_dir>/
Start it:
alphagsm myjk2serve start
Check it:
alphagsm myjk2serve status
Stop it:
alphagsm myjk2serve stop
Setup Details
Setup configures:
- the game port (default 28070)
- the install directory
- downloads and extracts the server archive when
url is set
Suggested flow:
alphagsm myjk2serve create jk2server
alphagsm myjk2serve set url https://example.invalid/jk2-dedicated.tar.gz
alphagsm myjk2serve setup -n 28070 /path/to/jk2
alphagsm myjk2serve start
Or, if you already have the server files:
alphagsm myjk2serve create jk2server
alphagsm myjk2serve setup -n 28070 /path/to/jk2
## copy jk2mvded.x86_64 and the rest of the server tree into /path/to/jk2/
alphagsm myjk2serve start
Useful Commands
alphagsm myjk2serve update
alphagsm myjk2serve backup
alphagsm myjk2serve set url https://example.invalid/jk2-dedicated.tar.gz
Notes
- Module name:
jk2server
- Default port: 28070
query and info use Quake III UDP getstatus on the game port.
Server variables
After create jk2server, 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 |
dir |
— |
string |
Install directory for the server. |
download_name |
— |
string |
Cached archive filename. |
exe_name |
— |
string |
Server executable filename. |
fs_game |
— |
string |
The active game/mod directory. Example: baseq3. |
hostname |
servername, name |
string |
The advertised server name. Example: AlphaGSM Arena. |
port |
gameport |
integer |
The game port for the server. Example: 27960. |
startmap |
map, gamemap, level, world |
string |
The startup map. Example: q3dm17. |
url |
— |
string |
Download URL for the server archive. |
Developer Notes
Run File
- Executable:
jk2mvded.x86_64
- Location:
<install_dir>/jk2mvded.x86_64
- Engine: Custom
Server Configuration
Maps and Mods
- Map directory:
<install_dir>/<fs_game>/
- Mod directory:
<install_dir>/<fs_game>/
- Workshop support: No
Mod Sources
Jedi Outcast supports AlphaGSM-managed direct url mod sources for content-only .pk3 payloads.
Supported payload shapes:
- a direct
.pk3 URL
- an archive containing bare
.pk3 files at the archive root
- an archive containing
<fs_game>/<name>.pk3
AlphaGSM installs approved .pk3 content into the active fs_game directory, tracks only the files it owns, and adds that active content directory to the managed backup targets.
Examples:
alphagsm myjk2serve mod add url https://example.com/mappack.pk3
alphagsm myjk2serve mod add url https://example.com/custom-content.zip
alphagsm myjk2serve mod apply
alphagsm myjk2serve mod cleanup
BYO file helper
Inspect this game's required files, source instructions and destinations with
alphagsm <server-name> assets requirements; check the declared files with
alphagsm <server-name> assets check. File checks do not establish game readiness.
This helper checks known sentinels only and directs you to stage the complete
compatible distribution manually; managed import is unavailable for this recipe.
See BYO files and private SteamCMD acquisition.