Data/Actors/Site Operation (Local Offset)

## Site Operation (Local Offset)

### Description

SOp used to offset actors from their default position, which is usually centred on the host actor

### Hint

* May need a lot of fine tuning to get just right
* Often used for **Model Additions** or to correct heights
* Can be combined with other SOps like **Forward Vector** or **Rotator** to create custom animations

## Example Usage

### GhostEMPOffset

SOp used to raise the EMP impact model, without this the center of the explosion would occur exactly at ground level. Used by **Ghost EMP Attack** under **Combat: Impact Point Site Operations - Operations**

#### URL

The Ghost is part of the core game, no URL is needed

## Fields Description

### Actor - Aliases

* Aliases that refer to the actor in Events or in Hosting as a subject

### Actor - Filter

* Determines what players can see the actor depending on their diplomatic status eg. Nuke Target/Indicator
* Pointless as this actor has no visuals

### Actor - Flags

* **Add To External Finder:** (Unknown)
* **Not Saved:** (Unknown) used by all temporary Model actors
* **Scale To Host:** overrides any scaling the actor has and sets it to the host Unit actor
* **Suppress Creation Errors:** (Unknown)

### Actor - Fog Visibility

* Determines how the actor appears under the fog of war
* Limited by the setting in the **UI: Fog Visibility** field under the Units data type
* Pointless as this actor has no visuals

### Actor - Hold Position

* If enabled the actor with this SOp is locked in the position relative to the global map grid but turns to face the desired direction
* Useful for stationary abilities or structures that have parts which need to face a moving target

### Actor - Hold Rotation

* If enabled the actor with this SOp is locked with it's rotation facing the direction of creation relative to the global map grid

### Actor - Local Offset

* The actual offset vector, the core value for this SOp
* Unlike directional vectors this is not normalised, these values determine the actual offset
* When placed on units -Y is forwards, +X is left and +Z is up

### Actor - Sharing

Determines to what degree the same actor is shared by a unit if there are multiple functions refering to it

* **Always:** means the actor is always shared
* **None:** means the actor is never shared
* **Per Effect Tree:** means that effects within an effect tree share the actor but different effect trees can't

### Event - Events+

* Series of minitriggers that determine the motions and visual effects of the model
* Covered in detail in the Events section of the wiki
* Apparently have no effect on SOps

### Event - Macros

* The [{Data/Actors/Event Macro|Event Macro]] actors used to supplement the events

### Hosting - Host Supporter - Actor

* **Actor Find:** (Not Sure) means the actor has to be found using the scope
* **Creation:** (Not Sure) is the actor that creates this actor is given priority for hosting if there is a choice of several
* **Implicit:** is the default

### Hosting - Host Supporter - Effect

The effect whose scope is used in combination with the Hosting - Host Supporter - Scope field to determine valid subjects

### Hosting - Host Supporter - Fail If No Host

* Causes the model to be automatically destroyed if no host

### Hosting - Host Supporter - Scope

* **Implicit:** is the default but gives an error message if using the scope of an effect
* **Scope Caster:** (Unsure) Uses the scope of the caster of the effect to choose the caster unit as the subject
* **Scope Effect:** (Unknown)
* **Scope Missile:** (Unknown)
* **Scope Outer:** (Unknown)
* **Scope Source:** (Unknown) Uses the scope of the source of the effect to choose the source unit as the subject
* **Scope Target:** (Unknown) Uses the scope of the target of the effect to choose the target unit as the subject

### Hosting - Host Supporter - Subject

* Actor, alias or reference refered to by the **::Supporter** system reference for Events

### Properties - Accepted Property Transfers

* When this actor is in the Hosting - Host - Subject field of another actor, this field determines what properties are able to be inherited from this actor
* As this actor has no visuals this field is pointless
* **Cast Shadows:** allows the attached actor to cast shadows
* **Cloak Effect:** allows the attached actor to show the cloaking bluish effect
* **Decal:** allows the attached actor to show the host unit decal
* **Local Tint Color:** (Unknown)
* **Model Scale:** makes the actor inherit the scale for the host model
* **Opacity:** spreads the opacity set by the Set Opacity event to attached actors
* **Physics State:** (Unknown)
* **Scale:** transfers the scale of the host actor to the attached actors
* **Team Color:** makes the attached actor show the team colour if it can
* **Time Scale:** means the animations of the attached actor are the same as the host actors timescale
* **Tint Color:** (Unknown)
* **Visibility:** allows the attached actor to share the host actor's Actor - Fog Visibility
* **Warp Group:** (Unknown)

### Properties - Accepted Transfers

* As this actor has no visuals this field is pointless
* **Animation Properties:** (Unknown)
* **Animator:** (Unknown)
* **Fog Of War Color:** (Unknown)
* **Fog Of War Shader:** (Unknown)
* **Model:** (Unknown)
* **Position:** (Unknown)
* **Rotation:** (Unknown)
* **Status:** (Unknown)
* **Textures:** (Unknown)

### Properties - Inherit Type

* As this actor has no visuals this field is pointless
* Determines how often the host properties are inherited
* **Continuous:** means the properties are continuously inherited from the host
* **None:** means properties are not inherited from the host
* **Once:** means properties are only inherited on actor creation

### Properties - Inherited Properties

* This field determines what properties are able to be inherited from the actor in the Hosting - Host - Subject or Hosting - Host For Properties - Subject field
* **Cast Shadows:** allows the attached actor to cast shadows
* **Cloak Effect:** allows the attached actor to show the cloaking bluish effect
* **Decal:** allows the attached actor to show the host unit decal
* **Local Tint Color:** (Unknown)
* **Model Scale:** makes the actor inherit the scale for the host model
* **Opacity:** spreads the opacity set by the Set Opacity event to attached actors
* **Physics State:** (Unknown)
* **Scale:** transfers the scale of the host actor to the attached actors
* **Team Color:** makes the attached actor show the team colour if it can
* **Time Scale:** means the animations of the attached actor are the same as the host actors timescale
* **Tint Color:** (Unknown)
* **Visibility:** allows the attached actor to share the host actor's Actor - Fog Visibility
* **Warp Group:** (Unknown)
* As this actor has no visuals this field is pointless

## Related

* Actors
* Model (actor)