Weapons

This documentation is aimed at modders and has been automatically generated for version {DEV_VERSION} of OpenRA. Please do not edit it directly, but instead add new [Desc("String")] tags to the source code.

Listed below are a template for weapon definitions and the types it can use (warheads and projectiles) with default values and developer commentary.

OpenRA.GameRules

Weapon

Property	Default Value	Type	Attributes	Description
Range	0c0	1D World Distance		The maximum range the weapon can fire.
FirstBurstTargetOffset	0,0,0	3D World Vector		First burst is aimed at this offset relative to target position.
FollowingBurstTargetOffset	0,0,0	3D World Vector		Each burst after the first lands by this offset away from the previous burst.
Report		Collection of String		The sound played each time the weapon is fired.
StartBurstReport		Collection of String		Sound played only on first burst in a salvo.
AfterFireSound		Collection of String		The sound played when the weapon is reloaded.
AfterFireSoundDelay	0	Integer		Delay in ticks to play reloading sound.
ReloadDelay	1	Integer		Delay in ticks between reloading ammo magazines.
Burst	1	Integer		Number of shots in a single ammo magazine.
ValidTargets	Ground, Water	Collection of TargetableType		What types of targets are affected.
InvalidTargets		Collection of TargetableType		What types of targets are unaffected. Overrules ValidTargets.
AirThreshold	0c128	1D World Distance		If weapon is not directly targeting an actor and targeted position is above this altitude, the weapon will ignore terrain target types and only check TargetTypeAir for validity.
BurstDelays	5	Collection of Integer		Delay in ticks between firing shots from the same ammo magazine. If one entry, it will be used for all bursts. If multiple entries, their number needs to match Burst - 1.
MinRange	0c0	1D World Distance		The minimum range the weapon can fire.
TargetActorCenter	False	Boolean		Does this weapon aim at the target's center regardless of other targetable offsets?
Projectile		Projectile
Warheads		Collection of Warhead

OpenRA.Mods.Cnc.Projectiles

TeslaZap

Instant-hit projectile used to create electricity-like effects.

Property	Default Value	Type	Attributes	Description
Image	litning	String
BrightSequence	bright	String	SequenceReference
DimSequence	dim	String	SequenceReference
Palette	effect	String	PaletteReference
BrightZaps	1	Integer
DimZaps	2	Integer
Duration	2	Integer
DamageDuration	1	Integer
TrackTarget	True	Boolean

OpenRA.Mods.Common.Projectiles

AreaBeam

Beam projectile that travels in a straight line.

Property	Default Value	Type	Attributes	Description
Speed	0c128	Collection of 1D World Distance		Projectile speed in WDist / tick, two values indicate a randomly picked velocity per beam.
Duration	10	Integer		The maximum duration (in ticks) of each beam burst.
DamageInterval	3	Integer		The number of ticks between the beam causing warhead impacts in its area of effect.
Width	0c512	1D World Distance		The width of the beam.
Shape	Cylindrical	BeamRenderableShape		The shape of the beam. Accepts values Cylindrical or Flat.
BeyondTargetRange	0c0	1D World Distance		How far beyond the target the projectile keeps on travelling.
Falloff	100, 100	Collection of Integer		Damage modifier applied at each range step.
Range	0c0, 2097151c1023	Collection of 1D World Distance		Ranges at which each Falloff step is defined.
Inaccuracy	0c0	1D World Distance		The maximum/constant/incremental inaccuracy used in conjunction with the InaccuracyType property.
InaccuracyType	Maximum	InaccuracyType		Controls the way inaccuracy is calculated. Possible values are 'Maximum' - scale from 0 to max with range, 'PerCellIncrement' - scale from 0 with range and 'Absolute' - use set value regardless of range.
Blockable	False	Boolean		Can this projectile be blocked when hitting actors with an IBlocksProjectiles trait.
TrackTarget	False	Boolean		Does the beam follow the target.
RenderBeam	True	Boolean		Should the beam be visually rendered? False = Beam is invisible.
ZOffset	0	Integer		Equivalent to sequence ZOffset. Controls Z sorting.
Color	FF0000	Color (RRGGBB[AA] notation)		Color of the beam.
UsePlayerColor	False	Boolean		Beam color is the player's color.

