This guide covers the bfvserver module in AlphaGSM.
bfvserver 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 Battlefield Vietnam dedicated-server archive URL or a
pre-staged Battlefield Vietnam Linux dedicated server tree
- Python packages from
requirements.txt
Quick Start
Create the server:
alphagsm mybfvserve create bfvserver
Run setup:
alphagsm mybfvserve setup
bfvserver is supported in ENABLED (BYO) mode. Before setup or start,
either:
- set
url to a working Battlefield Vietnam dedicated-server archive, or
- stage
bfvietnam_lnxded and the rest of the Battlefield Vietnam server
files inside your chosen <install_dir>/
Start it:
alphagsm mybfvserve start
Check it:
alphagsm mybfvserve status
Stop it:
alphagsm mybfvserve stop
Setup Details
Setup configures:
- the game port (default 15567)
- the install directory
- downloads and extracts the server archive when
url is set
Suggested flow:
alphagsm mybfvserve create bfvserver
alphagsm mybfvserve set url https://example.invalid/bfv-dedicated.run
alphagsm mybfvserve setup -n 15567 /path/to/bfv
alphagsm mybfvserve start
Or, if you already have the server files:
alphagsm mybfvserve create bfvserver
alphagsm mybfvserve setup -n 15567 /path/to/bfv
## copy bfvietnam_lnxded and the rest of the server tree into /path/to/bfv/
alphagsm mybfvserve start
Useful Commands
alphagsm mybfvserve update
alphagsm mybfvserve backup
alphagsm mybfvserve set url https://example.invalid/bfv-dedicated.run
Notes
- Module name:
bfvserver
- Default port: 15567
Server variables
After create bfvserver, 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:
bfvietnam_lnxded
- Location:
<install_dir>/bfvietnam_lnxded
- Engine: Custom
Server Configuration
Maps and Mods
- Map directory: Check game documentation
- Mod directory: Check game documentation
- Workshop support: No
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.