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

# CHANGE

> Triggered every second while the timer is counting down.

## Usage Example

<CodeGroup>
  ```java Java Example theme={null}
  @EventHandler
  public void onVCTEvent(VCTEvent event) {
      if (event.getType() == VCTEventType.CHANGE) {
          String timeLeft = event.getTimeLeft();
          
          Bukkit.broadcastMessage("Time left: " + timeLeft);
      }
  }
  ```

  ```yaml CE Example theme={null}
  vct_change_example:
    type: custom
    custom_event_data:
      event: voiidstudios.vct.api.VCTEvent
      variables_to_capture:
      - '%eventType%;getType()'
      - '%timeLeft%;getTimeLeft()'
    conditions:
    - '%eventType% == CHANGE'
    actions:
      default:
      - 'to_all: actionbar: Time left %timeLeft%;20'
  ```
</CodeGroup>

## Behavior

* Runs **every second** while the timer is active and decreasing.
* Useful for showing live updates, side effects, or syncing other features.

## Parameters

<ResponseField name="event" type="VCTEvent">
  Represents the event. Useful getters:

  * `String getTimeLeft()` — the remaining time in HH:MM:SS
  * `String getTimerId()` — the ID of the active timer
</ResponseField>