BTC Sky

The ultimate Skyblock engine with multi-dimension islands, research trees, and seasonal events.

The BTC Sky Extension is a comprehensive solution for modern Skyblock servers. It replaces traditional plugins with a fully integrated engine offering cooperative islands, independent progression per dimension, and deep economy features.

[!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.

Architecture

Commands & Permissions

[!NOTE] All command aliases and permissions are fully customizable in config.yml. The system uses a CommandToggle structure, allowing you to natively enable or disable specific commands (e.g. enabled: false) and provide arrays of aliases (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> (like dimension_<id>_size) natively supports the keyword current. 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.