Skip to content

Traits

Jump to bottom Edit New page
Cook Green edited this page Feb 4, 2017 · 102 revisions

This documentation is aimed at modders. It displays all traits with default values and developer commentary. Please do not edit it directly, but add new [Desc("String")] tags to the source code. This file has been automatically generated for version release-20161019 of OpenRA.

OpenRA.Mods.Cnc.Traits

AttackPopupTurreted

Actor's turret rises from the ground before attacking.

Requires traits: Building, Turreted, WithTurretedSpriteBody.

Property Default Value Type Description
CloseDelay 125 Integer How many game ticks should pass before closing the actor's turret.
DefaultFacing 0 Integer
ClosedDamageMultiplier 50 Integer The percentage of damage that is received while this actor is closed.
OpeningSequence opening String Sequence to play when opening.
ClosingSequence closing String Sequence to play when closing.
ClosedIdleSequence closed-idle String Idle sequence to play when closed.
Armaments primary, secondary Multiple String Armament names
Cursor String
OutsideRangeCursor String
AttackRequiresEnteringCell False Boolean Does the attack type require the attacker to enter the target's cell?
IgnoresVisibility False Boolean Does not care about shroud or fog. Enables the actor to launch an attack against a target even if he has no visibility of it.
Voice Action String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

ProductionAirdrop

Deliver the unit in production via skylift.

Property Default Value Type Description
ReadyAudio Reinforce String
ActorType c17 String Cargo aircraft used for delivery. Must have the `Aircraft` trait.
Produces (required) Multiple String e.g. Infantry, Vehicles, Aircraft, Buildings

IonCannonPower

Property Default Value Type Description
CameraActor String Actor to spawn when the attack starts
CameraRemoveDelay 25 Integer Amount of time to keep the camera alive
Effect ionsfx String Effect sequence sprite image
EffectSequence idle String Effect sequence to display
EffectPalette effect String
Weapon IonCannon String Which weapon to fire
WeaponDelay 7 Integer Apply the weapon impact this many ticks into the effect
ChargeTime 0 Integer Measured in seconds.
Icon String
Description String
LongDesc String
AllowMultiple False Boolean
OneShot False Boolean
Cursor ability String Cursor to display for using this support power.
StartFullyCharged False Boolean If set to true, the support power will be fully charged when it becomes available. Normal rules apply for subsequent charges.
Prerequisites Multiple String
BeginChargeSound String
BeginChargeSpeechNotification String
EndChargeSound String
EndChargeSpeechNotification String
SelectTargetSound String
SelectTargetSpeechNotification String
InsufficientPowerSound String
InsufficientPowerSpeechNotification String
LaunchSound String
LaunchSpeechNotification String
IncomingSound String
IncomingSpeechNotification String
DisplayTimerStances None Stance Defines to which players the timer is shown.
IconPalette chrome String Palette used for the icon.
DisplayBeacon False Boolean Beacons are only supported on the Airstrike, Paratroopers, and Nuke powers
BeaconPaletteIsPlayerPalette True Boolean
BeaconPalette player String
BeaconImage beacon String
BeaconPoster String
BeaconPosterPalette chrome String
ClockSequence clock String
ArrowSequence arrow String
CircleSequence circles String
DisplayRadarPing False Boolean
RadarPingDuration 125 Integer Measured in ticks.
OrderName IonCannonPowerInfoOrder String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

OpenRA.Mods.Cnc.Traits.Render

WithCargo

Renders the cargo loaded into the unit.

Requires traits: BodyOrientation, Cargo.

Property Default Value Type Description
LocalOffset 0,0,0 Multiple 3D World Vector Cargo position relative to turret or body in (forward, right, up) triples. The default offset should be in the middle of the list.
DisplayTypes Set of String Passenger CargoType to display.

WithDeliveryAnimation

Building animation to play when ProductionAirdrop is used to deliver units.

Requires trait: WithSpriteBody.

Property Default Value Type Description
ActiveSequence active String
IdleSequence idle String

WithGunboatBody

Requires traits: BodyOrientation, RenderSprites, Turreted.

Property Default Value Type Description
Turret primary String Turreted 'Turret' key to display
LeftSequence left String
RightSequence right String
WakeLeftSequence wake-left String
WakeRightSequence wake-right String
StartSequence String Animation to play when the actor is created.
Sequence idle String Animation to play when the actor is idle.
PauseAnimationWhenDisabled False Boolean Pause animation when actor is disabled.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithReloadingSpriteTurret

Renders ammo-dependent turret graphics for units with the Turreted trait.

Requires traits: AmmoPool, Armament, BodyOrientation, RenderSprites, Turreted.

Property Default Value Type Description
AmmoPoolName String AmmoPool to use for ammo-dependent sequences.
ReloadStages -1 Integer How many reload stages does this turret have. Defaults to AmmoPool's Ammo. Adds current reload stage to Sequence as suffix when a matching AmmoPool is present.
Sequence turret String Sequence name to use
AimSequence String Sequence name to use when prepared to fire
Turret primary String Turreted 'Turret' key to display
Recoils True Boolean Render recoil
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithRoof

Provides an overlay for the Tiberian Dawn hover craft.

Requires trait: RenderSprites.

Property Default Value Type Description
Sequence roof String

OpenRA.Mods.Common.AI

DummyAI

Property Default Value Type Description
Name Unnamed Bot String Ingame name this bot uses.

HackyAI

