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

# CREATE

> Triggered when a new timer is created.

## Usage Example

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

          Bukkit.getLogger().info("[MyPlugin] Timer created: " + timerId);
          Bukkit.broadcastMessage("The timer " + timerId + " has started (" + timeInitial + ")");
      }
  }
  ```

  ```yaml CE Example theme={null}
  vct_create_example:
    type: custom
    custom_event_data:
      event: voiidstudios.vct.api.VCTEvent
      variables_to_capture:
      - '%eventType%;getType()'
      - '%timerId%;getTimerId()'
      - '%timeInitial%;getInitialTime()'
    conditions:
    - '%eventType% == CREATE'
    actions:
      default:
      - 'to_all: actionbar: The timer %timerId% has started (%timeInitial%);100'
  ```
</CodeGroup>

## Behavior

* Fired immediately after a timer is created (either via command or API).
* Provides access to the new timer’s **ID** and **initial time**.

## Parameters

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

  * `String getTimerId()` — the ID of the created timer
  * `String getInitialTime()` — time in HH:MM:SS format
</ResponseField>