SCUD TEL Tactical Munitions Reference

SCUD TEL Tactical Munitions Reference

Source-verified on 2026-07-03 against origin/claude/build84-cmdcon36@5fca3239069a5eff6335f06fecb26bb72e8c9ceb.

This page documents the current Build84/cmdcon36 Tactical-menu SCUD/TEL surface, the server icbm-tel-fire contract and the Takistan bought-SCUD bridge. It is separate from the older SCUD Saturation Strike Mechanic, which documents the naval-HVT carrier payoff weapon behind ScudStrike.

Fast Route

Surface	How it is opened	Server route	Main distinction
Carrier SCUD	Tactical menu row SCUD STRIKE (carrier) when WFBE_C_SCUD_MENU > 0.	RequestSpecial ["ScudStrike", playerSide, pos, group player]	Requires a side-owned naval HVT carrier/platform; server reuses KAT_ScudStrike.
Research land TEL	Tactical menu rows SCUD: SATURATION, RECON FLASH, FASCAM, STEEL RAIN, BUNKER BUSTER when WFBE_C_ICBM_TEL > 0.	RequestSpecial ["icbm-tel-fire", side, pos, mode, group, fee]	Uses the side land TEL or a valid side SCUD platform, with server validation for platform, level, cooldown, range and funds.
Takistan bought SCUD	Heavy Factory SCUD Launcher (conventional) row and vehicle addAction SCUD Fire Mission (map-click).	RequestSpecial ["icbm-tel-fire", side, pos, "SATURATION", group, 0, vehicle]	Takistan-only purchased MAZ_543_SCUD_TK_EP1; conventional only, no nuke, per-platform cooldown.
AI commander SCUD	Takistan-only low-cadence evaluator for AI-commanded sides.	Direct call to WFBE_SE_FNC_IcbmTelFire with AI treasury side as the seventh argument.	Fires SATURATION at persistent enemy clusters, avoids base areas and pays from wfbe_aicom_funds.

Tactical Menu Catalog

Client/GUI/GUI_Menu_Tactical.sqf:78-100 appends the SCUD/TEL rows after the original support list. The list is sorted before display, so declaration order is not guaranteed to be the visual order.

UI row	Internal ID	MenuAction	Server mode/payload	Default fee	Server effect
SCUD: SATURATION	TEL_Saturation	81	icbm-tel-fire, mode SATURATION	12000	Carrier-style MIRV saturation at the target zone.
SCUD: RECON FLASH	TEL_Recon	82	icbm-tel-fire, mode RECON	10000	High airburst reveal: enemy units in about 800m are revealed and temporarily marked for about 45s.
SCUD: FASCAM (mines)	TEL_Fascam	83	icbm-tel-fire, mode FASCAM	14000	Scatters AT mines in a 150m field; fields self-clear after about 20 minutes and cap at 2 live fields per side.
SCUD: STEEL RAIN (anti-inf)	TEL_SteelRain	84	icbm-tel-fire, mode STEELRAIN	9000	Rolling airburst barrage: about 18 bursts over a 300m disc, scripted damage only to exposed on-foot infantry.
SCUD: BUNKER BUSTER (point)	TEL_Buster	85	icbm-tel-fire, mode BUSTER	18000	Drops three precision bombs on the point, then guarantees the nearest enemy structure within 30m dies.
SCUD STRIKE (carrier)	SCUD_Carrier	80	ScudStrike	25000	Naval-HVT carrier saturation strike; owned carrier/platform and carrier cooldown are validated by the existing carrier SCUD server helper.

The classic ICBM row still exists separately. In this Build84 branch it is the nuclear TEL path and requires SCUD/ICBM research level 2; conventional TEL munitions are level 1 or bought-SCUD platform paths, depending on how they are fired.

Client Enable Gates

The Tactical menu gate is a UX gate, not the authority boundary. The shared TEL helper at GUI_Menu_Tactical.sqf:175-203 enables the five land-TEL rows only when all of these are true:

• The player group is the current commanderTeam.
• WFBE_UP_ICBM level is at least 1.
• A side platform is alive: the research TEL from WFBE_ICBM_TEL_<side> or, on Takistan with WFBE_C_TK_SCUD_HF > 0, at least one alive registered bought SCUD in WFBE_TK_SCUD_PLATFORMS_<side>.
• Team funds cover the displayed fee.

