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

# Events

> Triggers for island lifecycle.

Events allow you to trigger TypeWriter flows when specific island actions occur.

<CardGroup cols={2}>
  <Card title="Lifecycle" icon="arrows-rotate" href="#island-lifecycle">
    Creation, deletion, and reset events.
  </Card>

  <Card title="Social" icon="users" href="#social-and-members">
    Invites, kicks, bans, and promotions.
  </Card>

  <Card title="Economy" icon="coins" href="#economy-and-progression">
    Bank transactions and research unlocks.
  </Card>

  <Card title="Environment" icon="cloud-sun" href="#environment-and-movement">
    Weather, seasons, and dimension travel.
  </Card>
</CardGroup>

## Island Lifecycle

### Island Created

**Type:** `btcsky_island_create_event`
Fires when a player successfully creates an island.

### Island Deleted

**Type:** `btcsky_island_delete_event`
Fires after an island is permanently removed.

### Island Reset

**Type:** `btcsky_island_reset_event`
Fires when an island is reset to its original schematic.

## Social & Members

### Invites

* `btcsky_coop_invite_sent_event`
* `btcsky_coop_invite_accepted_event`
* `btcsky_coop_invite_declined_event`

### Member Management

* `btcsky_member_promoted_event`
* `btcsky_member_demoted_event`
* `btcsky_member_kicked_event`
* `btcsky_member_banned_event`
* `btcsky_member_unbanned_event`

## Economy & Progression

### Bank Transaction

**Type:** `btcsky_bank_transaction_event`
Fires on any bank deposit or withdrawal. Contains transaction amount and new balance.

### Island Upgrade

**Type:** `btcsky_island_upgrade_event`
Fires when an island upgrade is purchased.

### Research Complete

**Type:** `btcsky_research_complete_event`
Fires when a research node is successfully unlocked.

## Environment & Movement

### Dimension Enter

**Type:** `btcsky_dimension_enter_event`
Fires when a player travels between island dimensions (e.g. Overworld -> Nether).

### Island Enter/Leave

* `btcsky_island_enter_event`: Entering any island region.
* `btcsky_island_leave_event`: Leaving an island region.

### Season Change

**Type:** `btcsky_season_change_event`
Fires when the global island season changes (e.g., Spring to Summer).

### Island Random Event

**Type:** `btcsky_random_event_trigger_event`
Fires when a procedural event (like a meteor shower) starts on an island.

## Block & Production

### Block Placed

**Type:** `btcsky_block_placed_event`
Fires when a player places a block within their island territory.

### Block Broken

**Type:** `btcsky_block_broken_event`
Fires when a player breaks a block within their island territory.

### Generator Used

**Type:** `btcsky_generator_used_event`
Fires when a cobblestone/ore generator produces a block.