MrxStrategicMissile
Module: mrxstrategicmissile.lua
Overview
MrxStrategicMissile is a beacon-designated, big-single-warhead strike: a launch projectile fires up near the player, a short delay later the real warhead drops onto the beacon, detonates with an explosion effect, and sprays six cones of shrapnel outward. It inherits from MrxSupport and uses MrxSupportDesignatorBeacon to target.
Inheritance
- Inherits from:
MrxSupport - Imports:
MrxSupportDesignatorBeacon
Instance pattern
Same class-factory pattern as MrxSupport, not per-uGuid — Create(self, uPlayerGuid) builds a new table via setmetatable/__index, exactly like its parent. No OnActivate/Awake, no tInstance registry. It tracks the following key fields:
uOwner: The GUID of the player who owns the missile.uSpawnedBomb: The GUID of the spawned missile projectile.oDesignator: The designator beacon used to target the missile.
Functions
Create(self, uPlayerGuid)
Creates a new per-instance table for the strategic missile using the module’s prototype. Initializes the designator beacon and sets the owner, recruit, and module name.
DesignationCallback(self)
Runs on beacon-designation complete. Plays a random Chinese-soldier “artillery/incoming” VO line, and chains MissileLaunch as the second element of the same MrxVoSequence.Start sequence table — so the launch is kicked off by the VO sequencer, not called directly.
MissileLaunch(self)
Spawns the launch projectile ("Strategic Missile Projectile Launch") near the camera via Airstrike.SpawnOrdnance with an upward velocity +100 and "distance" detonation 500, passing ActivateDelay as its spawn callback. This is the visible “rocket goes up” stage.
ActivateDelay(self, uProjectileGuid)
Waits 2 seconds (Event.TimerRelative), then calls self.DropBomb — the gap between launch-up and warhead-down.
DropBomb(self)
Reads the beacon target, raises nTargetY by 100, and spawns the real warhead ("Strategic Missile Projectile") falling with velocity -100, "distance" detonation 80, callback BombExplodes. Stores the handle in self.uSpawnedBomb.
BombExplodes(self)
The payoff. Logs the target coords (Debug.Printf noise), spawns "Explosion (Strategic Missile)" at the bomb, Object.Kills the warhead, removes the beacon object if Player.IsLocal(self.uOwner), then fires six Airstrike.ConeSpawn shrapnel bursts of "Strategic Missile Shrapnel" at spread angles 5°/30°/45°/60°/75°/90° (counts 2,3,3,3,3,4) directed away from the impact along the bomb→target vector.
Events
No event subscriptions. DesignationCallback is the beacon’s completion callback (via MrxSupport:Commence). The two-stage delay uses Event.TimerRelative (the 2s in ActivateDelay); the rest of the chain is driven by ordnance spawn callbacks.
Module constants & tunables
Unlike the artillery modules, the payload names here are true module-level locals (top of file), so they are not reachable from outside — overriding the whole firing function is the only way to change them:
sProjectileName = "Strategic Missile Projectile"(the warhead)sProjectileLaunchName = "Strategic Missile Projectile Launch"(the launch stage)sShrapnelName = "Strategic Missile Shrapnel"sExplosionName = "Explosion (Strategic Missile)"
Other bakes: launch velocity +100 / detonation "distance" 500; warhead velocity -100 / detonation "distance" 80; ActivateDelay 2s; six shrapnel cones (see BombExplodes).
Notes for modders
- Because the four payload names are
local, a field reassignment won’t work here — overrideMissileLaunch/DropBomb/BombExplodes(all plain globals) to change the projectile, explosion, or shrapnel. See thelocal-is-unreachable note on the Airstrike page. - The shrapnel cone pattern in
BombExplodesis the tuning knob for “how deadly the blast footprint is” — add/removeAirstrike.ConeSpawncalls or change the angle/count triples. ActivateDelay’s 2s timer is the only reason there’s a visible arc; drop it and the warhead falls the instant the launch spawns.