The carrier row has its own Tactical-menu gate at GUI_Menu_Tactical.sqf:343-350: commander, funds and ownership of a side wfbe_is_naval_hvt town/platform. The server rechecks carrier ownership and funds through the ScudStrike path.

Research Level Split

All checked faction upgrade files keep the same two-level ICBM/SCUD cost tuple in this snapshot (Common/Config/Core_Upgrades/Upgrades_*.sqf:44):

Level	Cost tuple	Meaning in Build84
1	[18000,10000]	Conventional SCUD platform level: enables the research TEL and Tactical land-TEL munitions when a platform is alive.
2	[49500,80000]	Nuclear level: required for the classic Tactical ICBM / TEL NUKE path.

The upgrade row remains module-gated by WFBE_C_MODULE_WFBE_ICBM > 0 and disabled during the air-war event (Upgrades_*.sqf:17). Takistan bought-SCUD vehicle actions are the exception to the level-1 conventional gate: the purchased launcher itself is treated as the conventional unlock by the server fire path.

Server Fire Contract

Server/Functions/Server_HandleSpecial.sqf:134-149 routes the TEL payload:

["icbm-tel-fire", side, target, munition, playerTeam, fee, platformHint?]

The handler forwards it to WFBE_SE_FNC_IcbmTelFire, compiled by Server/Init/Init_IcbmTel.sqf. The server fire function owns the authoritative contract (Init_IcbmTel.sqf:254-496):

