Add tournament and gameplay docs, update commands and cvars

Added new documentation for gameplay balance, gametypes/modifiers, monsters, spawn points, and tournaments. Updated command and cvar references for new tournament and practice features, clarified map system fields, and improved documentation structure and terminology throughout. Code and menu changes support new tournament logic, forfeit voting, and expanded admin tools.

Author: themuffinator

README.md

@@ -28,9 +28,9 @@ It dramatically extends entity and gameplay support, integrates modern competiti
 **WORR** transforms QUAKE II’s multiplayer into a flexible, competitive, and feature-rich platform.
 
 #### Gametypes
-- **18 competitive gametypes plus Practice Mode**, including:
+- **18 competitive gametypes plus a practice format**, including:
   - *Duel, Domination, Head Hunters, Clan Arena, Freeze Tag* and more
-  - *Practice Mode* for no-score warmups with self-damage disabled
+  - *Practice format* for no-score warmups
 
 #### Game Modifiers
 - Unique match modifiers such as:
@@ -53,14 +53,9 @@ It dramatically extends entity and gameplay support, integrates modern competiti
 - Dynamic **match announcer** for event feedback
 - **QUAKE** and **QUAKE III: ARENA-style rulesets** that auto-apply during compatible maps
 
-## Documentation & Wiki
-- Browse the [WORR Knowledge Base](https://github.com/themuffinator/WORR-kex/wiki) for persona guides, cvar/command references, and feature overviews tailored to hosts, players, designers, and programmers. See [wiki/Home.md](wiki/Home.md) for the source file.
-- Markdown sources for the live wiki live in the repository's [wiki/](wiki/) folder so documentation changes can travel alongside code updates.
-
----
-
 ## Documentation
-- **[WORR Wiki](docs/wiki/index.md)** - Persona-focused guides for server hosts, players, level designers, and programmers, plus links to broader reference material.
+- **[WORR Knowledge Base](docs/wiki/index.md)** - Persona-focused guides for server hosts, players, level designers, and programmers, plus links to broader reference material.
+- **GitHub Wiki** - Published copy of the knowledge base for quick browsing: https://github.com/themuffinator/WORR-kex/wiki (mirrors `docs/wiki/` via `wiki/`).
 - Additional technical references live throughout the [`docs/`](docs/) directory, including changelog comparisons and versioning policy.
 
 > WORR does not currently ship a standalone web UI. To browse the wiki, open the Markdown files directly in your editor or render them with your preferred static site tooling.

docs/g_vote_flags.md

@@ -1,7 +1,7 @@
 # `g_vote_flags` Reference
 
 The `g_vote_flags` cvar controls which vote types players can initiate. By
-default the server enables every vote (`g_vote_flags 8191`) so the Call Vote menu
+default the server enables every vote (`g_vote_flags 16383`) so the Call Vote menu
 lists all available actions. You can override this by setting the cvar to the
 bitwise OR of the options you want to allow.
 
@@ -20,5 +20,6 @@ bitwise OR of the options you want to allow.
 | 10           | 1024  | `balance`    | Balance teams without a shuffle. |
 | 11           | 2048  | `ruleset`    | Change the active ruleset. |
 | 12           | 4096  | `arena`      | Switch to another arena in Arena/RA2 modes. |
+| 13           | 8192  | `forfeit`    | End the current match by vote. |
 
 Enable the flags that match the entries you want to appear in the Call Vote menu.

docs/headhunters.md

@@ -6,7 +6,7 @@ Head Hunters is a WORR multiplayer mode that rewards risk management and map awa
 
 - **Heads on death.** Each player drops every head they were holding when eliminated. The server spawns physical skull pickups that can be scooped up by anyone in play.
 - **Carry limit.** Players may hold up to 20 heads at a time; attempting to grab more while at the cap ignores the pickup.
-- **Deposit to score.** Touching a receptacle while carrying heads awards triangular scoring—`1 + 2 + … + n`—so bigger runs pay off exponentially (e.g., 3 heads = 6 points, 5 heads = 15). The deposit also resets the carrier’s held heads and triggers the receptacle spike display.
+- **Deposit to score.** Touching a receptacle while carrying heads awards triangular scoring-`1 + 2 + ... + n`-so bigger runs pay off exponentially (e.g., 3 heads = 6 points, 5 heads = 15). The deposit also resets the carrier's held heads and triggers the receptacle spike display.
 - **HUD feedback.** While Head Hunters is active, the HUD exposes the number of heads you currently hold so you know when it is safe to bank or keep hunting.
 
 ## Map Setup

docs/mapsystem.html

@@ -70,7 +70,7 @@ <h3>Schema</h3>
         <tr>
           <td><code>gametype</code></td>
           <td>integer</td>
-          <td>Default gametype index loaded when the map boots (`0` is Practice Mode for no-score warmups with self-damage disabled).</td>
+          <td>Default gametype index loaded when the map boots (omit or use <code>0</code> for no override).</td>
           <td><strong>Gates auto-rotation.</strong> Used when a cycle entry omits overrides.</td>
         </tr>
         <tr>
@@ -80,7 +80,7 @@ <h3>Schema</h3>
           <td><strong>Gates rotation.</strong> Selector avoids mismatched rulesets for the current playlist.</td>
         </tr>
         <tr>
-          <td><code>scorelimit</code>, <code>timelimit</code></td>
+          <td><code>scorelimit</code>, <code>timeLimit</code></td>
           <td>integer</td>
           <td>Per-map overrides for match objectives.</td>
           <td>Applied on load; does not affect selection.</td>
@@ -109,7 +109,7 @@ <h3>Example Entry</h3>
       "gametype": 1,
       "ruleset": 0,
       "scorelimit": 30,
-      "timelimit": 15,
+      "timeLimit": 15,
       "popular": true
     },
     {

docs/wiki/commands.md

@@ -56,10 +56,14 @@ These flags appear in each `RegisterCommand` call alongside the handler function
   - *Syntax:* `end_match`  
   - *Permissions:* Admin-only; usable while spectating or during intermission.  
   - *Example:* `\end_match`
-- **`reset_match`** — Restarts the live match after confirming it has begun and is not already at intermission.  
+- **`reset_match`** - Restarts the live match after confirming it has begun and is not already at intermission.  
   - *Syntax:* `reset_match`  
   - *Permissions:* Admin-only; usable while spectating or during intermission.  
   - *Example:* `\reset_match`
+- **`replay`** - Replays a specific tournament game in the current match set (confirmation required).  
+  - *Syntax:* `replay <game#> [confirm]`  
+  - *Permissions:* Admin-only; usable while spectating or during intermission.  
+  - *Example:* `\replay 2 confirm`
 - **`map_restart`** — Issues a `gamemap` reload for the current BSP, effectively soft-restarting the server session.  
   - *Syntax:* `map_restart`  
   - *Permissions:* Admin-only; usable while spectating or during intermission.  
@@ -103,10 +107,10 @@ These flags appear in each `RegisterCommand` call alongside the handler function
   - *Syntax:* `arena [number]`  
   - *Permissions:* Admin-only; callable while spectating (intermission restricted).  
   - *Example:* `\arena 3`
-- **`gametype`** — Lists available gametypes on `?` and switches modes when supplied a valid identifier; use `practice` for no-score warmups with self-damage disabled.  
+- **`gametype`** - Lists available gametypes on `?` and switches modes when supplied a valid identifier; `none` sets a no-score ruleset (also disables self-damage). For persistent warmup sessions, set `g_practice 1`.  
   - *Syntax:* `gametype <name>`  
   - *Permissions:* Admin-only; usable while spectating or during intermission.  
-  - *Example:* `\gametype practice`
+  - *Example:* `\gametype duel`
 - **`ruleset`** — Shows the active ruleset and applies a new one by identifier, updating the `g_ruleset` cvar.  
   - *Syntax:* `ruleset <q1|q2|q3a>`  
   - *Permissions:* Admin-only; usable while spectating or during intermission.  
@@ -142,19 +146,35 @@ These flags appear in each `RegisterCommand` call alongside the handler function
   - *Syntax:* `forfeit`  
   - *Permissions:* Usable while dead; flood-exempt.  
   - *Example:* `\forfeit`
-- **`timeout`** / **`timein`** — Starts a timeout (respecting per-player limits) or ends one if called by the owner or an admin.  
+- **`timeout`** / **`timein`** - Starts a timeout (respecting per-player limits) or ends one if called by the owner or an admin.  
   - *Syntax:* `timeout` / `timein`  
   - *Permissions:* Usable while dead or spectating.  
   - *Example:* `\timeout`
-- **`timer`** — Toggles the HUD match timer widget for the caller.  
+- **`timer`** - Toggles the HUD match timer widget for the caller.  
   - *Syntax:* `timer`  
   - *Permissions:* Usable while dead or spectating.  
   - *Example:* `\timer`
-- **`putaway`** — Closes active menus, scoreboards, and help screens, restoring the regular HUD.  
+- **`putaway`** - Closes active menus, scoreboards, and help screens, restoring the regular HUD.  
   - *Syntax:* `putaway`  
   - *Permissions:* Usable while spectating.  
   - *Example:* `\putaway`
 
+### Tournament veto tools
+
+- Tournament vetoes are menu-driven; captains (or the home/away players in FFA) can still use the commands below when needed.
+- **`tourney_pick`** - Selects a map for the tournament series during the veto phase (captain only).  
+  - *Syntax:* `tourney_pick <mapname>`  
+  - *Permissions:* Usable while dead or spectating.  
+  - *Example:* `\tourney_pick q2dm1`
+- **`tourney_ban`** - Bans a map from the tournament series during the veto phase (captain only).  
+  - *Syntax:* `tourney_ban <mapname>`  
+  - *Permissions:* Usable while dead or spectating.  
+  - *Example:* `\tourney_ban q2dm2`
+- **`tourney_status`** - Prints the current tournament pool, picks, bans, and whose turn is next.  
+  - *Syntax:* `tourney_status`  
+  - *Permissions:* Usable while dead or spectating.  
+  - *Example:* `\tourney_status`
+
 ### Spectating and camera tools
 
 - **`follow`** — As a spectator, lock the camera onto a named or numbered player after validating they are active.  

docs/wiki/cvars.md

@@ -24,26 +24,32 @@ This reference consolidates the gameplay-facing console variables (cvars) that W
 | `roundtimelimit` | `2` | Serverinfo | Minutes allotted per round before sudden-death logic kicks in. |
 | `mercylimit` | `0` | Live | Ends lopsided matches early when a team exceeds the margin. |
 | `noplayerstime` | `10` | Live | Seconds the map stays active without human players before resetting. |
-| `marathon` | `0` | Serverinfo | Enables Marathon leg chaining; consult timers below. |
-| `g_marathon_timelimit` | `0` | Live | Overrides leg duration when Marathon mode is active. |
-| `g_marathon_scorelimit` | `0` | Live | Score cap per leg in Marathon runs. |
+| `marathon` | `0` | Serverinfo | Explicit Marathon toggle; non-zero leg limits also enable chaining. |
+| `g_marathon_timelimit` | `0` | Live | Minutes per leg; setting this enables Marathon advancement. |
+| `g_marathon_scorelimit` | `0` | Live | Score delta per leg; setting this enables Marathon advancement. |
 | `match_start_no_humans` | `1` | Live | Defers countdown until a human joins the lobby. |
 | `match_auto_join` | `1` | Live | Auto-slots players onto teams as they connect. |
 | `match_force_join` | `0` | Live | Forces ready players into teams when the match starts. |
 | `match_do_force_respawn` | `1` | Live | Re-spawns eliminated players after `match_force_respawn_time`. |
 | `match_force_respawn_time` | `2.4` | Live | Seconds before a forced respawn occurs. |
 | `match_do_overtime` | `120` | Live | Adds the listed seconds of overtime to 1v1 matches that tie at regulation. |
+| `g_allow_duel_queue` | `1` | Live | Enables duel/gauntlet queueing; tournaments always disable this and clear the queue. |
 | `match_timeout_length` | `120` | Live | Duration (seconds) of player-called timeouts; `0` disables the feature. |
 | `warmup_enabled` | `1` | Live | Enables the warmup lobby cycle after map load. |
 | `warmup_do_ready_up` | `0` | Live | Requires players to ready-up before the countdown starts. |
 | `g_warmup_countdown` | `10` | Live | Seconds the start timer runs once ready-up conditions are satisfied. |
 | `g_warmup_ready_percentage` | `0.51f` | Live | Fraction of ready players required when ready-up is enabled. |
+| `g_practice` | `0` | Serverinfo | Keeps the lobby in warmup (no scoring) for practice sessions. |
+| `match_setup_length` | `standard` | Live | Stores match setup length preset (short/standard/long/endurance). |
+| `match_setup_type` | `standard` | Live | Stores match setup type preset (casual/standard/competitive/tournament). |
+| `match_setup_bestof` | `bo1` | Live | Stores match setup series length (BO1/BO3/BO5/BO7/BO9). |
+| `g_tourney_cfg` | `tourney.json` | Live | Tournament config filename resolved in the active gamedir or `baseq2`. |
 
 ### Player lifecycle & loadouts
 
 | Cvar | Default | Scope | Usage |
 | --- | --- | --- | --- |
-| `match_crosshair_ids` | `1` | Live | Shows friendly names when aiming at teammates. |
+| `match_crosshair_ids` | `1` | Live | Shows player names when aiming at other players. |
 | `match_holdable_adrenaline` | `1` | Live | Allows adrenaline holdable pickup outside duel presets. |
 | `match_instant_items` | `1` | Live | Grants items immediately on pickup (no use delay). |
 | `match_items_respawn_rate` | `1.0` | Live | Global multiplier on item respawn timers. |
@@ -54,6 +60,7 @@ This reference consolidates the gameplay-facing console variables (cvars) that W
 | `match_allow_teleporter_pads` | `1` | Live | Keeps teleporter pads available for spawn logic. |
 | `match_weapons_stay` | `0` | Live | When set, weapon pickups persist after being claimed. |
 | `match_drop_cmd_flags` | `7` | Live | Bitmask of inventory types dropped with the `drop` command. |
+| `g_ghost_min_play_time` | `60` | Live | Seconds of live play required before reconnect ghost data is persisted. |
 | `g_start_items` | `` | Live | Seed inventory items granted on spawn. |
 | `g_starting_health` | `100` | Live | Base health on spawn before bonuses apply. |
 | `g_starting_health_bonus` | `25` | Live | Temporary bonus health that decays to the base value. |
@@ -75,7 +82,7 @@ This reference consolidates the gameplay-facing console variables (cvars) that W
 | `g_allow_vote_mid_game` | `0` | Live | Blocks new votes once a match is underway when `0`. |
 | `g_allow_spec_vote` | `0` | Live | Lets spectators initiate votes when enabled. |
 | `g_allow_forfeit` | `1` | Live | Unlocks the `forfeit` vote/command path. |
-| `g_vote_flags` | `8191` | Live | Bitmask of vote commands available to players; see [Voting Flags](../g_vote_flags.md). |
+| `g_vote_flags` | `16383` | Live | Bitmask of vote commands available to players (includes `forfeit`); see [Voting Flags](../g_vote_flags.md). |
 | `g_vote_limit` | `3` | Live | Number of failed votes before a player is throttled. |
 | `g_allow_mymap` | `1` | Live | Enables per-player MyMap queue submissions. |
 | `g_allow_custom_skins` | `1` | Live | Lets clients stream custom skin assets when permitted by policy. |
@@ -97,14 +104,14 @@ This reference consolidates the gameplay-facing console variables (cvars) that W
 | `g_maps_allow_custom_sounds` | `1` | Live | Same as above for audio packages. |
 | `match_maps_list` | `` | Live | Inline rotation fallback processed when the pool is empty. |
 | `match_maps_list_shuffle` | `1` | Live | Shuffles the inline rotation once it loops, avoiding repeats. |
-| `g_mapspawn_no_bfg` | `0` | Live | Strips BFG spawns from maps that include them. |
-| `g_mapspawn_no_plasmabeam` | `0` | Live | Removes Plasma Beam spawns when toggled. |
+| `g_mapspawn_no_bfg` | `0` | Live | Strips BFG spawns from maps with BFG-less options. |
+| `g_mapspawn_no_plasmabeam` | `0` | Live | Strips Plasma Beam spawns from maps with Beam-less options. |
 
 ### Gametype & ruleset management
 
 | Cvar | Default | Scope | Usage |
 | --- | --- | --- | --- |
-| `g_gametype` | `1` (`ffa`) | Serverinfo | Primary gametype switch; `0` is Practice Mode (no-score, no self-damage). |
+| `g_gametype` | `1` (`ffa`) | Serverinfo | Primary gametype switch; `0` is `none` (no-score ruleset that also disables self-damage). |
 | `g_ruleset` | `RS_Q2` | Serverinfo | Applies predefined gameplay rule bundles; auto-corrected via `CheckRuleset`. |
 | `g_level_rulesets` | `0` | Live | Lets maps override the active ruleset when set. |
 | `deathmatch` | `1` | Latch | Baseline deathmatch toggle; enforced when team modes require it. |
@@ -122,6 +129,7 @@ This reference consolidates the gameplay-facing console variables (cvars) that W
 | `g_quadhog` | `0` | Serverinfo + Latch | Restricts Quad distribution to a single player at a time. |
 | `g_nadeFest` | `0` | Serverinfo + Latch | Forces grenade-focused loadouts in supported modes. |
 | `g_frenzy` | `0` | Serverinfo + Latch | Activates Frenzy rules for high-velocity matches. |
+| `g_gravity_lotto` | `0` | Live | Enables Gravity Lotto modifier presets. |
 | `g_domination_*` | `see defaults` | Live | Tunes Domination tick cadence, capture speeds, and bonuses. |
 | `g_coop_*` | `see defaults` | Latch | Coop campaign toggles for collision, lives, and instanced items. |
 | `g_lms_num_lives` | `4` | Latch | Starting lives for LMS/LTS variants. |
@@ -241,9 +249,6 @@ This reference consolidates the gameplay-facing console variables (cvars) that W
 | `g_dm_random_items` | `0` | Live | Enables item randomizer for DM playlists. |
 | `g_dm_strong_mines` | `0` | Live | Buffs mines in DM playlists. |
 | `g_frag_messages` | `1` | Live | Broadcasts frag strings to clients. |
-| `g_owner_push_scores` | `1` | Live | Keeps lobby owners syncing scoreboard data. |
-| `g_matchstats` | `0` | Live | Controls per-match stat dumps (see Analytics). |
-| `g_auto_screenshot_tool` | `0` | Live | Signals screenshot automation (see Analytics). |
 
 ## Related persona guides