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

# Biome Actions

> Apply and refresh biomes.

Actions allows you to dynamically change biomes or force client updates.

<CardGroup cols={2}>
  <Card title="Apply Biome" icon="paintbrush" href="#apply-biome-action">
    Set the biome at a specific location or radius.
  </Card>

  <Card title="Refresh Chunks" icon="rotate" href="#refresh-biome-chunks-action">
    Force client to reload biome data for visuals.
  </Card>
</CardGroup>

## Actions

### Apply Biome Action

Sets the biome at a specific location.

<ResponseField name="biomeId" type="Var<String>" required>
  The biome ID to apply. Can be update vanilla (e.g. `minecraft:plains`) or custom (e.g. `typewriter:enchanted_forest`).
</ResponseField>

<ResponseField name="location" type="Position" required>
  The center position where the biome change originates.
</ResponseField>

<ResponseField name="radius" type="Var<Int>" default="0">
  The radius in blocks to apply the biome. `0` affects only the single block column.
</ResponseField>

<ResponseField name="atPlayerLocation" type="Boolean" default="true">
  If true, applies at player's location. If false, might require specific target location logic (currently defaults to player location if false as well in implementation).
</ResponseField>

<CodeGroup>
  ```yaml Apply Biome theme={null}
  action:
    type: apply_biome_action
    biomeId: "typewriter:enchanted_forest"
    radius: 10
    location:
      x: 0
      y: 64
      z: 0
      world: "world"
  ```
</CodeGroup>

### Refresh Biome Chunks Action

Sends biome update packets to players in the area. This is usually called after the **Apply Biome** action to ensure players see the change immediately without re-logging.

<ResponseField name="radius" type="Var<Int>" default="5">
  Chunk radius around the player to refresh.
</ResponseField>

<CodeGroup>
  ```yaml Refresh theme={null}
  action:
    type: refresh_biome_chunks_action
    radius: 5
  ```
</CodeGroup>