AI Commander Wildcard Deck Reference

AI Commander Wildcard Deck Reference

Current source-backed map of the conventional and GUER wildcard decks, with explicit PR routing so closed prototypes are not mistaken for live behavior.

Base checked: origin/claude/build84-cmdcon36@33cab11c165fc82dfc9082a02cb7e2c672242c53. Scope: the conventional WEST/EAST AI-commander deck, the separate GUER insurgent deck, and the open/closed adjacent wildcard PRs that should not be mistaken for source-present behavior.

Lane 318 refresh note: the current target still has no W25/W26 or GUER G3 source entries, still forces W14/W17/W18/W21 to weight 0, and still keeps the old conventional W21 apply block unreachable. Open PR #536 now owns the source-side W2 supply-cap pre-check and W15 human-commander discount refund; until it merges, this page describes current-base behavior and routes W2/W15 source work there.

Use this before editing Server/Functions/AI_Commander_Wildcard.sqf, Server/Functions/AI_Commander_Wildcard_GUER.sqf, wildcard markers, Help-menu deck text, or wildcard-related lobby flags.

Runtime Shape

The conventional wildcard worker runs once per WEST/EAST side from server init. It is server-side, sleeps one full interval before the first draw, adds a random 0-30 second jitter before each roll, and logs the result through the AICOM logging path.

Important interval fact: AI_Commander_Wildcard.sqf still has header/fallback wording that says the default interval is 1800 seconds, but Common/Init/Init_CommonConstants.sqf currently sets WFBE_C_AI_COMMANDER_WILDCARD_INTERVAL = 900. On the current target, the practical default is therefore 900 seconds unless a lobby/global override changes it. The GUER worker is separate and currently reads WFBE_C_GUER_WILDCARD_INTERVAL with a fallback of 1800 seconds.

Draw gates:

1. WFBE_C_AI_COMMANDER_WILDCARD = 0 disables the conventional worker.
2. The conventional worker is disabled only when both sides are human-commanded, unless WFBE_C_AI_COMMANDER_LOCK or WFBE_C_WILDCARD_ALWAYS keeps draws active.
3. AI-commanded sides also require an alive HQ and wfbe_aicom_running; human-commanded sides can still draw, with some payouts remapped to the commander team.
4. A losing side is one with at least WFBE_C_AI_COMMANDER_WILDCARD_ESCALATION_TOWNS fewer towns than the enemy, default 5. In that state, selected combat-card weights are multiplied by WFBE_C_AI_COMMANDER_WILDCARD_ESCALATION_MULT, default 2.
5. The weighted roll can retry up to three times for a rejected draw, then falls back to W1.

Telemetry and player feedback:

• Conventional draws log WILDCARD_W<n> through AICOMSTAT and an AICOM log line.
• GUER draws log GUERWILDCARD_G<n>.
• Conventional AI-side draws broadcast a LocalizeMessage announcement to all clients; human-side draws are side-scoped.
• Client/PVFunctions/WildcardMarker.sqf handles side-local map markers for supported cards such as Airborne Assault, Air Cavalry, Gunship Strike, Heliborne QRF, Top Gun, Armor Column, Technical Swarm and Car Bomb.

Conventional Deck

Source of truth: Server/Functions/AI_Commander_Wildcard.sqf lines 507-560 for live weights and the weight table. The file header is historical context, not the final truth, because several later removals force old card weights to zero.

