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

# Island Upgrade Event

> Triggers when an island is upgraded.

The `on_island_upgrade` event fires when an island's level or tier increases.

## Configuration

<ResponseField name="on_island_upgrade" type="Map" required>
  Configuration for the event.

  <Expandable title="Properties">
    <ResponseField name="dimension" type="String">
      Optional dimension filter (`NORMAL`, `NETHER`, `END`).
    </ResponseField>

    <ResponseField name="triggers" type="List<TriggerableEntry>">
      List of actions to execute.
    </ResponseField>
  </Expandable>
</ResponseField>