Skip to content
rayswaynl edited this page Jul 7, 2026 · 153 revisions

A2 Wasp Warfare Developer Wiki

Developer documentation for rayswaynl/a2waspwarfare, an Arma 2: Operation Arrowhead 1.64 Warfare / CTI mission and server ecosystem.

Current live state: Build 89 line (cmdcon44 chain) — see Current live state before acting on any 'current' claim elsewhere.

This page is the front door. It should help you choose the right owner page quickly, not repeat the whole wiki.

Looking for a specific page? See the Page Index — a one-line description of every wiki page so you (or an agent) can jump straight to the right one without opening others. Machine-readable twin: page-index.json.

Start Here

If you are... Open first Then
New human developer Quickstart Architecture overview, Mission entrypoints, SQF code atlas
New player / commander New player quickstart Commander's Handbook, Upgrade costs, Unit/vehicle roster, Optional client mods, GUER Insurgents faction
AI assistant / LLM Agent Guide (START HERE — HARD rules, trap table, claim protocol) -> Current live state -> LLM agent entry pack llms.txt, agent-entrypoint.json, agent-context.json, AI assistant guide, Agent orchestration playbook
Current work reviewer Progress dashboard agent-status.json, agent-collaboration.json, Agent worklog
Feature or bug triager Feature status register Dead/stale code register, Pending owner decisions
Gameplay implementer Gameplay systems atlas Construction/CoIn, Factory/purchase, Server runtime
Public-server hardening owner Hardening roadmap Server authority map, PVF dispatch playbook, Testing workflow
Upstream/community archaeologist Community & Dev Miksuu wiki import, Developer history, Upstream commit intel, Upstream mining ledger, BE 2073 AICOM delta, Parent 2.073 divergence audit
Docs/platform maintainer Navigation inventory Wiki pruning ledger, Knowledge platform roadmap, Wiki mirror plan, Audit archive 2026-07
Spec researcher / game designer Utes invasion concept Briefing reference, External research reports

Non-Negotiables

Rule Why it matters
Source gameplay edits start in Missions/[55-2hc]warfarev2_073v48co.chernarus. This is the source mission.
Treat Missions_Vanilla as maintained generated/copy output. Propagate with Tools/LoadoutManager; do not hand-edit drift unless a release owner says so.
Treat Modded_Missions as divergent/stubbed unless tooling proves otherwise. Current generation/package paths do not actively maintain those folders.
Use Arma 2 OA 1.64 scripting references and the agent traps reference. Arma 3 assumptions and repeated review traps are common sources of bad fixes.
Check Progress dashboard before claiming work. It prevents duplicate Codex/Claude/agent lanes.
Keep docs/wiki and the GitHub wiki mirror in sync when the mirror exists on the active branch. Humans use the wiki; agents use the repo mirror, but some gameplay branches do not carry docs/wiki.
Check Shelved registry before proposing a previously-pitched change. Shelved items are owner-parked or owner-rejected; reviving one needs explicit owner sign-off.

Main Routes

