Data/Actors/Simple

## Simple

### Description

Similar to Event Macros, this actor supplements the Event: Events+ field on actors. Unlike Event Macros this actor is not added to specific actors, instead it creates itself whenever the events trigger. Event actions must be directed at their target actor to produce visible effects.

### Hint

* Used scarcely, all existing instances react to a Behavior being applied to a unit and change visual settings and/or play animations.
* Most effects use Model type actors for unique visuals or Event Macros to play animations.

## Example Usage

### RecallOpacity

The actor that turns units blue and semi-transparent while under the effects of the Mothership's Mass Recall ability, referenced by the Behaviors Recalling and Recalled. Note that the Set Opacity and Set Tint Color event actions are directed at the host Unit actors via the **Target** field using the **Alias** \_Unit, without this addition they would affect the **Simple** actor itself, which has no visual representation in game.
Also note the tint/opacity actions are given the unique names MassRecallTint/MassRecallOpacity so as to only remove these, rather than all tints/opacities, after the ability completes.

#### Hallucination Tinter

This is an heavy tip from a deep discovery: The way Sentry make hallucinations works by putting a specific behavior on a unit. That behavior (Sentry - Hallucination) is being validated as "on" or "off", used by every CActorUnit in their default events that triggers upon if the unit is detected by viewer or not. Those events respond with a signal to the alias \_HallucinationTinter, used by a Simple actor named: High Templar Hallucination. Here's the thing: if you wish to remake your own hallucination ability, you have to change the core validator from CActor unit to something more generic, if you want the tint of an hallucination to change to blue. All units have that same core event, so you might want to change it on the core CActor Unit.

## 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
* Is limited by the setting of the **UI: Fog Visibility** field under the Units data type
* Pointless as this actor has no visuals

### Actor - Sharing

* Determines to what degree the same actor is shared by a unit if there are multiple functions referring 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

### Event - Macros

* The Event Macro actors used to supplement the events
* Pointless for the most part, as this actor type itself acts similar to an **Event Macro**

### 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:** 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:** Uses the scope of the source of the effect to choose the source unit as the subject
* **Scope Target:** 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

* Events
* Event Macro