CRMod7

Recommended Host Layout

For public servers, use a VPS or dedicated box with a static IP, persistent storage, and a background process manager. QSS-M is the easiest deployment target because it listens on a single UDP game port, which keeps NAT and firewall setup simple.

• Best fit: dedicated Linux server or Linux VPS for 24/7 uptime
• Supported engines: QSS-M Server on macOS, Windows, Linux; FTEQW Server on Windows, Linux
• Suggested approach: provision a VPS, open one UDP game port, upload the engine plus id1/ content, then run it under screen or systemd
• Working reference: QSS-M-Server is an exact copy of a working server configuration directory

Linux VPS Bootstrap

A practical bootstrap flow is: provision a current Ubuntu LTS VPS, update the base system, install transfer and runtime packages, upload QSS-M, then run the server inside screen. Older notes that started on Ubuntu 16.04 and upgraded through later releases should be treated as legacy; start from a current supported LTS image instead.

sudo apt update
sudo apt upgrade -y
sudo apt install -y vsftpd git curl screen build-essential \
  libsdl2-2.0-0 libgl1-mesa-glx libopusfile0 libvorbisfile3 libmad0
sudo timedatectl set-timezone America/Los_Angeles
date

# Upload the server package to /home/quake/qssm, then:
chmod 755 QSS-M-l64
screen -S qssm26001
./QSS-M-l64 -dedicated -port 26001 -protocol 666 -condebug
# detach: Ctrl+A, then D
screen -r qssm26001

CRMod Upload Flow

After the base server is live, upload the mod payload into id1/: progs.dat, server.cfg, configs/, maps/, sound/, locs/, and any other custom assets you want available for client auto-downloads. In practice, configs/ usually carries both the core files and map-specific overrides, maps/ can include BSPs, per-map .ent files, and alternative-entity folders, and sound/ often carries mode-specific or custom subfolders like match music, weapon audio, player sounds, ambience, and arena assets. Some deployments also keep map packs and content bundles as root-level .pak archives next to the unpacked folders. The mod uses fteextensions.qc, so older ProQuake builds are not a good server target.

/home/quake/qssm/
  QSS-M-l64
  id1/
    pak0.pak
    pak1.pak
    ctf3maps.pak
    ctf4maps.pak
    ctfgoldmaps.pak
    ctflocmaps.pak
    raexpo.pak
    ramaps.pak
    progs.dat
    server.cfg
    progs/
    configs/
      clanring.cfg
      warp.cfg
      warp_main_menu.cfg
      levels.cfg
      dm3.cfg
      ultrav.cfg
    maps/
      dm6.bsp
      dm6.ent
      ctf1war.ent
      dm_alt/
      ctf_alt/
      ctf/
    sound/
      matchsounds/
        int001.wav
      weapons/
      player/
      misc/
      plasma/
      ra/
      doors/
      fire/
      ambience/
    locs/
    data/

Network Notes

QSS-M is the recommended public-hosting target because it only needs the single UDP game port forwarded, and it should generally be run in protocol 666 for Qrack compatibility. CRMod7 also depends on fteextensions.qc, which is not supported by older ProQuake versions. Older ProQuake-style server setups can require additional ephemeral UDP ports, which makes them less friendly behind NAT or restrictive firewalls.

Global Commands

Executed every time the server starts a new level. Set admin passwords, powerup defaults, tick rates, and webhook URLs here.

setadmin 1234567          // Main admin passcode (4-7 digits, first non-zero)
setadmin1 9876543         // Additional admin passcode (up to 9)
noexit 1                  // Prevent level exit in normal/practice
pausable 0                // Disable console pause (match pause still works)
quadon                    // Quad Damage on by default
ringoff                   // Ring of Invisibility off by default
pentoff                   // Pentagram off by default
runesoff                  // Runes off by default
autopauseon               // Auto-pause match on player disconnect
matchsoundson             // Enable end-of-match music
sv_pak0_only 0            // Restrict assets to pak0/shareware-safe content
ctfticrate 0.025          // Server update rate for CTF
tdmticrate 0.025          // Server update rate for TDM
captimesdiscordurl <url>  // Discord webhook for cap time records
statsdiscordurl <url>     // Discord webhook for match stats
matchposturl <url>        // HTTP POST endpoint for match data
googlesheetsurl <url>     // Google Sheets script URL for captimes
googlesheetsapikey <key>  // Google Sheets API key
cr_allow_leavemealone 1   // Allow leave-me-alone in prewar
cr_allow_qwsucks "1"      // Allow QuakeTag QWSucks mode
cr_allow_q14ever "1"      // Allow QuakeTag Q14Ever mode

