Skip to main content
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
List<String>
default:"[\"island\", \"is\", \"islands\"]"
Aliases for the player-facing island command.
worldPrefix
String
default:"btcsky_"
Prefix for generated island world names.
playerSkyDataArtifact
Ref<ArtifactEntry>
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
default:"1"
Starting island radius in chunks.
defaults.maxSizeInChunks
Int
default:"20"
Maximum possible radius through upgrades.
defaults.distance
Int
default:"500"
Buffer distance between island centers (in blocks).
defaults.teamLimit
Int
default:"4"
Default maximum members (including owner).
defaults.warpsLimit
Int
default:"3"
Default warp slot limit.
defaults.enabledFlags
List<IslandFlag>
Flags active by default (e.g., CREEPER_EXPLOSION, CROPS_GROWTH, WATER_FLOW).

Teleportation

teleportation.warpWarmup
Int
default:"0"
Warmup in seconds before warping.
teleportation.voidTeleportMembers
Boolean
default:"true"
Teleport members to spawn if they fall into the void.
teleportation.onKickActions
List<Ref<TriggerableEntry>>
Actions triggered when a player is kicked (e.g., teleport to global spawn).

Performance & Optimization

optimization.disableRedstoneOffline
Boolean
default:"true"
Stops redstone clocks when no members are online.
optimization.disableSpawningAfk
Boolean
default:"false"
Stops mob spawning when all members are AFK.

Island Upgrades

Each upgrade follows a cost formula: baseCost * costMultiplier^(level-1).
upgrades.availableUpgrades
List<UpgradeDefinition>
Defined upgrades like island_size, generator_tier, team_size, crop_growth, etc.
upgrades.requireConfirmation
Boolean
default:"true"
Show a GUI confirmation before deducting funds.

Contract System

Configuration for player-to-player or island-to-server agreements.
contracts.creationCooldownSeconds
Int
default:"300"
Cooldown between creating new contracts.
contracts.permissionLimits
Map<String, Int>
Group-based limits (e.g., btcsky.contracts.vip: 5).
contracts.rewardTaxPercent
Double
default:"5.0"
Percentage of the reward taken by the server.

Research (Tech Tree)

research.branches
List<ResearchBranch>
Categories like Agriculture, Automation, Combat.
research.nodes
List<ResearchNodeConfig>
Individual research steps with costs and icons.
research.fragments
List<ResearchFragment>
Items used to accelerate research (Basic, Advanced, Mystical).

Holograms

holograms.maxHologramsPerIsland
Int
default:"5"
Base limit for persistent holograms.
holograms.viewDistance
Double
default:"32.0"
Distance at which holograms become visible to players.

dimensionTemplates
List<Ref<DimensionTemplateEntry>>
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.