Dimension Template

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

Core Settings

dimensionId — String

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

The name of the world to clone (must exist in slime_worlds).

---

Unlock & Progression

unlock.cost — Double

Currency required for access.

unlock.requiredLevel — Int

Minimum island level to unlock.

expansion — DimensionExpansionConfig

Radius settings (Chunks). Supports initialRadiusChunks and maxRadiusChunks.

---

Economy & Level

blockValues

"> 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

"> Permissions for non-members.

rolePermissions.coop

"> 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

Enables time-based variation.

seasons.definitions

"> Define Spring, Summer, Autumn, Winter with biome overrides, multipliers, and start/end actions.

---

Procedural Events

events.enabled — Boolean

Enables random events.

events.events

"> Defined events like METEOR_SHOWER or MOB_INVASION.

---

Interaction Multipliers

multipliers.cropGrowth — Double

Speed multiplier for all crops in this dimension.

multipliers.autoCollectionRadius — Double

Radius for automatic drop collection (0 = disabled).