> ## 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.

# FINISH

> Triggered when a timer reaches 00:00:00.

## Usage Example

<CodeGroup>
  ```java Java Example theme={null}
  @EventHandler
  public void onVCTEvent(VCTEvent event) {
      if (event.getType() == VCTEventType.FINISH) {
          String timerId = event.getTimerId();

          Bukkit.getLogger().info("[MyPlugin] Timer finished: " + timerId);
      }
  }
  ```

  ```yaml CE Example theme={null}
  vct_finish_example:
    type: custom
    custom_event_data:
      event: voiidstudios.vct.api.VCTEvent
      variables_to_capture:
      - '%eventType%;getType()'
      - '%timerId%;getTimerId()'
    conditions:
    - '%eventType% == FINISH'
    actions:
      default:
      - 'to_all: actionbar: Timer finished %timerId%;100'
  ```
</CodeGroup>

## Behavior

* Fired when the timer **naturally finishes** its countdown.
* By default, the timer is also destroyed after the configured [ticks\_hide\_after\_ending](https://vctdocs.mintlify.app/usage-guide/configuration#ticks-hide-after-ending%3A-60).

## Parameters

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

  * `String getTimerId()` — ID of the finished timer
</ResponseField>