Init Section

Executed only once when the server first starts. Use for one-time setup.

-init-
modevoteon                // Enable mode voting
setafk 5                  // Mark inactive players AFK after 5 minutes
kickafk 0                 // AFK kick timeout (0 = disabled)

Mode Sections

Each mode section executes its commands when the server enters that mode on a new level.

-ffa-                     // Free For All settings
timelimit 10
fraglimit 40
deathmatch 3              // 3 = weapon stay on
powerupdropon

-pub-ctf-                 // Public CTF settings
timelimit 10
fraglimit 100
runeson
deathmatch 1              // 1 = weapon stay off

-practice-                // Practice mode
safepracticeon
timelimit 0               // 0 = no limit
fraglimit 0

-match-tdm-               // Team Deathmatch match settings
teamplay 2                // 2 = team damage on
timelimit 20
setovertime 5
deathmatch 3

-match-ctf-               // CTF match settings
timelimit 20
setovertime 5
pentoff
deathmatch 1

-done-                    // Finalize and apply collected cvar changes

Parser & Extra Commands

The parser accepts regular Quake cvars, custom CRMod commands, and generic set/seta lines. These are also valid in map-specific overrides.

// Generic cvar passthrough
set hostname "CRMod 7 - local"
// FTE/QSS engine cvar passthrough
seta sv_demoAutoRecord 1
setadmin2 2468101                // Extra admin codes up to setadmin9
ringauto                         // Return ring handling to automatic mode logic
allvoteoff                       // Disable all player voting globally
powerupdropoff                   // Disable Quad/Ring/Suit dropping
matchsoundsoff                   // Disable intermission music
safedischargeon                  // Legacy alias for safe discharge rules
tossruneoff                      // Prevent players from throwing runes
sv_pak0_only 1                   // Force pak0/shareware-safe assets
cr_allow_leavemealone 0          // Disable leave-me-alone entirely
cr_allow_qwsucks 0               // Disable QuakeTag QWSucks mode
cr_allow_q14ever 0               // Disable QuakeTag Q14Ever mode

data/stats/*.crx — Capture Time Records

Per-map capture time leaderboards. Trial records use <map>_captimes.crx, match records use <map>_captimes_match.crx. Each file stores the current top 3 records with team-color metadata and optional v2 record metadata.

// ctf1_captimes.crx - trial records
unspoken                  // Player name
14                        // Team color (14=red, 5=blue, etc.)
10.19873046875            // Capture time in seconds
# meta v2 2026-01-09T07:12:53-0800  // Timestamp

data/json/*.json — Match Results

Full match stat exports in JSON. Includes per-player weapon efficiency, damage breakdown, item pickups, CTF stats, quad stats, and more. The same directory also carries snapshots like lastscores.json.

{"match": {
  "date": "2025-09-07 20:14:28",
  "hostname": "CRMod 7 - denver.quakeone.com",
  "map": "ctf3m2",
  "gamemode": "ctf match",
  "team size": 3,
  "timelimit": 20,
  "teams": [
    { "name": "Red team", "players": [
      { "name": "omicron", "score": 106, "kills": 34,
        "rockets_eff": 36, "lightning_eff": 23,
        "ctf": { "captures": 0, "returns": 6 }
      } ...
    ]}
  ]
}}

data/stats/airshot_*.crx — Airshot Records

Tracks airshot height records and gib streak records in the same .crx format. Used by the Airshot Arena mode.

data/disconnect_log.txt — Recent Disconnects

Append-only disconnect history used by the in-game last command and related moderation workflows.