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

> Core island management actions.

Actions for creating, deleting, teleporting, and managing island properties.

<CardGroup cols={2}>
  <Card title="Create Island" icon="plus" href="#create-island-action">
    Create a new island from a schematic.
  </Card>

  <Card title="Delete Island" icon="trash" href="#delete-island-action">
    Permanently remove an island.
  </Card>

  <Card title="Teleport Home" icon="house" href="#teleport-home-action">
    Teleport to island spawn.
  </Card>

  <Card title="Unlock Dimension" icon="lock-open" href="#unlock-dimension-action">
    Unlock new island worlds.
  </Card>
</CardGroup>

## Lifecycle Actions

### Create Island Action

Creates a new island using the configured schematic template.

<ResponseField name="templateId" type="String" default="default">
  ID of the schematic template to use.
</ResponseField>

<ResponseField name="teleportOnCreate" type="Boolean" default="true">
  If true, teleports the player to the new island immediately.
</ResponseField>

<CodeGroup>
  ```yaml Create theme={null}
  action:
    type: btcsky_create_island
    templateId: "desert_template"
  ```
</CodeGroup>

### Reset Island Action

Resets the player's island to its initial state using its current template.

<ResponseField name="requireConfirmation" type="Boolean" default="true">
  If true, requires a confirmation dialog.
</ResponseField>

<CodeGroup>
  ```yaml Reset theme={null}
  action:
    type: btcsky_reset_island
  ```
</CodeGroup>

### Delete Island Action

Permanently deletes the player's island.

<ResponseField name="requireConfirmation" type="Boolean" default="true">
  If true, requires a second execution within the timeout period to confirm.
</ResponseField>

<ResponseField name="confirmationTimeout" type="Int" default="30">
  Valid confirmation window in seconds.
</ResponseField>

<CodeGroup>
  ```yaml Delete theme={null}
  action:
    type: btcsky_delete_island
  ```
</CodeGroup>

## Teleportation

### Teleport Home Action

Teleports the player to their island spawn point.

<ResponseField name="dimension" type="Var<String>" default="overworld">
  The dimension ID to teleport to.
</ResponseField>

### Teleport Dimension Action

Teleports the player to a specific island dimension.

<ResponseField name="dimension" type="String" required>
  The target dimension ID (e.g., `nether`).
</ResponseField>

### Teleport Spawn Action

Teleports the player to the server's global island spawn/hub.

<CodeGroup>
  ```yaml Teleport Spawn theme={null}
  action:
    type: btcsky_teleport_spawn
  ```
</CodeGroup>

### Unlock Dimension Action

Unlocks a new dimension for access.

<ResponseField name="dimension" type="String" required>
  The dimension ID to unlock.
</ResponseField>

<ResponseField name="cost" type="Double" default="0.0">
  Cost deducted from the island bank.
</ResponseField>

## Management Actions

### Calculate Level Action

Triggers a recalculation of the island's level.

<CodeGroup>
  ```yaml Level theme={null}
  action:
    type: btcsky_calculate_level
  ```
</CodeGroup>

### Show Border Action

Displays the island border using particles.

<ResponseField name="duration" type="Int" default="60">
  Duration in seconds.
</ResponseField>

<CodeGroup>
  ```yaml Show Border theme={null}
  action:
    type: btcsky_show_border
  ```
</CodeGroup>

### Toggle Fly Action

Toggles flight mode for the player on the island.

<CodeGroup>
  ```yaml Toggle Fly theme={null}
  action:
    type: btcsky_toggle_fly
  ```
</CodeGroup>

### Toggle PvP Action

Toggles PvP damage on the island.

<CodeGroup>
  ```yaml Toggle PvP theme={null}
  action:
    type: btcsky_toggle_pvp
  ```
</CodeGroup>

## World & Environment

### Set Biome Action

Changes the biome of the specified island dimension.

<ResponseField name="dimensionId" type="String" default="overworld">
  Target dimension.
</ResponseField>

<ResponseField name="biome" type="String" default="PLAINS">
  Biome type (e.g., `DESERT`, `FOREST`, `OCEAN`).
</ResponseField>

### Set Time Action

Sets the current world time in the player's world.

<ResponseField name="time" type="String" default="DAY">
  Presets: `DAY`, `NIGHT`, `NOON`, `MIDNIGHT`. Also accepts ticks as string.
</ResponseField>

## Production & Resources

### Set Generator Tier

Manually sets the resource generator tier.

<ResponseField name="dimensionId" type="String" default="overworld">
  Target dimension.
</ResponseField>

<ResponseField name="tier" type="Int" default="1">
  Target tier level.
</ResponseField>

### Upgrade Generator

Upgrades the current generator to the next available tier.

<ResponseField name="dimensionId" type="String" default="overworld">
  Target dimension.
</ResponseField>
