Btcsky Dimension Template

Island Dimension Template

清单由 BTC Sky 提供

Island Dimension Template Entry Defines all settings for a single dimension (overworld, nether, end, skills, mining, etc.) Each island can have multiple dimensions, each configured via this template. This entry is completely self-contained with all nested configurations inline, eliminating the need for separate ID-based lookups.

字段

字段	类型	默认值	描述
dimensionId	String	overworld	Unique dimension identifier (e.g., 'overworld', 'nether', 'skills', 'mining')
priority	Int	0	Order priority in menus (higher = first)
description	List<String>	—	Description shown in dimension menu. Supports colors and placeholders.占位符颜色多行
icon	Item	—	Menu item icon for this dimension
menuSlots	List<Int>	—	Slot positions in dimension menu (0-53)
defaultBiome	String	minecraft:plains	Default biome identifier (e.g., 'minecraft:plains')
templateWorldName	String	btcsky_template_overworld	Template world name to clone from (must exist in slime_worlds directory)
allowedBiomes	List<BiomeGroup>	—	Allowed biome groups for this dimension BiomeGroup（2） 字段 类型 默认值 描述 icon Item — Icon representing the group biomes List<BiomeDefinition> empty List of biomes in this group BiomeDefinition（7） 字段 类型 默认值 描述 biomeId String PLAINS Biome identifier (e.g., 'PLAINS', 'minecraft:plains', 'custombiomes:my_biome') displayName String <green>Plains Display name shown in menu (supports MiniMessage)颜色 permission String — Permission required to unlock/use this biome (empty = none) cost Double 0.0 Cost to unlock this biome icon Material GRASS_BLOCK Custom icon for this biome description List<String> empty Description/Lore for this biome customSpawns List<CustomMobSpawn> empty Custom BTCMobs that can spawn in this biome
overrideGlobalFlags	Boolean	false	Override global island flags for this dimension
enabledFlags	List<IslandFlag>	—	Enabled flags for this dimension (if override is enabled)可选值：NATURAL_ANIMALS_SPAWNNATURAL_MONSTER_SPAWNSPAWNER_ANIMALS_SPAWNSPAWNER_MONSTER_SPAWNWATER_FLOWLAVA_FLOWCROPS_GROWTHTREE_GROWTHFIRE_SPREADEGG_LAYENDERMAN_GRIEFLEAF_DECAYANIMAL_DAMAGEMONSTER_DAMAGEBUILDBREAKINTERACTPVP
unlock	DimensionUnlockConfig	—	Unlock requirements and costs for this dimension DimensionUnlockConfig（10） 字段 类型 默认值 描述 unlockedByDefault Boolean true Is this dimension unlocked by default for new islands? isPrimary Boolean true Is this the primary/main dimension? cost Double 0.0 Cost to unlock currency Ref<ManifestEntry> — Currency storage definition for unlock cost requiredLevel Int 0 Required island level to unlock permission String — Permission required to unlock (empty = none) requirementMessage String — Custom requirement text shown in lore when locked (e.g. 'Requiert: Quete du Nether'). Use {cost}, {level} placeholders. unlockedLore List<String> empty Lore lines to ADD when dimension is unlocked (appended after the item's default lore). Leave empty for default.颜色 lockedLore List<String> empty Lore lines to ADD when dimension is locked (appended after the item's default lore). Leave empty for default.颜色 onUnlock List<Ref<TriggerableEntry>> empty TypeWriter actions to trigger on unlock
limits	DimensionLimitsConfig	—	Block and entity limits specific to this dimension DimensionLimitsConfig（5） 字段 类型 默认值 描述 blocks List<BlockLimitConfig> empty Block placement limits for this dimension BlockLimitConfig（5） 字段 类型 默认值 描述 block Item — Block type (use Item Editor for vanilla or custom blocks) limit Int 10 Maximum allowed count of this block upgradeable Boolean true Can this limit be upgraded? upgradeCost Double 1000.0 Cost per upgrade level upgradeIncrease Int 5 Limit increase per upgrade level entities List<EntityLimitConfig> empty Entity spawn limits for this dimension EntityLimitConfig（6） 字段 类型 默认值 描述 entityType EntityType VILLAGER Vanilla entity type btcMobId String — BTCMob ID (if using BTCMob extension, leave empty for vanilla) limit Int 10 Maximum allowed count of this entity upgradeable Boolean true Can this limit be upgraded? upgradeCost Double 1000.0 Cost per upgrade level upgradeIncrease Int 2 Limit increase per upgrade level machines List<MachineLimitConfig> empty Machine limits for this dimension (requires Machine Extension) MachineLimitConfig（5） 字段 类型 默认值 描述 machineId String — Machine ID (from Machine Extension) limit Int 5 Maximum allowed count of this machine upgradeable Boolean true Can this limit be upgraded? upgradeCost Double 5000.0 Cost per upgrade level upgradeIncrease Int 1 Limit increase per upgrade level pets List<PetLimitConfig> empty Pet limits for this dimension (requires Pets Extension) PetLimitConfig（5） 字段 类型 默认值 描述 petId String — Pet ID (from Pets Extension) limit Int 2 Maximum allowed count of this pet upgradeable Boolean true Can this limit be upgraded? upgradeCost Double 25000.0 Cost per upgrade level upgradeIncrease Int 1 Limit increase per upgrade level warpLimit Int 3 Maximum numbers of warps for this dimension
crystal	CrystalState	ACTIVE	Whether this dimension has a usable stabilisation crystal, a decorative one, or none at all
crystalOffset	Vector	ZERO	Where the stabilisation crystal stands by default, relative to this dimension's home
crystalMovable	Boolean	true	May a player move the crystal in this dimension? The Archipel says no
mobLevelAtCenter	Int	1	Mob level at the island's central chunk
mobLevelAtEdge	Int	45	Mob level at the outermost unlockable chunk; the level rises continuously between the two
spawner	IslandSpawnerConfig	—	How this dimension is populated: rate, distance and caps IslandSpawnerConfig（8） 字段 类型 默认值 描述 enabled Boolean true Whether this dimension is populated at all attemptChance Double 0.25 Chance, per spawner pass and per player, of attempting a spawn (0 to 1) minDistance Int 4 Closest a mob may appear from the player, in blocks maxDistance Int 48 Furthest a mob may appear from the player, in blocks capRadius Double 32.0 Radius, in blocks, over which the caps below are counted maxNearbyMobs Int 20 Maximum living mobs within the cap radius; zero disables the cap maxPerChunk Int 8 Maximum living mobs in the target chunk; zero disables the cap perTemplateCaps List<SpawnTemplateCap> empty Per-template caps within the cap radius, overriding the global one SpawnTemplateCap（2） 字段 类型 默认值 描述 btcMobId String — BTC mob template identifier this cap applies to limit Int 4 Maximum mobs of that template within the cap radius
blockValues	List<BlockValueConfig>	—	Block values for island level calculation in this dimension BlockValueConfig（3） 字段 类型 默认值 描述 material Material STONE Block type (Vanilla Material) customBlockId String — Custom Block ID (e.g. craftengine:ruby_block). Leaves empty for vanilla. value Double 1.0 Value contribution to island level/worth
generator	DimensionGeneratorConfig	—	Cobblestone generator configuration for this dimension DimensionGeneratorConfig（2） 字段 类型 默认值 描述 defaultTier Int 0 Default generator tier for this dimension (tier 0 = free starting tier) tiers List<GeneratorTierConfig> empty Generator tiers with upgrade costs and rates. Leave empty to use the documented default for overworld/nether/end (see DefaultGenerators). GeneratorTierConfig（4） 字段 类型 默认值 描述 tier Int 1 Tier level (1, 2, 3, ...) cost Double 0.0 Cost to unlock this tier currency Ref<ManifestEntry> — Currency storage definition for tier cost rates List<GeneratorRate> empty Block generation rates for this tier
expansion	DimensionExpansionConfig	—	Island expansion configuration for this dimension DimensionExpansionConfig（9） 字段 类型 默认值 描述 initialSizeChunks Int 1 Initial island size in chunks per side (1 = a single 16x16 chunk at the centre). maxSizeChunks Int 15 Maximum island size in chunks per side (e.g. 15 = 15x15 chunks). Use an odd value for a centred grid. baseCost Double 1000.0 Base cost for the first expansion costMultiplier Double 1.25 Cost multiplier per expansion level (e.g., 1.5 increase) stepSize Int 2 Number of purchased chunks per level requirement step levelIncrease Int 100 Level requirement increase per step customChunks List<ChunkCustomizationConfig> empty Defined custom chunks with specific costs and requirements ChunkCustomizationConfig（4） 字段 类型 默认值 描述 limitIndex Int 1 The index of the purchased chunk this applies to (1 = 1st purchase, 2 = 2nd...) cost Double 1000.0 Cost to unlock this specific chunk criteria List<Criteria> empty Requirements to unlock this chunk requirementMessage String — Custom message shown when requirements are not met颜色多行 unlockedMaterial String GRASS_BLOCK Material for the unlocked chunks in binary grid lockedMaterial String DIRT Material for the locked/buyable chunks in binary grid
multipliers	DimensionMultipliersConfig	—	Default multipliers for this dimension DimensionMultipliersConfig（6） 字段 类型 默认值 描述 cropGrowth Double 1.0 Crop growth speed multiplier (1.0 = normal) mobDrops Double 1.0 Mob drop multiplier (1.0 = normal) spawnerRates Double 1.0 Spawner rate multiplier (1.0 = normal) xp Double 1.0 XP gain multiplier (1.0 = normal) professionXp Double 1.0 Block break XP multiplier for professions autoCollectionRadius Double 0.0 Radius for auto-collection of drops (0.0 = disabled)
rolePermissions	DimensionRolePermissionsConfig	—	Default permissions per role in this dimension DimensionRolePermissionsConfig（5） 字段 类型 默认值 描述 visitor List<IslandPermission> empty Permissions for visitors (non-members)可选值：INTERACTBUILDBREAKCHEST_ACCESSISLAND_CHESTFLYINVITEKICKBANUNBANSET_WARPDELETE_WARPSET_HOMESET_BIOMESET_ROLEMANAGE_FLAGSMANAGE_UPGRADESTRANSFERDISBAND coop List<IslandPermission> — Permissions for coop members可选值：INTERACTBUILDBREAKCHEST_ACCESSISLAND_CHESTFLYINVITEKICKBANUNBANSET_WARPDELETE_WARPSET_HOMESET_BIOMESET_ROLEMANAGE_FLAGSMANAGE_UPGRADESTRANSFERDISBAND member List<IslandPermission> — Permissions for regular members可选值：INTERACTBUILDBREAKCHEST_ACCESSISLAND_CHESTFLYINVITEKICKBANUNBANSET_WARPDELETE_WARPSET_HOMESET_BIOMESET_ROLEMANAGE_FLAGSMANAGE_UPGRADESTRANSFERDISBAND moderator List<IslandPermission> — Permissions for moderators (includes member permissions)可选值：INTERACTBUILDBREAKCHEST_ACCESSISLAND_CHESTFLYINVITEKICKBANUNBANSET_WARPDELETE_WARPSET_HOMESET_BIOMESET_ROLEMANAGE_FLAGSMANAGE_UPGRADESTRANSFERDISBAND admin List<IslandPermission> — Permissions for admins (includes moderator permissions)可选值：INTERACTBUILDBREAKCHEST_ACCESSISLAND_CHESTFLYINVITEKICKBANUNBANSET_WARPDELETE_WARPSET_HOMESET_BIOMESET_ROLEMANAGE_FLAGSMANAGE_UPGRADESTRANSFERDISBAND
spawn	DimensionSpawnConfig	—	Player spawn configuration for this dimension DimensionSpawnConfig（3） 字段 类型 默认值 描述 corner SpawnCorner CENTER Spawn corner position (for corner spawn feature)可选值：CENTERNORTH_WESTNORTH_EASTSOUTH_WESTSOUTH_EAST yLevel Int -1 Y level for spawn (-1 to use schematic spawn point) edgeOffset Int 5 Offset from edge when using corner spawn (blocks)
seasons	DimensionSeasonsConfig	—	Seasonal themes configuration with TinyEssentials calendar integration DimensionSeasonsConfig（6） 字段 类型 默认值 描述 enabled Boolean false Enable seasonal themes for this dimension timingMode SeasonTimingMode FIXED_DURATION Season timing mode: FIXED_DURATION or CALENDAR_LINKED可选值：FIXED_DURATIONCALENDAR_LINKED fixedDurationHours Int 168 Duration of each season in real-time hours (for FIXED_DURATION mode) calendar Ref<ManifestEntry> — Reference to TinyEssentials definition for calendar linking. When linked, the calendar year is divided evenly by the number of seasons. For example: 4 seasons = each season is 1/4 of the calendar year. startMonth Int 1 Starting month for first season (1-12 or calendar-specific). Used to align seasons with real-world equivalents. For 4 seasons: Spring starts month 3 (March), Summer month 6, etc. definitions List<SeasonDefinition> — Available seasons with their configurations SeasonDefinition（10） 字段 类型 默认值 描述 displayName String <green>Spring Display name with colors颜色 biomeOverride String — Biome override during this season (empty = no change) weatherPattern String CLEAR Weather pattern: CLEAR, RAIN, THUNDER, SNOW cropGrowthMultiplier Double 1.0 Crop growth multiplier during this season mobSpawnMultiplier Double 1.0 Mob spawn rate multiplier during this season mobDropMultiplier Double 1.0 Mob drop multiplier during this season xpMultiplier Double 1.0 Additional XP multiplier during this season particleEffects List<String> empty Particle effects to display (empty = none) onStart List<Ref<TriggerableEntry>> empty TypeWriter actions to trigger when season starts onEnd List<Ref<TriggerableEntry>> empty TypeWriter actions to trigger when season ends
events	DimensionEventsConfig	—	Random procedural events for this dimension DimensionEventsConfig（5） 字段 类型 默认值 描述 enabled Boolean true Enable random procedural events frequencyMultiplier Double 1.0 Event frequency multiplier (1.0 = normal) minIntervalMinutes Int 60 Minimum time between events in minutes maxIntervalMinutes Int 240 Maximum time between events in minutes events List<Ref<IslandEventEntry>> empty Available events for this dimension
combat	DimensionCombatConfig	—	Combat/War system configuration for this dimension DimensionCombatConfig（13） 字段 类型 默认值 描述 enabled Boolean false Enable combat zone mode (PvP always enabled, events/seasons blocked) coreNpcDefinition Ref<ManifestEntry> — Reference to Core NPC definition (from Entity or BetterModel Extension) coreHealth Double 1000.0 Core NPC maximum health coreRegeneration Double 1.0 Core NPC regeneration per second durationMinutes Int 15 Combat duration in minutes (0 = unlimited) minIslandLevel Int 10 Minimum island level to participate in combat attackCooldownHours Int 24 Cooldown between attacks in hours attackerSpawn CombatSpawnPoint — Spawn point for attacking team CombatSpawnPoint（5） 字段 类型 默认值 描述 offsetX Double 0.0 Relative X offset from island center offsetY Double 5.0 Relative Y offset from island center offsetZ Double 0.0 Relative Z offset from island center yaw Float 0 Yaw rotation pitch Float 0 Pitch rotation defenderSpawn CombatSpawnPoint — Spawn point for defending team CombatSpawnPoint（5） 字段 类型 默认值 描述 offsetX Double 0.0 Relative X offset from island center offsetY Double 5.0 Relative Y offset from island center offsetZ Double 0.0 Relative Z offset from island center yaw Float 0 Yaw rotation pitch Float 0 Pitch rotation coreLocation CombatSpawnPoint — Location of the core NPC relative to island center CombatSpawnPoint（5） 字段 类型 默认值 描述 offsetX Double 0.0 Relative X offset from island center offsetY Double 5.0 Relative Y offset from island center offsetZ Double 0.0 Relative Z offset from island center yaw Float 0 Yaw rotation pitch Float 0 Pitch rotation onCombatStart List<Ref<TriggerableEntry>> empty TypeWriter actions to trigger when combat starts onVictory List<Ref<TriggerableEntry>> empty TypeWriter actions to trigger when combat ends (victory) onDefeat List<Ref<TriggerableEntry>> empty TypeWriter actions to trigger when combat ends (defeat)
upgrades	List<DimensionUpgradeConfig>	—	Available upgrades for this dimension DimensionUpgradeConfig（6） 字段 类型 默认值 描述 displayName String — Display name颜色 description List<String> empty Description for the upgrade颜色 effectType UpgradeEffectType CUSTOM Effect type for this upgrade可选值：CROP_GROWTHMOB_DROP_BONUSSPAWNER_RATESPOTION_EFFECTISLAND_EFFECTBLOCK_LIMITSTORAGE_LIMITREDSTONE_LIMITMISC_LIMITENTITY_LIMITTEAM_SIZEWARP_LIMITGENERATOR_TIERISLAND_FLYEVENT_FREQUENCYEVENT_LOOT upgradeTemplate SlotItemConfig — Item template for available upgrade. {level}, {cost}, {effect_value} placeholders available. SlotItemConfig（3） 字段 类型 默认值 描述 item Item — Base item (use Item Editor). Leave empty to show only text. lore List<String> empty Lore lines. Each line supports MiniMessage and placeholders.占位符颜色多行 glowing Boolean false Apply enchantment glow to the item. maxedTemplate SlotItemConfig — Item template for maxed upgrade SlotItemConfig（3） 字段 类型 默认值 描述 item Item — Base item (use Item Editor). Leave empty to show only text. lore List<String> empty Lore lines. Each line supports MiniMessage and placeholders.占位符颜色多行 glowing Boolean false Apply enchantment glow to the item. levels List<UpgradeLevelConfig> empty Upgrade sequential levels UpgradeLevelConfig（7） 字段 类型 默认值 描述 level Int 1 Level number (1, 2, 3...) lore List<String> empty Custom lore for this level in the upgrade detail view (appended below the state template).颜色多行 cost Double 1000.0 Unlock cost effectValue Double 0.0 Effect modifier value (multiplier or flat increase) potionEffectValue String — Potion effect string (e.g., 'SPEED:1') requiredProfessionLevel Map<String, Int> empty Required Profession Levels (RPG Core integration) onUpgrade List<Ref<TriggerableEntry>> empty TypeWriter actions to trigger when upgraded

TypeWriter 通用字段（displayName）

字段	类型	默认值	描述
displayName	String	<green>Overworld	Display name shown in menus. Supports MiniMessage colors.颜色

How to use it

One template is one dimension. dimensionId is the id used everywhere else (placeholders, facts, actions, /typewriter island admin unlock dimension). The world named in templateWorldName must exist in the slime_worlds folder. Exactly one template should have unlock.isPrimary on: it is the home dimension created with the island. Sizes are in chunks per side; use odd values so the grid is centred. Block and entity limits that are not listed are unlimited. See the "Dimension templates" section of the extension page for the field groups.