Custom Biome Definition
Define a custom biome with colors and climate settings
Manifest entry for defining a custom biome. Custom biomes are registered as datapacks and require a server restart for changes to take effect. Once registered, they can be used like vanilla biomes in all biome-related entries and actions.
Campos
| Campo | Tipo | Padrão | Descrição |
|---|---|---|---|
biomeId | String | my_custom_biome | Unique biome ID (lowercase, no spaces, use underscores) |
namespace | String | typewriter | Namespace for the biome key (default: typewriter) |
baseBiome | String | minecraft:plains | Base vanilla biome to inherit properties from (e.g., 'minecraft:plains', 'minecraft:forest') |
preset | Ref<CustomBiomePresetEntry> | — | Optional preset providing shared colors and visual attributes. Anything set below wins over it. |
temperature | String | — | Temperature value (0.0 = cold/snowy, 0.5 = temperate, 2.0 = hot). Leave empty to inherit from base biome. |
downfall | String | — | Downfall/humidity value (0.0 = dry, 1.0 = wet/rainy). Leave empty to inherit from base biome. |
fogColor | String | — | Fog color in hex format (#RRGGBB). Leave empty to inherit from base biome. |
waterColor | String | — | Water color in hex format (#RRGGBB). Leave empty to inherit from base biome. |
waterFogColor | String | — | Underwater fog color in hex format (#RRGGBB). Leave empty to inherit from base biome. |
skyColor | String | — | Sky color in hex format (#RRGGBB). Leave empty to inherit from base biome. |
foliageColor | String | — | Foliage/leaf color in hex format (#RRGGBB). Leave empty to inherit from base biome. |
grassColor | String | — | Grass color in hex format (#RRGGBB). Leave empty to inherit from base biome. |
dryFoliageColor | String | — | Dry foliage color for badlands/savanna in hex format (#RRGGBB). Leave empty to inherit from base biome. |
sunriseSunsetColor | String | — | Sunrise/sunset sky tint color in hex format (#RRGGBB). Leave empty to inherit from base biome. |
cloudColor | String | — | Cloud color in hex format (#RRGGBB). Leave empty to inherit from base biome. |
skyLightColor | String | — | Skylight color tint in hex format (#RRGGBB). Leave empty to inherit from base biome. |
fogStartDistance | Float? | — | Distance where fog starts |
fogEndDistance | Float? | — | Distance where fog ends |
skyFogEndDistance | Float? | — | Distance where sky fog ends |
waterFogStartDistance | Float? | — | Distance where water fog starts |
waterFogEndDistance | Float? | — | Distance where water fog ends |
cloudFogEndDistance | Float? | — | Distance where cloud fog ends |
cloudHeight | Float? | — | Height of the clouds |
skyLightFactor | Float? | — | Multiplier for sky light brightness. Must be between 0.0 and 1.0. |
sunAngle | Float? | — | Sun angle (0.0 = overhead) |
moonAngle | Float? | — | Moon angle |
starAngle | Float? | — | Star angle |
starBrightness | Float? | — | Star brightness |
moonPhase | String? | — | Moon phase (full_moon, waning_gibbous, etc) |
How to use it
biomeIdandnamespacebuild the keynamespace:biomeId, for exampletypewriter:corrupted_forest. This is the identifier you type in actions, events and facts.baseBiomeis a vanilla biome such asminecraft:forest. The new biome inherits its spawns and features. If the value cannot be resolved, plains is used.- Colours are hex strings (
#RRGGBB). An empty field falls back to the preset, then to the base biome. temperatureanddownfallare numbers written as text (0.0cold or dry,2.0hot). Leave them empty to inherit.- The fields from
fogStartDistancetomoonPhaseare optional visual attributes.skyLightFactormust be between0.0and1.0. - Run
/tw biome listafter publishing to check that the biome is live.