Property Default Value Type Description
Name Unnamed Bot String Ingame name this bot uses.
SquadSize 8 Integer Minimum number of units AI must have before attacking.
SquadSizeRandomBonus 30 Integer Random number of up to this many units is added to squad size when creating an attack squad.
BuildingQueues Building Set of String Production queues AI uses for buildings.
DefenseQueues Defense Set of String Production queues AI uses for defenses.
AssignRolesInterval 20 Integer Delay (in ticks) between giving out orders to units.
RushInterval 600 Integer Delay (in ticks) between attempting rush attacks.
AttackForceInterval 30 Integer Delay (in ticks) between updating squads.
MinimumAttackForceDelay 0 Integer Minimum delay (in ticks) between creating squads.
MinOrderQuotientPerTick 5 Integer Minimum portion of pending orders to issue each tick (e.g. 5 issues at least 1/5th of all pending orders). Excess orders remain queued for subsequent ticks.
MinimumExcessPower 0 Integer Minimum excess power the AI should try to maintain.
StructureProductionInactiveDelay 125 Integer Additional delay (in ticks) between structure production checks when there is no active production. StructureProductionRandomBonusDelay is added to this.
StructureProductionActiveDelay 0 Integer Additional delay (in ticks) added between structure production checks when actively building things. Note: The total delay is gamespeed OrderLatency x 4 + this + StructureProductionRandomBonusDelay.
StructureProductionRandomBonusDelay 10 Integer A random delay (in ticks) of up to this is added to active/inactive production delays.
StructureProductionResumeDelay 1500 Integer Delay (in ticks) until retrying to build structure after the last 3 consecutive attempts failed.
MaximumFailedPlacementAttempts 3 Integer After how many failed attempts to place a structure should AI give up and wait for StructureProductionResumeDelay before retrying.
MaxResourceCellsToCheck 3 Integer How many randomly chosen cells with resources to check when deciding refinery placement.
CheckForNewBasesDelay 1500 Integer Delay (in ticks) until rechecking for new BaseProviders.
MinimumDefenseRadius 5 Integer Minimum range at which to build defensive structures near a combat hotspot.
MaximumDefenseRadius 20 Integer Maximum range at which to build defensive structures near a combat hotspot.
NewProductionCashThreshold 5000 Integer Try to build another production building if there is too much cash.
IdleBaseUnitsMaximum 12 Integer Only produce units as long as there are less than this amount of units idling inside the base.
RushAttackScanRadius 15 Integer Radius in cells around enemy BaseBuilder (Construction Yard) where AI scans for targets to rush.
ProtectUnitScanRadius 15 Integer Radius in cells around the base that should be scanned for units to be protected.
RallyPointScanRadius 8 Integer Radius in cells around a factory scanned for rally points by the AI.
MinBaseRadius 2 Integer Minimum distance in cells from center of the base when checking for building placement.
MaxBaseRadius 20 Integer Radius in cells around the center of the base to expand.
RestrictMCVDeploymentFallbackToBase True Boolean Should deployment of additional MCVs be restricted to MaxBaseRadius if explicit deploy locations are missing or occupied?
CheckForWaterRadius 8 Integer Radius in cells around each building with ProvideBuildableArea to check for a 3x3 area of water where naval structures can be built. Should match maximum adjacency of naval structures.
WaterTerrainTypes Water Set of String Terrain types which are considered water for base building purposes.
HarvesterEnemyAvoidanceRadius 8c0 1D World Distance Avoid enemy actors nearby when searching for a new resource patch. Should be somewhere near the max weapon range.
UnitQueues Vehicle, Infantry, Plane, Ship, Aircraft Set of String Production queues AI uses for producing units.
ShouldRepairBuildings True Boolean Should the AI repair its buildings if damaged?
UnitsToBuild Dictionary What units to the AI should build. What % of the total army must be this type of unit.
UnitLimits Dictionary What units should the AI have a maximum limit to train.
BuildingFractions Dictionary What buildings to the AI should build. What % of the total base must be this type of building.
UnitsCommonNames (required) UnitCategories Tells the AI what unit types fall under the same common name. Supported entries are Mcv and ExcludeFromSquads.
BuildingCommonNames (required) BuildingCategories Tells the AI what building types fall under the same common name. Possible keys are ConstructionYard, Power, Refinery, Silo , Barracks, Production, VehiclesFactory, NavalProduction.
BuildingLimits Dictionary What buildings should the AI have a maximum limit to build.
PowerDecisions (Collection) List`1 Tells the AI how to use its support powers.
CapturingActorTypes Set of String Actor types that can capture other actors (via `Captures` or `ExternalCaptures`). Leave this empty to disable capturing.
CapturableActorTypes Set of String Actor types that can be targeted for capturing. Leave this empty to include all actors.
MinimumCaptureDelay 375 Integer Minimum delay (in ticks) between trying to capture with CapturingActorTypes.
MaximumCaptureTargetOptions 10 Integer Maximum number of options to consider for capturing. If a value less than 1 is given 1 will be used instead.
CheckCaptureTargetsForVisibility True Boolean Should visibility (Shroud, Fog, Cloak, etc) be considered when searching for capturable targets?
CapturableStances Enemy, Neutral Stance Player stances that capturers should attempt to target.

OpenRA.Mods.Common.Commands

ChatCommands

Enables commands triggered by typing them into the chatbox. Attach this to the world actor.

DevCommands

Enables developer cheats via the chatbox. Attach this to the world actor.

HelpCommand

Shows a list of available commands in the chatbox. Attach this to the world actor.

PlayerCommands

Allows the player to pause or surrender the game via the chatbox. Attach this to the world actor.

OpenRA.Mods.Common.Effects

Contrail

Draw a colored contrail behind this actor when they move.

Requires trait: BodyOrientation.

Property Default Value Type Description
Offset 0,0,0 3D World Vector Position relative to body
ZOffset 0 Integer Offset for Z sorting.
TrailLength 25 Integer Length of the trail (in ticks).
TrailWidth 0c64 1D World Distance Width of the trail.
Color FFFFFF Color RGB color of the contrail.
UsePlayerColor True Boolean Use player remap color instead of a custom color?

OpenRA.Mods.Common.Scripting

LuaScript

Part of the new Lua API.

Requires trait: SpawnMapActors.

Property Default Value Type Description
Scripts Set of String

ScriptTriggers

Allows map scripts to attach triggers to this actor via the Triggers global.

ScriptUpgradesCache

Allows granting upgrades to actors from Lua scripts.

Property Default Value Type Description
Upgrades Set of String Upgrades that can be granted from the scripts.

OpenRA.Mods.Common.Traits

AcceptsSupplies

Tag trait for SupplyTruck actors.

Aircraft

Property Default Value Type Description
CruiseAltitude 1c256 1D World Distance
IdealSeparation 1c682 1D World Distance
Repulsable True Boolean Whether the aircraft can be repulsed.
RepulsionSpeed -1 Integer The speed at which the aircraft is repulsed from other aircraft. Specify -1 for normal movement speed.
RepairBuildings Set of String
RearmBuildings Set of String
InitialFacing 0 Integer
TurnSpeed 255 Integer
Speed 1 Integer
MinAirborneAltitude 1 Integer Minimum altitude where this aircraft is considered airborne
LandableTerrainTypes Set of String
MoveIntoShroud True Boolean Can the actor be ordered to move in to shroud?
Voice Action String
AirborneUpgrades Multiple String The upgrades to grant to self while airborne.
CruisingUpgrades Multiple String The upgrades to grant to self while at cruise altitude.
CanHover False Boolean Can the actor hover in place mid-air? If not, then the actor will have to remain in motion (circle around).
LandWhenIdle True Boolean Will this actor try to land after it has no more commands?
TurnToLand False Boolean Does this actor need to turn before landing?
AbortOnResupply True Boolean Does this actor cancel its previous activity after resupplying?
LandAltitude 0c0 1D World Distance
MaximumPitch 28 1D World Angle How fast this actor ascends or descends when using horizontal take off/landing.
AltitudeVelocity 0c43 1D World Distance How fast this actor ascends or descends when using vertical take off/landing.
TakeoffSound String Sound to play when the actor is taking off.
LandingSound String Sound to play when the actor is landing.
WaitDistanceFromResupplyBase 3c0 1D World Distance The distance of the resupply base that the aircraft will wait for its turn.
NumberOfTicksToVerifyAvailableAirport 150 Integer The number of ticks that a airplane will wait to make a new search for an available airport.

AttackBomber

Property Default Value Type Description
Bombs primary String Armament name
Guns secondary String Armament name
FacingTolerance 2 Integer
Armaments primary, secondary Multiple String Armament names
Cursor String
OutsideRangeCursor String
AttackRequiresEnteringCell False Boolean Does the attack type require the attacker to enter the target's cell?
IgnoresVisibility False Boolean Does not care about shroud or fog. Enables the actor to launch an attack against a target even if he has no visibility of it.
Voice Action String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

AttackHeli

Property Default Value Type Description
FacingTolerance 1 Integer
Armaments primary, secondary Multiple String Armament names
Cursor String
OutsideRangeCursor String
AttackRequiresEnteringCell False Boolean Does the attack type require the attacker to enter the target's cell?
IgnoresVisibility False Boolean Does not care about shroud or fog. Enables the actor to launch an attack against a target even if he has no visibility of it.
Voice Action String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

AttackPlane

Requires trait: Aircraft.

Property Default Value Type Description
AttackTurnDelay 50 Integer Delay, in game ticks, before turning to attack.
FacingTolerance 1 Integer
Armaments primary, secondary Multiple String Armament names
Cursor String
OutsideRangeCursor String
AttackRequiresEnteringCell False Boolean Does the attack type require the attacker to enter the target's cell?
IgnoresVisibility False Boolean Does not care about shroud or fog. Enables the actor to launch an attack against a target even if he has no visibility of it.
Voice Action String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

FallsToEarth

Causes aircraft husks that are spawned in the air to crash to the ground.

Requires trait: Aircraft.

Property Default Value Type Description
Explosion UnitExplode String
Spins True Boolean
Moves False Boolean
Velocity 0c43 1D World Distance

FlyAwayOnIdle

Leave the map when idle.

ReturnOnIdle

Return to a player owned RearmBuildings. If none available, head back to base and circle over it.

Requires trait: Aircraft.

AmmoPool

Actor has a limited amount of ammo, after using it all the actor must reload in some way.

Property Default Value Type Description
Name primary String Name of this ammo pool, used to link armaments to this pool.
Ammo 1 Integer How much ammo does this pool contain when fully loaded.
InitialAmmo -1 Integer Initial ammo the actor is created with. Defaults to Ammo.
PipCount -1 Integer Defaults to value in Ammo. 0 means no visible pips.
PipType Green PipType PipType to use for loaded ammo.
PipTypeEmpty Transparent PipType PipType to use for empty ammo.
ReloadCount 1 Integer How much ammo is reloaded after a certain period.
RearmSound String Sound to play for each reloaded ammo magazine.
ReloadDelay 50 Integer Time to reload per ReloadCount on airfield etc.
SelfReloads False Boolean Whether or not ammo is replenished on its own.
SelfReloadDelay 50 Integer Time to reload per ReloadCount when actor 'SelfReloads'.
ResetOnFire False Boolean Whether or not reload timer should be reset when ammo has been fired.

Armament

Allows you to attach weapons to the unit (use @IdentifierSuffix for > 1)

Requires trait: AttackBase.

Property Default Value Type Description
Name primary String
Weapon (required) String Has to be defined in weapons.yaml as well.
AmmoPoolName primary String Which limited ammo pool (if present) should this armament be assigned to.
Turret primary String Which turret (if present) should this armament be assigned to.
FireDelay 0 Integer Time (in frames) until the weapon can fire again.
LocalOffset Multiple 3D World Vector Muzzle position relative to turret or body. (forward, right, up) triples
LocalYaw Multiple 1D World Angle Muzzle yaw relative to turret or body.
Recoil 0c0 1D World Distance Move the turret backwards when firing.
RecoilRecovery 0c9 1D World Distance Recoil recovery per-frame
MuzzleSequence String Muzzle flash sequence to render
MuzzlePalette effect String Palette to render Muzzle flash sequence in
MuzzleSplitFacings 0 Integer Use multiple muzzle images if non-zero
TargetStances Enemy Stance
ForceTargetStances Enemy, Neutral, Ally Stance
Cursor attack String
OutsideRangeCursor attackoutsiderange String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

Armor

Used to define weapon efficiency modifiers with different percentages per Type.

Property Default Value Type Description
Type String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

AttackCharge

Charges up before being able to attack.

Property Default Value Type Description
MaxCharges 1 Integer How many charges this actor has to attack with, once charged.
ReloadDelay 120 Integer Reload time for all charges (in ticks).
InitialChargeDelay 22 Integer Delay for initial charge attack (in ticks).
ChargeDelay 3 Integer Delay between charge attacks (in ticks).
ChargeAudio String Sound to play when actor charges.
Armaments primary, secondary Multiple String Armament names
Cursor String
OutsideRangeCursor String
AttackRequiresEnteringCell False Boolean Does the attack type require the attacker to enter the target's cell?
IgnoresVisibility False Boolean Does not care about shroud or fog. Enables the actor to launch an attack against a target even if he has no visibility of it.
Voice Action String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

AttackFollow

Actor will follow units until in range to attack them.

Property Default Value Type Description
Armaments primary, secondary Multiple String Armament names
Cursor String
OutsideRangeCursor String
AttackRequiresEnteringCell False Boolean Does the attack type require the attacker to enter the target's cell?
IgnoresVisibility False Boolean Does not care about shroud or fog. Enables the actor to launch an attack against a target even if he has no visibility of it.
Voice Action String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

AttackFrontal

Unit got to face the target

Property Default Value Type Description
FacingTolerance 1 Integer
Armaments primary, secondary Multiple String Armament names
Cursor String
OutsideRangeCursor String
AttackRequiresEnteringCell False Boolean Does the attack type require the attacker to enter the target's cell?
IgnoresVisibility False Boolean Does not care about shroud or fog. Enables the actor to launch an attack against a target even if he has no visibility of it.
Voice Action String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

AttackGarrisoned

Cargo can fire their weapons out of fire ports.

Requires trait: Cargo.

Property Default Value Type Description
PortOffsets (required) Multiple 3D World Vector Fire port offsets in local coordinates.
PortYaws (required) Multiple 1D World Angle Fire port yaw angles.
PortCones (required) Multiple 1D World Angle Fire port yaw cone angle.
MuzzlePalette effect String
Armaments primary, secondary Multiple String Armament names
Cursor String
OutsideRangeCursor String
AttackRequiresEnteringCell False Boolean Does the attack type require the attacker to enter the target's cell?
IgnoresVisibility False Boolean Does not care about shroud or fog. Enables the actor to launch an attack against a target even if he has no visibility of it.
Voice Action String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

AttackOmni

Property Default Value Type Description
Armaments primary, secondary Multiple String Armament names
Cursor String
OutsideRangeCursor String
AttackRequiresEnteringCell False Boolean Does the attack type require the attacker to enter the target's cell?
IgnoresVisibility False Boolean Does not care about shroud or fog. Enables the actor to launch an attack against a target even if he has no visibility of it.
Voice Action String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

AttackSuicides

Does a suicide attack where it moves next to the target when used in combination with Explodes.

Property Default Value Type Description
Voice Action String

AttackTurreted

Actor has a visual turret used to attack.

Requires trait: Turreted.

Property Default Value Type Description
Armaments primary, secondary Multiple String Armament names
Cursor String
OutsideRangeCursor String
AttackRequiresEnteringCell False Boolean Does the attack type require the attacker to enter the target's cell?
IgnoresVisibility False Boolean Does not care about shroud or fog. Enables the actor to launch an attack against a target even if he has no visibility of it.
Voice Action String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

AttackMove

Provides access to the attack-move command, which will make the actor automatically engage viable targets while moving to the destination.

Property Default Value Type Description
Voice Action String

AttackWander

Will AttackMove to a random location within MoveRadius when idle. This conflicts with player orders and should only be added to animal creeps.

Requires trait: AttackMove.

Property Default Value Type Description
WanderMoveRadius 1 Integer
ReduceMoveRadiusDelay 5 Integer Number of ticks to wait before decreasing the effective move radius.
MinMoveDelay 0 Integer Minimum amount of ticks the actor will sit idly before starting to wander.
MaxMoveDelay 0 Integer Maximum amount of ticks the actor will sit idly before starting to wander.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

AutoCarryable

Can be carried by units with the trait Carryall.

Requires trait: UpgradeManager.

Property Default Value Type Description
MinDistance 6c0 1D World Distance Required distance away from destination before requesting a pickup. Default is 6 cells.
CarryableUpgrades Multiple String The upgrades to grant to self while waiting or being carried.
LocalOffset 0,0,0 3D World Vector Carryall attachment point relative to body.

AutoCarryall

Automatically transports harvesters with the Carryable trait between resource fields and refineries.

Requires traits: Aircraft, BodyOrientation.

Property Default Value Type Description
LoadingDelay 0 Integer Delay on the ground while attaching an actor to the carryall.
UnloadingDelay 0 Integer Delay on the ground while detacting an actor to the carryall.
LocalOffset 0,0,0 3D World Vector Carryable attachment point relative to body.
DropRange 5c0 1D World Distance Radius around the target drop location that are considered if the target tile is blocked.
Voice Action String

AutoTarget

The actor will automatically engage the enemy when it is in range.

Requires trait: AttackBase.

Property Default Value Type Description
AllowMovement True Boolean It will try to hunt down the enemy if it is not set to defend.
ScanRadius -1 Integer Set to a value >1 to override weapons maximum range for this.
InitialStanceAI AttackAnything UnitStance Possible values are HoldFire, ReturnFire, Defend and AttackAnything. Used for computer-controlled players, both Lua-scripted and regular Skirmish AI alike.
InitialStance Defend UnitStance Possible values are HoldFire, ReturnFire, Defend and AttackAnything. Used for human players.
EnableStances True Boolean Allow the player to change the unit stance.
MinimumScanTimeInterval 3 Integer Ticks to wait until next AutoTarget: attempt.
MaximumScanTimeInterval 8 Integer Ticks to wait until next AutoTarget: attempt.
TargetWhenIdle True Boolean
TargetWhenDamaged True Boolean
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

AutoTargetIgnore

Will not get automatically targeted by enemy (like walls)

BlocksProjectiles

This actor blocks bullets and missiles with 'Blockable' property.

Property Default Value Type Description
Height 1c0 1D World Distance
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

BodyOrientation

Property Default Value Type Description
QuantizedFacings -1 Integer Number of facings for gameplay calculations. -1 indicates auto-detection from another trait
CameraPitch 113 1D World Angle Camera pitch for rotation calculations
UseClassicPerspectiveFudge True Boolean Fudge the coordinate system angles like the early games.
UseClassicFacingFudge False Boolean Fudge the coordinate system angles like the early games.

Buildable

Property Default Value Type Description
Prerequisites Multiple String The prerequisite names that must be available before this can be built. This can be prefixed with ! to invert the prerequisite (disabling production if the prerequisite is available) and/or ~ to hide the actor from the production palette if the prerequisite is not available. Prerequisites are granted by actors with the ProvidesPrerequisite trait.
Queue Set of String Production queue(s) that can produce this.
BuildAtProductionType String Override the production structure type (from the Production Produces list) that this unit should be built at.
BuildLimit 0 Integer Disable production when there are more than this many of this actor on the battlefield. Set to 0 to disable.
ForceFaction String Force a specific faction variant, overriding the faction of the producing actor.
IconPalette chrome String Palette used for the production icon.
BuildDuration -1 Integer Base build time in frames (-1 indicates to use the unit's Value).
BuildDurationModifier 60 Integer Percentage modifier to apply to the build duration.
BuildPaletteOrder 9999 Integer

BaseBuilding

Tag trait for construction yard and MCVs. Used by the cycle bases hotkey to identify actors.

BaseProvider

Limits the zone where buildings can be constructed to a radius around this actor.

Property Default Value Type Description
Range 10c0 1D World Distance
Cooldown 0 Integer
InitialDelay 0 Integer

Bib

Requires traits: Building, RenderSprites.

Property Default Value Type Description
Sequence bib String
Palette terrain String
HasMinibib False Boolean

Bridge

Requires traits: Building, Health.

Property Default Value Type Description
Long False Boolean
RepairPropagationDelay 20 Integer Delay (in ticks) between repairing adjacent spans in long bridges
Template 0 UInt16
DamagedTemplate 0 UInt16
DestroyedTemplate 0 UInt16
DestroyedPlusNorthTemplate 0 UInt16
DestroyedPlusSouthTemplate 0 UInt16
DestroyedPlusBothTemplate 0 UInt16
ShorePieces br1, br2 Multiple String
NorthOffset Multiple Integer
SouthOffset Multiple Integer
DemolishWeapon Demolish String The name of the weapon to use when demolishing the bridge

BridgeHut

Allows bridges to be targeted for demolition and repair.

GivesBuildableArea

Remove this trait to limit base-walking by cheap or defensive buildings.

Building

Property Default Value Type Description
TerrainTypes Set of String Where you are allowed to place the building (Water, Clear, ...)
Adjacent 2 Integer The range to the next building it can be constructed. Set it higher for walls.
Footprint x String x means space it blocks, _ is a part that is passable by actors.
Dimensions 1,1 2D Cell Vector
RequiresBaseProvider False Boolean
AllowInvalidPlacement False Boolean
RemoveSmudgesOnBuild True Boolean Clear smudges from underneath the building footprint.
RemoveSmudgesOnSell True Boolean Clear smudges from underneath the building footprint on sell.
RemoveSmudgesOnTransform True Boolean Clear smudges from underneath the building footprint on transform.
BuildSounds placbldg.aud, build5.aud Multiple String
UndeploySounds cashturn.aud Multiple String

BuildingInfluence

A dictionary of buildings placed on the map. Attach this to the world actor.

Exit

Where the unit should leave the building. Multiples are allowed if IDs are added: Exit@2, ...

Property Default Value Type Description
SpawnOffset 0,0,0 3D World Vector Offset at which that the exiting actor is spawned relative to the center of the producing actor.
ExitCell 0,0 2D Cell Vector Cell offset where the exiting actor enters the ActorMap relative to the topleft cell of the producing actor.
Facing -1 Integer
MoveIntoWorld True Boolean AttackMove to a RallyPoint or stay where you are spawned.
ExitDelay 0 Integer Number of ticks to wait before moving into the world.

FreeActor

Player receives a unit for free once the building is placed. This also works for structures. If you want more than one unit to appear copy this section and assign IDs like FreeActor@2, ...

Property Default Value Type Description
Actor (required) String Name of the actor.
SpawnOffset 0,0 2D Cell Vector Offset relative to the top-left cell of the building.
Facing 0 Integer Which direction the unit should face.

FreeActorWithDelivery

Player receives a unit for free once the building is placed. If you want more than one unit to be delivered, copy this section and assign IDs like FreeActorWithDelivery@2, ...

Property Default Value Type Description
DeliveringActor (required) String Name of the delivering actor. This actor must have the `Carryall` trait
SpawnLocation 0,0 2D Cell Position Cell coordinates for spawning the delivering actor. If left blank, the closest edge cell will be chosen.
DeliveryOffset 0,0 2D Cell Vector Offset relative to the top-left cell of the building.
Actor (required) String Name of the actor.
SpawnOffset 0,0 2D Cell Vector Offset relative to the top-left cell of the building.
Facing 0 Integer Which direction the unit should face.

Gate

Will open and be passable for actors that appear friendly when there are no enemies in range.

Property Default Value Type Description
OpeningSound String
ClosingSound String
CloseDelay 150 Integer Ticks until the gate closes.
TransitionDelay 33 Integer Ticks until the gate is considered open.
BlocksProjectilesHeight 640 Integer Blocks bullets scaled to open value.
TerrainTypes Set of String Where you are allowed to place the building (Water, Clear, ...)
Adjacent 2 Integer The range to the next building it can be constructed. Set it higher for walls.
Footprint x String x means space it blocks, _ is a part that is passable by actors.
Dimensions 1,1 2D Cell Vector
RequiresBaseProvider False Boolean
AllowInvalidPlacement False Boolean
RemoveSmudgesOnBuild True Boolean Clear smudges from underneath the building footprint.
RemoveSmudgesOnSell True Boolean Clear smudges from underneath the building footprint on sell.
RemoveSmudgesOnTransform True Boolean Clear smudges from underneath the building footprint on transform.
BuildSounds placbldg.aud, build5.aud Multiple String
UndeploySounds cashturn.aud Multiple String

LineBuild

Place the second actor in line to build more of the same at once (used for walls).

Property Default Value Type Description
Range 5 Integer The maximum allowed length of the line.
NodeTypes wall Set of String LineBuildNode 'Types' to attach to.

LineBuildNode

LineBuild actors attach to LineBuildNodes.

Property Default Value Type Description
Types wall Set of String This actor is of LineBuild 'NodeType'...
Connections 1,0, 0,1, -1,0, 0,-1 Multiple 2D Cell Vector Cells (outside the footprint) that contain cells that can connect to this actor.

PrimaryBuilding

Used together with ClassicProductionQueue.

Requires trait: UpgradeManager.

Property Default Value Type Description
Upgrades primary Multiple String The upgrades to grant while the primary building.
SelectionNotification PrimaryBuildingSelected String The speech notification to play when selecting a primary building.

RallyPoint

Used to waypoint units after production or repair is finished.

Property Default Value Type Description
Image rallypoint String
FlagSequence flag String
CirclesSequence circles String
Palette player String Custom indicator palette name
IsPlayerPalette True Boolean Custom palette is a player palette BaseName
Offset 1,3 2D Cell Vector

Refinery

Requires trait: WithSpriteBody.

Property Default Value Type Description
DockAngle 0 Integer Actual harvester facing when docking, 0-255 counter-clock-wise.
DockOffset 0,0 2D Cell Vector Docking cell relative to top-left cell.
IsDragRequired False Boolean Does the refinery require the harvester to be dragged in?
DragOffset 0,0,0 3D World Vector Vector by which the harvester will be dragged when docking.
DragLength 0 Integer In how many steps to perform the dragging?
DiscardExcessResources False Boolean Discard resources once silo capacity has been reached.
ShowTicks True Boolean
TickLifetime 30 Integer
TickVelocity 2 Integer
TickRate 10 Integer

RepairableBuilding

Building can be repaired by the repair button.

Requires trait: Health.

Property Default Value Type Description
RepairPercent 20 Integer
RepairInterval 24 Integer
RepairStep 7 Integer
RepairBonuses 100, 150, 175, 200, 220, 240, 260, 280, 300 Multiple Integer
CancelWhenDisabled False Boolean
IndicatorImage allyrepair String
IndicatorSequence repair String
IndicatorPalette String Overrides the IndicatorPalettePrefix.
IndicatorPalettePrefix player String Suffixed by the internal repairing player name.
PlayerExperience 0 Integer Experience gained by a player for repairing structures of allied players.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

RepairsUnits

Property Default Value Type Description
ValuePercentage 20 Integer Cost in % of the unit value to fully repair the unit.
HpPerStep 10 Integer
Interval 24 Integer Time (in ticks) between two repair steps.
StartRepairingNotification Repairing String The sound played when starting to repair a unit.
FinishRepairingNotification String The sound played when repairing a unit is done.
PlayerExperience 0 Integer Experience gained by the player owning this actor for repairing an allied unit.

Reservable

Reserve landing places for aircraft.

Burns

This actor will play a fire animation over its body and take damage over time.

Requires trait: RenderSprites.

Property Default Value Type Description
Anim 1 String
Damage 1 Integer
Interval 8 Integer

Capturable

This actor can be captured by a unit with Captures: trait.

Property Default Value Type Description
Type building String Type listed under Types in Captures: trait of actors that can capture this).
AllowAllies False Boolean
AllowNeutral True Boolean
AllowEnemies True Boolean
CaptureThreshold 50 Integer Health percentage the target must be at (or below) before it can be captured.
CancelActivity False Boolean

Captures

This actor can capture other actors which have the Capturable: trait.

Property Default Value Type Description
CaptureTypes building Set of String Types of actors that it can capture, as long as the type also exists in the Capturable Type: trait.
Sabotage True Boolean Unit will do damage to the actor instead of capturing it. Unit is destroyed when sabotaging.
SabotageHPRemoval 50 Integer Only used if Sabotage=true. Sabotage damage expressed as a percentage of enemy health removed.
PlayerExperience 0 Integer Experience granted to the capturing player.
PlayerExperienceStances Enemy Stance Stance that the structure's previous owner needs to have for the capturing player to receive Experience.
SabotageCursor capture String
EnterCursor enter String
EnterBlockedCursor enter-blocked String
Voice Action String

Cargo

This actor can transport Passenger actors.

Requires trait: UpgradeManager.

Property Default Value Type Description
MaxWeight 0 Integer The maximum sum of Passenger.Weight that this actor can support.
PipCount 0 Integer Number of pips to display when this actor is selected.
Types Set of String `Passenger.CargoType`s that can be loaded into this actor.
InitialUnits Multiple String A list of actor types that are initially spawned into this actor.
EjectOnSell True Boolean When this actor is sold should all of its passengers be unloaded?
EjectOnDeath False Boolean When this actor dies should all of its passengers be unloaded?
UnloadTerrainTypes Set of String Terrain types that this actor is allowed to eject actors onto. Leave empty for all terrain types.
UnloadVoice Action String Voice to play when ordered to unload the passengers.
PassengerFacing 128 Integer Which direction the passenger will face (relative to the transport) when unloading.
UnloadCursor deploy String Cursor to display when able to unload the passengers.
UnloadBlockedCursor deploy-blocked String Cursor to display when unable to unload the passengers.
LoadingUpgrades Multiple String The upgrades to grant to self while loading cargo.

Carryable

Can be carried by actors with the Carryall trait.

Requires trait: UpgradeManager.

Property Default Value Type Description
CarryableUpgrades Multiple String The upgrades to grant to self while waiting or being carried.
LocalOffset 0,0,0 3D World Vector Carryall attachment point relative to body.

Carryall

Transports actors with the Carryable trait.

Requires traits: Aircraft, BodyOrientation.

Property Default Value Type Description
LoadingDelay 0 Integer Delay on the ground while attaching an actor to the carryall.
UnloadingDelay 0 Integer Delay on the ground while detacting an actor to the carryall.
LocalOffset 0,0,0 3D World Vector Carryable attachment point relative to body.
DropRange 5c0 1D World Distance Radius around the target drop location that are considered if the target tile is blocked.
Voice Action String

CashTrickler

Lets the actor generate cash in a set periodic time.

Property Default Value Type Description
Period 50 Integer Number of ticks to wait between giving money.
Amount 15 Integer Amount of money to give each time.
ShowTicks True Boolean Whether to show the cash tick indicators (+$15 rising from actor).
CaptureAmount 0 Integer Amount of money awarded for capturing the actor.

Cloak

This unit can cloak and uncloak in specific situations.

Property Default Value Type Description
InitialDelay 10 Integer Measured in game ticks.
CloakDelay 30 Integer Measured in game ticks.
UncloakOn Attack, Unload, Infiltrate, Demolish, Dock UncloakType Events leading to the actor getting uncloaked. Possible values are: Attack, Move, Unload, Infiltrate, Demolish, Dock and Damage
CloakSound String
UncloakSound String
Palette cloak String
IsPlayerPalette False Boolean
CloakTypes Cloak Set of String
WhileCloakedUpgrades Multiple String The upgrades to grant to self while cloaked.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

CombatDebugOverlay

Displays fireports, muzzle offsets, and hit areas in developer mode.

Crate

Requires trait: RenderSprites.

Property Default Value Type Description
Lifetime 0 Integer Length of time (in seconds) until the crate gets removed automatically. A value of zero disables auto-removal.
TerrainTypes Set of String Allowed to land on.
CrushClass crate String Define actors that can collect crates by setting this into the Crushes field from the Mobile trait.

CrateAction

Property Default Value Type Description
SelectionShares 10 Integer Chance of getting this crate, assuming the collector is compatible.
Effect String An animation defined in sequence yaml(s) to draw.
Palette effect String Palette to draw the animation in.
Notification String Audio clip to play when the crate is collected.
TimeDelay 0 Integer The earliest time (in ticks) that this crate action can occur on.
Prerequisites Multiple String Only allow this crate action when the collector has these prerequisites
ExcludedActorTypes Multiple String Actor types that this crate action will not occur for.

DuplicateUnitCrateAction

Creates duplicates of the actor that collects the crate.

Property Default Value Type Description
MaxAmount 2 Integer The maximum number of duplicates to make.
MinAmount 1 Integer The minimum number of duplicates to make. Overrules MaxDuplicatesWorth.
MaxDuplicateValue -1 Integer The maximum total value allowed for the duplicates. Duplication stops if the total worth will exceed this number. -1 = no limit
MaxRadius 4 Integer The maximum radius (in cells) that duplicates can be spawned.
ValidTargets Ground, Water Set of String The list of unit target types we are allowed to duplicate.
ValidFactions Set of String Which factions this crate action can occur for.
Owner String Is the new duplicates given to a specific owner, regardless of whom collected it?
SelectionShares 10 Integer Chance of getting this crate, assuming the collector is compatible.
Effect String An animation defined in sequence yaml(s) to draw.
Palette effect String Palette to draw the animation in.
Notification String Audio clip to play when the crate is collected.
TimeDelay 0 Integer The earliest time (in ticks) that this crate action can occur on.
Prerequisites Multiple String Only allow this crate action when the collector has these prerequisites
ExcludedActorTypes Multiple String Actor types that this crate action will not occur for.

ExplodeCrateAction

Fires a weapon at the location when collected.

Property Default Value Type Description
Weapon (required) String The weapon to fire upon collection.
SelectionShares 10 Integer Chance of getting this crate, assuming the collector is compatible.
Effect String An animation defined in sequence yaml(s) to draw.
Palette effect String Palette to draw the animation in.
Notification String Audio clip to play when the crate is collected.
TimeDelay 0 Integer The earliest time (in ticks) that this crate action can occur on.
Prerequisites Multiple String Only allow this crate action when the collector has these prerequisites
ExcludedActorTypes Multiple String Actor types that this crate action will not occur for.

GiveCashCrateAction

Gives cash to the collector.

Property Default Value Type Description
Amount 2000 Integer Amount of cash to give.
UseCashTick False Boolean Should the collected amount be displayed as a cash tick?
SelectionShares 10 Integer Chance of getting this crate, assuming the collector is compatible.
Effect String An animation defined in sequence yaml(s) to draw.
Palette effect String Palette to draw the animation in.
Notification String Audio clip to play when the crate is collected.
TimeDelay 0 Integer The earliest time (in ticks) that this crate action can occur on.
Prerequisites Multiple String Only allow this crate action when the collector has these prerequisites
ExcludedActorTypes Multiple String Actor types that this crate action will not occur for.

GiveMcvCrateAction

Spawns units when collected. Adjust selection shares when player has no base.

Property Default Value Type Description
NoBaseSelectionShares 1000 Integer The selection shares to use if the collector has no base.
Units (required) Multiple String The list of units to spawn.
ValidFactions Set of String Factions that are allowed to trigger this action.
Owner String Override the owner of the newly spawned unit: e.g. Creeps or Neutral
SelectionShares 10 Integer Chance of getting this crate, assuming the collector is compatible.
Effect String An animation defined in sequence yaml(s) to draw.
Palette effect String Palette to draw the animation in.
Notification String Audio clip to play when the crate is collected.
TimeDelay 0 Integer The earliest time (in ticks) that this crate action can occur on.
Prerequisites Multiple String Only allow this crate action when the collector has these prerequisites
ExcludedActorTypes Multiple String Actor types that this crate action will not occur for.

GiveUnitCrateAction

Spawns units when collected.

Property Default Value Type Description
Units (required) Multiple String The list of units to spawn.
ValidFactions Set of String Factions that are allowed to trigger this action.
Owner String Override the owner of the newly spawned unit: e.g. Creeps or Neutral
SelectionShares 10 Integer Chance of getting this crate, assuming the collector is compatible.
Effect String An animation defined in sequence yaml(s) to draw.
Palette effect String Palette to draw the animation in.
Notification String Audio clip to play when the crate is collected.
TimeDelay 0 Integer The earliest time (in ticks) that this crate action can occur on.
Prerequisites Multiple String Only allow this crate action when the collector has these prerequisites
ExcludedActorTypes Multiple String Actor types that this crate action will not occur for.

GrantUpgradeCrateAction

Grants an upgrade to the collector.

Property Default Value Type Description
Upgrades (required) Multiple String The upgrades to apply.
Duration 0 Integer Duration of the upgrade (in ticks). Set to 0 for a permanent upgrade.
Range 0c3 1D World Distance The range to search for extra collectors in. Extra collectors will also be granted the crate action.
MaxExtraCollectors 4 Integer The maximum number of extra collectors to grant the crate action to. -1 = no limit
SelectionShares 10 Integer Chance of getting this crate, assuming the collector is compatible.
Effect String An animation defined in sequence yaml(s) to draw.
Palette effect String Palette to draw the animation in.
Notification String Audio clip to play when the crate is collected.
TimeDelay 0 Integer The earliest time (in ticks) that this crate action can occur on.
Prerequisites Multiple String Only allow this crate action when the collector has these prerequisites
ExcludedActorTypes Multiple String Actor types that this crate action will not occur for.

HealUnitsCrateAction

Heals all actors that belong to the owner of the collector.

Property Default Value Type Description
SelectionShares 10 Integer Chance of getting this crate, assuming the collector is compatible.
Effect String An animation defined in sequence yaml(s) to draw.
Palette effect String Palette to draw the animation in.
Notification String Audio clip to play when the crate is collected.
TimeDelay 0 Integer The earliest time (in ticks) that this crate action can occur on.
Prerequisites Multiple String Only allow this crate action when the collector has these prerequisites
ExcludedActorTypes Multiple String Actor types that this crate action will not occur for.

HideMapCrateAction

Hides the entire map in shroud.

Property Default Value Type Description
IncludeAllies False Boolean Should the map also be hidden for the allies of the collector's owner?
SelectionShares 10 Integer Chance of getting this crate, assuming the collector is compatible.
Effect String An animation defined in sequence yaml(s) to draw.
Palette effect String Palette to draw the animation in.
Notification String Audio clip to play when the crate is collected.
TimeDelay 0 Integer The earliest time (in ticks) that this crate action can occur on.
Prerequisites Multiple String Only allow this crate action when the collector has these prerequisites
ExcludedActorTypes Multiple String Actor types that this crate action will not occur for.

LevelUpCrateAction

Gives experience levels to the collector.

Property Default Value Type Description
Levels 1 Integer Number of experience levels to give.
Range 0c3 1D World Distance The range to search for extra collectors in. Extra collectors will also be granted the crate action.
MaxExtraCollectors 4 Integer The maximum number of extra collectors to grant the crate action to.
SelectionShares 10 Integer Chance of getting this crate, assuming the collector is compatible.
Effect String An animation defined in sequence yaml(s) to draw.
Palette effect String Palette to draw the animation in.
Notification String Audio clip to play when the crate is collected.
TimeDelay 0 Integer The earliest time (in ticks) that this crate action can occur on.
Prerequisites Multiple String Only allow this crate action when the collector has these prerequisites
ExcludedActorTypes Multiple String Actor types that this crate action will not occur for.

RevealMapCrateAction

Reveals the entire map.

Property Default Value Type Description
IncludeAllies False Boolean Should the map also be revealed for the allies of the collector's owner?
SelectionShares 10 Integer Chance of getting this crate, assuming the collector is compatible.
Effect String An animation defined in sequence yaml(s) to draw.
Palette effect String Palette to draw the animation in.
Notification String Audio clip to play when the crate is collected.
TimeDelay 0 Integer The earliest time (in ticks) that this crate action can occur on.
Prerequisites Multiple String Only allow this crate action when the collector has these prerequisites
ExcludedActorTypes Multiple String Actor types that this crate action will not occur for.

SupportPowerCrateAction

Gives a supportpower to the collector.

Property Default Value Type Description
Proxy (required) String Which proxy actor, which grants the support power, to spawn.
SelectionShares 10 Integer Chance of getting this crate, assuming the collector is compatible.
Effect String An animation defined in sequence yaml(s) to draw.
Palette effect String Palette to draw the animation in.
Notification String Audio clip to play when the crate is collected.
TimeDelay 0 Integer The earliest time (in ticks) that this crate action can occur on.
Prerequisites Multiple String Only allow this crate action when the collector has these prerequisites
ExcludedActorTypes Multiple String Actor types that this crate action will not occur for.

CreatesShroud

Property Default Value Type Description
Range 0c0 1D World Distance
Type Footprint VisibilityType Possible values are CenterPosition (measure range from the center) and Footprint (measure range from the footprint)

Crushable

This actor is crushable.

Property Default Value Type Description
CrushSound String Sound to play when being crushed.
CrushClasses infantry Set of String Which crush classes does this actor belong to.
WarnProbability 75 Integer Probability of mobile actors noticing and evading a crush attempt.
CrushedByFriendlies False Boolean Will friendly units just crush me instead of pathing around.

CustomSelectionSize

Special case trait for actors that need to define targetable area and screen map bounds manually.

Property Default Value Type Description
CustomBounds (required) Multiple Integer

CustomSellValue

Allow a non-standard sell/repair value to avoid buy-sell exploits.

Property Default Value Type Description
Value (required) Integer

DamagedByTerrain

This actor receives damage from the given weapon when on the specified terrain type.

Requires trait: Health.

Property Default Value Type Description
Damage (required) Integer Amount of damage received per DamageInterval ticks.
DamageInterval 0 Integer Delay between receiving damage.
DamageTypes Set of String Apply the damage using these damagetypes.
Terrain (required) Multiple String Terrain types where the actor will take damage.
DamageThreshold 0 Integer Percentage health below which the actor will not receive further damage.
StartOnThreshold False Boolean Inflict damage down to the DamageThreshold when the actor gets created on damaging terrain.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

Demolishable

Handle demolitions from C4 explosives.

Property Default Value Type Description
PreventsEjectOnDeath False Boolean If true and this actor has EjectOnDeath, no actor will be spawned.

Demolition

Property Default Value Type Description
DetonationDelay 45 Integer Delay to demolish the target once the explosive device is planted. Measured in game ticks. Default is 1.8 seconds.
Flashes 3 Integer Number of times to flash the target.
FlashesDelay 4 Integer Delay before the flashing starts.
FlashInterval 4 Integer Interval between each flash.
FlashDuration 3 Integer Duration of each flash.
EnterBehaviour Exit EnterBehaviour Behaviour when entering the structure. Possible values are Exit, Suicide, Dispose.
Voice Action String Voice string when planting explosive charges.
Cursor c4 String

DetectCloaked

Actor can reveal Cloak actors in a specified range.

Property Default Value Type Description
CloakTypes Cloak Set of String Specific cloak classifications I can reveal.
Range 5c0 1D World Distance
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

EditorTilesetFilter

Property Default Value Type Description
RequireTilesets Set of String
ExcludeTilesets Set of String

EjectOnDeath

Eject a ground soldier or a paratrooper while in the air.

Property Default Value Type Description
PilotActor E1 String Name of the unit to eject. This actor type needs to have the Parachutable trait defined.
SuccessRate 50 Integer Probability that the aircraft's pilot gets ejected once the aircraft is destroyed.
ChuteSound chute1.aud String Sound to play when ejecting the pilot from the aircraft.
EjectInAir False Boolean Can a destroyed aircraft eject its pilot while it has not yet fallen to ground level?
EjectOnGround False Boolean Can a destroyed aircraft eject its pilot when it falls to ground level?
AllowUnsuitableCell False Boolean Risks stuck units when they don't have the Paratrooper trait.

EmitInfantryOnSell

Spawn new actors when sold.

Property Default Value Type Description
ValuePercent 40 Integer
MinHpPercent 30 Integer
ActorTypes e1 Multiple String Be sure to use lowercase. Default value is "e1".
Factions Set of String Spawns actors only if the selling player's faction is in this list. Leave empty to allow all factions by default.

EngineerRepair

Can instantly repair other actors, but gets consumed afterwards.

Property Default Value Type Description
Voice Action String
EnterBehaviour Dispose EnterBehaviour Behaviour when entering the structure. Possible values are Exit, Suicide, Dispose.

EngineerRepairable

Eligible for instant repair.

ExitsDebugOverlay

Displays Exit data for factories.

Requires trait: Exit.

Property Default Value Type Description
DrawPerimiterCellVectors True Boolean Should cell vectors be drawn for each perimeter cell?
DrawExitCellVectors True Boolean Should cell vectors be drawn for each exit cell?
DrawSpawnOffsetLines True Boolean Should lines be drawn for each exit (from spawn offset to the center of the exit cell)?

Explodes

This actor explodes when killed.

Requires trait: Health.

Property Default Value Type Description
Weapon (required) String Weapon to use for explosion if ammo/payload is loaded.
EmptyWeapon UnitExplode String Weapon to use for explosion if no ammo/payload is loaded.
LoadedChance 100 Integer Chance that the explosion will use Weapon if the actor has ammo/payload.
Chance 100 Integer Chance that this actor will explode at all.
DamageThreshold 0 Integer Health level at which actor will explode.
DeathTypes Set of String DeathType(s) that trigger the explosion. Leave empty to always trigger an explosion.

ExplosionOnDamageTransition

This actor triggers an explosion on itself when transitioning to a specific damage state.

Requires trait: Health.

Property Default Value Type Description
Weapon (required) String Weapon to use for explosion.
DamageState Heavy DamageState At which damage state explosion will trigger.
TriggerOnlyOnce False Boolean Should the explosion only be triggered once?

ExternalCapturable

This actor can be captured by a unit with ExternalCaptures: trait.

Property Default Value Type Description
Type building String Type of actor (the ExternalCaptures: trait defines what Types it can capture).
AllowAllies False Boolean
AllowNeutral True Boolean
AllowEnemies True Boolean
CaptureCompleteTime 15 Integer Seconds it takes to change the owner. You might want to add a ExternalCapturableBar: trait, too.
PreventsAutoTarget True Boolean Whether to prevent autotargeting this actor while it is being captured by an ally.

ExternalCapturableBar

Visualize the remaining CaptureCompleteTime from ExternalCapturable: trait.

Requires trait: ExternalCapturable.

ExternalCaptures

This actor can capture other actors which have the ExternalCapturable: trait.

Property Default Value Type Description
CaptureTypes building Set of String Types of actors that it can capture, as long as the type also exists in the ExternalCapturable Type: trait.
ConsumeActor False Boolean Destroy the unit after capturing.
PlayerExperience 0 Integer Experience granted to the capturing player.
PlayerExperienceStances Enemy Stance Stance that the structure's previous owner needs to have for the capturing player to receive Experience.
Voice Action String
CaptureCursor ability String
CaptureBlockedCursor move-blocked String

GainsExperience

This actor's experience increases when it has killed a GivesExperience actor.

Requires traits: UpgradeManager, Valued.

Property Default Value Type Description
Upgrades (required) Dictionary Upgrades to grant at each level. Key is the XP requirements for each level as a percentage of our own value. Value is a list of the upgrade types to grant
LevelUpPalette effect String Palette for the level up sprite.
SuppressLevelupAnimation True Boolean Should the level-up animation be suppressed when actor is created?

GivesBounty

When killed, this actor causes the attacking player to receive money.

Property Default Value Type Description
Percentage 10 Integer Percentage of the killed actor's Cost or CustomSellValue to be given.
LevelMod 125 Integer Scale bounty based on the veterancy of the killed unit. The value is given in percent.
ValidStances Enemy, Neutral Stance Stance the attacking player needs to receive the bounty.
ShowBounty True Boolean Whether to show a floating text announcing the won bounty.
DeathTypes Set of String DeathTypes for which a bounty should be granted. Use an empty list (the default) to allow all DeathTypes.

GivesExperience

This actor gives experience to a GainsExperience actor when they are killed.

Property Default Value Type Description
Experience -1 Integer If -1, use the value of the unit cost.
ValidStances Enemy, Neutral Stance Stance the attacking player needs to receive the experience.
ActorExperienceModifier 10000 Integer Percentage of the `Experience` value that is being granted to the killing actor.
PlayerExperienceModifier 0 Integer Percentage of the `Experience` value that is being granted to the player owning the killing actor.

GlobalUpgradable

Grants upgrades to the actor this is attached to when prerequisites are available.

Requires trait: UpgradeManager.

Property Default Value Type Description
Upgrades (required) Multiple String List of upgrades to apply.
Prerequisites (required) Multiple String List of required prerequisites.

Guard

The player can give this unit the order to follow and protect friendly units with the Guardable trait.

Property Default Value Type Description
Voice Action String

Guardable

This unit can be guarded (followed and protected) by a Guard unit.

Property Default Value Type Description
Range 2c0 1D World Distance Maximum range that guarding actors will maintain.

Harvester

Requires trait: Mobile.

Property Default Value Type Description
DeliveryBuildings Set of String
SearchForDeliveryBuildingDelay 125 Integer How long (in ticks) to wait until (re-)checking for a nearby available DeliveryBuilding if not yet linked to one.
UnblockCell 0,4 2D Cell Vector Cell to move to when automatically unblocking DeliveryBuilding.
Capacity 28 Integer How much resources it can carry.
BaleLoadDelay 4 Integer
BaleUnloadDelay 4 Integer How fast it can dump it's carryage.
PipCount 7 Integer How many squares to show the fill level.
HarvestFacings 0 Integer
Resources Set of String Which resources it can harvest.
FullyLoadedSpeed 85 Integer Percentage of maximum speed when fully loaded.
SearchOnCreation True Boolean Automatically scan for resources when created.
SearchFromProcRadius 24 Integer Initial search radius (in cells) from the refinery that created us.
SearchFromOrderRadius 12 Integer Search radius (in cells) from the last harvest order location to find more resources.
MaxIdleDuration 25 Integer Maximum duration of being idle before queueing a Wait activity.
WaitDuration 25 Integer Duration to wait before becoming idle again.
HarvestVoice Action String
DeliverVoice Action String

Health

Property Default Value Type Description
HP 0 Integer HitPoints
NotifyAppliedDamage True Boolean Trigger interfaces such as AnnounceOnKill?
Shape IHitShape

Huntable

This actor can be targeted by the Hunt activity.

Husk

Spawns remains of a husk actor with the correct facing.

Property Default Value Type Description
AllowedTerrain Set of String

IgnoresCloak

This actor does not care about any type of cloak its targets might have, regardless of distance.

IgnoresDisguise

Allows automatic targeting of disguised actors.

Immobile

Property Default Value Type Description
OccupiesSpace True Boolean

ScaredyCat

Makes the unit automatically run around when taking damage.

Requires trait: Mobile.

Property Default Value Type Description
PanicLength 250 Integer How long (in ticks) the actor should panic for.
PanicSpeedModifier 200 Integer Panic movement speed as a percentage of the normal speed.
AttackPanicChance 20 Integer Chance (out of 100) the unit has to enter panic mode when attacked.
PanicSequencePrefix panic- String

TakeCover

Make the unit go prone when under attack, in an attempt to reduce damage.

Requires trait: BodyOrientation.

Property Default Value Type Description
ProneTime 100 Integer How long (in ticks) the actor remains prone.
SpeedModifier 50 Integer Prone movement speed as a percentage of the normal speed.
DamageTriggers (required) Set of String Damage types that trigger prone state. Defined on the warheads.
DamageModifiers Dictionary Damage modifiers for each damage type (defined on the warheads) while the unit is prone.
ProneOffset 85,0,-171 3D World Vector
ProneSequencePrefix prone- String
Turret primary String
TurnSpeed 255 Integer Speed at which the turret turns.
InitialFacing 0 Integer
RealignDelay 40 Integer Number of ticks before turret is realigned. (-1 turns off realignment)
Offset 0,0,0 3D World Vector Muzzle position relative to turret or body. (forward, right, up) triples

TerrainModifiesDamage

Property Default Value Type Description
TerrainModifier (required) Dictionary Damage percentage for specific terrain types. 120 = 120%, 80 = 80%, etc.
ModifyHealing False Boolean Modify healing damage? For example: A friendly medic.

JamsMissiles

This actor deflects missiles.

Property Default Value Type Description
Range 0c0 1D World Distance Range of the deflection.
DeflectionStances Enemy, Neutral, Ally Stance What diplomatic stances are affected.
Chance 100 Integer Chance of deflecting missiles.

KillsSelf

Property Default Value Type Description
RemoveInstead False Boolean Remove the actor from the world (and destroy it) instead of killing it.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

Mobile

Unit is able to move.

Property Default Value Type Description
TerrainSpeeds (required) Dictionary Set Water: 0 for ground units and lower the value on rough terrain.
Crushes Set of String e.g. crate, wall, infantry
WaitAverage 5 Integer
WaitSpread 2 Integer
InitialFacing 0 Integer
TurnSpeed 255 Integer Speed at which the actor turns.
Speed 1 Integer
OnRails False Boolean
SharesCell False Boolean Allow multiple (infantry) units in one cell.
MoveIntoShroud True Boolean Can the actor be ordered to move in to shroud?
Cursor move String
BlockedCursor move-blocked String
Voice Action String
TilesetTerrainInfo Cached
TilesetMovementClass Cached
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

AlwaysVisible

The actor is always considered visible for targeting and rendering purposes.

DisabledOverlay

Use together with CanPowerDown/RequiresPower on buildings or Husk for vehicles.

FrozenUnderFog

This actor will remain visible (but not updated visually) under fog, once discovered.

Requires trait: Building.

Property Default Value Type Description
AlwaysVisibleStances Ally Stance Players with these stances can always see the actor.

HiddenUnderFog

The actor stays invisible under fog of war.

Property Default Value Type Description
AlwaysVisibleStances Ally Stance Players with these stances can always see the actor.
Type Footprint VisibilityType Possible values are CenterPosition (reveal when the center is visible) and Footprint (reveal when any footprint cell is visible).

HiddenUnderShroud

The actor stays invisible under the shroud.

Property Default Value Type Description
AlwaysVisibleStances Ally Stance Players with these stances can always see the actor.
Type Footprint VisibilityType Possible values are CenterPosition (reveal when the center is visible) and Footprint (reveal when any footprint cell is visible).

WithColoredOverlay

Display a colored overlay when a timed upgrade is active.

Property Default Value Type Description
Palette invuln String Palette to use when rendering the overlay
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

DamageMultiplier

Damage taken by this actor is multiplied based on upgrade level. Decrease to increase actor's apparent strength. Use 0 to make actor invulnerable.

Property Default Value Type Description
UpgradeTypes Multiple String Accepted upgrade types.
BaseLevel 1 Integer The lowest upgrade level using the scale.
Modifier (required) Multiple Integer Percentages to apply with the first being applied at the base level. Repeat last entry to accept time extensions. If no upgrade types are specified, then the first/only modifier is always applied.

FirepowerMultiplier

The firepower of this actor is multiplied based on upgrade level if specified.

Property Default Value Type Description
UpgradeTypes Multiple String Accepted upgrade types.
BaseLevel 1 Integer The lowest upgrade level using the scale.
Modifier (required) Multiple Integer Percentages to apply with the first being applied at the base level. Repeat last entry to accept time extensions. If no upgrade types are specified, then the first/only modifier is always applied.

InaccuracyMultiplier

The inaccuracy of this actor is multiplied based on upgrade level if specified.

Property Default Value Type Description
UpgradeTypes Multiple String Accepted upgrade types.
BaseLevel 1 Integer The lowest upgrade level using the scale.
Modifier (required) Multiple Integer Percentages to apply with the first being applied at the base level. Repeat last entry to accept time extensions. If no upgrade types are specified, then the first/only modifier is always applied.

PowerMultiplier

The power usage/output of this actor is multiplied based on upgrade level if specified.

Property Default Value Type Description
UpgradeTypes Multiple String Accepted upgrade types.
BaseLevel 1 Integer The lowest upgrade level using the scale.
Modifier (required) Multiple Integer Percentages to apply with the first being applied at the base level. Repeat last entry to accept time extensions. If no upgrade types are specified, then the first/only modifier is always applied.

RangeMultiplier

Range of this actor is multiplied based on upgrade level.

Property Default Value Type Description
UpgradeTypes Multiple String Accepted upgrade types.
BaseLevel 1 Integer The lowest upgrade level using the scale.
Modifier (required) Multiple Integer Percentages to apply with the first being applied at the base level. Repeat last entry to accept time extensions. If no upgrade types are specified, then the first/only modifier is always applied.

ReloadDelayMultiplier

The reloading time of this actor is multiplied based on upgrade level if specified.

Property Default Value Type Description
UpgradeTypes Multiple String Accepted upgrade types.
BaseLevel 1 Integer The lowest upgrade level using the scale.
Modifier (required) Multiple Integer Percentages to apply with the first being applied at the base level. Repeat last entry to accept time extensions. If no upgrade types are specified, then the first/only modifier is always applied.

SpeedMultiplier

The speed of this actor is multiplied based on upgrade level if specified.

Property Default Value Type Description
UpgradeTypes Multiple String Accepted upgrade types.
BaseLevel 1 Integer The lowest upgrade level using the scale.
Modifier (required) Multiple Integer Percentages to apply with the first being applied at the base level. Repeat last entry to accept time extensions. If no upgrade types are specified, then the first/only modifier is always applied.

MustBeDestroyed

Actors with this trait must be destroyed for a game to end.

Property Default Value Type Description
RequiredForShortGame False Boolean In a short game only actors that have this value set to true need to be destroyed.

CloakPaletteEffect

FlashPaletteEffect

Used for bursted one-colored whole screen effects. Add this to the world actor.

Property Default Value Type Description
ExcludePalettes cursor, chrome, colorpicker, fog, shroud Set of String
Length 20 Integer Measured in ticks.
Color FFFFFF Color
Type String Set this when using multiple independent flash effects.

GlobalLightingPaletteEffect

Used for day/night effects.

Property Default Value Type Description
ExcludePalettes cursor, chrome, colorpicker, fog, shroud, alpha Set of String Do not modify graphics that use any palette in this list.
ExcludePalettePrefixes Set of String Do not modify graphics that start with these letters.
Red 1 Real Number
Green 1 Real Number
Blue 1 Real Number
Ambient 1 Real Number

MenuPaletteEffect

Fades the world from/to black at the start/end of the game, and can (optionally) desaturate the world

Property Default Value Type Description
FadeLength 10 Integer Time (in ticks) to fade between states
Effect None EffectType Effect style to fade to during gameplay. Accepts values of None or Desaturated.
MenuEffect None EffectType Effect style to fade to when opening the in-game menu. Accepts values of None, Black or Desaturated.

RotationPaletteEffect

Palette effect used for sprinkle "animations".

Property Default Value Type Description
Palettes Set of String Defines to which palettes this effect should be applied to. If none specified, it applies to all palettes not explicitly excluded.
Tilesets Set of String Defines for which tileset IDs this effect should be loaded. If none specified, it applies to all tileset IDs not explicitly excluded.
ExcludePalettes Set of String Defines which palettes should be excluded from this effect.
ExcludeTilesets Set of String Don't apply the effect for these tileset IDs.
RotationBase 96 Integer Palette index of first RotationRange color.
RotationRange 7 Integer Range of colors to rotate.
RotationStep 0.25 Real Number Step towards next color index per tick.

ParaDrop

This unit can spawn and eject other actors while flying.

Requires trait: Cargo.

Property Default Value Type Description
DropRange 4c0 1D World Distance Distance around the drop-point to unload troops.
ChuteSound chute1.aud String Sound to play when dropping.

Parachutable

Can be paradropped by a ParaDrop actor.

Property Default Value Type Description
KilledOnImpassableTerrain True Boolean If we land on invalid terrain for my actor type should we be killed?
Image explosion String Image where Ground/WaterCorpseSequence is looked up.
GroundImpactSound String
GroundCorpseSequence corpse String
GroundCorpsePalette effect String
WaterImpactSound String
WaterCorpseSequence String
WaterCorpsePalette effect String
WaterTerrainTypes Water Set of String Terrain types on which to display WaterCorpseSequence.
FallRate 13 Integer
ParachuteUpgrade parachute Multiple String Upgrade to grant to this actor when parachuting. Normally used to render the parachute using the WithParachute trait.

Passenger

This actor can enter Cargo actors.

Property Default Value Type Description
CargoType String
PipType Green PipType
Weight 1 Integer
AlternateTransportsMode Force AlternateTransportsMode Use to set when to use alternate transports (Never, Force, Default, Always). Force - use force move modifier (Alt) to enable. Default - use force move modifier (Alt) to disable.
MaxAlternateTransportAttempts 1 Integer Number of retries using alternate transports.
AlternateTransportScanRange 5c512 1D World Distance Range from self for looking for an alternate transport (default: 5.5 cells).
GrantUpgrades Multiple String Upgrade types to grant to transport.
Voice Action String

ActorGroupProxy

Part of the unfinished group-movement system. Attach this to the player actor.

AllyRepair

Attach this to the player actor to allow building repair by team mates.

BaseAttackNotifier

Plays an audio notification and shows a radar ping when a building is attacked. Attach this to the player actor.

Property Default Value Type Description
NotifyInterval 30 Integer Minimum duration (in seconds) between notification events.
RadarPingColor FF0000 Color
RadarPingDuration 250 Integer Length of time (in ticks) to display a location ping in the minimap.
Notification BaseAttack String The audio notification type to play.
AllyNotification String The audio notification to play to allies when under attack. Won't play a notification to allies if this is null.

ClassicProductionQueue

Attach this to the player actor (not a building!) to define a new shared build queue. Will only work together with the Production: trait on the actor that actually does the production. You will also want to add PrimaryBuildings: to let the user choose where new units should exit.

Requires traits: PlayerResources, PowerManager, TechTree.

Property Default Value Type Description
SpeedUp False Boolean If you build more actors of the same type, the same queue will get its build time lowered for every actor produced there.
BuildTimeSpeedReduction 100, 85, 75, 65, 60, 55, 50 Multiple Integer Every time another production building of the same queue is constructed, the build times of all actors in the queue decreased by a percentage of the original time.
Type (required) String What kind of production will be added (e.g. Building, Infantry, Vehicle, ...)
Group String Group queues from separate buildings together into the same tab.
Factions Set of String Only enable this queue for certain factions.
Sticky True Boolean Should the prerequisite remain enabled if the owner changes?
BuildDurationModifier 100 Integer This percentage value is multiplied with actor cost to translate into build time (lower means faster).
LowPowerSlowdown 3 Integer The build time is multiplied with this value on low power.
ReadyAudio UnitReady String Notification played when production is complete. The filename of the audio is defined per faction in notifications.yaml.
BlockedAudio NoBuild String Notification played when you can't train another unit when the build limit exceeded or the exit is jammed. The filename of the audio is defined per faction in notifications.yaml.
QueuedAudio Training String Notification played when user clicks on the build palette icon. The filename of the audio is defined per faction in notifications.yaml.
OnHoldAudio OnHold String Notification played when player right-clicks on the build palette icon. The filename of the audio is defined per faction in notifications.yaml.
CancelledAudio Cancelled String Notification played when player right-clicks on a build palette icon that is already on hold. The filename of the audio is defined per faction in notifications.yaml.

ConquestVictoryConditions

Requires trait: MissionObjectives.

Property Default Value Type Description
NotificationDelay 1500 Integer Delay for the end game notification in milliseconds.
Objective Destroy all opposition! String Description of the objective.

EnemyWatcher

Tracks neutral and enemy actors' visibility and notifies the player. Attach this to the player actor.

Property Default Value Type Description
ScanInterval 25 Integer Interval in ticks between scanning for enemies.
NotificationInterval 750 Integer Minimal ticks in-between notifications.

GlobalUpgradeManager

Attach this to the player actor.

Requires trait: TechTree.

HarvesterAttackNotifier

Plays an audio notification and shows a radar ping when a harvester is attacked. Attach this to the player actor.

Property Default Value Type Description
NotifyInterval 30 Integer Minimum duration (in seconds) between notification events.
RadarPingColor FF0000 Color
RadarPingDuration 250 Integer Length of time (in ticks) to display a location ping in the minimap.
Notification HarvesterAttack String The audio notification type to play.

MissionObjectives

Property Default Value Type Description
Cooperative False Boolean Set this to true if multiple cooperative players have a distinct set of objectives that each of them has to complete to win the game. This is mainly useful for multiplayer coop missions. Do not use this for skirmish team games.
EarlyGameOver False Boolean If set to true, this setting causes the game to end immediately once the first player (or team of cooperative players) fails or completes his objectives. If set to false, players that fail their objectives will stick around and become observers.
GameOverDelay 1500 Integer Delay between the game over condition being met, and the game actually ending, in milliseconds.

ObjectivesPanel

Provides game mode progress information for players. Goes on WorldActor - observers don't have a player it can live on. Current options for PanelName are 'SKIRMISH_STATS' and 'MISSION_OBJECTIVES'.

Property Default Value Type Description
PanelName String
ExitDelay 1400 Integer in ms

PlaceBeacon

A beacon that is constructed from a circle sprite that is animated once and a moving arrow sprite.

Property Default Value Type Description
Duration 750 Integer
NotificationType Sounds String
Notification Beacon String
IsPlayerPalette True Boolean
Palette player String
BeaconImage beacon String
ArrowSequence arrow String
CircleSequence circles String

PlaceBuilding

Allows the player to execute build orders. Attach this to the player actor.

Property Default Value Type Description
Palette terrain String Palette to use for rendering the placement sprite.
NewOptionsNotificationDelay 10 Integer Play NewOptionsNotification this many ticks after building placement.
NewOptionsNotification NewOptions String Notification to play after building placement if new construction options are available.

PlayerExperience

This trait can be used to track player experience based on units killed with the GivesExperience trait. It can also be used as a point score system in scripted maps, for example. Attach this to the player actor.

PlayerStatistics

Attach this to the player actor to collect observer stats.

UpdatesPlayerStatistics

Attach this to a unit to update observer stats.

ProductionQueue

Attach this to an actor (usually a building) to let it produce units or construct buildings. If one builds another actor of this type, he will get a separate queue to create two actors at the same time. Will only work together with the Production: trait.

Property Default Value Type Description
Type (required) String What kind of production will be added (e.g. Building, Infantry, Vehicle, ...)
Group String Group queues from separate buildings together into the same tab.
Factions Set of String Only enable this queue for certain factions.
Sticky True Boolean Should the prerequisite remain enabled if the owner changes?
BuildDurationModifier 100 Integer This percentage value is multiplied with actor cost to translate into build time (lower means faster).
LowPowerSlowdown 3 Integer The build time is multiplied with this value on low power.
ReadyAudio UnitReady String Notification played when production is complete. The filename of the audio is defined per faction in notifications.yaml.
BlockedAudio NoBuild String Notification played when you can't train another unit when the build limit exceeded or the exit is jammed. The filename of the audio is defined per faction in notifications.yaml.
QueuedAudio Training String Notification played when user clicks on the build palette icon. The filename of the audio is defined per faction in notifications.yaml.
OnHoldAudio OnHold String Notification played when player right-clicks on the build palette icon. The filename of the audio is defined per faction in notifications.yaml.
CancelledAudio Cancelled String Notification played when player right-clicks on a build palette icon that is already on hold. The filename of the audio is defined per faction in notifications.yaml.

ProvidesPrerequisite

Property Default Value Type Description
Prerequisite String The prerequisite type that this provides. If left empty it defaults to the actor's name.
RequiresPrerequisites Multiple String Only grant this prerequisite when you have these prerequisites.
Factions Set of String Only grant this prerequisite for certain factions.
ResetOnOwnerChange False Boolean Should it recheck everything when it is captured?

ProvidesTechPrerequisite

Property Default Value Type Description
Id String Internal id for this tech level.
Name String Name shown in the lobby options.
Prerequisites Multiple String Prerequisites to grant when this tech level is active.

ResourceStorageWarning

Provides the player with an audible warning when their storage is nearing full.

Requires trait: PlayerResources.

Property Default Value Type Description
AdviceInterval 20 Integer Interval, in seconds, at which to check if more storage is needed.
Threshold 80 Integer The percentage threshold above which a warning is played.
Notification SilosNeeded String The speech to play for the warning.

StrategicPoint

Used to mark a place that needs to be in possession for StrategicVictoryConditions.

StrategicVictoryConditions

Allows King of the Hill (KotH) style gameplay.

Requires trait: MissionObjectives.

Property Default Value Type Description
HoldDuration 7500 Integer Amount of time (in game ticks) that the player has to hold all the strategic points. Defaults to 7500 ticks (5 minutes at default speed).
ResetOnHoldLost True Boolean Should the timer reset when the player loses hold of a strategic point.
RatioRequired 50 Integer Percentage of all strategic points the player has to hold to win.
NotificationDelay 1500 Integer Delay for the end game notification in milliseconds.
Objective Hold all the strategic positions! String Description of the objective

TechTree

Manages build limits and pre-requisites. Attach this to the player actor.

Plug

Property Default Value Type Description
Type (required) String Plug type (matched against Upgrades in Pluggable)

Pluggable

Requires trait: UpgradeManager.

Property Default Value Type Description
Offset 0,0 2D Cell Vector Footprint cell offset where a plug can be placed.
Upgrades (required) Dictionary Upgrades to grant for each accepted plug type.

AffectedByPowerOutage

Disables the actor when a power outage is triggered (see InfiltrateForPowerOutage for more information).

CanPowerDown

The player can disable the power individually on this actor.

Requires trait: Power.

Property Default Value Type Description
CancelWhenDisabled False Boolean Restore power when this trait is disabled.
IndicatorImage poweroff String
IndicatorSequence offline String
IndicatorPalette chrome String
PowerupSound String
PowerdownSound String
PowerupSpeech String
PowerdownSpeech String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

PowerManager

Attach this to the player actor.

Requires trait: DeveloperMode.

Property Default Value Type Description
AdviceInterval 250 Integer
SpeechNotification LowPower String

Power

Property Default Value Type Description
Amount 0 Integer If negative, it will drain power. If positive, it will provide power.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

RequiresPower

Needs power to operate.

Property Default Value Type Description
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

ScalePowerWithHealth

Scale power amount with the current health.

Requires traits: Health, Power.

PowerTooltip

Shown power info on the build palette widget.

ProducibleWithLevel

Actors possessing this trait should define the GainsExperience trait. When the prerequisites are fulfilled, this trait grants a level-up to newly spawned actors. If additionally the actor's owning player defines the ProductionIconOverlay trait, the production queue icon renders with an overlay defined in that trait.

Requires trait: GainsExperience.

Property Default Value Type Description
Prerequisites Multiple String
InitialLevels 1 Integer Number of levels to give to the actor on creation.
SuppressLevelupAnimation True Boolean Should the level-up animation be suppressed when actor is created?

Production

This unit has access to build queues.

Property Default Value Type Description
Produces (required) Multiple String e.g. Infantry, Vehicles, Aircraft, Buildings

ProductionFromMapEdge

Produce a unit on the closest map edge cell and move into the world.

Property Default Value Type Description
Produces (required) Multiple String e.g. Infantry, Vehicles, Aircraft, Buildings

ProductionParadrop

Deliver the unit in production via paradrop.

Requires trait: Exit.

Property Default Value Type Description
ActorType badr String Cargo aircraft used. Must have Aircraft trait.
ChuteSound chute1.aud String Sound to play when dropping the unit.
ReadyAudio String Notification to play when dropping the unit.
Produces (required) Multiple String e.g. Infantry, Vehicles, Aircraft, Buildings

ProductionQueueFromSelection

Property Default Value Type Description
ProductionTabsWidget String
ProductionPaletteWidget String

ProximityCaptor

Actor can capture ProximityCapturable actors.

Property Default Value Type Description
Types (required) Set of String

ProximityCapturable

Actor can be captured by units in a specified proximity.

Property Default Value Type Description
Range 5c0 1D World Distance Maximum range at which a ProximityCaptor actor can initiate the capture.
CaptorTypes Vehicle, Tank, Infantry Set of String Allowed ProximityCaptor actors to capture this actor.
MustBeClear False Boolean If set, the capturing process stops immediately after another player comes into Range.
Sticky False Boolean If set, the ownership will not revert back when the captor leaves the area.
Permanent False Boolean If set, the actor can only be captured via this logic once. This option implies the `Sticky` behaviour as well.

QuantizeFacingsFromSequence

Derive facings from sprite body sequence.

Requires trait: RenderSprites.

Property Default Value Type Description
Sequence idle String Defines sequence to derive facings from.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

RejectsOrders

Can be used to make a unit partly uncontrollable by the player.

Property Default Value Type Description
Except Set of String Possible values include Attack, AttackMove, Guard, Move.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

CustomTerrainDebugOverlay

Displays custom terrain types.

Property Default Value Type Description
Font TinyBold String

DrawLineToTarget

Property Default Value Type Description
Delay 60 Integer

Repairable

This actor can be sent to a structure for repairs.

Requires trait: Health.

Property Default Value Type Description
RepairBuildings fix Set of String
Voice Action String

RepairableNear

Requires trait: Health.

Property Default Value Type Description
Buildings spen, syrd Set of String
CloseEnough 4c0 1D World Distance
Voice Action String

RepairsBridges

Can enter a BridgeHut to trigger a repair.

Property Default Value Type Description
Voice Action String
EnterBehaviour Dispose EnterBehaviour Behaviour when entering the structure. Possible values are Exit, Suicide, Dispose.
TargetCursor goldwrench String Cursor to use when targeting a BridgeHut of an unrepaired bridge.
TargetBlockedCursor goldwrench-blocked String Cursor to use when repairing is denied.
RepairNotification String Speech notification to play when a bridge is repaired.

RevealsShroud

Property Default Value Type Description
Range 0c0 1D World Distance
Type Footprint VisibilityType Possible values are CenterPosition (measure range from the center) and Footprint (measure range from the footprint)

ScriptTags

Allows this actor to be 'tagged' with arbitrary strings. Tags must be unique or they will be rejected.

SeedsResource

Lets the actor spread resources around it in a circle.

Property Default Value Type Description
Interval 75 Integer
ResourceType Ore String
MaxRange 100 Integer
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

SelfHealing

Attach this to actors which should be able to regenerate their health points.

Requires trait: Health.

Property Default Value Type Description
Step 5 Integer Absolute amount of health points added in each step.
PercentageStep 0 Integer Relative percentages of health added in each step. When both values are defined, their summary will be applied.
Delay 5 Integer
HealIfBelow 50 Integer Heal if current health is below this percentage of full health.
DamageCooldown 0 Integer
DamageTypes Set of String Apply the selfhealing using these damagetypes.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

Sellable

Actor can be sold

Property Default Value Type Description
RefundPercent 50 Integer
SellSounds Multiple String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

ShakeOnDeath

Property Default Value Type Description
Intensity 10 Integer

SmokeTrailWhenDamaged

Requires trait: BodyOrientation.

Property Default Value Type Description
Offset 0,0,0 3D World Vector Position relative to body
Interval 3 Integer
Sprite smokey String
Sequence idle String
Palette effect String
MinDamage Heavy DamageState

SpawnActorOnDeath

Spawn another actor immediately upon death.

Property Default Value Type Description
Actor (required) String Actor to spawn on death.
Probability 100 Integer Probability the actor spawns.
OwnerType Victim OwnerType Owner of the spawned actor. Allowed keywords:'Victim', 'Killer' and 'InternalName'.
InternalOwner String Map player to use when 'InternalName' is defined on 'OwnerType'.
DeathType String DeathType that triggers the actor spawn. Leave empty to spawn an actor ignoring the DeathTypes.
SkipMakeAnimations True Boolean Skips the spawned actor's make animations if true.
RequiresLobbyCreeps False Boolean Should an actor only be spawned when the 'Creeps' setting is true?

StoresResources

Used for silos.

Property Default Value Type Description
PipCount (required) Integer Number of little squares used to display how filled unit is.
PipColor Yellow PipType
Capacity (required) Integer

SupplyTruck

Donate money to actors with the AcceptSupplies trait.

Property Default Value Type Description
Payload 500 Integer The amount of cash the owner receives.
PlayerExperience 0 Integer The amount of experience the donating player receives.
Voice Action String

AirstrikePower

Property Default Value Type Description
UnitType badr.bomber String
SquadSize 1 Integer
SquadOffset -1536,1536,0 3D World Vector
QuantizedFacings 32 Integer
Cordon 5c0 1D World Distance
CameraActor String Actor to spawn when the aircraft start attacking
CameraRemoveDelay 25 Integer Amount of time to keep the camera alive after the aircraft have finished attacking
BeaconDistanceOffset 6c0 1D World Distance Weapon range offset to apply during the beacon clock calculation
ChargeTime 0 Integer Measured in seconds.
Icon String
Description String
LongDesc String
AllowMultiple False Boolean
OneShot False Boolean
Cursor ability String Cursor to display for using this support power.
StartFullyCharged False Boolean If set to true, the support power will be fully charged when it becomes available. Normal rules apply for subsequent charges.
Prerequisites Multiple String
BeginChargeSound String
BeginChargeSpeechNotification String
EndChargeSound String
EndChargeSpeechNotification String
SelectTargetSound String
SelectTargetSpeechNotification String
InsufficientPowerSound String
InsufficientPowerSpeechNotification String
LaunchSound String
LaunchSpeechNotification String
IncomingSound String
IncomingSpeechNotification String
DisplayTimerStances None Stance Defines to which players the timer is shown.
IconPalette chrome String Palette used for the icon.
DisplayBeacon False Boolean Beacons are only supported on the Airstrike, Paratroopers, and Nuke powers
BeaconPaletteIsPlayerPalette True Boolean
BeaconPalette player String
BeaconImage beacon String
BeaconPoster String
BeaconPosterPalette chrome String
ClockSequence clock String
ArrowSequence arrow String
CircleSequence circles String
DisplayRadarPing False Boolean
RadarPingDuration 125 Integer Measured in ticks.
OrderName AirstrikePowerInfoOrder String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

GrantUpgradePower

Property Default Value Type Description
Upgrades (required) Multiple String The upgrades to apply.
Duration 0 Integer Duration of the upgrade (in ticks). Set to 0 for a permanent upgrade.
Range 1 Integer Cells - affects whole cells only
GrantUpgradeSound ironcur9.aud String
GrantUpgradeSequence active String Sequence to play for granting actor when activated. This requires the actor to have the WithSpriteBody trait or one of its derivatives.
ChargeTime 0 Integer Measured in seconds.
Icon String
Description String
LongDesc String
AllowMultiple False Boolean
OneShot False Boolean
Cursor ability String Cursor to display for using this support power.
StartFullyCharged False Boolean If set to true, the support power will be fully charged when it becomes available. Normal rules apply for subsequent charges.
Prerequisites Multiple String
BeginChargeSound String
BeginChargeSpeechNotification String
EndChargeSound String
EndChargeSpeechNotification String
SelectTargetSound String
SelectTargetSpeechNotification String
InsufficientPowerSound String
InsufficientPowerSpeechNotification String
LaunchSound String
LaunchSpeechNotification String
IncomingSound String
IncomingSpeechNotification String
DisplayTimerStances None Stance Defines to which players the timer is shown.
IconPalette chrome String Palette used for the icon.
DisplayBeacon False Boolean Beacons are only supported on the Airstrike, Paratroopers, and Nuke powers
BeaconPaletteIsPlayerPalette True Boolean
BeaconPalette player String
BeaconImage beacon String
BeaconPoster String
BeaconPosterPalette chrome String
ClockSequence clock String
ArrowSequence arrow String
CircleSequence circles String
DisplayRadarPing False Boolean
RadarPingDuration 125 Integer Measured in ticks.
OrderName GrantUpgradePowerInfoOrder String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

NukePower

Requires trait: BodyOrientation.

Property Default Value Type Description
MissileWeapon (required) String Weapon to use for the impact. Also image to use for the missile.
MissileUp up String Sprite sequence for the ascending missile.
MissileDown down String Sprite sequence for the descending missile.
SpawnOffset 0,0,0 3D World Vector Offset from the actor the missile spawns on.
MissilePalette effect String Palette to use for the missile weapon image.
IsPlayerPalette False Boolean Custom palette is a player palette BaseName
FlightDelay 400 Integer Travel time - split equally between ascent and descent
FlightVelocity 0c512 1D World Distance Visual ascent velocity in WDist / tick
SkipAscent False Boolean Descend immediately on the target, with half the FlightDelay
BeaconRemoveAdvance 25 Integer Amount of time before detonation to remove the beacon
CameraActor String Actor to spawn before detonation
CameraSpawnAdvance 25 Integer Amount of time before detonation to spawn the camera
CameraRemoveDelay 25 Integer Amount of time after detonation to remove the camera
FlashType String Corresponds to `Type` from `FlashPaletteEffect` on the world actor.
ActivationSequence active String Sequence the launching actor should play when activating this power.
ChargeTime 0 Integer Measured in seconds.
Icon String
Description String
LongDesc String
AllowMultiple False Boolean
OneShot False Boolean
Cursor ability String Cursor to display for using this support power.
StartFullyCharged False Boolean If set to true, the support power will be fully charged when it becomes available. Normal rules apply for subsequent charges.
Prerequisites Multiple String
BeginChargeSound String
BeginChargeSpeechNotification String
EndChargeSound String
EndChargeSpeechNotification String
SelectTargetSound String
SelectTargetSpeechNotification String
InsufficientPowerSound String
InsufficientPowerSpeechNotification String
LaunchSound String
LaunchSpeechNotification String
IncomingSound String
IncomingSpeechNotification String
DisplayTimerStances None Stance Defines to which players the timer is shown.
IconPalette chrome String Palette used for the icon.
DisplayBeacon False Boolean Beacons are only supported on the Airstrike, Paratroopers, and Nuke powers
BeaconPaletteIsPlayerPalette True Boolean
BeaconPalette player String
BeaconImage beacon String
BeaconPoster String
BeaconPosterPalette chrome String
ClockSequence clock String
ArrowSequence arrow String
CircleSequence circles String
DisplayRadarPing False Boolean
RadarPingDuration 125 Integer Measured in ticks.
OrderName NukePowerInfoOrder String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

ProduceActorPower

Produces an actor without using the standard production queue.

Property Default Value Type Description
Actors (required) Multiple String Actors to produce.
Type (required) String Production queue type to use
ReadyAudio String Notification played when production is activated. The filename of the audio is defined per faction in notifications.yaml.
BlockedAudio String Notification played when the exit is jammed. The filename of the audio is defined per faction in notifications.yaml.
ChargeTime 0 Integer Measured in seconds.
Icon String
Description String
LongDesc String
AllowMultiple False Boolean
OneShot False Boolean
Cursor ability String Cursor to display for using this support power.
StartFullyCharged False Boolean If set to true, the support power will be fully charged when it becomes available. Normal rules apply for subsequent charges.
Prerequisites Multiple String
BeginChargeSound String
BeginChargeSpeechNotification String
EndChargeSound String
EndChargeSpeechNotification String
SelectTargetSound String
SelectTargetSpeechNotification String
InsufficientPowerSound String
InsufficientPowerSpeechNotification String
LaunchSound String
LaunchSpeechNotification String
IncomingSound String
IncomingSpeechNotification String
DisplayTimerStances None Stance Defines to which players the timer is shown.
IconPalette chrome String Palette used for the icon.
DisplayBeacon False Boolean Beacons are only supported on the Airstrike, Paratroopers, and Nuke powers
BeaconPaletteIsPlayerPalette True Boolean
BeaconPalette player String
BeaconImage beacon String
BeaconPoster String
BeaconPosterPalette chrome String
ClockSequence clock String
ArrowSequence arrow String
CircleSequence circles String
DisplayRadarPing False Boolean
RadarPingDuration 125 Integer Measured in ticks.
OrderName ProduceActorPowerInfoOrder String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

SpawnActorPower

Spawns an actor that stays for a limited amount of time.

Property Default Value Type Description
Actor (required) String Actor to spawn.
LifeTime 250 Integer Amount of time to keep the actor alive in ticks. Value < 0 means this actor will not remove itself.
DeploySound String
EffectImage String
EffectSequence idle String
EffectPalette String
ChargeTime 0 Integer Measured in seconds.
Icon String
Description String
LongDesc String
AllowMultiple False Boolean
OneShot False Boolean
Cursor ability String Cursor to display for using this support power.
StartFullyCharged False Boolean If set to true, the support power will be fully charged when it becomes available. Normal rules apply for subsequent charges.
Prerequisites Multiple String
BeginChargeSound String
BeginChargeSpeechNotification String
EndChargeSound String
EndChargeSpeechNotification String
SelectTargetSound String
SelectTargetSpeechNotification String
InsufficientPowerSound String
InsufficientPowerSpeechNotification String
LaunchSound String
LaunchSpeechNotification String
IncomingSound String
IncomingSpeechNotification String
DisplayTimerStances None Stance Defines to which players the timer is shown.
IconPalette chrome String Palette used for the icon.
DisplayBeacon False Boolean Beacons are only supported on the Airstrike, Paratroopers, and Nuke powers
BeaconPaletteIsPlayerPalette True Boolean
BeaconPalette player String
BeaconImage beacon String
BeaconPoster String
BeaconPosterPalette chrome String
ClockSequence clock String
ArrowSequence arrow String
CircleSequence circles String
DisplayRadarPing False Boolean
RadarPingDuration 125 Integer Measured in ticks.
OrderName SpawnActorPowerInfoOrder String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

SupportPowerManager

Attach this to the player actor.

Requires traits: DeveloperMode, TechTree.

Targetable

Actor can be targeted.

Property Default Value Type Description
TargetTypes Set of String Target type. Used for filtering (in)valid targets.
RequiresForceFire False Boolean
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

ThrowsParticle

Requires traits: BodyOrientation, WithSpriteBody.

Property Default Value Type Description
Anim (required) String
Offset 0,0,0 3D World Vector Initial position relative to body
MinThrowRange 0c256 1D World Distance Minimum distance to throw the particle
MaxThrowRange 0c768 1D World Distance Maximum distance to throw the particle
MinThrowAngle 85 1D World Angle Minimum angle to throw the particle
MaxThrowAngle 170 1D World Angle Maximum angle to throw the particle
Velocity 75 Integer Speed to throw the particle (horizontal WPos/tick)
TurnSpeed 15 Integer Speed at which the particle turns.

ThrowsShrapnel

Throws particles when the actor is destroyed that do damage on impact.

Property Default Value Type Description
Weapons (required) Multiple String The weapons used for shrapnel.
Pieces 3, 10 Multiple Integer The amount of pieces of shrapnel to expel. Two values indicate a range.
Range 2c0, 5c0 Multiple 1D World Distance The minimum and maximum distances the shrapnel may travel.

EditorOnlyTooltip

Shown in map editor.

Property Default Value Type Description
Description String
Name String

Tooltip

Shown in the build palette widget.

Property Default Value Type Description
GenericName String An optional generic name (i.e. "Soldier" or "Structure")to be shown to chosen players.
GenericStancePrefix True Boolean Prefix generic tooltip name with 'Enemy' or 'Allied'.
GenericVisibility None Stance Player stances that the generic name should be shown to.
ShowOwnerRow True Boolean Show the actor's owner and their faction flag
Icon icon String Sequence of the actor that contains the cameo.
Description String
Name String

TransformOnCapture

Property Default Value Type Description
IntoActor String
ForceHealthPercentage 0 Integer
SkipMakeAnims True Boolean

Transforms

Actor becomes a specified actor type when this trait is triggered.

Property Default Value Type Description
IntoActor (required) String Actor to transform into.
Offset 0,0 2D Cell Vector Offset to spawn the transformed actor relative to the current cell.
Facing 96 Integer Facing that the actor must face before transforming.
TransformSounds Multiple String Sounds to play when transforming.
NoTransformSounds Multiple String Sounds to play when the transformation is blocked.
TransformNotification String Notification to play when transforming.
NoTransformNotification String Notification to play when the transformation is blocked.
DeployCursor deploy String Cursor to display when able to (un)deploy the actor.
DeployBlockedCursor deploy-blocked String Cursor to display when unable to (un)deploy the actor.
Voice Action String

Turreted

Requires trait: BodyOrientation.

Property Default Value Type Description
Turret primary String
TurnSpeed 255 Integer Speed at which the turret turns.
InitialFacing 0 Integer
RealignDelay 40 Integer Number of ticks before turret is realigned. (-1 turns off realignment)
Offset 0,0,0 3D World Vector Muzzle position relative to turret or body. (forward, right, up) triples

DeployToUpgrade

Requires trait: UpgradeManager.

Property Default Value Type Description
UndeployedUpgrades Multiple String The upgrades to grant while the actor is undeployed.
DeployedUpgrades (required) Multiple String The upgrades to grant after deploying and revoke before undeploying.
AllowedTerrainTypes Set of String The terrain types that this actor can deploy on to receive these upgrades. Leave empty to allow any.
CanDeployOnRamps False Boolean Can this actor deploy on slopes?
DeployCursor deploy String Cursor to display when able to (un)deploy the actor.
DeployBlockedCursor deploy-blocked String Cursor to display when unable to (un)deploy the actor.
DeployAnimation String Animation to play for deploying/undeploying.
Facing -1 Integer Facing that the actor must face before deploying. Set to -1 to deploy regardless of facing.
DeploySound String Sound to play when deploying.
UndeploySound String Sound to play when undeploying.
CanUndeploy True Boolean Can this actor undeploy?

DisableOnUpgrade

Disable the actor when this trait is enabled by an upgrade.

Property Default Value Type Description
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

UpgradeActorsNear

Applies an upgrade to actors within a specified range.

Property Default Value Type Description
Upgrades (required) Multiple String The upgrades to grant.
Range 3c0 1D World Distance The range to search for actors to upgrade.
MaximumVerticalOffset 0c0 1D World Distance The maximum vertical range above terrain to search for actors to upgrade. Ignored if 0 (actors are upgraded regardless of vertical distance).
ValidStances Ally Stance What diplomatic stances are affected.
AffectsParent False Boolean Grant the upgrades apply to this actor.
EnableSound String
DisableSound String

UpgradeManager

Attach this to a unit to enable dynamic upgrades by warheads, experience, crates, support powers, etc.

UpgradeOnDamageState

Applies an upgrade to the actor at specified damage states.

Requires traits: Health, UpgradeManager.

Property Default Value Type Description
Upgrades (required) Multiple String The upgrades to grant.
EnabledSounds Multiple String Play a random sound from this list when enabled.
DisabledSounds Multiple String Play a random sound from this list when disabled.
ValidDamageStates Heavy, Critical DamageState Levels of damage at which to grant upgrades.
GrantPermanently False Boolean Are upgrades irrevocable once the conditions have been met?

UpgradeOnTerrain

Requires trait: UpgradeManager.

Property Default Value Type Description
Upgrades terrain Multiple String
TerrainTypes Multiple String Terrain names to trigger the upgrade.

Valued

How much the unit is worth.

Property Default Value Type Description
Cost (required) Integer Used in production, but also for bounties so remember to set it > 0 even for NPCs.

Voiced

This actor has a voice.

Property Default Value Type Description
VoiceSet (required) String Which voice set to use.
Volume 1 Real Number Multiply volume with this factor.

Wanders

Wanders around aimlessly while idle.

Property Default Value Type Description
WanderMoveRadius 1 Integer
ReduceMoveRadiusDelay 5 Integer Number of ticks to wait before decreasing the effective move radius.
MinMoveDelay 0 Integer Minimum amount of ticks the actor will sit idly before starting to wander.
MaxMoveDelay 0 Integer Maximum amount of ticks the actor will sit idly before starting to wander.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

BridgeLayer

Property Default Value Type Description
Bridges bridge1, bridge2 Multiple String

CrateSpawner

Property Default Value Type Description
Enabled True Boolean Default value of the crates checkbox in the lobby.
Locked False Boolean Prevent the crates state from being changed in the lobby.
Minimum 1 Integer Minimum number of crates.
Maximum 255 Integer Maximum number of crates.
SpawnInterval 4500 Integer Average time (ticks) between crate spawn.
InitialSpawnDelay 0 Integer Delay (in ticks) before the first crate spawns.
ValidGround Clear, Rough, Road, Ore, Beach Set of String Which terrain types can we drop on?
ValidWater Water Set of String Which terrain types count as water?
WaterChance 20 Integer Chance of generating a water crate instead of a land crate.
CrateActors crate Multiple String Crate actors to drop.
CrateActorShares 10 Multiple Integer Chance of each crate actor spawning.
DeliveryAircraft String If a DeliveryAircraft: is specified, then this actor will deliver crates.
QuantizedFacings 32 Integer Number of facings that the delivery aircraft may approach from.
Cordon 5c0 1D World Distance Spawn and remove the plane this far outside the map.

CreateMPPlayers

Attach this to the world actor.

DomainIndex

Identify untraversable regions of the map for faster pathfinding, especially with AI. This trait is required. Every mod needs it attached to the world actor.

EditorActorLayer

Required for the map editor to work. Attach this to the world actor.

Property Default Value Type Description
BinSize 250 Integer Size of partition bins (world pixels)

EditorResourceLayer

Required for the map editor to work. Attach this to the world actor.

Requires trait: ResourceType.

EditorSelectionLayer

Required for the map editor to work. Attach this to the world actor.

Property Default Value Type Description
Palette terrain String Palette to use for rendering the placement sprite.
Image editor-overlay String Sequence image where the selection overlay types are defined.
CopySequence copy String Sequence to use for the copy overlay.
PasteSequence paste String Sequence to use for the paste overlay.

ExitsDebugOverlayManager

Property Default Value Type Description
Font TinyBold String The font used to draw cell vectors. Should match the value as-is in the Fonts section of the mod manifest (do not convert to lowercase).

LoadWidgetAtGameStart

Property Default Value Type Description
ShellmapRoot MAINMENU String The widget tree to open when a shellmap is loaded (i.e. the main menu).
IngameRoot INGAME_ROOT String The widget tree to open when a regular map is loaded (i.e. the ingame UI).
EditorRoot EDITOR_ROOT String The widget tree to open when the map editor is loaded.
ClearRoot True Boolean Remove any existing UI when a map is loaded.

MPStartLocations

Property Default Value Type Description
InitialExploreRange 5c0 1D World Distance

MPStartUnits

Used by SpawnMPUnits. Attach these to the world actor. You can have multiple variants by adding @suffixes.

Property Default Value Type Description
Class none String Internal class ID.
ClassName Unlabeled String Exposed via the UI to the player.
Factions Set of String Only available when selecting one of these factions. Leave empty for no restrictions.
BaseActor String The mobile construction vehicle.
SupportActors Multiple String A group of units ready to defend or scout.
InnerSupportRadius 2 Integer Inner radius for spawning support actors
OuterSupportRadius 4 Integer Outer radius for spawning support actors

MapBuildRadius

Controls the build radius checkboxes in the lobby options.

Property Default Value Type Description
AllyBuildRadiusEnabled True Boolean Default value of the ally build radius checkbox in the lobby.
AllyBuildRadiusLocked False Boolean Prevent the ally build radius state from being changed in the lobby.

MapCreeps

Controls the 'Creeps' checkbox in the lobby options.

Property Default Value Type Description
Enabled True Boolean Default value of the creeps checkbox in the lobby.
Locked False Boolean Prevent the creeps state from being changed in the lobby.

MapOptions

Controls the game speed, tech level, and short game lobby options.

Property Default Value Type Description
ShortGameEnabled True Boolean Default value of the short game checkbox in the lobby.
ShortGameLocked False Boolean Prevent the short game enabled state from being changed in the lobby.
TechLevel unrestricted String Default tech level.
TechLevelLocked False Boolean Prevent the tech level from being changed in the lobby.
GameSpeed default String Default game speed.
GameSpeedLocked False Boolean Prevent the game speed from being changed in the lobby.

MissionData

Defines the FMVs that can be played by missions.

Property Default Value Type Description
Briefing String Briefing text displayed in the mission browser.
BackgroundVideo String Played by the "Background Info" button in the mission browser.
BriefingVideo String Played by the "Briefing" button in the mission browser.
StartVideo String Automatically played before starting the mission.
WinVideo String Automatically played when the player wins the mission.
LossVideo String Automatically played when the player loses the mission.

MusicPlaylist

Trait for music handling. Attach this to the world actor.

Property Default Value Type Description
StartingMusic String Music to play when the map starts. Plays the first song on the playlist when undefined.
VictoryMusic String Music to play when the game has been won.
DefeatMusic String Music to play when the game has been lost.
BackgroundMusic String This track is played when no other music is playing. It cannot be paused, but can be overridden by selecting a new track.

PaletteFromCurrentTileset

Loads the palette specified in the tileset definition

Property Default Value Type Description
Name (required) String internal palette name
ShadowIndex Multiple Integer Map listed indices to shadow. Ignores previous color.
AllowModifiers True Boolean

PaletteFromFile

Property Default Value Type Description
Name (required) String internal palette name
Tileset String If defined, load the palette only for this tileset.
Filename (required) String filename to load
ShadowIndex Multiple Integer Map listed indices to shadow. Ignores previous color.
AllowModifiers True Boolean

PaletteFromPaletteWithAlpha

Create a palette by applying alpha transparency to another palette.

Property Default Value Type Description
Name (required) String Internal palette name
BasePalette (required) String The name of the palette to base off.
AllowModifiers True Boolean Allow palette modifiers to change the palette.
Alpha 1 Real Number Alpha component that is applied to the base palette.
Premultiply True Boolean Premultiply color by the alpha component.

PaletteFromPlayerPaletteWithAlpha

Create player palettes by applying alpha transparency to another player palette.

Property Default Value Type Description
BaseName (required) String The prefix for the resulting player palettes
BasePalette (required) String The name of the player palette to base off.
AllowModifiers True Boolean Allow palette modifiers to change the palette.
Alpha 1 Real Number Alpha component that is applied to the base palette.
Premultiply True Boolean Premultiply color by the alpha component.

PaletteFromRGBA

Creates a single color palette without any base palette file.

Property Default Value Type Description
Name (required) String internal palette name
Tileset String If defined, load the palette only for this tileset.
R 0 Integer red color component
G 0 Integer green color component
B 0 Integer blue color component
A 255 Integer alpha channel (transparency)
AllowModifiers True Boolean

PathFinder

Calculates routes for mobile units based on the A* search algorithm. Attach this to the world actor.

PlayerPaletteFromCurrentTileset

Property Default Value Type Description
Name (required) String internal palette name
ShadowIndex Multiple Integer Map listed indices to shadow.
AllowModifiers True Boolean Apply palette rotators or not.

RadarPings

Property Default Value Type Description
FromRadius 200 Integer
ToRadius 15 Integer
ShrinkSpeed 4 Integer
RotationSpeed 0.12 Real Number

ResourceClaimLayer

Allows harvesters to coordinate their operations. Attach this to the world actor.

ResourceLayer

Attach this to the world actor. Order of the layers defines the Z sorting.

Requires traits: BuildingInfluence, ResourceType.

ScriptLobbyDropdown

Controls the map difficulty, tech level, and short game lobby options.

Property Default Value Type Description
ID (required) String Internal id for this option.
Label (required) String Display name for this option.
Default (required) String Default option key in the `Values` list.
Values (required) Dictionary Difficulty levels supported by the map.
Locked False Boolean Prevent the option from being changed from its default value.

ShroudPalette

Adds the hard-coded shroud palette to the game

Property Default Value Type Description
Name (required) String Internal palette name
Fog False Boolean Palette type

ShroudRenderer

Property Default Value Type Description
Sequence shroud String
ShroudVariants shroud Multiple String
FogVariants fog Multiple String
ShroudPalette shroud String
FogPalette fog String
Index 12, 9, 8, 3, 1, 6, 4, 2, 13, 11, 7, 14 Multiple Integer Bitfield of shroud directions for each frame. Lower four bits are corners clockwise from TL; upper four are edges clockwise from top
UseExtendedIndex False Boolean Use the upper four bits when calculating frame
OverrideFullShroud String Override for source art that doesn't define a fully shrouded tile
OverrideShroudIndex 15 Integer
OverrideFullFog String Override for source art that doesn't define a fully fogged tile
OverrideFogIndex 15 Integer
ShroudBlend Alpha BlendMode

SmudgeLayer

Attach this to the world actor. Order of the layers defines the Z sorting.

Property Default Value Type Description
Type Scorch String
Sequence scorch String Sprite sequence name
SmokePercentage 25 Integer
SmokeType smoke_m String Sprite sequence name
SmokeSequence idle String
SmokePalette effect String
Palette terrain String
InitialSmudges Dictionary<2D Cell Position,MapSmudge>

SpawnMPUnits

Spawn base actor at the spawnpoint and support units in an annulus around the base actor. Both are defined at MPStartUnits. Attach this to the world actor.

Requires traits: MPStartLocations, MPStartUnits.

Property Default Value Type Description
StartingUnitsClass none String
Locked False Boolean Prevent the starting units option from being changed in the lobby.

SpawnMapActors

Spawns the initial units for each player upon game start.

StartGameNotification

Property Default Value Type Description
Notification StartGame String

TerrainGeometryOverlay

Renders a debug overlay showing the terrain cells. Attach this to the world actor.

ValidateOrder

Used to detect exploits. Attach this to the world actor.

VoxelNormalsPalette

Property Default Value Type Description
Name normals String
Type TiberianSun NormalType Can be TiberianSun or RedAlert2

WarheadDebugOverlay

Part of the combat overlay from DeveloperMode. Attach this to the world actor.

Property Default Value Type Description
DisplayDuration 25 Integer

WeatherOverlay

Adds a particle-based overlay.

Property Default Value Type Description
ParticleDensityFactor 8 Integer Average number of particles per 100x100 px square.
ChangingWindLevel True Boolean Should the level of the wind change over time, or just stick to the first value of WindLevels?
WindLevels -5, -3, -2, 0, 2, 3, 5 Multiple Integer The levels of wind intensity (particles x-axis movement in px/tick).
WindTick 150, 750 Multiple Integer Works only if ChangingWindLevel is enabled. Min. and max. ticks needed to change the WindLevel.
InstantWindChanges False Boolean Hard or soft fading between the WindLevels.
UseSquares True Boolean Particles are drawn in squares when enabled, otherwise with lines.
ParticleSize 1, 3 Multiple Integer Size / width of the particle in px.
ScatterDirection -1, 1 Multiple Integer Scatters falling direction on the x-axis. Scatter min. and max. value in px/tick.
Gravity 1, 2 Multiple Real Number Min. and max. speed at which particles fall in px/tick.
SwingOffset 1, 1.5 Multiple Real Number The current offset value for the swing movement. SwingOffset min. and max. value in px/tick.
SwingSpeed 0.001, 0.025 Multiple Real Number The value that particles swing to the side each update. SwingSpeed min. and max. value in px/tick.
SwingAmplitude 1, 1.5 Multiple Real Number The value range that can be swung to the left or right. SwingAmplitude min. and max. value in px/tick.
ParticleColors ECECEC, E4E4E4, D0D0D0, BCBCBC Multiple Color The randomly selected rgb(a) hex colors for the particles. Use this order: rrggbb[aa], rrggbb[aa], ...
LineTailAlphaValue 200 Byte Works only with line enabled and can be used to fade out the tail of the line like a contrail.

OpenRA.Mods.Common.Traits.Radar

AppearsOnRadar

Property Default Value Type Description
UseLocation False Boolean

JamsRadar

When an actor with this trait is in range of an actor with ProvidesRadar, it will temporarily disable the radar minimap for the enemy player.

Property Default Value Type Description
Range 0c0 1D World Distance Range for jamming.

ProvidesRadar

This actor enables the radar minimap.

RadarColorFromTerrain

Property Default Value Type Description
Terrain String

OpenRA.Mods.Common.Traits.Render

AutoSelectionSize

Automatically calculates the targetable area and screen map boundaries from the sprite size.

Requires trait: RenderSprites.

Hovers

Changes the visual Z position periodically.

Property Default Value Type Description
OffsetModifier -43 Integer Amount of Z axis changes in world units.
MinHoveringAltitude 0 Integer
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

LeavesTrails

Renders a sprite effect when leaving a cell.

Property Default Value Type Description
Image String
Sequences idle Multiple String
Palette effect String
TerrainTypes Set of String Only do so when the terrain types match with the previous cell.
Type Cell TrailType Accepts values: Cell to draw the trail sprite in the center of the current cell, CenterPosition to draw the trail sprite at the current position.
VisibleThroughFog False Boolean Should the trail be visible through fog.
TrailWhileStationary False Boolean Display a trail while stationary.
StationaryInterval 0 Integer Delay between trail updates when stationary.
TrailWhileMoving True Boolean Display a trail while moving.
MovingInterval 0 Integer Delay between trail updates when moving.
StartDelay 0 Integer Delay before first trail.
Offsets 0,0,0 Multiple 3D World Vector Trail spawn positions relative to actor position. (forward, right, up) triples
SpawnAtLastPosition True Boolean Should the trail spawn relative to last position or current position?
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

ProductionBar

Visualizes the remaining build time of actor produced here.

Requires trait: Production.

Property Default Value Type Description
ProductionType String Production queue type, for actors with multiple queues.
Color 87CEEB Color

RenderDebugState

Displays the actor's type and ID above the actor.

Property Default Value Type Description
Font TinyBold String

RenderDetectionCircle

Requires trait: DetectCloaked.

Property Default Value Type Description
UpdateLineTick 1023 1D World Angle WAngle the Radar update line advances per tick.
TrailCount 0 Integer Number of trailing Radar update lines.
Color 32CD3280 Color Color of the circle and scanner update line.
ContrastColor 00000060 Color Contrast color of the circle and scanner update line.

RenderNameTag

Displays the player name above the unit

Property Default Value Type Description
MaxLength 10 Integer
Font TinyBold String

RenderRangeCircle

Draw a circle indicating my weapon's range.

Requires trait: AttackBase.

Property Default Value Type Description
RangeCircleType String
FallbackRange 0c0 1D World Distance Range to draw if no armaments are available

RenderSprites

Render trait fundament that won't work without additional With* render traits.

Property Default Value Type Description
Image String The sequence name that defines the actor sprites. Defaults to the actor name.
FactionImages Dictionary A dictionary of faction-specific image overrides.
Palette String Custom palette name
PlayerPalette player String Custom PlayerColorPalette: BaseName
Scale 1 Real Number Change the sprite image size.

RenderSpritesEditorOnly

Invisible during games.

Property Default Value Type Description
Image String The sequence name that defines the actor sprites. Defaults to the actor name.
FactionImages Dictionary A dictionary of faction-specific image overrides.
Palette String Custom palette name
PlayerPalette player String Custom PlayerColorPalette: BaseName
Scale 1 Real Number Change the sprite image size.

RenderVoxels

Requires trait: BodyOrientation.

Property Default Value Type Description
Image String Defaults to the actor name.
Palette String Custom palette name
PlayerPalette player String Custom PlayerColorPalette: BaseName
NormalsPalette normals String
ShadowPalette shadow String
Scale 10 Real Number Change the image size.
LightPitch 142 1D World Angle
LightYaw 682 1D World Angle
LightAmbientColor 0.6, 0.6, 0.6 Multiple Real Number
LightDiffuseColor 0.4, 0.4, 0.4 Multiple Real Number

SelectionDecorations

Property Default Value Type Description
Palette chrome String
VisualBounds Multiple Integer Visual bounds for selection box. If null, it uses AutoSelectionSize. The first two values define the bounds' size, the optional third and fourth values specify the position relative to the actors' center. Defaults to selectable bounds.
RenderSelectionBars True Boolean Health bar, production progress bar etc.
RenderSelectionBox True Boolean
SelectionBoxColor FFFFFF Color
Image pips String

SupportPowerChargeBar

Display the time remaining until the super weapon attached to the actor is ready.

Property Default Value Type Description
DisplayStances Ally Stance Defines to which players the bar is to be shown.
Color FF00FF Color

TimedUpgradeBar

Visualizes the remaining time for an upgrade.

Requires trait: UpgradeManager.

Property Default Value Type Description
Upgrade (required) String Upgrade that this bar corresponds to
Color FF0000 Color

VeteranProductionIconOverlay

Attach this to the player actor. When attached, enables all actors possessing the LevelupWhenCreated trait to have their production queue icons render with an overlay defined in this trait. The icon change occurs when LevelupWhenCreated.Prerequisites are met.

Requires trait: TechTree.

Property Default Value Type Description
Image (required) String Image used for the overlay.
Sequence String Sequence used for the overlay (cannot be animated).
Palette chrome String Palette to render the sprite in. Reference the world actor's PaletteFrom* traits.
ReferencePoint Top, Left ReferencePoints Point on the production icon's used as reference for offsetting the overlay. Possible values are combinations of Center, Top, Bottom, Left, Right.

WithAttackAnimation

Requires traits: Armament, AttackBase, WithSpriteBody.

Property Default Value Type Description
Armament primary String Armament name
AttackSequence String Displayed while attacking.
AimSequence String Displayed while targeting.
ReloadPrefix String Shown while reloading.
Delay 0 Integer Delay in ticks before animation starts, either relative to attack preparation or attack.
DelayRelativeTo Preparation AttackDelayType Should the animation be delayed relative to preparation or actual attack?

WithAttackOverlay

Rendered together with an attack.

Requires trait: RenderSprites.

Property Default Value Type Description
Sequence (required) String Sequence name to use
Palette String Custom palette name
IsPlayerPalette False Boolean Custom palette is a player palette BaseName
Delay 0 Integer Delay in ticks before overlay starts, either relative to attack preparation or attack.
DelayRelativeTo Preparation AttackDelayType Should the overlay be delayed relative to preparation or actual attack?

WithBuildingExplosion

Display explosions over the building footprint when it is destroyed.

Requires trait: Building.

Property Default Value Type Description
Image explosion String 'Image' where Sequences are looked up.
Sequences building Multiple String Explosion sequence names to use.
Delay 0 Integer Delay the explosions by this many ticks.
Palette effect String Custom palette name.

WithBuildingPlacedAnimation

Changes the animation when the actor constructed a building.

Requires trait: WithSpriteBody.

Property Default Value Type Description
Sequence build String Sequence name to use

WithBuildingPlacedOverlay

Rendered when the actor constructed a building.

Requires traits: BodyOrientation, RenderSprites.

Property Default Value Type Description
Sequence crane-overlay String Sequence name to use
Offset 0,0,0 3D World Vector Position relative to body
Palette String Custom palette name
IsPlayerPalette False Boolean Custom palette is a player palette BaseName

WithChargeAnimation

This actor displays a charge-up animation before firing.

Requires traits: RenderSprites, WithSpriteBody.

Property Default Value Type Description
ChargeSequence active String Sequence to use for charge animation.

WithChargeOverlay

Rendered together with AttackCharge.

Requires trait: RenderSprites.

Property Default Value Type Description
Sequence active String Sequence name to use
Palette String Custom palette name
IsPlayerPalette False Boolean Custom palette is a player palette BaseName

WithCrateBody

Renders crates with both water and land variants.

Requires trait: RenderSprites.

Property Default Value Type Description
XmasImages Multiple String Easteregg sequences to use in December.
WaterTerrainTypes Water Set of String Terrain types on which to display WaterSequence.
IdleSequence idle String
WaterSequence String
LandSequence String

WithDamageOverlay

Renders an overlay when the actor is taking heavy damage.

Requires trait: RenderSprites.

Property Default Value Type Description
Image smoke_m String
IdleSequence idle String
LoopSequence loop String
EndSequence end String
DamageTypes Set of String Damage types that this should be used for (defined on the warheads). Leave empty to disable all filtering.
MinimumDamageState Heavy DamageState Trigger when Undamaged, Light, Medium, Heavy, Critical or Dead.
MaximumDamageState Dead DamageState

WithDeathAnimation

This actor has a death animation.

Requires trait: RenderSprites.

Property Default Value Type Description
DeathSequence die String Sequence prefix to play when this actor is killed by a warhead.
DeathSequencePalette player String The palette used for `DeathSequence`.
DeathPaletteIsPlayerPalette True Boolean Custom death animation palette is a player palette BaseName
UseDeathTypeSuffix True Boolean Should DeathType-specific sequences be used (sequence name = DeathSequence + DeathType).
CrushedSequence String Sequence to play when this actor is crushed.
CrushedSequencePalette effect String The palette used for `CrushedSequence`.
CrushedPaletteIsPlayerPalette False Boolean Custom crushed animation palette is a player palette BaseName
DeathTypes Dictionary Death animations to use for each damage type (defined on the warheads). Is only used if UseDeathTypeSuffix is `True`.
FallbackSequence String Sequence to use when the actor is killed by some non-standard means (e.g. suicide).

WithDecoration

Displays a custom UI overlay relative to the selection box.

Property Default Value Type Description
Image String Image used for this decoration. Defaults to the actor's type.
Sequence String Sequence used for this decoration (can be animated).
Palette chrome String Palette to render the sprite in. Reference the world actor's PaletteFrom* traits.
ReferencePoint Top, Left ReferencePoints Point in the actor's selection box used as reference for offsetting the decoration image. Possible values are combinations of Center, Top, Bottom, Left, Right.
ZOffset 1 Integer The Z offset to apply when rendering this decoration.
ValidStances Ally Stance Player stances who can view the decoration.
RequiresSelection False Boolean Should this be visible only when selected?
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithDockedOverlay

Rendered when a harvester is docked.

Requires traits: BodyOrientation, RenderSprites.

Property Default Value Type Description
Sequence docking-overlay String Sequence name to use
Offset 0,0,0 3D World Vector Position relative to body
Palette String Custom palette name
IsPlayerPalette False Boolean Custom palette is a player palette BaseName

WithDockingAnimation

Requires traits: Harvester, WithSpriteBody.

Property Default Value Type Description
DockSequence dock String Displayed when docking to refinery.
DockLoopSequence dock-loop String Looped while unloading at refinery.

WithFacingSpriteBody

Requires traits: BodyOrientation, RenderSprites.

Property Default Value Type Description
StartSequence String Animation to play when the actor is created.
Sequence idle String Animation to play when the actor is idle.
PauseAnimationWhenDisabled False Boolean Pause animation when actor is disabled.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithGateSpriteBody

Requires traits: Gate, RenderSprites.

Property Default Value Type Description
WallConnections Multiple 2D Cell Vector Cells (outside the gate footprint) that contain wall cells that can connect to the gate
Type wall String Wall type for connections
OpenSequence String Override sequence to use when fully open.
StartSequence String Animation to play when the actor is created.
Sequence idle String Animation to play when the actor is idle.
PauseAnimationWhenDisabled False Boolean Pause animation when actor is disabled.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithHarvestAnimation

Requires traits: Harvester, WithSpriteBody.

Property Default Value Type Description
PrefixByFullness Multiple String Prefix added to idle and harvest sequences depending on fullness of harvester.
HarvestSequence harvest String Displayed while harvesting.

WithHarvestOverlay

Displays an overlay whenever resources are harvested by the actor.

Requires traits: BodyOrientation, RenderSprites.

Property Default Value Type Description
Sequence harvest String Sequence name to use
Offset 0,0,0 3D World Vector Position relative to body
Palette effect String

WithIdleAnimation

Periodically plays an idle animation, replacing the default body animation.

Requires trait: WithSpriteBody.

Property Default Value Type Description
Sequences active Multiple String Sequence names to use.
Interval 750 Integer
PauseOnLowPower False Boolean Pause when the actor is disabled. Deprecated. Use upgrades instead.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithIdleOverlay

Renders a decorative animation on units and buildings.

Requires traits: BodyOrientation, RenderSprites.

Property Default Value Type Description
StartSequence String Animation to play when the actor is created.
Sequence idle-overlay String Sequence name to use
Offset 0,0,0 3D World Vector Position relative to body
Palette String Custom palette name
IsPlayerPalette False Boolean Custom palette is a player palette BaseName
PauseOnLowPower False Boolean
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithInfantryBody

Requires trait: RenderSprites.

Property Default Value Type Description
MinIdleDelay 30 Integer
MaxIdleDelay 110 Integer
MoveSequence run String
AttackSequence String
IdleSequences Multiple String
StandSequences stand Multiple String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithMakeAnimation

Replaces the sprite during construction.

Requires trait: WithSpriteBody.

Property Default Value Type Description
Sequence make String Sequence name to use

WithMoveAnimation

Requires trait: WithSpriteBody.

Property Default Value Type Description
MoveSequence move String Displayed while moving.

WithMuzzleOverlay

Renders the MuzzleSequence from the Armament trait.

Requires traits: Armament, AttackBase, RenderSprites.

Property Default Value Type Description
IgnoreOffset False Boolean Ignore the weapon position, and always draw relative to the center of the actor
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithParachute

Renders a parachute on units.

Requires traits: BodyOrientation, RenderSprites.

Property Default Value Type Description
Image String The image that contains the parachute sequences.
OpeningSequence String Parachute opening sequence.
Sequence String Parachute idle sequence.
ClosingSequence String Parachute closing sequence. Defaults to opening sequence played backwards.
Palette player String Palette used to render the parachute.
IsPlayerPalette True Boolean
Offset 0,0,384 3D World Vector Parachute position relative to the paradropped unit.
ShadowImage String The image that contains the shadow sequence for the paradropped unit.
ShadowSequence String Paradropped unit's shadow sequence.
ShadowPalette shadow String Palette used to render the paradropped unit's shadow.
ShadowOffset 0,128,0 3D World Vector Shadow position relative to the paradropped unit's intended landing position.
ShadowZOffset 0 Integer Z-offset to apply on the shadow sequence.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithProductionDoorOverlay

Play an animation when a unit exits or blocks the exit after production finished.

Requires traits: BodyOrientation, Building, RenderSprites.

Property Default Value Type Description
Sequence build-door String

WithProductionOverlay

Renders an animation when the Production trait of the actor is activated. Works both with per player ClassicProductionQueue and per building ProductionQueue, but needs any of these.

Requires traits: BodyOrientation, Production, RenderSprites.

Property Default Value Type Description
Sequence production-overlay String Sequence name to use
Offset 0,0,0 3D World Vector Position relative to body
Palette String Custom palette name
IsPlayerPalette False Boolean Custom palette is a player palette BaseName

WithRangeCircle

Renders an arbitrary circle when selected or placing a structure

Property Default Value Type Description
Type String Type of range circle. used to decide which circles to draw on other structures during building placement.
Color FFFFFF80 Color Color of the circle
UsePlayerColor False Boolean If set, the color of the owning player will be used instead of `Color`.
ValidStances Ally Stance Stances of players which will be able to see the circle. Valid values are combinations of `None`, `Ally`, `Enemy` and `Neutral`.
Visible WhenSelected RangeCircleVisibility When to show the range circle. Valid values are `Always`, and `WhenSelected`
Range 0c0 1D World Distance Range of the circle

WithRankDecoration

Property Default Value Type Description
Image String Image used for this decoration. Defaults to the actor's type.
Sequence String Sequence used for this decoration (can be animated).
Palette chrome String Palette to render the sprite in. Reference the world actor's PaletteFrom* traits.
ReferencePoint Top, Left ReferencePoints Point in the actor's selection box used as reference for offsetting the decoration image. Possible values are combinations of Center, Top, Bottom, Left, Right.
ZOffset 1 Integer The Z offset to apply when rendering this decoration.
ValidStances Ally Stance Player stances who can view the decoration.
RequiresSelection False Boolean Should this be visible only when selected?
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithRearmAnimation

Replaces the building animation when it rearms a unit.

Requires trait: WithSpriteBody.

Property Default Value Type Description
Sequence active String Sequence name to use
PauseOnLowPower False Boolean

WithRepairAnimation

Replaces the building animation when it repairs a unit.

Requires trait: WithSpriteBody.

Property Default Value Type Description
Sequence active String Sequence name to use
PauseOnLowPower False Boolean

WithRepairOverlay

Displays an overlay when the building is being repaired by the player.

Requires traits: BodyOrientation, RenderSprites.

Property Default Value Type Description
Sequence active String Sequence name to use
Offset 0,0,0 3D World Vector Position relative to body
Palette String Custom palette name
IsPlayerPalette False Boolean Custom palette is a player palette BaseName
PauseOnLowPower False Boolean

WithResources

Displays the fill status of PlayerResources with an extra sprite overlay on the actor.

Requires traits: RenderSprites, WithSpriteBody.

Property Default Value Type Description
Sequence resources String Sequence name to use

WithShadow

Clones the actor sprite with another palette below it.

Property Default Value Type Description
Palette shadow String
Offset 0,0,0 3D World Vector Shadow position offset relative to actor position (ground level).
ZOffset -5 Integer Shadow Z offset relative to actor sprite.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithSiloAnimation

Render trait for buildings that change the sprite according to the remaining resource storage capacity across all depots.

Requires traits: RenderSprites, WithSpriteBody.

Property Default Value Type Description
Sequence stages String Sequence to use for resources-dependent 'stages'.
Stages 10 Integer Internal resource stages. Does not have to match number of sequence frames.

WithSpriteBarrel

Renders barrels for units with the Turreted trait.

Requires traits: Armament, BodyOrientation, RenderSprites, Turreted.

Property Default Value Type Description
Sequence barrel String Sequence name to use.
Armament primary String Armament to use for recoil.
LocalOffset 0,0,0 3D World Vector Visual offset.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithSpriteBody

Default trait for rendering sprite-based actors.

Requires trait: RenderSprites.

Property Default Value Type Description
StartSequence String Animation to play when the actor is created.
Sequence idle String Animation to play when the actor is idle.
PauseAnimationWhenDisabled False Boolean Pause animation when actor is disabled.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithSpriteControlGroupDecoration

Renders Ctrl groups using pixel art.

Property Default Value Type Description
Palette chrome String
Image pips String
GroupSequence groups String Sprite sequence used to render the control group 0-9 numbers.
ReferencePoint Top, Left ReferencePoints Point in the actor's selection box used as reference for offsetting the decoration image. Possible values are combinations of Center, Top, Bottom, Left, Right.

WithSpriteTurret

Renders turrets for units with the Turreted trait.

Requires traits: Armament, BodyOrientation, RenderSprites, Turreted.

Property Default Value Type Description
Sequence turret String Sequence name to use
AimSequence String Sequence name to use when prepared to fire
Turret primary String Turreted 'Turret' key to display
Recoils True Boolean Render recoil
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithTextControlGroupDecoration

Renders Ctrl groups using typeface.

Property Default Value Type Description
Font TinyBold String
Color FFFFFF Color Display in this color when not using the player color.
UsePlayerColor False Boolean Use the player color of the current owner.
ZOffset 1 Integer The Z offset to apply when rendering this decoration.
ReferencePoint Bottom, Left ReferencePoints Point in the actor's selection box used as reference for offsetting the decoration image. Possible values are combinations of Center, Top, Bottom, Left, Right.
ScreenOffset 2,-2 2D Integer Manual offset in screen pixel.

WithTextDecoration

Displays a text overlay relative to the selection box.

Property Default Value Type Description
Text (required) String
Font TinyBold String
Color FFFFFF Color Display in this color when not using the player color.
UsePlayerColor False Boolean Use the player color of the current owner.
ReferencePoint Top, Left ReferencePoints Point in the actor's selection box used as reference for offsetting the decoration image. Possible values are combinations of Center, Top, Bottom, Left, Right.
ZOffset 1 Integer The Z offset to apply when rendering this decoration.
ValidStances Ally Stance Player stances who can view the decoration.
RequiresSelection False Boolean Should this be visible only when selected?
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithTurretedSpriteBody

This actor has turret art with facings baked into the sprite.

Requires traits: BodyOrientation, RenderSprites, Turreted.

Property Default Value Type Description
StartSequence String Animation to play when the actor is created.
Sequence idle String Animation to play when the actor is idle.
PauseAnimationWhenDisabled False Boolean Pause animation when actor is disabled.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithVoxelBarrel

Requires traits: Armament, RenderVoxels, Turreted.

Property Default Value Type Description
Sequence barrel String Voxel sequence name to use
Armament primary String Armament to use for recoil
LocalOffset 0,0,0 3D World Vector Visual offset
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithVoxelBody

Also returns a default selection size that is calculated automatically from the voxel dimensions.

Requires trait: RenderVoxels.

Property Default Value Type Description
Sequence idle String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithVoxelTurret

Requires traits: RenderVoxels, Turreted.

Property Default Value Type Description
Sequence turret String Voxel sequence name to use
Turret primary String Turreted 'Turret' key to display
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithWallSpriteBody

Render trait for actors that change sprites if neighbors with the same trait are present.

Requires traits: Building, RenderSprites.

Property Default Value Type Description
Type wall String
StartSequence String Animation to play when the actor is created.
Sequence idle String Animation to play when the actor is idle.
PauseAnimationWhenDisabled False Boolean Pause animation when actor is disabled.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

OpenRA.Mods.Common.Traits.Sound

ActorLostNotification

Property Default Value Type Description
Notification UnitLost String
NotifyAll False Boolean

AmbientSound

Plays a looping audio file at the actor position. Attach this to the World actor to cover the whole map.

Property Default Value Type Description
SoundFile (required) String
Interval 0 Integer Interval between playing the sound (in ticks).
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

AnnounceOnBuild

Play the Build voice of this actor when trained.

Property Default Value Type Description
Voice Build String Voice to use when built/trained.

AnnounceOnKill

Play the Kill voice of this actor when eliminating enemies.

Property Default Value Type Description
Interval 5 Integer Minimum duration (in seconds) between sound events.
Voice Kill String Voice to use when killing something.

AnnounceOnSeen

Players will be notified when this actor becomes visible to them.

Property Default Value Type Description
PingRadar False Boolean Should there be a radar ping on enemies' radar at the actor's location when they see him
Notification String
AnnounceNeutrals False Boolean

AttackSounds

Played when preparing for an attack or attacking.

Property Default Value Type Description
Sounds Multiple String Play a randomly selected sound from this list when preparing for an attack or attacking.
Delay 0 Integer Delay in ticks before sound starts, either relative to attack preparation or attack.
DelayRelativeTo Preparation AttackDelayType Should the sound be delayed relative to preparation or actual attack?
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

CaptureNotification

Property Default Value Type Description
Notification BuildingCaptured String The speech notification to play to the new owner.
NewOwnerVoice True Boolean Specifies if Notification is played with the voice of the new owners faction.
LoseNotification String The speech notification to play to the old owner.
LoseNewOwnerVoice False Boolean Specifies if LoseNotification is played with the voice of the new owners faction.

DeathSounds

Sounds to play when killed.

Property Default Value Type Description
Voice Die String Death notification voice.
VolumeMultiplier 1 Real Number Multiply volume with this factor.
DeathTypes Set of String Damage types that this should be used for (defined on the warheads). If empty, this will be used as the default sound for all death types.

SoundOnDamageTransition

Property Default Value Type Description
DamagedSounds Multiple String Play a random sound from this list when damaged.
DestroyedSounds Multiple String Play a random sound from this list when destroyed.

OpenRA.Mods.D2k.Traits

AttackSwallow

Sandworms use this attack model.

Property Default Value Type Description
ReturnDelay 60 Integer The number of ticks it takes to return underground.
AttackDelay 30 Integer The number of ticks it takes to get in place under the target to attack.
AttackingUpgrades attacking Multiple String The upgrades to grant while attacking.
WormAttackSound WORM.WAV String
WormAttackNotification WormAttack String
FacingTolerance 1 Integer
Armaments primary, secondary Multiple String Armament names
Cursor String
OutsideRangeCursor String
AttackRequiresEnteringCell False Boolean Does the attack type require the attacker to enter the target's cell?
IgnoresVisibility False Boolean Does not care about shroud or fog. Enables the actor to launch an attack against a target even if he has no visibility of it.
Voice Action String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

AttractsWorms

This actor makes noise, which causes them to be targeted by actors with the Sandworm trait.

Property Default Value Type Description
Intensity 0 Integer How much noise this actor produces.
Falloff 100, 100, 25, 11, 6, 4, 3, 2, 1, 0 Multiple Integer Noise percentage at Range step away from the actor.
Spread 3c0 1D World Distance Range between falloff steps.
Range Multiple 1D World Distance Ranges at which each Falloff step is defined. Overrides Spread.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

LaysTerrain

Requires trait: Building.

Property Default Value Type Description
Template 0 UInt16 The terrain template to place. If the template is PickAny, then the actor footprint will be filled with this tile.
TerrainTypes (required) Set of String The terrain types that this template will be placed on
Offset 0,0 2D Cell Vector Offset relative to the actor TopLeft. Not used if the template is PickAny

HarvesterInsurance

A player with this trait will receive a free harvester when his last one gets eaten by a sandworm, provided he has at least one refinery.

Sandworm

Requires traits: AttackBase, Mobile.

Property Default Value Type Description
TargetRescanInterval 125 Integer Time between rescanning for targets (in ticks).
MaxSearchRadius 20c0 1D World Distance The radius in which the worm "searches" for targets.
IgnoreNoiseAttackRange 3c0 1D World Distance The range at which the worm launches an attack regardless of noise levels.
ChanceToDisappear 100 Integer The chance this actor has of disappearing after it attacks (in %).
WanderMoveRadius 1 Integer
ReduceMoveRadiusDelay 5 Integer Number of ticks to wait before decreasing the effective move radius.
MinMoveDelay 0 Integer Minimum amount of ticks the actor will sit idly before starting to wander.
MaxMoveDelay 0 Integer Maximum amount of ticks the actor will sit idly before starting to wander.
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

SpiceBloom

Seeds resources by explosive eruptions after accumulation times.

Requires trait: RenderSprites.

Property Default Value Type Description
SpawnActor spicebloom.spawnpoint String
GrowthSequences grow1, grow2, grow3 Multiple String
RespawnDelay 1500, 2500 Multiple Integer The range of time (in ticks) that the spicebloom will take to respawn.
GrowthDelay 1000, 3000 Multiple Integer The range of time (in ticks) that the spicebloom will take to grow.
ResourceType Spice String
GrowthTerrainTypes Set of String Spice blooms only grow on these terrain types.
Weapon String The weapon to use for spice creation.
Pieces 2, 12 Multiple Integer The amount of spice to expel.
Range 5 Integer The maximum distance in cells that spice may be expelled.

TemporaryOwnerManager

Interacts with the ChangeOwner warhead. Displays a bar how long this actor is affected and reverts back to the old owner on temporary changes.

Property Default Value Type Description
BarColor FFA500 Color

BuildableTerrainLayer

Attach this to the world actor. Required for LaysTerrain to work.

Property Default Value Type Description
Palette terrain String Palette to render the layer sprites in.

D2kEditorResourceLayer

Used to render spice with round borders.

Requires trait: ResourceType.

D2kResourceLayer

Used to render spice with round borders.

Requires traits: BuildingInfluence, ResourceType.

FogPaletteFromR8

Property Default Value Type Description
Name (required) String Internal palette name
Filename (required) String Filename to load
Offset 0 Int64 Palette byte offset
AllowModifiers True Boolean
InvertColor False Boolean

PaletteFromR8

Property Default Value Type Description
Name (required) String Internal palette name
Filename (required) String Filename to load
Offset 0 Int64 Palette byte offset
AllowModifiers True Boolean
InvertColor False Boolean

PaletteFromScaledPalette

Create a palette by applying a scale and offset to the colors in another palette.

Property Default Value Type Description
Name (required) String Internal palette name
BasePalette (required) String The name of the palette to base off.
AllowModifiers True Boolean Allow palette modifiers to change the palette.
Scale 1 Real Number Amount to scale the base palette colors by.
Offset 0 Integer Amount to offset the base palette colors by.

WormManager

Controls the spawning of sandworms. Attach this to the world actor.

Requires trait: MapCreeps.

Property Default Value Type Description
Minimum 0 Integer Minimum number of worms
Maximum 4 Integer Maximum number of worms
SpawnInterval 6000 Integer Time (in ticks) between worm spawn.
WormSignature sandworm String Name of the actor that will be spawned.
WormSignNotification WormSign String
WormOwnerPlayer Creeps String

WormSpawner

An actor with this trait indicates a valid spawn point for sandworms.

OpenRA.Mods.D2k.Traits.Render

WithCrumbleOverlay

Rendered together with the "make" animation.

Requires trait: RenderSprites.

Property Default Value Type Description
Sequence crumble-overlay String Sequence name to use
Palette String Custom palette name
IsPlayerPalette False Boolean Custom palette is a player palette BaseName

WithDecorationCarryable

Displays a sprite when the carryable actor is waiting for pickup.

Requires trait: Carryable.

Property Default Value Type Description
Image String Image used for this decoration. Defaults to the actor's type.
Sequence String Sequence used for this decoration (can be animated).
Palette chrome String Palette to render the sprite in. Reference the world actor's PaletteFrom* traits.
ReferencePoint Top, Left ReferencePoints Point in the actor's selection box used as reference for offsetting the decoration image. Possible values are combinations of Center, Top, Bottom, Left, Right.
ZOffset 1 Integer The Z offset to apply when rendering this decoration.
ValidStances Ally Stance Player stances who can view the decoration.
RequiresSelection False Boolean Should this be visible only when selected?
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithDeliveryOverlay

Rendered when ProductionAirdrop is in progress.

Requires traits: BodyOrientation, RenderSprites.

Property Default Value Type Description
Sequence active String Sequence name to use
Offset 0,0,0 3D World Vector Position relative to body
Palette String Custom palette name
IsPlayerPalette False Boolean Custom palette is a player palette BaseName

OpenRA.Mods.RA.Effects

GpsDot

Attach this to actors to render pictograms while hidden.

Property Default Value Type Description
Image gpsdot String Sprite collection for symbols.
String Infantry String Sprite used for this actor.
IndicatorPalettePrefix player String

OpenRA.Mods.RA.Traits

AttackLeap

Dogs use this attack model.

Property Default Value Type Description
Speed 0c426 1D World Distance Leap speed (in units/tick).
Angle 56 1D World Angle
FacingTolerance 1 Integer
Armaments primary, secondary Multiple String Armament names
Cursor String
OutsideRangeCursor String
AttackRequiresEnteringCell False Boolean Does the attack type require the attacker to enter the target's cell?
IgnoresVisibility False Boolean Does not care about shroud or fog. Enables the actor to launch an attack against a target even if he has no visibility of it.
Voice Action String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

ClonesProducedUnits

Creates a free duplicate of produced units.

Requires traits: Exit, Production.

Property Default Value Type Description
CloneableTypes (required) Set of String Uses the "Cloneable" trait to determine whether or not we should clone a produced unit.

Chronoshiftable

Can be teleported via Chronoshift power.

Property Default Value Type Description
ExplodeInstead False Boolean Should the actor die instead of being teleported?
ChronoshiftSound chrono2.aud String
ReturnToOrigin True Boolean Should the actor return to its previous location after the chronoshift wore out?
TimeBarColor FFFFFF Color The color the bar of the 'return-to-origin' logic has.

Cloneable

Actors with the "ClonesProducedUnits" trait will produce a free duplicate of me.

Property Default Value Type Description
Types (required) Set of String This unit's cloneable type is:

DisguiseToolTip

Overrides the default ToolTip when this actor is disguised (aids in deceiving enemy players).

Requires trait: Disguise.

Property Default Value Type Description
GenericName String An optional generic name (i.e. "Soldier" or "Structure")to be shown to chosen players.
GenericStancePrefix True Boolean Prefix generic tooltip name with 'Enemy' or 'Allied'.
GenericVisibility None Stance Player stances that the generic name should be shown to.
ShowOwnerRow True Boolean Show the actor's owner and their faction flag
Icon icon String Sequence of the actor that contains the cameo.
Description String
Name String

Disguise

Provides access to the disguise command, which makes the actor appear to be another player's actor.

Property Default Value Type Description
Voice Action String
Upgrades disguise Multiple String Upgrades to grant when disguised.

FrozenUnderFogUpdatedByGps

Updates frozen actors of actors that change owners, are sold or die whilst having an active GPS power.

Requires trait: FrozenUnderFog.

GpsWatcher

Required for GpsPower. Attach this to the player actor.

HarvesterHuskModifier

Requires trait: Harvester.

Property Default Value Type Description
FullHuskActor String
FullnessThreshold 50 Integer

InfiltrateForCash

This structure can be infiltrated causing funds to be stolen.

Property Default Value Type Description
Percentage 100 Integer Percentage of the victim's resources that will be stolen.
Minimum -1 Integer Amount of guaranteed funds to claim when the victim does not have enough resources. When negative, the production price of the infiltrating actor will be used instead.
Maximum 2147483647 Integer Maximum amount of funds which will be stolen.
Notification String Sound the victim will hear when they get robbed.

InfiltrateForDecoration

Reveals a decoration sprite to the indicated players when infiltrated.

Property Default Value Type Description
Image String Image used for this decoration. Defaults to the actor's type.
Sequence String Sequence used for this decoration (can be animated).
Palette chrome String Palette to render the sprite in. Reference the world actor's PaletteFrom* traits.
ReferencePoint Top, Left ReferencePoints Point in the actor's selection box used as reference for offsetting the decoration image. Possible values are combinations of Center, Top, Bottom, Left, Right.
ZOffset 1 Integer The Z offset to apply when rendering this decoration.
ValidStances Ally Stance Player stances who can view the decoration.
RequiresSelection False Boolean Should this be visible only when selected?
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

InfiltrateForExploration

Steal and reset the owner's exploration.

InfiltrateForPowerOutage

Property Default Value Type Description
Duration 500 Integer

InfiltrateForSupportPower

Property Default Value Type Description
Proxy (required) String

Infiltrates

Property Default Value Type Description
Types Set of String
Voice Action String
ValidStances Enemy, Neutral Stance What diplomatic stances can be infiltrated by this actor.
EnterBehaviour Dispose EnterBehaviour Behaviour when entering the structure. Possible values are Exit, Suicide, Dispose.
Notification BuildingInfiltrated String Notification to play when a building is infiltrated.
PlayerExperience 0 Integer Experience to grant to the infiltrating player.

MadTank

Requires traits: Explodes, WithFacingSpriteBody.

Property Default Value Type Description
ThumpSequence piston String
ThumpInterval 8 Integer
ThumpDamageWeapon MADTankThump String
ThumpShakeIntensity 3 Integer
ThumpShakeMultiplier 1,0 2D Real Number
ThumpShakeTime 10 Integer
ChargeDelay 96 Integer Measured in ticks.
ChargeSound madchrg2.aud String
DetonationDelay 42 Integer Measured in ticks.
DetonationSound madexplo.aud String
DetonationWeapon MADTankDetonate String
DriverActor e1 String
Voice Action String

Mine

Property Default Value Type Description
CrushClasses Set of String
AvoidFriendly True Boolean
DetonateClasses Set of String

MineImmune

Tag trait for stuff that should not trigger mines.

Minelayer

Property Default Value Type Description
Mine minv String
RearmBuildings fix Set of String
AmmoPoolName primary String
MinefieldDepth 1c512 1D World Distance

ChronoshiftPaletteEffect

Apply palette full screen rotations during chronoshifts. Add this to the world actor.

Property Default Value Type Description
ChronoEffectLength 60 Integer Measured in ticks.

LightPaletteRotator

Palette effect used for blinking "animations" on actors.

Property Default Value Type Description
ExcludePalettes Set of String

PortableChrono

Property Default Value Type Description
ChargeDelay 500 Integer Cooldown in ticks until the unit can teleport.
HasDistanceLimit True Boolean Can the unit teleport only a certain distance?
MaxDistance 12 Integer The maximum distance in cells this unit can teleport (only used if HasDistanceLimit = true).
ChronoshiftSound chrotnk1.aud String Sound to play when teleporting.
DeployCursor deploy String Cursor to display when able to deploy the actor.
DeployBlockedCursor deploy-blocked String Cursor to display when unable to deploy the actor.
TargetCursor chrono-target String Cursor to display when targeting a teleport location.
TargetBlockedCursor move-blocked String Cursor to display when the targeted location is blocked.
Voice Action String

RenderJammerCircle

RenderShroudCircle

ChronoshiftPower

Property Default Value Type Description
Range 1 Integer Target actor selection radius in cells.
Duration 30 Integer Seconds until returning after teleportation.
TargetOverlayPalette terrain String
OverlaySpriteGroup overlay String
ValidTileSequencePrefix target-valid- String
InvalidTileSequence target-invalid String
SourceTileSequence target-select String
KillCargo True Boolean
SelectionCursor chrono-select String Cursor sequence to use when selecting targets for the chronoshift.
TargetCursor chrono-target String Cursor sequence to use when targeting an area for the chronoshift.
TargetBlockedCursor move-blocked String Cursor sequence to use when the targeted area is blocked.
ChargeTime 0 Integer Measured in seconds.
Icon String
Description String
LongDesc String
AllowMultiple False Boolean
OneShot False Boolean
Cursor ability String Cursor to display for using this support power.
StartFullyCharged False Boolean If set to true, the support power will be fully charged when it becomes available. Normal rules apply for subsequent charges.
Prerequisites Multiple String
BeginChargeSound String
BeginChargeSpeechNotification String
EndChargeSound String
EndChargeSpeechNotification String
SelectTargetSound String
SelectTargetSpeechNotification String
InsufficientPowerSound String
InsufficientPowerSpeechNotification String
LaunchSound String
LaunchSpeechNotification String
IncomingSound String
IncomingSpeechNotification String
DisplayTimerStances None Stance Defines to which players the timer is shown.
IconPalette chrome String Palette used for the icon.
DisplayBeacon False Boolean Beacons are only supported on the Airstrike, Paratroopers, and Nuke powers
BeaconPaletteIsPlayerPalette True Boolean
BeaconPalette player String
BeaconImage beacon String
BeaconPoster String
BeaconPosterPalette chrome String
ClockSequence clock String
ArrowSequence arrow String
CircleSequence circles String
DisplayRadarPing False Boolean
RadarPingDuration 125 Integer Measured in ticks.
OrderName ChronoshiftPowerInfoOrder String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

GpsPower

Requires GpsWatcher on the player actor.

Property Default Value Type Description
RevealDelay 0 Integer
DoorImage atek String
DoorSequence active String
DoorPalette player String Palette to use for rendering the launch animation
DoorPaletteIsPlayerPalette True Boolean Custom palette is a player palette BaseName
SatelliteImage sputnik String
SatelliteSequence idle String
SatellitePalette player String Palette to use for rendering the satellite projectile
SatellitePaletteIsPlayerPalette True Boolean Custom palette is a player palette BaseName
RequiresActiveRadar True Boolean Requires an actor with an online `ProvidesRadar` to show GPS dots.
ChargeTime 0 Integer Measured in seconds.
Icon String
Description String
LongDesc String
AllowMultiple False Boolean
OneShot False Boolean
Cursor ability String Cursor to display for using this support power.
StartFullyCharged False Boolean If set to true, the support power will be fully charged when it becomes available. Normal rules apply for subsequent charges.
Prerequisites Multiple String
BeginChargeSound String
BeginChargeSpeechNotification String
EndChargeSound String
EndChargeSpeechNotification String
SelectTargetSound String
SelectTargetSpeechNotification String
InsufficientPowerSound String
InsufficientPowerSpeechNotification String
LaunchSound String
LaunchSpeechNotification String
IncomingSound String
IncomingSpeechNotification String
DisplayTimerStances None Stance Defines to which players the timer is shown.
IconPalette chrome String Palette used for the icon.
DisplayBeacon False Boolean Beacons are only supported on the Airstrike, Paratroopers, and Nuke powers
BeaconPaletteIsPlayerPalette True Boolean
BeaconPalette player String
BeaconImage beacon String
BeaconPoster String
BeaconPosterPalette chrome String
ClockSequence clock String
ArrowSequence arrow String
CircleSequence circles String
DisplayRadarPing False Boolean
RadarPingDuration 125 Integer Measured in ticks.
OrderName GpsPowerInfoOrder String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

ParatroopersPower

Property Default Value Type Description
UnitType badr String
SquadSize 1 Integer
SquadOffset -1536,1536,0 3D World Vector
QuantizedFacings 32 Integer Number of facings that the delivery aircraft may approach from.
Cordon 5c0 1D World Distance Spawn and remove the plane this far outside the map.
DropItems Multiple String Troops to be delivered. They will be distributed between the planes if SquadSize > 1.
AllowImpassableCells False Boolean Risks stuck units when they don't have the Paratrooper trait.
CameraActor String Actor to spawn when the paradrop starts.
CameraRemoveDelay 85 Integer Amount of time (in ticks) to keep the camera alive while the passengers drop.
BeaconDistanceOffset 4c0 1D World Distance Weapon range offset to apply during the beacon clock calculation.
ChargeTime 0 Integer Measured in seconds.
Icon String
Description String
LongDesc String
AllowMultiple False Boolean
OneShot False Boolean
Cursor ability String Cursor to display for using this support power.
StartFullyCharged False Boolean If set to true, the support power will be fully charged when it becomes available. Normal rules apply for subsequent charges.
Prerequisites Multiple String
BeginChargeSound String
BeginChargeSpeechNotification String
EndChargeSound String
EndChargeSpeechNotification String
SelectTargetSound String
SelectTargetSpeechNotification String
InsufficientPowerSound String
InsufficientPowerSpeechNotification String
LaunchSound String
LaunchSpeechNotification String
IncomingSound String
IncomingSpeechNotification String
DisplayTimerStances None Stance Defines to which players the timer is shown.
IconPalette chrome String Palette used for the icon.
DisplayBeacon False Boolean Beacons are only supported on the Airstrike, Paratroopers, and Nuke powers
BeaconPaletteIsPlayerPalette True Boolean
BeaconPalette player String
BeaconImage beacon String
BeaconPoster String
BeaconPosterPalette chrome String
ClockSequence clock String
ArrowSequence arrow String
CircleSequence circles String
DisplayRadarPing False Boolean
RadarPingDuration 125 Integer Measured in ticks.
OrderName ParatroopersPowerInfoOrder String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

OpenRA.Mods.RA.Traits.Render

WithDisguisingInfantryBody

Requires traits: Disguise, RenderSprites.

Property Default Value Type Description
MinIdleDelay 30 Integer
MaxIdleDelay 110 Integer
MoveSequence run String
AttackSequence String
IdleSequences Multiple String
StandSequences stand Multiple String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

WithLandingCraftAnimation

Requires traits: Cargo, WithSpriteBody.

Property Default Value Type Description
OpenTerrainTypes Clear Set of String
OpenSequence open String
CloseSequence close String
UnloadSequence unload String

OpenRA.Mods.TS.Traits

PlaceSimpleBeacon

A beacon that consists of a single sprite that can be animated.

Property Default Value Type Description
Duration 750 Integer
NotificationType Sounds String
Notification Beacon String
IsPlayerPalette False Boolean
Palette effect String
BeaconImage beacon String
BeaconSequence idle String

LowBridge

Bridge actor that can't be passed underneath.

Requires trait: Building.

Property Default Value Type Description
TerrainType Road String

TiberianSunRefinery

Requires trait: WithSpriteBody.

Property Default Value Type Description
DockAngle 0 Integer Actual harvester facing when docking, 0-255 counter-clock-wise.
DockOffset 0,0 2D Cell Vector Docking cell relative to top-left cell.
IsDragRequired False Boolean Does the refinery require the harvester to be dragged in?
DragOffset 0,0,0 3D World Vector Vector by which the harvester will be dragged when docking.
DragLength 0 Integer In how many steps to perform the dragging?
DiscardExcessResources False Boolean Discard resources once silo capacity has been reached.
ShowTicks True Boolean
TickLifetime 30 Integer
TickVelocity 2 Integer
TickRate 10 Integer

AttackOrderPower

Requires trait: AttackBase.

Property Default Value Type Description
ChargeTime 0 Integer Measured in seconds.
Icon String
Description String
LongDesc String
AllowMultiple False Boolean
OneShot False Boolean
Cursor ability String Cursor to display for using this support power.
StartFullyCharged False Boolean If set to true, the support power will be fully charged when it becomes available. Normal rules apply for subsequent charges.
Prerequisites Multiple String
BeginChargeSound String
BeginChargeSpeechNotification String
EndChargeSound String
EndChargeSpeechNotification String
SelectTargetSound String
SelectTargetSpeechNotification String
InsufficientPowerSound String
InsufficientPowerSpeechNotification String
LaunchSound String
LaunchSpeechNotification String
IncomingSound String
IncomingSpeechNotification String
DisplayTimerStances None Stance Defines to which players the timer is shown.
IconPalette chrome String Palette used for the icon.
DisplayBeacon False Boolean Beacons are only supported on the Airstrike, Paratroopers, and Nuke powers
BeaconPaletteIsPlayerPalette True Boolean
BeaconPalette player String
BeaconImage beacon String
BeaconPoster String
BeaconPosterPalette chrome String
ClockSequence clock String
ArrowSequence arrow String
CircleSequence circles String
DisplayRadarPing False Boolean
RadarPingDuration 125 Integer Measured in ticks.
OrderName AttackOrderPowerInfoOrder String
UpgradeTypes Set of String The upgrade types which can enable or disable this trait.
UpgradeMinEnabledLevel 0 Integer The minimum upgrade level at which this trait is enabled. Defaults to 0 (enabled by default).
UpgradeMaxEnabledLevel 2147483647 Integer The maximum upgrade level at which the trait is enabled. Defaults to UpgradeMaxAcceptedLevel (enabled for all levels greater than UpgradeMinEnabledLevel). Set this to a value smaller than UpgradeMaxAcceptedLevel to disable the trait at higher levels. Use UpgradeMaxAcceptedLevel: 2 (1 more) to be able to extend upgrade time.
UpgradeMaxAcceptedLevel 1 Integer The maximum upgrade level that this trait will accept.

TSShroudPalette

Adds the hard-coded shroud palette to the game

Property Default Value Type Description
Name (required) String Internal palette name

OpenRA.Mods.TS.Traits.Render

WithDockingOverlay

Rendered on the refinery when a voxel harvester is docking and undocking.

Requires traits: BodyOrientation, RenderSprites.

Property Default Value Type Description
Sequence unload-overlay String Sequence name to use
Offset 0,0,0 3D World Vector Position relative to body
Palette String Custom palette name
IsPlayerPalette False Boolean Custom palette is a player palette BaseName

WithPermanentInjury

Change the sprite after a certain amount of damage is taken, even when the hitpoints are regenerated.

Property Default Value Type Description
TriggeringDamageStage Critical DamageState
InjuredSequencePrefix crippled- String

WithVoxelUnloadBody

Requires trait: RenderVoxels.

Property Default Value Type Description
UnloadSequence unload String Voxel sequence name to use when docked to a refinery.
IdleSequence idle String Voxel sequence name to use when undocked from a refinery.

WithVoxelWalkerBody

Requires trait: RenderVoxels.

Property Default Value Type Description
TickRate 5 Integer

OpenRA.Traits

DebugPauseState

Checks for pause related desyncs. Attach this to the world actor.

DeveloperMode

Attach this to the player actor.

Property Default Value Type Description
Enabled False Boolean Default value of the developer mode checkbox in the lobby.
Locked False Boolean Prevent the developer mode state from being changed in the lobby.
Cash 20000 Integer Default cash bonus granted by the give cash cheat.
ResourceGrowth 100 Integer Growth steps triggered by the grow resources button.
FastBuild False Boolean Enable the fast build cheat by default.
FastCharge False Boolean Enable the fast support powers cheat by default.
DisableShroud False Boolean Enable the disable visibility cheat by default.
UnlimitedPower False Boolean Enable the unlimited power cheat by default.
BuildAnywhere False Boolean Enable the build anywhere cheat by default.
PathDebug False Boolean Enable the path debug overlay by default.
ShowCombatGeometry False Boolean Enable the combat geometry overlay by default.
ShowDebugGeometry False Boolean Enable the debug geometry overlay by default.
ShowDepthPreview False Boolean Enable the depth buffer overlay by default.
ShowActorTags False Boolean Enable the actor tags overlay by default.

FixedColorPalette

Add this to the World actor definition.

Property Default Value Type Description
Base terrain String The name of the palette to base off.
Name resources String The name of the resulting palette
RemapIndex Multiple Integer Remap these indices to pre-defined colors.
Color 00000000 Color The fixed color to remap.
Ramp 0.05 Real Number Luminosity range to span.
AllowModifiers True Boolean Allow palette modifiers to change the palette.

FrozenActorLayer

Required for FrozenUnderFog to work. Attach this to the player actor.

Requires trait: Shroud.

Property Default Value Type Description
BinSize 10 Integer Size of partition bins (cells)

IndexedPlayerPalette

Define a player palette by swapping palette indices.

Property Default Value Type Description
BasePalette String The name of the palette to base off.
BaseName player String The prefix for the resulting player palettes
RemapIndex Multiple Integer Remap these indices to player colors.
AllowModifiers True Boolean Allow palette modifiers to change the palette.
PlayerIndex Dictionary

PlayerColorPalette

Add this to the Player actor definition.

Property Default Value Type Description
BasePalette String The name of the palette to base off.
BaseName player String The prefix for the resulting player palettes
RemapIndex Multiple Integer Remap these indices to player colors.
Ramp 0.05 Real Number Luminosity range to span.
AllowModifiers True Boolean Allow palette modifiers to change the palette.

PlayerHighlightPalette

Add this to the Player actor definition.

Property Default Value Type Description
BaseName highlight String The prefix for the resulting player palettes

PlayerResources

Property Default Value Type Description
SelectableCash 2500, 5000, 10000, 20000 Multiple Integer Starting cash options that are available in the lobby options.
DefaultCash 5000 Integer Default starting cash option: should be one of the SelectableCash options.
DefaultCashLocked False Boolean Force the DefaultCash option by disabling changes in the lobby.
InsufficientFundsNotification String Speech notification to play when the player does not have any funds.
InsufficientFundsNotificationDelay 750 Integer Delay (in ticks) during which warnings will be muted.

Selectable

This actor is selectable. Defines bounds of selectable area, selection class and selection priority.

Property Default Value Type Description
Priority 10 Integer
Bounds Multiple Integer Bounds for the selectable area.
Class String All units having the same selection class specified will be selected with select-by-type commands (e.g. double-click). Defaults to the actor name when not defined or inherited.
Voice Select String

ActorMap

Property Default Value Type Description
BinSize 10 Integer Size of partition bins (cells)

Faction

Attach this to the World actor.

Property Default Value Type Description
Name String This is the name exposed to the players.
InternalName String This is the internal name for owner checks.
RandomFactionMembers Set of String Pick a random faction as the player's faction out of this list.
Side String The side that the faction belongs to. For example, England belongs to the 'Allies' side.
Description String
Selectable True Boolean

ResourceType

Property Default Value Type Description
Sequence resources String
Variants Multiple String
Palette terrain String
ResourceType 1 Integer
ValuePerUnit 0 Integer
MaxDensity 10 Integer
Name String
TerrainType Ore String
AllowedTerrainTypes Set of String
AllowUnderActors False Boolean
AllowUnderBuildings False Boolean
AllowOnRamps False Boolean
PipColor Yellow PipType

ScreenMap

Property Default Value Type Description
BinSize 250 Integer Size of partition bins (world pixels)

ScreenShaker

Property Default Value Type Description
MinMultiplier -3,-3 2D Real Number
MaxMultiplier 3,3 2D Real Number

Shroud

Required for shroud and fog visibility checks. Add this to the player actor.

Property Default Value Type Description
FogEnabled True Boolean Default value of the fog checkbox in the lobby.
FogLocked False Boolean Prevent the fog enabled state from being changed in the lobby.
ExploredMapEnabled False Boolean Default value of the explore map checkbox in the lobby.
ExploredMapLocked False Boolean Prevent the explore map enabled state from being changed in the lobby.

openra.net - forum.openra.net - discord.openra.net - bugs.openra.net - docs.openra.net - logs.openra.net - resource.openra.net - openra.net/book - academy.openra.net - wiki.openra.net

Players 🎲

Modders ✏️

Developers 🔧

Clone this wiki locally