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
Configuration for this manifest.
Properties
dimensionId
Unique dimension identifier (e.g. "overworld", "nether", "skills", "mining").
displayName — String
Display name shown in menus (supports MiniMessage).
priority — Int
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).
menuSlots — List<Int>
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
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
id — String
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: {display_name}, {level}, {cost}, {effect_value}, {description}.
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
Initial island radius in chunks (1 chunk = 16×16 blocks).
maxRadiusChunks — Int
Maximum island radius in chunks (radius 20 = 41×41 map diameter).
baseCost — Double
Base cost for the first expansion purchase.
costMultiplier — Double
Cost multiplier per expansion level.
stepSize — Int
Number of chunks purchased per level requirement step.
levelIncrease — Int
Island level requirement increase per step.
customChunks — List<ChunkCustomizationConfig>
Custom chunk rules with specific costs and criteria.
unlockedMaterial — String
Material shown for unlocked chunks in the binary grid.
lockedMaterial — String
Material shown for locked/buyable chunks in the binary grid.
DimensionSeasonsConfig
enabled — Boolean
Enable seasonal themes for this dimension.
timingMode — SeasonTimingMode
FIXED_DURATION uses real-time hours per season; CALENDAR_LINKED ties to TinyEssentials calendar.
fixedDurationHours — Int
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
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
Enable random procedural events.
frequencyMultiplier — Double
Event frequency multiplier.
minIntervalMinutes — Int
Minimum time between events in minutes.
maxIntervalMinutes — Int
Maximum time between events in minutes.
events — List<RandomEventConfig>
Available event types with weights, durations, and configurations.
DimensionCombatConfig
enabled — Boolean
Enable combat zone mode (PvP always active, events/seasons blocked).
coreNpcDefinition — Ref<ManifestEntry>
Reference to Core NPC definition (Entity or BetterModel Extension).
coreHealth — Double
Core NPC maximum health.
coreRegeneration — Double
Core NPC health regeneration per second.
durationMinutes — Int
Combat duration in minutes (0 = unlimited).
minIslandLevel — Int
Minimum island level required to participate.
attackCooldownHours — Int
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.