Bullet

Projectile that travels in a straight line or arc.

Property	Default Value	Type	Attributes	Description
Speed	0c17	Collection of 1D World Distance		Projectile speed in WDist / tick, two values indicate variable velocity.
Inaccuracy	0c0	1D World Distance		The maximum/constant/incremental inaccuracy used in conjunction with the InaccuracyType property.
InaccuracyType	Maximum	InaccuracyType		Controls the way inaccuracy is calculated. Possible values are 'Maximum' - scale from 0 to max with range, 'PerCellIncrement' - scale from 0 with range and 'Absolute' - use set value regardless of range.
Image		String		Image to display.
Sequences	idle	Collection of String	SequenceReference	Loop a randomly chosen sequence of Image from this list while this projectile is moving.
Palette	effect	String	PaletteReference	The palette used to draw this projectile.
IsPlayerPalette	False	Boolean		Palette is a player palette BaseName
Shadow	False	Boolean		Does this projectile have a shadow?
ShadowColor	0000008C	Color (RRGGBB[AA] notation)		Color to draw shadow if Shadow is true.
TrailImage		String		Trail animation.
TrailSequences	idle	Collection of String	SequenceReference	Loop a randomly chosen sequence of TrailImage from this list while this projectile is moving.
TrailInterval	2	Integer		Interval in ticks between each spawned Trail animation.
TrailDelay	1	Integer		Delay in ticks until trail animation is spawned.
TrailPalette	effect	String	PaletteReference	Palette used to render the trail sequence.
TrailUsePlayerPalette	False	Boolean		Use the Player Palette to render the trail sequence.
Blockable	True	Boolean		Is this blocked by actors with BlocksProjectiles trait.
Width	0c1	1D World Distance		Width of projectile (used for finding blocking actors).
LaunchAngle	0	Collection of 1D World Angle		Arc in WAngles, two values indicate variable arc.
BounceCount	0	Integer		Up to how many times does this bullet bounce when touching ground without hitting a target. 0 implies exploding on contact with the originally targeted position.
BounceRangeModifier	60	Integer		Modify distance of each bounce by this percentage of previous distance.
BounceSound		String		Sound to play when the projectile hits the ground, but not the target.
InvalidBounceTerrain		Set of String		Terrain where the projectile explodes instead of bouncing.
ValidBounceBlockerRelationships	Enemy, Neutral	PlayerRelationship		Trigger the explosion if the projectile touches an actor thats owner has these player relationships.
AirburstAltitude	0c0	1D World Distance		Altitude above terrain below which to explode. Zero effectively deactivates airburst.
ContrailLength	0	Integer
ContrailZOffset	2047	Integer
ContrailColor	FFFFFF	Color (RRGGBB[AA] notation)
ContrailUsePlayerColor	False	Boolean
ContrailDelay	1	Integer
ContrailWidth	0c64	1D World Distance

GravityBomb

Projectile with customisable acceleration vector.

Property	Default Value	Type	Attributes	Description
Image		String
Sequences	idle	Collection of String	SequenceReference	Loop a randomly chosen sequence of Image from this list while falling.
OpenSequence		String	SequenceReference	Sequence to play when launched. Skipped if null or empty.
Palette	effect	String	PaletteReference	The palette used to draw this projectile.
IsPlayerPalette	False	Boolean		Palette is a player palette BaseName
Shadow	False	Boolean		Does this projectile have a shadow?
ShadowColor	0000008C	Color (RRGGBB[AA] notation)		Color to draw shadow if Shadow is true.
Velocity	0,0,0	3D World Vector		Projectile movement vector per tick (forward, right, up), use negative values for opposite directions.
Acceleration	0,0,-15	3D World Vector		Value added to Velocity every tick.

InstantHit

Instant, invisible, usually direct-on-target projectile.

