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

# Progression Actions

> Research and upgrades.

Actions related to island development, research trees, and level calculation.

<CardGroup cols={2}>
  <Card title="Unlock Research" icon="flask" href="#unlock-research">
    Unlock a node in the tech tree.
  </Card>

  <Card title="Upgrade Island" icon="arrow-up-from-bracket" href="#upgrade-island">
    Purchase specific island upgrades.
  </Card>
</CardGroup>

## Actions

### Unlock Research

**Type:** `island_unlock_research_action`

Unlocks a specific node in the island's research tech tree.

<ResponseField name="researchId" type="String" required>
  The ID of the research node to unlock.
</ResponseField>

<ResponseField name="consumeCurrency" type="Boolean" default="false">
  Whether to deduct the cost from the island bank automatically.
</ResponseField>

### Upgrade Island

**Type:** `island_upgrade_action`

Purchases the next level for a specific island upgrade type.

<ResponseField name="upgradeId" type="String" required>
  ID of the upgrade (e.g., `SIZE`, `MEMBERS`, `GENERATOR`).
</ResponseField>

### Calculate Island Level

**Type:** `island_calculate_level_action`

Triggers a manual recalculation of the island level based on current block values and worth. This is an expensive operation and is usually rate-limited.

<CodeGroup>
  ```yaml Example theme={null}
  action:
    type: island_calculate_level_action
  ```
</CodeGroup>