Card	Base weight	Current status	Eligibility / effect
W1 War Chest	17	Active	AI commander gets 25% of side starting funds unless already above 2x start funds; human commander side credits the commander team's wfbe_funds.
W2 Supply Drop	17	Active, but can still draw at cap	Adds up to 1500 side supply, capped by WFBE_C_MAX_ECONOMY_SUPPLY_LIMIT; current base computes the grant after draw and reports ineligible at cap. PR #303 documents the UX issue; open PR #536 owns the source pre-check/refund path.
W3 Bonus Patrol	0	Removed / inert	Obsolete after patrol-cap lowering; apply block remains but cannot be drawn.
W4 Airborne Assault	6, escalates	Active when eligible	Requires a valid parachute cargo/level-3 payload and a target town; sends a max-level paradrop at the spearhead/front.
W5	none	Absent slot	No current weight-table entry or apply case. Do not reuse without owner choice.
W6 Air Cavalry	8, escalates	Active when eligible	Requires HQ, Air research, enough owned towns, and a troop-capable air template; founds a free elite air-assault team.
W7 Veteran Company	0	Removed / inert	Removed because the payoff was invisible; old flag/apply code is unreachable.
W8 Motor Pool Delivery	none	Retired slot	Removed after leaking a persistent vehicle and doing heavy scans. W20 did not reuse this id.
W9 Uprising	0	Removed / inert	Removed as too invasive; apply block cannot be drawn.
W10 Lucky Salvage	0	Removed / inert	Salvage concept moved away from this card; apply block cannot be drawn.
W11 Field Hospital	8	Active when eligible	Requires wounded AI infantry on the side; heals wounded AI infantry and supports a free refounding path.
W12 Spoils of War	6	Active when not already active	Sets a 10-minute double kill-bounty flag; not stackable.
W13 Gunship Strike	6, escalates	Active when eligible	Requires Air research, an attack-capable air class, and a clustered enemy target; launches a single strike aircraft pass/self-despawn.
W14 Iron Dome	0	Removed / inert	Removed as low payoff; apply block cannot be drawn. Closed PR #357 attempted a default-off revive but was closed unmerged and is not current-base behavior.
W15 Black Market	6	Active AI production discount; human path open	Sets a 10-minute production-discount flag consumed by AI_Commander_Produce.sqf for AI commander production. Open PR #536 owns the human-commander buy-path refund/discount fix, so current base should not be described as fully covering human purchases.
W16 Lend-Lease	6	Active when eligible	Raises one random Light/Heavy/Air upgrade tier if below max.
W17 Supply Convoy	0	Removed / inert	Removed as low payoff; apply block cannot be drawn.
W18 Bounty HVT	0	Removed / inert	Removed as low payoff; apply block cannot be drawn.
W19 Heliborne QRF	5, escalates	Active when eligible	Requires an owned town under threat and the W6 transport-template path; air-inserts a QRF to the threatened friendly town.
W20 Captured Cache	6	Active when eligible	Raises one random support-line tier: Paratroopers, Supply Rate, or Gear. It intentionally does not touch artillery while AI artillery is disabled.
W21 GUER VBIED	0	Removed from conventional deck	Old conventional-side VBIED apply code remains in the file but is unreachable because weight is forced 0; current live car-bomb behavior belongs to G1 in the GUER deck. No current open source PR revives W21.
W22 Top Gun	6, escalates	Active when eligible	Requires HQ, Air research, enough owned towns, and a fixed-wing plane; spawns one fighter to loiter the front for 180 seconds.
W23 Armor Column	7, escalates	Active when eligible	Requires Heavy research and a tank-led AI template; founds one free tank team through the normal commander-team path.
W24 Technical Swarm	6, escalates	Active when eligible	Requires Light research and a car-led template; founds two free motorized/gun-truck teams through the normal commander-team path.
W25 Recon Drone	none in base	Closed PR #287, not current base	Closed unmerged PR #287 proposed a default-off Ka-137 WEST recon-drone card with weight 5 when WFBE_C_AICOM_DRONE_RECON is enabled. Current source has no W25 entry, weight, or apply case.
W26 Recon Drone	none in base	Closed PR #287, not current base	Closed unmerged PR #287 proposed a default-off Pchela EAST recon-drone card with weight 5 when WFBE_C_AICOM_DRONE_RECON is enabled. Current source has no W26 entry, weight, or apply case.

GUER Deck

Source of truth: Server/Functions/AI_Commander_Wildcard_GUER.sqf. GUER has no AI commander, HQ economy, or conventional commander wallet; this is a separate resistance-side insurgent event worker.

Card	Base weight	Current status	Eligibility / effect
G1 Car Bomb	6	Active when eligible	Requires a WEST/EAST occupied town, a GUER soldier class, and a valid VBIED chassis; spawns a driver-detonated car bomb against an occupied town with bounty/marker handling.
G2 Pop-up Checkpoint	8	Active when eligible	Requires a WEST/EAST occupied town and a GUER soldier class; creates a roadblock that taxes occupier supply, pays GUER tolls, and grants either clearing-side supply or a GUER FOB token if it holds to timeout.
G3 Road Ambush	none in base	Closed PR #368, not current base	Closed unmerged PR #368 proposed a default-off AT/MG road ambush card with weight 7. Current source has no G3 entry, weight, or apply case.
G4 Mortar Pit	none	Shelved	Removed from the deck and lobby toggles; see Shelved GUER wildcard mortar pit.
G5 Scavenger Team	0 unless flag enabled	Present but default-off	WFBE_C_GUER_SCAV defaults 0 in Rsc/Parameters.hpp; when enabled, the card needs a GUER-owned town and at least two abandoned wrecks, then sends a 4-man team to scrap wrecks for GUER player cash.

The GUER weight table currently contains only G1, G2 and G5. If all weights resolve to zero in a cycle, the worker exits that cycle without an announcement.

Pending / Adjacent PRs

Do not duplicate these as fresh source lanes:

Open adjacent PRs:

PR	Scope	Current routing
#303	Docs-only wildcard deck QA	Records W2 cap/no-op UX, stale inventory text, removed-card weights, marker locality and wildcard parity checks.
#362	Docs-only wildcard marker status	Confirms side-local marker creation and one-time explanatory titleText for supported wildcard markers.
#453	Docs-only recon-drone wildcard status	Status audit for lane 9. Its branch text predates the closure of #287; latest source/PR check says #287 is closed unmerged and W25/W26 are not current-base behavior.
#455	Docs-only Iron Dome / VBIED wildcard status	Status audit for lane 10. Its branch text predates closure of #357/#413; latest source/PR check says W14/W21 remain inert in the current base.
#536	Source lane 195 W2/W15 economy fix	Open draft source owner for the W2 supply-cap pre-check and W15 human-commander discount refund. Do not duplicate this as a new wildcard source lane; until merged, current base still has W2 post-draw cap rejection and W15 AI-production consumption only.