Property	Default Value	Type	Attributes	Description
Inaccuracy	0c0	1D World Distance		The maximum/constant/incremental inaccuracy used in conjunction with the InaccuracyType property.
InaccuracyType	Maximum	InaccuracyType		Controls the way inaccuracy is calculated. Possible values are 'Maximum' - scale from 0 to max with range, 'PerCellIncrement' - scale from 0 with range and 'Absolute' - use set value regardless of range.
Blockable	False	Boolean		Projectile can be blocked.
Width	0c1	1D World Distance		The width of the projectile.
BlockerScanRadius	-0c1	1D World Distance		Scan radius for actors with projectile-blocking trait. If set to a negative value (default), it will automatically scale to the blocker with the largest health shape. Only set custom values if you know what you're doing.

LaserZap

Not a sprite, but an engine effect.

Property	Default Value	Type	Attributes	Description
Width	0c86	1D World Distance		The width of the zap.
Shape	Cylindrical	BeamRenderableShape		The shape of the beam. Accepts values Cylindrical or Flat.
ZOffset	0	Integer		Equivalent to sequence ZOffset. Controls Z sorting.
Duration	10	Integer		The maximum duration (in ticks) of the beam's existence.
DamageDuration	1	Integer		Total time-frame in ticks that the beam deals damage every DamageInterval.
DamageInterval	1	Integer		The number of ticks between the beam causing warhead impacts in its area of effect.
UsePlayerColor	False	Boolean
Color	FF0000	Color (RRGGBB[AA] notation)		Color of the beam.
TrackTarget	True	Boolean		Beam follows the target.
Inaccuracy	0c0	1D World Distance		The maximum/constant/incremental inaccuracy used in conjunction with the InaccuracyType property.
InaccuracyType	Maximum	InaccuracyType		Controls the way inaccuracy is calculated. Possible values are 'Maximum' - scale from 0 to max with range, 'PerCellIncrement' - scale from 0 with range and 'Absolute' - use set value regardless of range.
Blockable	False	Boolean		Beam can be blocked.
SecondaryBeam	False	Boolean		Draw a second beam (for 'glow' effect).
SecondaryBeamWidth	0c86	1D World Distance		The width of the zap.
SecondaryBeamShape	Cylindrical	BeamRenderableShape		The shape of the beam. Accepts values Cylindrical or Flat.
SecondaryBeamZOffset	0	Integer		Equivalent to sequence ZOffset. Controls Z sorting.
SecondaryBeamUsePlayerColor	False	Boolean
SecondaryBeamColor	FF0000	Color (RRGGBB[AA] notation)		Color of the secondary beam.
HitAnim		String		Impact animation.
HitAnimSequence	idle	String	SequenceReference	Sequence of impact animation to use.
HitAnimPalette	effect	String	PaletteReference
LaunchEffectImage		String		Image containing launch effect sequence.
LaunchEffectSequence		String	SequenceReference	Launch effect sequence to play.
LaunchEffectPalette	effect	String	PaletteReference	Palette to use for launch effect.

Missile

Projectile with smart tracking.