Need Canonical route
Deploy & live ops Server ops runbook -> Server runtime and operations (owner-operated — agents never deploy; PRs are the only agent output)
Startup, lifecycle, includes Architecture overview -> Mission entrypoints -> Mission config/version graph -> Lifecycle wait-chain -> Experimental feature-flag constants -> Flag system quick reference -> Per-unit client init pipeline -> Server-init deadspawn & airfield probe -> Mission tunable constants catalog -> Stringtable localization catalog
SQF ownership and compile flow SQF code atlas -> Function and module index -> Modules atlas -> AntiStack/NEURO route -> Source inventory
Networking and authority Networking/PV -> Public variable channel index -> Server authority map -> Server HandleSpecial router -> LocalizeMessage chat router -> PVF send-helper contracts -> RequestTeamUpdate squad-discipline
Economy, towns, supply Economy/towns/supply -> Economy system reference -> Balance asymmetries -> Towns/camps/capture -> Victory conditions -> Town-AI lifecycle reference -> Side-patrol & convoy runtime -> Town-economy getters -> Supply mission architecture -> GUER Insurgents faction -> GUER insurgent economy -> Income-tick engine -> Town tuning constants -> Town-capture garrison & airfield rebuild -> Anti-stack balance -> AntiStack/NEURO route -> Empty-side stagnation -> GUER air-defense loop -> GUER tunnel network pitch
Commander, HQ, construction Commander/HQ lifecycle -> Construction/CoIn -> Counter-battery radar -> Bank/Reserve/Artillery Radar -> Site clearance -> Structure dressing -> Defense category & budget -> Structure damage & friendly-fire -> HQ radio kb catalog -> WASP base-repair -> Commander vote/reassignment
Factories, purchases, upgrades Factory/purchase -> Upgrades/research -> Gear/loadout/EASA -> Factory queue cancel -> Vehicle weapon balance init -> Vehicle theft economy pitch
AI, HC, performance AI/headless/performance -> AI mods/pathfinding -> Headless client scaling -> Performance opportunity sweep -> Performance audit writer -> AI commander tunable constants -> Commander-team driver -> AICOM command verbs -> AICOM behavior taxonomy -> BE 2073 AICOM delta -> Parent 2.073 divergence audit -> Wildcard deck reference -> AICOM aircraft & airfield -> Town-AI lifecycle reference -> Legacy AI order primitives -> Static-defense manning -> Flak tower & WDDM compositions -> AI commander execution loop -> AICOM treasury accessors -> AICOM logging & telemetry -> AICOMSTAT v2 event census -> WASPSCALE v2 telemetry -> WASPSCALE v2-ext coverage -> Group lifecycle & reaping -> Batch AI spawner -> Server group GC -> HC delegation target selection -> Client FPS & state telemetry -> HC init & stat loop -> Town-garrison patrol/defense worker -> B69 improvement roadmap -> B69 implementation sketches -> AICOM V2 cutover status -> Telemetry families reference -> GUER Director pitch
UI, HUD, menus Client UI/HUD/menus -> Client UI systems atlas -> UI IDD collision repair -> Gear buy-menu functions -> End-of-game stats screen -> Client funds/income HUD -> Client input/hotkey handler -> CoIn client engine -> Map-control & minimap templates -> Unit-camera spectator -> UI control class library -> UI theme palette -> UI design inspiration 2026-07 -> Available-actions gate FSM
Map markers Cleanup/restoration -> Loop engine & registries -> Marker families catalog -> FSM updater map -> Function reference
Support, specials, airlift Support specials -> SCUD TEL tactical munitions -> UAV terminal & spotter -> Countermeasures module -> Vehicle countermeasure -> Artillery firing functions -> Service Point pricing -> Paradrop delivery -> Paradrop player flow -> ICBM nuke VFX -> GUER VBIED detonate -> Zeta cargo sling-load -> Naval HVT objectives -> SCUD saturation strike -> Modules atlas -> NEURO AI-taxi module
Player QoL / WASP UI actions WASP overlay -> Skin selector/class swap -> Earplugs audio toggle -> Optional client mods -> QoL trio player hints -> Player vehicle/travel actions -> AutoFlip vehicle recovery -> Engine stealth fuel toggle -> View distance auto-throttle -> WASP DropRPG launcher -> Player UI workflow
Tools, build, release Tools/build workflow -> Zargabad tooling parity -> July 2026 release readiness -> current RPT release gate -> RPT telemetry consumer port map -> Operator monitor/CPU affinity tools -> Source fix propagation queue -> LoadoutManager build configs -> Arma2Warfare GPT assistant -> Warfare web tools
Web tools (browser editors) Warfare web tools
Integrations and ops Ecosystem & companion repos -> External integrations -> Integration trust boundary audit -> Server runtime and operations -> Server broadcast & telemetry loops -> GLOBALGAMESTATS extension logging -> Discord bot instrumented logging -> Day/night cycle & weather
Faction content & catalogs Unit/vehicle roster -> Gear loadout routes -> Gear store catalog (complete) -> Gear store prices -> Default gear templates -> Upgrade costs -> Defenses -> Artillery -> AI squad templates -> Town AI groups -> Aux/SF/civilian units -> Vehicle marking & texture -> Airfield-exclusive roster & hints -> Base-game config reference
Base-game visual catalogs Units -> Vehicles -> Weapons -> Warfare structures -> Objects -> Buildings -> Faces -> Markers -> Flags & bags
Map content Chernarus -> Takistan -> Takistan features -> SCUD TEL tactical munitions -> Takistan parity -> Takistan oilfields -> Ruleset model/object config -> Mission audio catalog -> Eden/Everon & Taviana content
Player roles and class abilities Class-skill system -> Player skill abilities -> Respawn/death-loop lifecycle -> Medic redeploy truck -> Deployable bipod / weapon resting -> Gear/loadout/EASA -> Player AI caps
Core SQF function reference Spawn primitives -> Kill/score pipeline -> Waypoint helpers -> Position/proximity helpers -> Side/team state -> CIPHER sort utilities -> Camp getters -> Gear parsing & cargo -> Client service-proximity getters -> Player-AI watchdog
Agent orchestration (build the docs and code) Agent orchestration playbook -> Subagents -> Fleets -> Loops -> Agent collaboration protocol
Player feature guides New player quickstart -> Optional client mods -> Earning funds & score -> Vehicle service & logistics -> Commander's Handbook -> Tactical support menu -> SCUD TEL tactical munitions -> Paradrop player flow -> Supply missions -> Squad/group join -> In-game briefing & Diary
Maps & modules Playable maps -> Modded maps -> BattlEye filter -> Valhalla
Combat & vehicle function refs Player vehicle/travel actions -> Missile/ordnance Fired-EH -> Engine stealth fuel toggle -> Vehicle equip/rearm -> Array utilities -> Composition spawner -> Namespace/profile utils -> Group bool getVariable A2-OA trap -> A2 OA agent traps
Server internals Upgrade queue loop -> Map boundaries & off-map

Current Work

Surface Use it for
Progress dashboard Human-readable current lanes, July update queue and recent published batches.
agent-status.json Compact machine snapshot of active/watchlist/code-owner lanes.
agent-collaboration.json Current claim/ownership surface. Historical lanes live in the worklog and event stream.
agent-events.jsonl Append-only coordination events.
Agent worklog Dated narrative notes and historical batch detail.

Validation

powershell -ExecutionPolicy Bypass -File docs\validate-wiki.ps1

Run the validator from a repo checkout that actually has docs\validate-wiki.ps1. If the active gameplay branch has no docs/wiki mirror or validator, say that explicitly, use the GitHub wiki checkout as the live docs surface, parse touched JSON/JSONL files, check internal links/page existence, inspect diffs and keep gameplay source unchanged unless Steff explicitly asks for a code patch.

Navigation Notes

Continue Reading

Previous: Claude long-term goal | Next: Quickstart

Main map: Home | Fast path: Quickstart | Agent pack: LLM agent entry pack

Sidebar

Clone this wiki locally