Skip to main content
Actions for creating, deleting, teleporting, and managing island properties.

Lifecycle Actions

Create Island Action

Creates a new island using the configured schematic template.
templateId
String
default:"default"
ID of the schematic template to use.
teleportOnCreate
Boolean
default:"true"
If true, teleports the player to the new island immediately.
action:
  type: btcsky_create_island
  templateId: "desert_template"

Reset Island Action

Resets the player’s island to its initial state using its current template.
requireConfirmation
Boolean
default:"true"
If true, requires a confirmation dialog.
action:
  type: btcsky_reset_island

Delete Island Action

Permanently deletes the player’s island.
requireConfirmation
Boolean
default:"true"
If true, requires a second execution within the timeout period to confirm.
confirmationTimeout
Int
default:"30"
Valid confirmation window in seconds.
action:
  type: btcsky_delete_island

Teleportation

Teleport Home Action

Teleports the player to their island spawn point.
dimension
Var<String>
default:"overworld"
The dimension ID to teleport to.

Teleport Dimension Action

Teleports the player to a specific island dimension.
dimension
String
required
The target dimension ID (e.g., nether).

Teleport Spawn Action

Teleports the player to the server’s global island spawn/hub.
action:
  type: btcsky_teleport_spawn

Unlock Dimension Action

Unlocks a new dimension for access.
dimension
String
required
The dimension ID to unlock.
cost
Double
default:"0.0"
Cost deducted from the island bank.

Management Actions

Calculate Level Action

Triggers a recalculation of the island’s level.
action:
  type: btcsky_calculate_level

Show Border Action

Displays the island border using particles.
duration
Int
default:"60"
Duration in seconds.
action:
  type: btcsky_show_border

Toggle Fly Action

Toggles flight mode for the player on the island.
action:
  type: btcsky_toggle_fly

Toggle PvP Action

Toggles PvP damage on the island.
action:
  type: btcsky_toggle_pvp

World & Environment

Set Biome Action

Changes the biome of the specified island dimension.
dimensionId
String
default:"overworld"
Target dimension.
biome
String
default:"PLAINS"
Biome type (e.g., DESERT, FOREST, OCEAN).

Set Time Action

Sets the current world time in the player’s world.
time
String
default:"DAY"
Presets: DAY, NIGHT, NOON, MIDNIGHT. Also accepts ticks as string.

Production & Resources

Set Generator Tier

Manually sets the resource generator tier.
dimensionId
String
default:"overworld"
Target dimension.
tier
Int
default:"1"
Target tier level.

Upgrade Generator

Upgrades the current generator to the next available tier.
dimensionId
String
default:"overworld"
Target dimension.