Skip to main content

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.

Facts allow you to check the state of an island, player roles, or economy.

Island State

Check ownership and location.

Economy

Query bank balances and limits.

​
Island Statistics

Fact TypeDescription
btcsky_island_level_factReturns the current island level.
btcsky_island_balance_factReturns the current island bank balance.
btcsky_island_rating_factReturns the average rating of the island (1-5).
btcsky_island_age_factReturns the number of days since the island was created.

​
World & Limits

Fact TypeDescription
btcsky_block_count_factReturns the count of specific block/material.
btcsky_block_limit_factReturns the limit for a specific block/material.
btcsky_entity_count_factReturns counts for specific entity types.
btcsky_entity_limit_factReturns limits for specific entity types.
​
material
String
Material for block facts.
​
entityType
String
Entity type for entity facts.
​
dimensionId
String
Dimension ID (defaults to current).

​
Role & Social

Fact TypeDescription
btcsky_island_role_factReturns the player’s role ID (OWNER=0, ADMIN=1, etc.).
btcsky_member_count_factReturns total number of island members.
btcsky_max_members_factReturns max members allowed (upgrades included).
btcsky_online_member_factReturns number of online island members.
btcsky_is_coop_factReturns 1 if it’s a cooperative island.

​
Progression

Fact TypeDescription
btcsky_upgrade_level_factReturns the level of a specific upgrade ID.
btcsky_generator_tier_factReturns current tier of resource generator.
btcsky_research_unlocked_factChecks if a specific research ID is unlocked.
btcsky_dimension_unlocked_factChecks if a specific dimension ID is unlocked.

​
Warps

Fact TypeDescription
btcsky_warp_count_factReturns current number of warps.
btcsky_max_warps_factReturns max warps allowed.
btcsky_warp_exists_factChecks 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