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

# Procedural Events

> Random island events.

The `btcsky_island_event` entry allows you to define random events that can occur on an island, such as meteor showers or invasions.

## Configuration

**Type:** `btcsky_island_event`

<ResponseField name="eventId" type="String" required>
  Unique ID for the event type.
</ResponseField>

<ResponseField name="displayName" type="String">
  Name shown in boss bars or titles during the event.
</ResponseField>

<ResponseField name="weight" type="Int" default="10">
  Probability weight for random selection. Higher = more frequent.
</ResponseField>

<ResponseField name="duration" type="Int" default="600">
  Duration of the event in seconds.
</ResponseField>

<ResponseField name="onStart" type="List<Ref<TriggerableEntry>>">
  List of actions to trigger when the event begins.
</ResponseField>

<ResponseField name="onEnd" type="List<Ref<TriggerableEntry>>">
  List of actions to trigger when the event ends or expires.
</ResponseField>

## Examples

* **Meteor Shower:** Drops rare ores in random locations on the island.
* **Monster Invasion:** Spawns waves of entities to defend against.
* **Gift from the Sky:** Deposits a small amount of money into the island bank.
* **Double XP Hours:** Applies a multiplier to all island activities for the duration.