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.
BTC Sky Extension
The ultimate Skyblock engine with multi-dimension islands, research trees, and seasonal events.
[!IMPORTANT] BTC Core is mandatory to run this extension.
Configuration
Configure global settings, menus, and dimension templates using safe Enum structures.
Actions
Manage islands, economy, research, and social interactions.
Events
Trigger logic on island creation, entry, and level changes.
Facts & Data
Query island levels, bank balances, and member counts.
Systems
Quest objectives, AI activities, and procedural events.
Artifacts
Persistent storage and data management.
Key Features
- Technically Unlimited Dimensions: Go beyond Overworld/Nether/End with support for an infinite number of custom dimensions per island, each with its own template and progression.
- Advanced Expansion System: Corner-spawn island expansion with real-time chunk-based preview and particle borders.
- Collection System: Global tracking of harvested blocks, killed entities and fished items with tiered progression rewards and anti-exploit protections.
- Research Trees & Contracts: Deep progression via visual research trees and procedural island contracts.
- Cooperative Play: Robust coop system with profile-linked islands and shared management.
- Dynamic Seasons & Events: Gameplay-altering seasons and scheduled island events like resource rains or meteor showers.
- Client-Side Visuals: Interactive holograms, particle borders, and custom HUDs powered by PacketEvents and BetterHUD.
- Integrated Economy: Global island bank with upgradeable capacity, interest rates, and transaction logs.
- Generator Tiers: Highly configurable block generators (Cobblestone, Basalt, etc.) with per-dimension rates and tiers.
- High-Performance Leveling: Dedicated island scanner and calculation service optimized for large-scale servers.
Commands & Permissions
[!NOTE] All command aliases and permissions are fully customizable inconfig.yml. The system uses aCommandTogglestructure, allowing you to nativelyenableordisablespecific commands (e.g.enabled: false) and provide arrays ofaliases(e.g.aliases: ["home", "go"]). The commands listed below represent the default configuration.
Player Commands
| Command | Description |
|---|---|
/island | Open the main Control Panel menu. |
/island create [template] | Create a new island from a template. |
/island home [dim] | Teleport to island home (overworld, nether, end, etc.). |
/island warp <name> | Teleport to a specific warp location. |
/island teleport <player> [dim] | Visit another player’s island. (Aliases: visit, tp) |
/island coop <invite/accept/deny>| Manage cooperative island invites. |
| /island top | View top island leaderboards. |
| /island level | Recalculate island level. |
| /island border | Toggle island border particle visibility. |
| /island research | Open the core research menus. |
| /island contracts | Browse active and available island contracts. |
| /island collections | Open global collections to claim rewards. |
| /island bans | View the moderation menu for banned players. |
| /island ratings | Rate other islands and view personal evaluations. |
| /island seasons | Display the current active seasons and events. |
| /island generators | View mineral generators and upgrade tiers. |
| /island menu | Open the main Control Panel (alias for /island). |
| /island help | View command help. |
Admin Commands
| Command | Permission | Description |
|---|---|---|
/islandadmin reload | btcsky.admin | Reload extension configuration. |
/islandadmin delete <id> | btcsky.admin | Delete an island by profile ID. |
/islandadmin tp <id/player> | btcsky.admin | Teleport to a specific island. |
/islandadmin setlevel <id> <val> | btcsky.admin | Manually set an island level. |
/islandadmin list | btcsky.admin | List total active islands. |
/islandadmin bypass | btcsky.admin | Toggle border bypass mode. |
/islandadmin bans | btcsky.admin | Modify the banlist of a specific island ID. |
/islandadmin contracts | btcsky.admin | Manage an island’s contracts (Under Construction). |
/islandadmin collections | btcsky.admin | Manage an island’s collections (Under Construction). |
Placeholders
All placeholders use the prefix%typewriter_btcsky_.
[!TIP] Dynamic Dimension Resolution: Any placeholder expecting a dimension<id>(likedimension_<id>_size) natively supports the keywordcurrent. Using%typewriter_btcsky_dimension_current_size%will automatically resolve to the dimension the player is currently standing in.
| Placeholder | Description |
|---|---|
%typewriter_btcsky_has_island% | Returns true if player has an island. |
%typewriter_btcsky_island_creation_date% | The creation date of the island. |
%typewriter_btcsky_island_id% | Unique ID of the island. |
%typewriter_btcsky_island_owner% | Name of the island owner. |
%typewriter_btcsky_team_members_list% | Comma-separated list of all island members. |
%typewriter_btcsky_island_role% | Current player’s role on the island. |
%typewriter_btcsky_island_level% | Current island level (formatted). |
%typewriter_btcsky_island_exp% | Current island experience. |
%typewriter_btcsky_island_level_progress% | Progress percentage to the next island level. |
%typewriter_btcsky_island_balance% | Current island bank balance. |
%typewriter_btcsky_bank_interest_rate% | The configured interest rate for the island bank. |
%typewriter_btcsky_island_members_count% | Current number of members. |
%typewriter_btcsky_island_members_online% | Number of members currently online. |
%typewriter_btcsky_member_max% | Maximum member capacity (including upgrades). |
%typewriter_btcsky_is_coop_island% | true if it’s a cooperative island. |
%typewriter_btcsky_season% | Current season of the player’s active dimension. |
%typewriter_btcsky_dimension_current% | ID of the current island dimension. |
%typewriter_btcsky_dimension_current_display% | Capitalized display name of current dimension. |
%typewriter_btcsky_dimension_<id>_unlocked% | true if the specified dimension is unlocked. |
%typewriter_btcsky_dimension_<id>_is_locked% | true if the specified dimension is locked. |
%typewriter_btcsky_dimension_<id>_level% | Current level of the specified dimension. |
%typewriter_btcsky_dimension_<id>_generator_tier% | Current generator tier of the dimension. |
%typewriter_btcsky_dimension_<id>_event_next% | Time remaining until the next scheduled event for the dimension. |
%typewriter_btcsky_block_count_<type>% | Count of specific blocks in current dimension. |
%typewriter_btcsky_block_limit_<type>% | Limit of specific blocks in current dimension. |
%typewriter_btcsky_upgrade_level_<id>% | Current level of a specific upgrade (current dim). |
%typewriter_btcsky_dimension_<id>_upgrade_<id>_level% | Current level of a specific upgrade in a specific dimension. |
%typewriter_btcsky_upgrades_acquired% | Total amount of upgrades acquired across all dimensions. |
%typewriter_btcsky_upgrades_total% | Maximum possible amount of upgrades globally. |
%typewriter_btcsky_dimension_<id>_upgrades_acquired% | Total amount of upgrades acquired in a specific dimension. |
%typewriter_btcsky_dimension_<id>_upgrades_total% | Total possible amount of upgrades in a specific dimension. |
%typewriter_btcsky_visitor_count% | Number of current visitors on the island globally. |
%typewriter_btcsky_dimension_<id>_visitor_count% | Number of current visitors in a specific dimension. |
%typewriter_btcsky_size% | Total number of unlocked chunks in current dimension. |
%typewriter_btcsky_island_size% | Total number of unlocked chunks across all dimensions. |
%typewriter_btcsky_dimension_<id>_size% | Total number of unlocked chunks in a specific dimension. |
%typewriter_btcsky_size_max% | Maximum possible chunks for current dimension based on template. |
%typewriter_btcsky_island_size_max% | Maximum possible chunks across all dimensions based on templates. |
%typewriter_btcsky_dimension_<id>_size_max% | Maximum possible chunks for a specific dimension based on template. |
%typewriter_btcsky_biomes_acquired% | Total amount of biomes unlocked across all dimensions. |
%typewriter_btcsky_biomes_total% | Maximum possible amount of biomes across all dimensions. |
%typewriter_btcsky_island_biomes_total% | Total number of unlocked biomes across all dimensions. |
%typewriter_btcsky_island_biomes_<group>% | Total number of unlocked biomes belonging to a specific group globally. |
%typewriter_btcsky_biomes_<group>% | Total number of unlocked biomes of a specific group in current dimension. |
%typewriter_btcsky_dimension_<id>_biomes_total% | Total number of unlocked biomes in a specific dimension. |
%typewriter_btcsky_dimension_<id>_biomes_acquired% | Total amount of biomes unlocked in a specific dimension. |
%typewriter_btcsky_dimension_<id>_biomes_total_possible% | Maximum possible amount of biomes in a specific dimension. |
%typewriter_btcsky_dimension_<id>_biomes_<group>% | Total number of unlocked biomes belonging to a specific group in a specific dimension. |
%typewriter_btcsky_warp_count% | Number of active warps created by the island. |
%typewriter_btcsky_warp_limit% | Maximum capacity of warps allowed globally per island. |
%typewriter_btcsky_warp_list% | Comma-separated list of active warp names. |
%typewriter_btcsky_contract_completed_count% | Lifetime amount of successfully completed contracts. |
%typewriter_btcsky_research_unlocked_nodes% | Number of research nodes unlocked within the tree. |
%typewriter_btcsky_research_points% | Raw metric value of unspent research points. |
%typewriter_btcsky_collection_total_unlocked% | Total amount of unique collections triggered globally. |
%typewriter_btcsky_collection_progress_<id>% | Explicit progression count of the specific resource ID. |
%typewriter_btcsky_ban_count% | Total amount of players currently banned from the island. |
%typewriter_btcsky_rating% | Current average evaluation (star decimal) of the island. |
%typewriter_btcsky_rating_count% | Number of players who voted on the island rating. |
%typewriter_btcsky_combat_wins% | Total amount of island combat wins. |
%typewriter_btcsky_combat_losses% | Total amount of island combat losses. |
%typewriter_btcsky_combat_draws% | Total amount of island combat draws. |
%typewriter_btcsky_combat_winrate% | Island combat winrate percentage. |
Dependencies
| Extension | Usage |
|---|---|
| BTC Core | Mandatory. Core engine required for all functionality. |
| MySql | Required for cross-server data capability. |
| Profiles | Recommended for separating inventories per island/mode. |
| Party | Recommended for robust team management. |
| BetterHUD | Recommended for advanced interactive UI and popups. |
| NumericalStorage | Required for large capacity island banks. |
| Protection | Recommended for advanced world protection integration. |