Property	Default Value	Type	Attributes	Description
Image		String		Name of the image containing the projectile sequence.
Sequences	idle	Collection of String	SequenceReference	Loop a randomly chosen sequence of Image from this list while this projectile is moving.
Palette	effect	String	PaletteReference	Palette used to render the projectile sequence.
IsPlayerPalette	False	Boolean		Palette is a player palette BaseName
Shadow	False	Boolean		Does this projectile have a shadow?
ShadowColor	0000008C	Color (RRGGBB[AA] notation)		Color to draw shadow if Shadow is true.
MinimumLaunchAngle	960	1D World Angle		Minimum vertical launch angle (pitch).
MaximumLaunchAngle	128	1D World Angle		Maximum vertical launch angle (pitch).
MinimumLaunchSpeed	-0c1	1D World Distance		Minimum launch speed in WDist / tick. Defaults to Speed if -1.
MaximumLaunchSpeed	-0c1	1D World Distance		Maximum launch speed in WDist / tick. Defaults to Speed if -1.
Speed	0c384	1D World Distance		Maximum projectile speed in WDist / tick
Acceleration	0c5	1D World Distance		Projectile acceleration when propulsion activated.
Arm	0	Integer		How many ticks before this missile is armed and can explode.
Blockable	True	Boolean		Is the missile blocked by actors with BlocksProjectiles: trait.
TerrainHeightAware	False	Boolean		Is the missile aware of terrain height levels. Only needed for mods with real, non-visual height levels.
Width	0c1	1D World Distance		Width of projectile (used for finding blocking actors).
Inaccuracy	0c0	1D World Distance		The maximum/constant/incremental inaccuracy used in conjunction with the InaccuracyType property.
InaccuracyType	Absolute	InaccuracyType		Controls the way inaccuracy is calculated. Possible values are 'Maximum' - scale from 0 to max with range, 'PerCellIncrement' - scale from 0 with range and 'Absolute' - use set value regardless of range.
LockOnInaccuracy	-0c1	1D World Distance		Inaccuracy override when successfully locked onto target. Defaults to Inaccuracy if negative.
LockOnProbability	100	Integer		Probability of locking onto and following target.
HorizontalRateOfTurn	20	1D World Angle		Horizontal rate of turn.
VerticalRateOfTurn	24	1D World Angle		Vertical rate of turn.
Gravity	10	Integer		Gravity applied while in free fall.
RangeLimit	0c0	1D World Distance		Run out of fuel after covering this distance. Zero for defaulting to weapon range. Negative for unlimited fuel.
ExplodeWhenEmpty	True	Boolean		Explode when running out of fuel.
AirburstAltitude	0c0	1D World Distance		Altitude above terrain below which to explode. Zero effectively deactivates airburst.
CruiseAltitude	0c512	1D World Distance		Cruise altitude. Zero means no cruise altitude used.
HomingActivationDelay	0	Integer		Activate homing mechanism after this many ticks.
TrailImage		String		Image that contains the trail animation.
TrailSequences	idle	Collection of String	SequenceReference	Loop a randomly chosen sequence of TrailImage from this list while this projectile is moving.
TrailPalette	effect	String	PaletteReference	Palette used to render the trail sequence.
TrailUsePlayerPalette	False	Boolean		Use the Player Palette to render the trail sequence.
TrailInterval	2	Integer		Interval in ticks between spawning trail animation.
TrailWhenDeactivated	False	Boolean		Should trail animation be spawned when the propulsion is not activated.
ContrailLength	0	Integer
ContrailZOffset	2047	Integer
ContrailWidth	0c64	1D World Distance
ContrailColor	FFFFFF	Color (RRGGBB[AA] notation)
ContrailUsePlayerColor	False	Boolean
ContrailDelay	1	Integer
Jammable	True	Boolean		Should missile targeting be thrown off by nearby actors with JamsMissiles.
JammedDiversionRange	20	Integer		Range of facings by which jammed missiles can stray from current path.
BoundToTerrainType		String		Explodes when leaving the following terrain type, e.g., Water for torpedoes.
AllowSnapping	False	Boolean		Allow the missile to snap to the target, meaning jumping to the target immediately when the missile enters the radius of the current speed around the target.
CloseEnough	0c298	1D World Distance		Explodes when inside this proximity radius to target. Note: If this value is lower than the missile speed, this check might not trigger fast enough, causing the missile to fly past the target.

Railgun

Laser effect with helix coiling around.

