Data\Actor\Site Operation
Site operations are special actors that modify the position or rotation of other actors.
They can be used to do things like adding offsets to attached models or rotating a model to be upside down. Some site operations can also be used to apply motion over time to create basic "animations", such as making a unit spin or slowly float up and then down.
Site operations can be applied via various Site Operation fields or through Actor Events. Site operations stack cumulatively in the order in which they are applied.
Note: Unit actors (and site operations applied to them) are purely the visual representation and not game objects themselves. Applying site operations to offset or rotate a unit actor does not change the unit's position or facing.
Offset
MessageType: Offset
Applies an offset to the actor's position.
The offset is relative to the Orientation.
Rotate
Rotates an actor.
The X/Y/Z fields are used to apply static rotation (or a one-off rotation over time using actor Events). The Dx/Dy/Dz field are used to apply a constant rotation over time (aka spin). The rotation is relative to the Orientation.
Note: Event Orientation and Move Orientation settings are special cases that behave slightly differently than other orientations.
X
The rotation in degrees around the X axis (aka Pitch).
Y
The rotation in degrees around the Y axis (aka Yaw).
Z
The rotation in degrees around the Z axis (aka Roll).
Dx
The rotation in degrees per second around the X axis.
Dy
The rotation in degrees per second around the Y axis.
Dz
The rotation in degrees per second around the Z axis.
Orientation
EnumType: SiteOperation.OrientationType
Determines relative orientation of the rotation.
Absolute Height
Set's the absolute height (or Y position) of the actor. Can be used to make aura VFX appear at ground height regardless of unit height (assuming no cliffs are used).
Functionally similar to Absolute Y Site Op.
Height
Sets the absolute height of the actor.
Hold Position
Makes the actor no longer update position or rotation.
Absolute Offset
Sets the absolute position of an actor using world orientation.
X
Horizontal position on the world grid. A value of 0 is the map's left edge.
Y
Height position on the world grid. A value of 0 is the map's base height.
Z
Vertical position on the world grid. A value of 0 is the map's bottom edge.
X Range
If set, a random value between 0 and the X Range will be applied to the X position when this site operation is applied. Only accepts positive values.
Y Range
If set, a random value between 0 and the Y Range will be applied to the Y position when this site operation is applied. Only accepts positive values.
Z Range
If set, a random value between 0 and the Z Range will be applied to the Z position when this site operation is applied. Only accepts positive values.
Absolute X
Locks the actor to a specific X value on the world grid.
X
Horizontal position on the world grid. A value of 0 is the map's left edge.
X Range
If set, a random value between 0 and the X Range will be applied to the X position when this site operation is applied. Only accepts positive values.
Absolute Y
Locks the actor to a specific Y value on the world grid.
Functionally similar to the Absolute Height Site Op.
Y
Height position on the world grid. A value of 0 is the map's base height.
Y Range
If set, a random value between 0 and the Y Range will be applied to the Y position when this site operation is applied. Only accepts positive values.
Absolute Z
Locks the actor to a specific Z value on the world grid.
Z
Vertical position on the world grid. A value of 0 is the map's bottom edge.
Z Range
If set, a random value between 0 and the Z Range will be applied to the Z position when this site operation is applied. Only accepts positive values.
Ballistic Move
Makes the actor move to a target position. Works the same as a Ballistic Mover.
Target Position Offset
MessageType: Offset
The offset for the target position of this site operation. This offset is relative the source actor's position and facing. Note that BallisticMove siteOperation may not work correctly with other siteOperation types that also change actors' positions.
Flight Time
When set, the actor move speed will be adjusted so that it takes this time to reach its target, regardless of the distance. When using flight time, speed should be set to 0.
Flight Time Range
A random value between 0 and this value is added to the flight time.
Speed
Speed of the Actor. When using speed, flight time should be set to 0. Speed is measured in terrain grid-units-per-second.
Speed Range
A random value between 0 and this value is added to the speed.
Gravity
Used to determine the height of the arc. Higher values mean a higher arc.
Orbit
Makes the actor orbit its host site.
Radius
Sets the offset radius that the actor will orbit round its host.
Speed
Sets the speed of the orbit in degrees per second.