Btcsky Dimension Template

The btcsky_dimension_template entry defines every aspect of an island dimension: world generation, biomes, upgrades, limits, combat, seasons, events, and more.

Configuration

btcsky_dimension_template

Map

required

Configuration for this manifest.

Show Properties

dimensionId

String

required

Unique dimension identifier (e.g. “overworld”, “nether”, “skills”, “mining”).

displayName

String

Display name shown in menus (supports MiniMessage).

priority

Int

default:"0"

Order priority in menus (higher = displayed first).

description

List<String>

Description shown in dimension menu (supports colors and placeholders).

icon

Item

Menu item icon for this dimension (Content Editor compatible).

Slot positions in the dimension selection menu (0-53).

defaultBiome

String

Default biome identifier (e.g. “minecraft:plains”).

templateWorldName

String

Template world name to clone from (must exist in slime_worlds directory).

allowedBiomes

List<BiomeGroup>

Allowed biome groups for this dimension (with icons and biome definitions).

overrideGlobalFlags

Boolean

default:"false"

Whether to override global island flags for this dimension.

enabledFlags

List<IslandFlag>

Enabled flags when override is active (CREEPER_EXPLOSION, NATURAL_ANIMALS_SPAWN, etc.).

unlock

DimensionUnlockConfig

Unlock requirements: cost, currency, required level, permission, unlock actions.

limits

DimensionLimitsConfig

Block, entity, machine, pet, and warp limits for this dimension.

blockValues

List<BlockValueConfig>

Block values for island level calculation (vanilla and custom blocks).

generator

DimensionGeneratorConfig

Cobblestone generator tiers with upgrade costs and block rates.

expansion

DimensionExpansionConfig

Island expansion: radius, max chunks, cost scaling, custom chunk rules.

multipliers

DimensionMultipliersConfig

Activity multipliers: crop growth, mob drops, spawner rates, XP, auto-collection.

rolePermissions

DimensionRolePermissionsConfig

Per-role permissions: visitor, coop, member, moderator, admin.

spawn

DimensionSpawnConfig

Spawn corner position, Y level, and edge offset.

seasons

DimensionSeasonsConfig

Seasonal themes: FIXED_DURATION or CALENDAR_LINKED modes, biome/weather overrides.

events

DimensionEventsConfig

Random procedural events: meteor showers, mob invasions, double drops, XP boosts, etc.

combat

DimensionCombatConfig

Combat/War system: core NPC, spawn points, duration, cooldown, victory/defeat actions.

upgrades

List<DimensionUpgradeConfig>

Available upgrades: storage limit, redstone limit, entity limit, island effects, etc.

Sub-Configuration Types

DimensionUpgradeConfig

String

required

Unique upgrade identifier.

displayName

String

Display name (supports MiniMessage).

description

List<String>

Upgrade description lore lines.

effectType

UpgradeEffectType

Type of effect applied (CROP_GROWTH, MOB_DROP_BONUS, SPAWNER_RATES, BLOCK_LIMIT, STORAGE_LIMIT, REDSTONE_LIMIT, MISC_LIMIT, ENTITY_LIMIT, TEAM_SIZE, WARP_LIMIT, GENERATOR_TIER, BLOCK_LIMITER, ENTITY_LIMITER, ISLAND_EFFECT, POTION_EFFECT, CUSTOM).

upgradeTemplate

SlotItemConfig

Template for purchasable upgrade slot. Placeholders: , , , , .

maxedTemplate

SlotItemConfig

Template shown when upgrade is at maximum level.

levels

List<UpgradeLevelConfig>

Sequential upgrade levels with costs, effect values, and unlock actions.

DimensionExpansionConfig

initialRadiusChunks

Int

default:"1"

Initial island radius in chunks (1 chunk = 16×16 blocks).

maxRadiusChunks

Int

default:"20"

Maximum island radius in chunks (radius 20 = 41×41 map diameter).

baseCost

Double

default:"1000.0"

Base cost for the first expansion purchase.

costMultiplier

Double

default:"1.25"

Cost multiplier per expansion level.

stepSize

Int

default:"2"

Number of chunks purchased per level requirement step.

levelIncrease

Int

default:"100"

Island level requirement increase per step.

customChunks

List<ChunkCustomizationConfig>

Custom chunk rules with specific costs and criteria.

unlockedMaterial

String

default:"GRASS_BLOCK"

Material shown for unlocked chunks in the binary grid.

lockedMaterial

String

default:"DIRT"

Material shown for locked/buyable chunks in the binary grid.

DimensionSeasonsConfig

enabled

Boolean

default:"false"

Enable seasonal themes for this dimension.

timingMode

SeasonTimingMode

default:"FIXED_DURATION"

FIXED_DURATION uses real-time hours per season; CALENDAR_LINKED ties to TinyEssentials calendar.

fixedDurationHours

Int

default:"168"

Duration per season in real-time hours (FIXED_DURATION mode). 168 = 1 week.

calendar

Ref<ManifestEntry>

Reference to TinyEssentials definition for calendar linking.

startMonth

Int

default:"1"

Starting month for first season alignment (1-12).

definitions

List<SeasonDefinition>

Season definitions: spring, summer, autumn, winter with biome/weather/multiplier overrides.

DimensionEventsConfig

enabled

Boolean

default:"true"

Enable random procedural events.

frequencyMultiplier

Double

default:"1.0"

Event frequency multiplier.

minIntervalMinutes

Int

default:"60"

Minimum time between events in minutes.

maxIntervalMinutes

Int

default:"240"

Maximum time between events in minutes.

events

List<RandomEventConfig>

Available event types with weights, durations, and configurations.

DimensionCombatConfig

enabled

Boolean

default:"false"

Enable combat zone mode (PvP always active, events/seasons blocked).

coreNpcDefinition

Ref<ManifestEntry>

Reference to Core NPC definition (Entity or BetterModel Extension).

coreHealth

Double

default:"1000.0"

Core NPC maximum health.

coreRegeneration

Double

default:"1.0"

Core NPC health regeneration per second.

durationMinutes

Int

default:"15"

Combat duration in minutes (0 = unlimited).

minIslandLevel

Int

default:"10"

Minimum island level required to participate.

attackCooldownHours

Int

default:"24"

Cooldown between attacks in hours.

attackerSpawn

CombatSpawnPoint

Spawn point for attacking team (offsets from island center).

defenderSpawn

CombatSpawnPoint

Spawn point for defending team.

coreLocation

CombatSpawnPoint

Location of the core NPC relative to island center.

onCombatStart

List<Ref<TriggerableEntry>>

Actions triggered when combat starts.

onVictory

List<Ref<TriggerableEntry>>

Actions triggered on victory.

onDefeat

List<Ref<TriggerableEntry>>

Actions triggered on defeat.

Introduction

Plugins

Extensions

Configuration

Sub-Configuration Types

DimensionUpgradeConfig

DimensionExpansionConfig

DimensionSeasonsConfig

DimensionEventsConfig

DimensionCombatConfig

Introduction

Plugins

Extensions

Documentation Index

​Configuration

​Sub-Configuration Types

​DimensionUpgradeConfig

​DimensionExpansionConfig

​DimensionSeasonsConfig

​DimensionEventsConfig

​DimensionCombatConfig

Configuration

Sub-Configuration Types

DimensionUpgradeConfig

DimensionExpansionConfig

DimensionSeasonsConfig

DimensionEventsConfig

DimensionCombatConfig