Skip to content

Pvrserver

Jump to bottom
github-actions[bot] edited this page Sep 11, 2026 · 2 revisions

Pavlov VR

This guide covers the pvrserver module in AlphaGSM.

pvrserver is currently PASSED in the checked-in support tracker on the documented Ubuntu 24.04 Linux baseline. The validated Linux lane uses the shared steamcmd-linux Docker runtime, and the current GitHub integration lane validates both process and Docker runtimes for this module while local runs remain process-backed by default unless you opt into the Docker backend.

Requirements

  • Docker for the primary validated runtime path
  • screen only if you intentionally run the legacy host-process path
  • SteamCMD runtime libraries (lib32gcc-s1, lib32stdc++6, libc++1)
  • Python packages from requirements.txt

On current Ubuntu 24.04 hosts, Pavlov VR's Linux dedicated binary needs the LLVM C++ runtime on the host process path and will fail before readiness if libc++.so.1 is missing. The shared AlphaGSM steamcmd-linux Docker image already provides this runtime, so the current smoke and integration lifecycle validation for pvrserver should run on the Docker runtime backend first. For host-process runs, install libc++1 first.

Some host installs may also still need the unversioned libc++.so loader name, so keep the compatibility symlink in place after installing libc++1:

sudo apt install libc++1
sudo ln -sf /lib/x86_64-linux-gnu/libc++.so.1 /lib/x86_64-linux-gnu/libc++.so

Quick Start

Create the server:

alphagsm mypvrserve create pvrserver

Run setup:

alphagsm mypvrserve setup

Start it:

alphagsm mypvrserve start

Check it:

alphagsm mypvrserve status

Stop it:

alphagsm mypvrserve stop

Setup Details

Setup configures:

  • the game port (default 7777)
  • the status/query helper port (fixed at game port + 400, so 8177 by default)
  • the install directory
  • SteamCMD downloads the server files

Useful Commands

alphagsm mypvrserve update
alphagsm mypvrserve backup

Notes

  • Module name: pvrserver
  • Default game port: 7777
  • Default status/query helper port: 8177

Server variables

After create pvrserver, 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.
exe_name — string Server executable filename.
map gamemap, startmap, level, worldname string Initial map or workshop scenario.
port gameport integer Primary gameplay port.
queryport — integer Derived status-helper port (game port + 400).

Developer Notes

Run File

  • Executable: PavlovServer.sh
  • Location: <install_dir>/PavlovServer.sh
  • Engine: Custom (SteamCMD)
  • SteamCMD App ID: 622970

Smoke and integration validation now track readiness through alphagsm info --json returning protocol udp on Pavlov's status-helper port (port + 400) instead of waiting for screen-log markers, and the supported validation path uses the steamcmd-linux Docker runtime image rather than the host process path.

Fresh smoke and focused integration reruns on 2026-05-29 now prove the current Docker-primary path end to end. AlphaGSM tolerates the known SteamCMD false-negative where app 622970 reports state is 0x602 after update job even though PavlovServer.sh is already present, and the supported runtime path uses the steamcmd-linux Docker image plus the runtime-aware stop hook for graceful alphagsm stop.

The checked-in module, smoke test, integration test, and docs are now aligned to the real generic UDP helper-port contract: query, info, and info --json succeed through Pavlov VR's fixed status port at port + 400, so the older A2S-specific blocker text no longer applies.

Server Configuration

Maps and Mods

  • Map directory: Check game documentation
  • Mod directory: Check game documentation
  • Workshop support: No

Clone this wiki locally