Closed/unmerged adjacent source prototypes:

PR	Scope	Current routing
#287	W25/W26 recon drones	Closed unmerged on 2026-07-03; do not treat the Ka-137/Pchela cards or WFBE_C_AICOM_DRONE_RECON as current source behavior.
#357	W14 Iron Dome revive	Closed unmerged on 2026-07-03; W14 remains forced weight 0 in the current source.
#368	GUER G3 Road Ambush	Closed unmerged on 2026-07-03; G3 is absent from the current GUER weight table.
#403	Lane 156 deck transparency	Closed unmerged on 2026-07-03; source-side manifest arrays, next-draw timestamps, and Help-menu Wildcards page are not current-base behavior.
#413	Player VBIED detonation confirm	Closed unmerged on 2026-07-03; adjacent to VBIED UX, but not a W21 wildcard revive.

Cross-Links And Flags

• AI commander tunable constants: conventional wildcard interval and AI commander knobs.
• AICOM logging and AICOMSTAT telemetry: runtime proof tokens for WILDCARD_W<n> and GUERWILDCARD_G<n>.
• GUER Insurgents faction overview and GUER insurgent economy: why GUER payouts route to players and FOB tokens instead of a commander wallet.
• GUER VBIED detonate action: player-side VBIED path, distinct from conventional W21 and GUER G1 AI event behavior.
• Balance asymmetries: W1 War Chest sizing and GUER toll/stipend pacing.
• Feature status register: use this to decide whether a wildcard behavior is source-present, draft PR, docs-only, or shelved.

Practical Rules For Agents

1. Treat the weight assignment block as truth. The header still names some cards later removed by weight zero.
2. Do not edit wildcard source files while source PRs are open for the same deck unless the owner explicitly asks for conflict repair.
3. Do not claim W25/W26 or G3 as current-base behavior; their source PRs were closed unmerged and the current weight tables do not contain them.
4. Do not revive W3, W7, W9, W10, W14, W17, W18, W21 or G4 by docs wording. Their code may still exist, but current weights/toggles make them inert or shelved.
5. Route W2 supply-cap and W15 human-commander discount source work to open PR #536 while it is live; this wiki page should only describe current base and handoff state.
6. When changing player-facing deck text, include both interval truth and card status: conventional current default 900 seconds, GUER fallback 1800 seconds, and closed PR #403 if someone is using the manifest/timer branch as a reference rather than current source.

Source Anchors

• Missions/[55-2hc]warfarev2_073v48co.chernarus/Common/Init/Init_CommonConstants.sqf:547
• Missions/[55-2hc]warfarev2_073v48co.chernarus/Server/Functions/AI_Commander_Wildcard.sqf:92-102
• Missions/[55-2hc]warfarev2_073v48co.chernarus/Server/Functions/AI_Commander_Wildcard.sqf:507-560
• Missions/[55-2hc]warfarev2_073v48co.chernarus/Server/Functions/AI_Commander_Wildcard.sqf:623-636
• Missions/[55-2hc]warfarev2_073v48co.chernarus/Server/Functions/AI_Commander_Wildcard.sqf:1024-1029
• Missions/[55-2hc]warfarev2_073v48co.chernarus/Server/Functions/AI_Commander_Wildcard.sqf:1253-1281
• Missions/[55-2hc]warfarev2_073v48co.chernarus/Server/Functions/AI_Commander_Wildcard.sqf:1283-1373
• Missions/[55-2hc]warfarev2_073v48co.chernarus/Server/Functions/AI_Commander_Wildcard.sqf:1520-1542
• Missions/[55-2hc]warfarev2_073v48co.chernarus/Server/AI/Commander/AI_Commander_Produce.sqf:459-465
• Missions/[55-2hc]warfarev2_073v48co.chernarus/Server/Functions/AI_Commander_Wildcard_GUER.sqf:95-116
• Missions/[55-2hc]warfarev2_073v48co.chernarus/Server/Functions/AI_Commander_Wildcard_GUER.sqf:132-190
• Missions/[55-2hc]warfarev2_073v48co.chernarus/Server/Functions/AI_Commander_Wildcard_GUER.sqf:414-432
• Missions/[55-2hc]warfarev2_073v48co.chernarus/Rsc/Parameters.hpp:638-667
• Missions/[55-2hc]warfarev2_073v48co.chernarus/Client/PVFunctions/WildcardMarker.sqf:45-65

Continue Reading

Previous: AICOM behavior taxonomy | Next: AI commander execution loop

Main map: Home | Agent pack: LLM agent entry pack | Status: Feature status register