Procedural 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

eventId — String

Unique ID for the event type.

displayName — String

Name shown in boss bars or titles during the event.

weight — Int

Probability weight for random selection. Higher = more frequent.

duration — Int

Duration of the event in seconds.

onStart

"> List of actions to trigger when the event begins.

onEnd

"> List of actions to trigger when the event ends or expires.

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.