ConVars and commands

3,030 cvars exist. Perhaps forty matter for a gamemode. Every default and description on this page was read from a dump taken off a live server, which is also how we found that one of the cvars our own plugin sets does not exist.

Reading and writing them

ConVar.Find(name);                     // returns ConVar? . NULL means it does not exist.
cv.GetInt() / GetFloat() / GetString();
cv.SetInt(v) / SetFloat(v);
cv.IsValid;
ConVar.Create(name, def, desc, serverOnly);  // your own

ConVar.Find("citadel_zipline_troopers_enabled")?.SetInt(0);

var ai = ConVar.Find("ai_disabled");
if (ai == null) Console.WriteLine("WARNING: cvar ai_disabled NOT FOUND, the objective will fight back");
else ai.SetInt(1);

ConCommands are not ConVars

Some things that look like cvars are commands, and ConVar.Find will never find them. They have no type and no default in a dump, just a description. Use Server.ExecuteCommand:

Server.ExecuteCommand("citadel_enable_fast_cooldowns 1");
Server.ExecuteCommand("citadel_unlock_flex_slots");        // omit the team for both teams
Server.ExecuteCommand($"changelevel {map}");

Your own cvar, and your own command

[ConVar] public int MyThing { get; set; }

[Command("mycmd", Description = "...", ServerOnly = false, ChatOnly = false,
          ConsoleOnly = false, SuppressChat = false, Hidden = false)]
public void CmdMine(CCitadelPlayerController caller, params string[] args) { }

One attribute creates all three forms at once: /mycmd, !mycmd and dw_mycmd. The handler can take a nullable controller for console use, and typed arguments (string, int, float, enum, params, rawArgs). Throw CommandException for a usage error.

The ones that matter, by what you are trying to do

Make the map quiet

Control the economy

ConVar.Find("citadel_tick_gold_start_time")?.SetFloat(999999f);
ConVar.Find("citadel_tick_gold_payout_for_lowest")?.SetFloat(0f);
ConVar.Find("citadel_tick_gold_payout_for_second_lowest")?.SetFloat(0f);

Shape a match

ConVar.Find("citadel_spawn_practice_bots")?.SetInt(1);
ConVar.Find("citadel_spawn_practice_bots_count")?.SetInt(1);
Server.ExecuteCommand($"changelevel {Server.MapName}");

Server hygiene

Powerup camp timings

Both override cvars are -1 by default, meaning "use the normal behaviour", and the normal interval is 300 seconds. That is why a freshly placed spawner looks empty for five minutes. The engine's own descriptions:

Note the words all powerup camps. These are global, so they also speed up any camps the map ships. See the warning at the bottom of Death and respawn.

Respawn

Nineteen cvars, with the full ramp model and how to pin it flat, on its own page: Death, respawn and revive.

Dumping them yourself

The dump in the KB has 3,030 entries with type, default, min, max and description, tab separated:

# find one, with its real default and the engine's own description
grep -P "^citadel_player_override_spawn_time\t" 06_server/cvars_dump_raw.txt

# every cvar in a family, formatted
grep -i "spawn_time" 06_server/cvars_dump_raw.txt \
  | awk -F'\t' '{printf "%-52s %-9s %s\n", $1, $2, $3}'

# 895 citadel_* cvars grouped by what they are for
less 06_server/cvars_by_category.md

grep -o 'ConVar.Find("[^"]*"' YourPlugin.cs | cut -d'"' -f2 | sort -u \
  | while read c; do grep -qP "^\Q$c\E\t" cvars_dump_raw.txt || echo "MISSING: $c"; done