Skip to main content
The btcsky_dimension_template manifest defines the behavior, rules, and progression for a specific island dimension.

Core Settings

dimensionId
String
required
Internal ID (e.g., overworld, nether).
[!NOTE] While common IDs are overworld, nether, and the_end, you can define any number of custom dimension IDs. BTC Sky supports a technically unlimited amount of dimensions per island, allowing for extreme scalability and diverse gameplay layers.
displayName
String
Name shown in menus.
templateWorldName
String
required
The name of the world to clone (must exist in slime_worlds).

Unlock & Progression

unlock.cost
Double
default:"0.0"
Currency required for access.
unlock.requiredLevel
Int
default:"0"
Minimum island level to unlock.
expansion
DimensionExpansionConfig
Radius settings (Chunks). Supports initialRadiusChunks and maxRadiusChunks.

Economy & Level

blockValues
List<BlockValueConfig>
Calculated worth for level calculation (e.g., DIAMOND_BLOCK: 100.0).
generator
DimensionGeneratorConfig
Tiered rates for cobblestone generators.

Role Permissions (Per Dimension)

You can define specific interaction rules per role for this dimension:
rolePermissions.visitor
List<IslandPermission>
Permissions for non-members.
rolePermissions.coop
List<IslandPermission>
Permissions for temporary partners.
Available permissions: INTERACT, BUILD, BREAK, CHEST_ACCESS, ISLAND_CHEST, FLY, INVITE, KICK, BAN, SET_WARP, SET_HOME, DISBAND.

Seasonal System

Seasons can be stand-alone or linked to the TinyEssentials Calendar.
seasons.enabled
Boolean
default:"false"
Enables time-based variation.
seasons.definitions
List<SeasonDefinition>
Define Spring, Summer, Autumn, Winter with biome overrides, multipliers, and start/end actions.

Procedural Events

events.enabled
Boolean
default:"true"
Enables random events.
events.events
List<RandomEventConfig>
Defined events like METEOR_SHOWER or MOB_INVASION.

Interaction Multipliers

multipliers.cropGrowth
Double
default:"1.0"
Speed multiplier for all crops in this dimension.
multipliers.autoCollectionRadius
Double
default:"0.0"
Radius for automatic drop collection (0 = disabled).