Property	Default Value	Type	Attributes	Description
DamageActorsInLine	False	Boolean		Damage all units hit by the beam instead of just the target?
Inaccuracy	0c0	1D World Distance		The maximum/constant/incremental inaccuracy used in conjunction with the InaccuracyType property.
InaccuracyType	Maximum	InaccuracyType		Controls the way inaccuracy is calculated. Possible values are 'Maximum' - scale from 0 to max with range, 'PerCellIncrement' - scale from 0 with range and 'Absolute' - use set value regardless of range.
Blockable	False	Boolean		Can this projectile be blocked when hitting actors with an IBlocksProjectiles trait.
Duration	15	Integer		Duration of the beam and helix
ZOffset	0	Integer		Equivalent to sequence ZOffset. Controls Z sorting.
BeamWidth	0c86	1D World Distance		The width of the main trajectory. ("beam").
BeamShape	Cylindrical	BeamRenderableShape		The shape of the beam. Accepts values Cylindrical or Flat.
BeamColor	FFFFFF80	Color (RRGGBB[AA] notation)		Beam color in (A),R,G,B.
BeamPlayerColor	False	Boolean		When true, this will override BeamColor parameter and draw the laser with player color. (Still uses BeamColor's alpha information)
BeamAlphaDeltaPerTick	-8	Integer		Beam alpha gets + this value per tick during drawing; hence negative value makes it fade over time.
HelixThickness	0c32	1D World Distance		Thickness of the helix
HelixRadius	0c64	1D World Distance		The radius of the spiral effect. (WDist)
HelixPitch	0c512	1D World Distance		Height of one complete helix turn, measured parallel to the axis of the helix (WDist)
HelixRadiusDeltaPerTick	8	Integer		Helix radius gets + this value per tick during drawing
HelixAlphaDeltaPerTick	-8	Integer		Helix alpha gets + this value per tick during drawing; hence negative value makes it fade over time.
HelixAngleDeltaPerTick	16	1D World Angle		Helix spins by this much over time each tick.
QuantizationCount	16	Integer		Draw each cycle of helix with this many quantization steps
HelixColor	FFFFFF80	Color (RRGGBB[AA] notation)		Helix color in (A),R,G,B.
HelixPlayerColor	False	Boolean		Draw helix in PlayerColor? Overrides RGB part of the HelixColor. (Still uses HelixColor's alpha information)
HitAnim		String		Impact animation.
HitAnimSequence	idle	String	SequenceReference	Sequence of impact animation to use.
HitAnimPalette	effect	String	PaletteReference

OpenRA.Mods.Common.Warheads

ChangeOwnerWarhead

Interacts with the TemporaryOwnerManager trait.

Property	Default Value	Type	Attributes	Description
Duration	0	Integer		Duration of the owner change (in ticks). Set to 0 to make it permanent.
Range	1c0	1D World Distance
ValidTargets	Ground, Water	Collection of TargetableType		What types of targets are affected.
InvalidTargets		Collection of TargetableType		What types of targets are unaffected. Overrules ValidTargets.
ValidRelationships	Enemy, Neutral, Ally	PlayerRelationship		What player relationships are affected.
AffectsParent	False	Boolean		Can this warhead affect the actor that fired it.
AirThreshold	0c128	1D World Distance		If impact is above this altitude, warheads that would affect terrain ignore terrain target types (and either do nothing or perform their own checks).
Delay	0	Integer		Delay in ticks before applying the warhead effect. 0 = instant (old model).
DebugOverlayColor	FF0000	Color (RRGGBB[AA] notation)		The color used for this warhead's visualization in the world's WarheadDebugOverlay trait.

CreateEffectWarhead

Spawn a sprite with sound.

Property	Default Value	Type	Attributes	Description
Explosions		Collection of String	SequenceReference	List of explosion sequences that can be used.
Image	explosion	String		Image containing explosion effect sequence.
ExplosionPalette	effect	String	PaletteReference	Palette to use for explosion effect.
UsePlayerPalette	False	Boolean		Remap explosion effect to player color, if art supports it.
ForceDisplayAtGroundLevel	False	Boolean		Display explosion effect at ground level, regardless of explosion altitude.
ImpactSounds		Collection of String		List of sounds that can be played on impact.
ImpactSoundChance	100	Integer		Chance of impact sound to play.
ImpactActors	True	Boolean		Whether to consider actors in determining whether the explosion should happen. If false, only terrain will be considered.
Inaccuracy	0c0	1D World Distance		The maximum inaccuracy of the effect spawn position relative to actual impact position.
ValidTargets	Ground, Water	Collection of TargetableType		What types of targets are affected.
InvalidTargets		Collection of TargetableType		What types of targets are unaffected. Overrules ValidTargets.
ValidRelationships	Enemy, Neutral, Ally	PlayerRelationship		What player relationships are affected.
AffectsParent	False	Boolean		Can this warhead affect the actor that fired it.
AirThreshold	0c128	1D World Distance		If impact is above this altitude, warheads that would affect terrain ignore terrain target types (and either do nothing or perform their own checks).
Delay	0	Integer		Delay in ticks before applying the warhead effect. 0 = instant (old model).
DebugOverlayColor	FF0000	Color (RRGGBB[AA] notation)		The color used for this warhead's visualization in the world's WarheadDebugOverlay trait.

CreateResourceWarhead

Creates resources in a circle.

Property	Default Value	Type	Attributes	Description
Size	0, 0	Collection of Integer		Size of the area. The resources are seeded within this area. Provide 2 values for a ring effect (outer/inner).
AddsResourceType		String	Require	Will this splatter resources and which?
ValidTargets	Ground, Water	Collection of TargetableType		What types of targets are affected.
InvalidTargets		Collection of TargetableType		What types of targets are unaffected. Overrules ValidTargets.
ValidRelationships	Enemy, Neutral, Ally	PlayerRelationship		What player relationships are affected.
AffectsParent	False	Boolean		Can this warhead affect the actor that fired it.
AirThreshold	0c128	1D World Distance		If impact is above this altitude, warheads that would affect terrain ignore terrain target types (and either do nothing or perform their own checks).
Delay	0	Integer		Delay in ticks before applying the warhead effect. 0 = instant (old model).
DebugOverlayColor	FF0000	Color (RRGGBB[AA] notation)		The color used for this warhead's visualization in the world's WarheadDebugOverlay trait.

DestroyResourceWarhead

Destroys resources in a circle.

Property	Default Value	Type	Attributes	Description
Size	0, 0	Collection of Integer		Size of the area. The resources are removed within this area. Provide 2 values for a ring effect (outer/inner).
ResourceAmount	0	Integer		Amount of resources to be removed. If negative or zero, all resources within the area will be removed.
ResourceTypes		Set of String		Resource types to remove with this warhead. If empty, all resource types will be removed.
ValidTargets	Ground, Water	Collection of TargetableType		What types of targets are affected.
InvalidTargets		Collection of TargetableType		What types of targets are unaffected. Overrules ValidTargets.
ValidRelationships	Enemy, Neutral, Ally	PlayerRelationship		What player relationships are affected.
AffectsParent	False	Boolean		Can this warhead affect the actor that fired it.
AirThreshold	0c128	1D World Distance		If impact is above this altitude, warheads that would affect terrain ignore terrain target types (and either do nothing or perform their own checks).
Delay	0	Integer		Delay in ticks before applying the warhead effect. 0 = instant (old model).
DebugOverlayColor	FF0000	Color (RRGGBB[AA] notation)		The color used for this warhead's visualization in the world's WarheadDebugOverlay trait.

FireClusterWarhead

Fires weapons from the point of impact.

Property	Default Value	Type	Attributes	Description
Weapon		String	WeaponReference, Require	Has to be defined in weapons.yaml as well.
RandomClusterCount	-1	Integer		Number of weapons fired at random 'x' cells. Negative values will result in a number equal to 'x' footprint cells fired.
Dimensions	0,0	2D Cell Vector	Require	Size of the cluster footprint
Footprint		String	Require	Cluster footprint. Cells marked as X will be attacked. Cells marked as x will be attacked randomly until RandomClusterCount is reached.
ValidTargets	Ground, Water	Collection of TargetableType		What types of targets are affected.
InvalidTargets		Collection of TargetableType		What types of targets are unaffected. Overrules ValidTargets.
ValidRelationships	Enemy, Neutral, Ally	PlayerRelationship		What player relationships are affected.
AffectsParent	False	Boolean		Can this warhead affect the actor that fired it.
AirThreshold	0c128	1D World Distance		If impact is above this altitude, warheads that would affect terrain ignore terrain target types (and either do nothing or perform their own checks).
Delay	0	Integer		Delay in ticks before applying the warhead effect. 0 = instant (old model).
DebugOverlayColor	FF0000	Color (RRGGBB[AA] notation)		The color used for this warhead's visualization in the world's WarheadDebugOverlay trait.

FlashPaletteEffectWarhead

Used to trigger a FlashPaletteEffect trait on the world actor.

Property	Default Value	Type	Attributes	Description
FlashType		String		Corresponds to Type from FlashPaletteEffect on the world actor.
Duration	0	Integer	Require	Duration of the flashing, measured in ticks. Set to -1 to default to the Length of the FlashPaletteEffect.
ValidTargets	Ground, Water	Collection of TargetableType		What types of targets are affected.
InvalidTargets		Collection of TargetableType		What types of targets are unaffected. Overrules ValidTargets.
ValidRelationships	Enemy, Neutral, Ally	PlayerRelationship		What player relationships are affected.
AffectsParent	False	Boolean		Can this warhead affect the actor that fired it.
AirThreshold	0c128	1D World Distance		If impact is above this altitude, warheads that would affect terrain ignore terrain target types (and either do nothing or perform their own checks).
Delay	0	Integer		Delay in ticks before applying the warhead effect. 0 = instant (old model).
DebugOverlayColor	FF0000	Color (RRGGBB[AA] notation)		The color used for this warhead's visualization in the world's WarheadDebugOverlay trait.

GrantExternalConditionWarhead

Grant an external condition to hit actors.

Property	Default Value	Type	Attributes	Description
Condition		String	Require	The condition to apply. Must be included in the target actor's ExternalConditions list.
Duration	0	Integer		Duration of the condition (in ticks). Set to 0 for a permanent condition.
Range	1c0	1D World Distance
ValidTargets	Ground, Water	Collection of TargetableType		What types of targets are affected.
InvalidTargets		Collection of TargetableType		What types of targets are unaffected. Overrules ValidTargets.
ValidRelationships	Enemy, Neutral, Ally	PlayerRelationship		What player relationships are affected.
AffectsParent	False	Boolean		Can this warhead affect the actor that fired it.
AirThreshold	0c128	1D World Distance		If impact is above this altitude, warheads that would affect terrain ignore terrain target types (and either do nothing or perform their own checks).
Delay	0	Integer		Delay in ticks before applying the warhead effect. 0 = instant (old model).
DebugOverlayColor	FF0000	Color (RRGGBB[AA] notation)		The color used for this warhead's visualization in the world's WarheadDebugOverlay trait.

HealthPercentageDamageWarhead

Apply damage based on the target's health.

Inherits from: TargetDamageWarhead, DamageWarhead.

Property	Default Value	Type	Attributes	Description
Spread	0c0	1D World Distance		Damage will be applied to actors in this area. A value of zero means only targeted actor will be damaged.
Damage	0	Integer		How much (raw) damage to deal.
DamageTypes		Collection of DamageType		Types of damage that this warhead causes. Leave empty for no damage types.
Versus		Dictionary with Key: String, Value: Integer		Damage percentage versus each armor type.
ValidTargets	Ground, Water	Collection of TargetableType		What types of targets are affected.
InvalidTargets		Collection of TargetableType		What types of targets are unaffected. Overrules ValidTargets.
ValidRelationships	Enemy, Neutral, Ally	PlayerRelationship		What player relationships are affected.
AffectsParent	False	Boolean		Can this warhead affect the actor that fired it.
AirThreshold	0c128	1D World Distance		If impact is above this altitude, warheads that would affect terrain ignore terrain target types (and either do nothing or perform their own checks).
Delay	0	Integer		Delay in ticks before applying the warhead effect. 0 = instant (old model).
DebugOverlayColor	FF0000	Color (RRGGBB[AA] notation)		The color used for this warhead's visualization in the world's WarheadDebugOverlay trait.

LeaveSmudgeWarhead

Creates a smudge in SmudgeLayer.

Property	Default Value	Type	Attributes	Description
Size	0, 0	Collection of Integer		Size of the area. A smudge will be created in each tile. Provide 2 values for a ring effect (outer/inner).
SmudgeType		Set of String		Type of smudge to apply to terrain.
Chance	100	Integer		Percentage chance the smudge is created.
ValidTargets	Ground, Water	Collection of TargetableType		What types of targets are affected.
InvalidTargets		Collection of TargetableType		What types of targets are unaffected. Overrules ValidTargets.
ValidRelationships	Enemy, Neutral, Ally	PlayerRelationship		What player relationships are affected.
AffectsParent	False	Boolean		Can this warhead affect the actor that fired it.
AirThreshold	0c128	1D World Distance		If impact is above this altitude, warheads that would affect terrain ignore terrain target types (and either do nothing or perform their own checks).
Delay	0	Integer		Delay in ticks before applying the warhead effect. 0 = instant (old model).
DebugOverlayColor	FF0000	Color (RRGGBB[AA] notation)		The color used for this warhead's visualization in the world's WarheadDebugOverlay trait.

ShakeScreenWarhead

Makes the screen shake.

Property	Default Value	Type	Attributes	Description
Duration	0	Integer		Duration of the shaking.
Intensity	0	Integer		Shake intensity.
Multiplier	0,0	2D Real Number		Shake multipliers by the X and Y axis, comma-separated.
ValidTargets	Ground, Water	Collection of TargetableType		What types of targets are affected.
InvalidTargets		Collection of TargetableType		What types of targets are unaffected. Overrules ValidTargets.
ValidRelationships	Enemy, Neutral, Ally	PlayerRelationship		What player relationships are affected.
AffectsParent	False	Boolean		Can this warhead affect the actor that fired it.
AirThreshold	0c128	1D World Distance		If impact is above this altitude, warheads that would affect terrain ignore terrain target types (and either do nothing or perform their own checks).
Delay	0	Integer		Delay in ticks before applying the warhead effect. 0 = instant (old model).
DebugOverlayColor	FF0000	Color (RRGGBB[AA] notation)		The color used for this warhead's visualization in the world's WarheadDebugOverlay trait.

SpreadDamageWarhead

Apply damage in a specified range.

Inherits from: DamageWarhead.

Property	Default Value	Type	Attributes	Description
Spread	0c43	1D World Distance		Range between falloff steps.
Falloff	100, 37, 14, 5, 0	Collection of Integer		Damage percentage at each range step
Range		Collection of 1D World Distance		Ranges at which each Falloff step is defined. Overrides Spread.
DamageCalculationType	HitShape	DamageCalculationType		Controls the way damage is calculated. Possible values are 'HitShape', 'ClosestTargetablePosition' and 'CenterPosition'.
Damage	0	Integer		How much (raw) damage to deal.
DamageTypes		Collection of DamageType		Types of damage that this warhead causes. Leave empty for no damage types.
Versus		Dictionary with Key: String, Value: Integer		Damage percentage versus each armor type.
ValidTargets	Ground, Water	Collection of TargetableType		What types of targets are affected.
InvalidTargets		Collection of TargetableType		What types of targets are unaffected. Overrules ValidTargets.
ValidRelationships	Enemy, Neutral, Ally	PlayerRelationship		What player relationships are affected.
AffectsParent	False	Boolean		Can this warhead affect the actor that fired it.
AirThreshold	0c128	1D World Distance		If impact is above this altitude, warheads that would affect terrain ignore terrain target types (and either do nothing or perform their own checks).
Delay	0	Integer		Delay in ticks before applying the warhead effect. 0 = instant (old model).
DebugOverlayColor	FF0000	Color (RRGGBB[AA] notation)		The color used for this warhead's visualization in the world's WarheadDebugOverlay trait.

TargetDamageWarhead

Apply damage to the targeted actor.

Inherits from: DamageWarhead.

Property	Default Value	Type	Attributes	Description
Spread	0c0	1D World Distance		Damage will be applied to actors in this area. A value of zero means only targeted actor will be damaged.
Damage	0	Integer		How much (raw) damage to deal.
DamageTypes		Collection of DamageType		Types of damage that this warhead causes. Leave empty for no damage types.
Versus		Dictionary with Key: String, Value: Integer		Damage percentage versus each armor type.
ValidTargets	Ground, Water	Collection of TargetableType		What types of targets are affected.
InvalidTargets		Collection of TargetableType		What types of targets are unaffected. Overrules ValidTargets.
ValidRelationships	Enemy, Neutral, Ally	PlayerRelationship		What player relationships are affected.
AffectsParent	False	Boolean		Can this warhead affect the actor that fired it.
AirThreshold	0c128	1D World Distance		If impact is above this altitude, warheads that would affect terrain ignore terrain target types (and either do nothing or perform their own checks).
Delay	0	Integer		Delay in ticks before applying the warhead effect. 0 = instant (old model).
DebugOverlayColor	FF0000	Color (RRGGBB[AA] notation)		The color used for this warhead's visualization in the world's WarheadDebugOverlay trait.