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.