Gate	Current behavior
Side and mode	Side must be west, east or resistance; mode is whitelisted to NUKE, SATURATION, RECON, FASCAM, STEELRAIN or BUSTER. Unknown mode falls back to NUKE.
Target	Accepts an object or position array, then resolves a target position.
Platform	NUKE uses only the research TEL. Conventional modes use the nearest alive side platform, or a valid hinted bought SCUD if passed by the vehicle action.
Research level	NUKE requires SCUD/ICBM level 2. Conventional menu fire normally requires level 1; a bought-SCUD vehicle action can waive the conventional research level because the purchased launcher is the unlock.
Platform alive	Refuses if no launch platform is alive. Destroyed research TELs can schedule replacement; bought SCUDs do not respawn.
Cooldown	Research TEL and nuke use the side-shared WFBE_ICBM_TEL_LASTFIRE_<side> clock. Bought SCUD conventional fire uses per-platform wfbe_tk_scud_lastfire. Both use WFBE_C_ICBM_TEL_COOLDOWN.
Range	NUKE is unlimited. Conventional modes are limited by WFBE_C_ICBM_TEL_RANGE, measured from the chosen platform.
Funds	Human fire reads and debits the player team through the canonical team-funds helpers. AI fire reads and debits the side AI treasury.
FASCAM cap	FASCAM refuses before charging when the side already has the configured maximum live mine fields.
Commit	The server charges funds and stamps cooldown before firing, then logs `ICBMTEL

Prompt munitions call WFBE_SE_FNC_IcbmTelTheatrics, create a 60-second global SCUD LAUNCH DETECTED marker at the firing platform, then dispatch the specific delivery function (Init_IcbmTel.sqf:477-494, :498-515).

Takistan Bought-SCUD Bridge

Takistan adds a conventional SCUD buy row when WFBE_C_TK_SCUD_HF > 0 and worldName == "Takistan". The defaults in Common/Init/Init_CommonConstants.sqf:971-981 are:

Constant	Default	Meaning
WFBE_C_TK_SCUD_HF	1	Master enable for the bought-SCUD path.
WFBE_C_TK_SCUD_HF_COST	28000	Heavy Factory buy-row price.
WFBE_C_TK_SCUD_HF_LEVEL	3	Required Heavy Factory upgrade level.
WFBE_C_TK_SCUD_HF_MAX	2	Maximum live bought SCUDs per side.
WFBE_C_TK_SCUD_HF_TYPE	MAZ_543_SCUD_TK_EP1	Purchased launcher hull, same class as the research TEL.

Both US and TKA core rosters append the friendly label SCUD Launcher (conventional) (Common/Config/Core/Core_US.sqf:193-195; Common/Config/Core/Core_TKA.sqf:158-160), and the OA unit arrays append the same hull class (Units_OA_US.sqf:182-183; Units_OA_TKA.sqf:96-97).

The buy menu refuses up front when the side already fields the cap (Client/GUI/GUI_Menu_BuyUnits.sqf:124-138). After purchase, Client_BuildUnit.sqf:410-453 sends tk-scud-register, marks the hull as wfbe_is_tk_scud, and adds the crew-only map-click action. The server registration case lives in Server_HandleSpecial.sqf:154-167; the authoritative register function at Init_IcbmTel.sqf:150-222 prunes dead refs, enforces the cap, deletes and refunds surplus purchases, tags accepted hulls, appends them to WFBE_TK_SCUD_PLATFORMS_<side> and removes them from the registry on death.

Bought SCUDs are conventional launch platforms only. They can fire SATURATION from their vehicle action and can be selected as conventional platforms by the server, but NUKE remains research-TEL-only.

Parameters And Constants

The lobby-visible rows in this snapshot are limited to carrier cost/cooldown and TEL nuke countdown/shared cooldown (Rsc/Parameters.hpp:413-436):

Parameter class	Default	Meaning
WFBE_C_SCUD_COST	25000	Carrier ScudStrike cost.
WFBE_C_SCUD_COOLDOWN	300	Carrier SCUD cooldown.
WFBE_C_ICBM_TEL_COUNTDOWN	300	Nuclear TEL countdown.
WFBE_C_ICBM_TEL_COOLDOWN	300	Shared TEL/per-platform SCUD cooldown duration.

The live TEL munition defaults are constants in Common/Init/Init_CommonConstants.sqf:944-981: WFBE_C_ICBM_TEL_RANGE is 10350 on non-Takistan maps and 8240 on Takistan; SATURATION costs 12000, RECON 10000, FASCAM 14000, STEEL RAIN 9000 and BUNKER BUSTER 18000.

AI Commander SCUD

Takistan can let AI-commanded sides use the same conventional fire function. The AI evaluator is world-gated to Takistan and WFBE_C_TK_SCUD_AI > 0, starts after server init and emits AICOMSTAT|...|AI_SCUD_LOOP|online (Init_IcbmTel.sqf:1197-1207).

The evaluator deliberately does less than a human commander:

• It skips human-commanded sides unless the AI commander lock says otherwise.
• It requires SCUD research level 1 and at least one alive launch platform.
• It searches bounded town/contested-town anchors, excludes targets within the configured HQ/base exclusion radius, requires an in-range platform and waits for the same cluster to persist across two ticks.
• It fires only SATURATION in this snapshot, pays from the AI treasury, skips when funds are below twice the SATURATION cost and logs AICOMSTAT|...|AI_SCUD|....
• Optional AI purchase can buy one conventional SCUD through the same server register path when rich and Heavy Factory-gated (Init_IcbmTel.sqf:917-940, :1093-1133, :1136-1195).

Adjacent source note: draft PR #491 / lane 196 concerns AI SCUD research order. This reference describes only the fetched Build84/cmdcon36 target snapshot above.

Reading Cautions

• Do not treat ScudStrike and icbm-tel-fire as the same path. Carrier SCUD uses the older naval-HVT payoff helper; land TEL and bought SCUDs use WFBE_SE_FNC_IcbmTelFire.
• Do not treat the Tactical menu enable check as server authority. The server fire function revalidates platform, research level, cooldown, range, funds and FASCAM cap.
• Do not assume bought SCUDs can nuke. They are conventional platforms only.
• Do not assume all SCUD constants are lobby parameters. Most TEL munition prices/ranges and Takistan bought-SCUD settings are code constants in this snapshot.
• Do not update the older naval-HVT SCUD page as if it owns the current Tactical TEL catalog. Link here for Build84 SCUD/TEL menu behavior.

Continue Reading

• Support Specials And Tactical Modules Atlas - support gateway and RequestSpecial context.
• Tactical Support Menu Player Guide - older player-facing support menu guide; use this page for current Build84 SCUD/TEL additions.
• Takistan Features - Takistan oilfield, land SCUD economy and AI SCUD route.
• SCUD Saturation Strike Mechanic - naval-HVT carrier SCUD payoff weapon.
• ICBM Authority Playbook - high-risk nuke authority context.
• ICBM Nuke Client VFX And Radiation Reference - classic nuke visual/radiation path.