Main Configuration
The btcsky_config manifest entry is the central hub for the entire Skyblock system. It defines everything from core command aliases to complex tech trees and economy rules.
Core Identification
commandAliases
" default='["island", "is", "islands"]'> Aliases for the player-facing island command.
worldPrefix — String
Prefix for generated island world names.
playerSkyDataArtifact
" required> Reference to the artifact storing player-specific Skyblock data.
Island Defaults
Settings applied to newly created islands. Units for size and radius are in Chunks (16x16 blocks).
defaults.sizeInChunks — Int
Starting island radius in chunks.
defaults.maxSizeInChunks — Int
Maximum possible radius through upgrades.
defaults.distance — Int
Buffer distance between island centers (in blocks).
defaults.teamLimit — Int
Default maximum members (including owner).
defaults.warpsLimit — Int
Default warp slot limit.
defaults.enabledFlags
">
Flags active by default (e.g., CREEPER_EXPLOSION, CROPS_GROWTH, WATER_FLOW).
Teleportation
teleportation.warpWarmup — Int
Warmup in seconds before warping.
teleportation.voidTeleportMembers — Boolean
Teleport members to spawn if they fall into the void.
teleportation.onKickActions
"> Actions triggered when a player is kicked (e.g., teleport to global spawn).
Performance & Optimization
optimization.disableRedstoneOffline — Boolean
Stops redstone clocks when no members are online.
optimization.disableSpawningAfk — Boolean
Stops mob spawning when all members are AFK.
Island Upgrades
Each upgrade follows a cost formula: baseCost * costMultiplier^(level-1).
upgrades.availableUpgrades
">
Defined upgrades like island_size, generator_tier, team_size, crop_growth, etc.
upgrades.requireConfirmation — Boolean
Show a GUI confirmation before deducting funds.
Contract System
Configuration for player-to-player or island-to-server agreements.
contracts.creationCooldownSeconds — Int
Cooldown between creating new contracts.
contracts.permissionLimits
">
Group-based limits (e.g., btcsky.contracts.vip: 5).
contracts.rewardTaxPercent — Double
Percentage of the reward taken by the server.
Research (Tech Tree)
research.branches
"> Categories like Agriculture, Automation, Combat.
research.nodes
"> Individual research steps with costs and icons.
research.fragments
"> Items used to accelerate research (Basic, Advanced, Mystical).
Holograms
holograms.maxHologramsPerIsland — Int
Base limit for persistent holograms.
holograms.viewDistance — Double
Distance at which holograms become visible to players.
dimensionTemplates
" required> References to all dimension templates available for this instance.
[!TIP] Technically Unlimited Dimensions: BTC Sky allows you to create an infinite number of independent dimensions per island by linking multiple templates. You are not limited to the standard Overworld, Nether, and End.