Facts allow you to check the state of an island, player roles, or economy.
Island Statistics
| Fact Type | Description |
|---|
btcsky_island_level_fact | Returns the current island level. |
btcsky_island_balance_fact | Returns the current island bank balance. |
btcsky_island_rating_fact | Returns the average rating of the island (1-5). |
btcsky_island_age_fact | Returns the number of days since the island was created. |
World & Limits
| Fact Type | Description |
|---|
btcsky_block_count_fact | Returns the count of specific block/material. |
btcsky_block_limit_fact | Returns the limit for a specific block/material. |
btcsky_entity_count_fact | Returns counts for specific entity types. |
btcsky_entity_limit_fact | Returns limits for specific entity types. |
Material for block facts.
Entity type for entity facts.
Dimension ID (defaults to current).
Role & Social
| Fact Type | Description |
|---|
btcsky_island_role_fact | Returns the player’s role ID (OWNER=0, ADMIN=1, etc.). |
btcsky_member_count_fact | Returns total number of island members. |
btcsky_max_members_fact | Returns max members allowed (upgrades included). |
btcsky_online_member_fact | Returns number of online island members. |
btcsky_is_coop_fact | Returns 1 if it’s a cooperative island. |
Progression
| Fact Type | Description |
|---|
btcsky_upgrade_level_fact | Returns the level of a specific upgrade ID. |
btcsky_generator_tier_fact | Returns current tier of resource generator. |
btcsky_research_unlocked_fact | Checks if a specific research ID is unlocked. |
btcsky_dimension_unlocked_fact | Checks if a specific dimension ID is unlocked. |
Warps
| Fact Type | Description |
|---|
btcsky_warp_count_fact | Returns current number of warps. |
btcsky_max_warps_fact | Returns max warps allowed. |
btcsky_warp_exists_fact | Checks if a warp name exists. |
Usage in Conditions
To check if a player has an island in a logic block:
condition:
type: fact_condition
fact: btcsky_has_island_fact
operator: EQUALS
value: 1
