Skip to content
Unofficial ChilloutVR Reference

CVR Advanced Avatar Settings Trigger

Modifies advanced avatar settings parameter values when a CVR Pointer enters the trigger area. The class is a subclass of CVRTrigger and registers itself with the contact system (TriggerToContact.Create) on Start. Size and placement are configured below; the trigger moves with its parented armature bone or GameObject. If another collider (Box, Sphere, Mesh, etc.) sits on the same GameObject, that collider becomes the trigger area. Non-convex Mesh Colliders are not supported.

Fields

Section titled “Fields”
Area Size
Section titled “Area Size”

Vector3. Size of the trigger area. Default (0.05, 0.05, 0.05).

Area Offset
Section titled “Area Offset”

Vector3. Offset from the GameObject center. Default (0, 0, 0).

Setting Name
Section titled “Setting Name”

string. Parameter name of the AAS setting to modify.

Setting Index
Section titled “Setting Index”

int. Resolved AAS setting index. Populated by the inspector.

Setting Value
Section titled “Setting Value”

float. Default value used when no task-specific value is configured.

Use Advanced Trigger
Section titled “Use Advanced Trigger”

bool. Enables the advanced (pointer-filtered, task-list) mode. When false, a simple single-value override is used.

Is Local Interactable
Section titled “Is Local Interactable”

bool. Default true. Allows this trigger to fire from local pointers.

Is Network Interactable
Section titled “Is Network Interactable”

bool. Default true. Allows this trigger to fire from remote pointers.

Allow Particle Interaction
Section titled “Allow Particle Interaction”

bool. Allows particle systems carrying a CVRPointer to activate this trigger. Particles can only fire the Enter tasks.

Allowed Pointers
Section titled “Allowed Pointers”

List<CVRPointer>. Whitelist of specific pointer instances. Other pointers are ignored.

Allowed Types
Section titled “Allowed Types”

string[]. Whitelist of CVRPointer.type strings.

Sample Direction
Section titled “Sample Direction”

SampleDirection enum: XPositive, XNegative, YPositive, YNegative, ZPositive, ZNegative. Axis used by SetFromPosition / SetFromDistance stay tasks to map position to value.

Enter Tasks

Section titled “Enter Tasks”

List<CVRTriggerTask>. Each entry runs when a pointer enters the trigger. Fields:

  • settingName / settingIndex — target AAS parameter.
  • settingValue — value used by the update method.
  • delay — seconds to wait before the task fires.
  • holdTime — how long the pointer must remain inside before the task fires.
  • updateMethod — UpdateMethod enum:
    • Override (default) — replace the parameter value.
    • Add — add settingValue.
    • Subtract — subtract settingValue.
    • Toggle — flip between 0 and settingValue (or 0/1).
    • SetFromPointer — use the pointer’s value field.

Exit Tasks

Section titled “Exit Tasks”

List<CVRTriggerTask>. Same shape as enter tasks; fires when the pointer leaves (after the configured delay). holdTime is not used on exit.

Stay Tasks

Section titled “Stay Tasks”

List<CVRTriggerTaskStay>. Fire continuously while a pointer is inside. Fields:

  • settingName / settingIndex — target parameter.
  • minValue / maxValue — range bounds (default 0..1).
  • updateMethod — UpdateMethod enum:
    • SetFromPosition (default) — map the pointer’s position along sampleDirection to [minValue, maxValue].
    • Add — add maxValue per second, clamped.
    • Subtract — subtract maxValue per second, clamped.
    • SetFromDistance — map distance from the trigger center.
    • SetFromPointer — use the pointer’s value field.
Section titled “Related”

Source

Section titled “Source”

CVR-GameFiles/ABI.CCK.Components/CVRAdvancedAvatarSettingsTrigger.cs, CVR-GameFiles/ABI.CCK.Components/CVRTrigger.cs, CVR-GameFiles/ABI.CCK.Components/CVRTriggerTask.cs, CVR-GameFiles/ABI.CCK.Components/CVRTriggerTaskStay.cs