> ## Documentation Index
> Fetch the complete documentation index at: https://docs.altoura.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Clear Pause Triggers

> Remove previously configured pause triggers so training continues without interruption

## Overview

The **Clear Pause Triggers** action removes pause trigger registrations that were previously set up by **Pause Training**. Use it when a phase of the training is complete and the safety boundaries, acknowledgment triggers, or collision pauses no longer need to fire.

Pause triggers attach to specific scene objects. Clear Pause Triggers can either tear down **every** trigger in the session, or target **specific objects** so that other triggers remain active.

## When to Use

* **End of a hazardous phase** — Remove safety-zone triggers once the learner has left the restricted area
* **Phase transitions** — Clear step-specific pauses before moving to the next chapter
* **Selective cleanup** — Remove pause triggers on some objects while keeping triggers on others active
* **Reset the scene** — Clear every configured pause trigger in one step (for example, at the end of the training)

## Parameters

| Parameter        | Type        | Required | Description                                                                                                 |
| ---------------- | ----------- | -------- | ----------------------------------------------------------------------------------------------------------- |
| Objects to Clear | Object List | No       | Specific scene objects whose pause triggers should be removed. **Leave empty to clear all pause triggers.** |

<Note>
  If the **Objects to Clear** list is empty, every pause trigger currently registered in the session is removed. Select one or more objects to clear only their triggers and leave other pauses in place.
</Note>

### Selecting Objects

Pick objects using the standard object picker. You can also enter the 3D scene pick mode — the panel shows the guidance:

> *Click objects in the 3D scene whose pause triggers should be cleared. Leave empty to clear all.*

Each selected object appears in the **Objects to Clear** list and can be removed with a single click.

## Example: Clear All Triggers at End of Phase

```
State: SafetyPhaseComplete
  onEntry:
    → Show Panel
        Title: "Safety Phase Complete"
        Display Text: "You have completed the safety awareness section."
    → Clear Pause Triggers
        Objects to Clear: []   # empty = clear all
```

All pause triggers registered during the safety phase are removed. The learner can move freely in subsequent phases without hitting leftover pause boundaries.

## Example: Selective Cleanup

```
State: EnterWorkArea
  onEntry:
    → Clear Pause Triggers
        Objects to Clear:
          - "restricted-zone-door-01"
          - "restricted-zone-door-02"
```

Only the pause triggers on the two named doors are cleared. Other pause triggers (for example, on hazardous equipment) remain active.

## How It Works with Pause Training

* **Pause Training** registers a pause trigger on one or more scene objects. When the learner interacts with or approaches a registered object, the training pauses and shows the configured message.
* **Clear Pause Triggers** removes those registrations. If every object in a pause group is cleared, the whole trigger is removed.

Think of **Pause Training** as "arm these triggers" and **Clear Pause Triggers** as "disarm them."

## Best Practices

<Steps>
  <Step title="Pair with Pause Training">
    For every **Pause Training** added to a phase, decide whether it should persist or be cleared at the end of the phase. Leaving stale triggers active can cause confusing pauses later in the training.
  </Step>

  <Step title="Use empty list for end-of-training resets">
    At the final state of a training, clearing all pause triggers guarantees a clean state if the learner restarts or continues.
  </Step>

  <Step title="Clear selectively between phases">
    If only some triggers are no longer needed, list those objects explicitly instead of clearing everything.
  </Step>

  <Step title="Place in onEntry or onExit">
    **onExit** of the phase that established the triggers is a natural place to clear them. **onEntry** of a new phase also works.
  </Step>
</Steps>

## Important Notes

* **No effect if nothing is registered** — Calling Clear Pause Triggers with no active triggers is a no-op; it will not raise errors.
* **Does not dismiss an active pause overlay** — If a pause is already on screen, Clear Pause Triggers does not acknowledge it. The learner still dismisses the overlay normally.
* **Preview behavior** — In the Creator App preview pipeline, Clear Pause Triggers is a stub (no live pause registry exists in preview). Behavior is fully exercised when the training runs in the Trainee App.

## Related Actions

* **Pause Training** — Register the pause triggers that this action clears
* **Show Panel** — Display messages when a pause fires or when triggers are cleared
* **Set Interactable Objects** — Control which objects the learner can interact with alongside trigger management
