Edit

Share via


Client Biome Documentation - minecraft:client_biome_definition

Contains a description and components to define a Client Biome.

Client Biome Definition Client Biome Properties

Name Default Value Type Description Example Values
components not set Components item Components for this Client Biome.
description not set Description item Non-component settings, including the Client Biome name.

Components item type

Any components that this Client Biome uses.

Client Biome Components Properties

Name Default Value Type Description Example Values
minecraft:ambient_sounds not set Ambient Sounds item Set the ambient sounds for the biome. These sounds must be in the 'individual_named_sounds' in a 'sounds.json' file.
minecraft:atmosphere_identifier not set Atmosphere Identifier item Set the identifier used for atmospherics in Vibrant Visuals mode. Identifiers must resolve to identifiers in valid Atmospheric Scattering JSON schemas under the "atmospherics" directory. Biomes without this component will have default atmosphere settings.
minecraft:biome_music not set Biome Music item Affect how music plays within the biome
minecraft:color_grading_identifier not set Color Grading Identifier item Set the identifier used for color grading in Vibrant Visuals mode. Identifiers must resolve to identifiers in valid Color Grading JSON schemas under the "color_grading" directory. Biomes without this component will have default color_grading settings.
minecraft:dry_foliage_color not set Dry Foliage Color item Set the dry foliage color used during rendering. Biomes without this component will have default dry foliage color behavior.
minecraft:fog_appearance not set Fog Appearance item Set the fog settings used during rendering. Biomes without this component will have default fog settings.
minecraft:foliage_appearance not set Foliage Appearance item Set the foliage color or color map used during rendering. Biomes without this component will have default foliage appearance.
minecraft:grass_appearance not set Grass Appearance item Set the grass color or color map used during rendering. Biomes without this component will have default grass appearance.
minecraft:lighting_identifier not set Lighting Identifier item Set the identifier used for lighting in Vibrant Visuals mode. Identifiers must resolve to identifiers in valid Lighting JSON schemas under the "lighting" directory. Biomes without this component will have default lighting settings.
minecraft:sky_color not set Sky Color item Set the sky color used during rendering. Biomes without this component will have default sky color behavior.
minecraft:water_appearance not set Water Appearance item Set the water surface color used during rendering. Biomes without this component will have default water surface color behavior.
minecraft:water_identifier not set Water Identifier item Set the identifier used for rendering water in Vibrant Visuals mode. Identifiers must resolve to identifiers in valid Water JSON schemas under the "water" directory. Biomes without this component will have default water settings.

Ambient Sounds item type

Set the ambient sounds for the biome. These sounds must be in the 'individual_named_sounds' in a 'sounds.json' file.

Ambient Sounds Properties

Name Default Value Type Description Example Values
addition not set Object Named sound that occasionally plays at the listener position
loop not set Object Named sound that loops while the listener position is inside the biome
mood not set Object Named sound that rarely plays at a nearby air block position when the light level is low. Biomes without an ambient mood sound will use the 'ambient.cave' sound.

Atmosphere Identifier item type

Set the identifier used for atmospherics in Vibrant Visuals mode. Identifiers must resolve to identifiers in valid Atmospheric Scattering JSON schemas under the "atmospherics" directory. Biomes without this component will have default atmosphere settings.

Atmosphere Identifier Properties

Name Default Value Type Description Example Values
atmosphere_identifier not set Object Identifier of atmosphere definition to use

Biome Music item type

Affect how music plays within the biome.

Biome Music Properties

Name Default Value Type Description Example Values
music_definition not set Object Music to be played when inside this biome. If left off or not found the default music will be determined by the dimension. Empty string will result in no music.
volume_multiplier not set Decimal number Multiplier temporarily and gradually applied to music volume when within this biome. Must be a value between 0 and 1, inclusive.

Color Grading Identifier item type

Set the identifier used for color grading in Vibrant Visuals mode. Identifiers must resolve to identifiers in valid Color Grading JSON schemas under the "color_grading" directory. Biomes without this component will have default color_grading settings.

Color Grading Identifier Properties

Name Default Value Type Description Example Values
color_grading_identifier not set Object Identifier of color_grading definition to use

Dry Foliage Color item type

Set the dry foliage color used during rendering. Biomes without this component will have default dry foliage color behavior.

Dry Foliage Color Properties

Name Default Value Type Description Example Values
color not set String RGB color of dry foliage
color (Alternate 1) not set Array of numbers

Fog Appearance item type

Set the fog settings used during rendering. Biomes without this component will have default fog settings.

Fog Appearance Properties

Name Default Value Type Description Example Values
fog_identifier not set Object Identifier of fog definition to use

Foliage Appearance item type

Set the foliage color or color map used during rendering. Biomes without this component will have default foliage appearance.

Foliage Appearance Properties

Name Default Value Type Description Example Values
color not set Object RGB color of foliage, or a Foliage Color Map object.

Grass Appearance item type

Set the grass color or color map used during rendering. Biomes without this component will have default grass appearance.

Grass Appearance Properties

Name Default Value Type Description Example Values
color not set Object RGB color of grass.
grass_is_shaded not set Boolean true/false Adds a shading effect to the grass as if there was a roof.

Lighting Identifier item type

Set the identifier used for lighting in Vibrant Visuals mode. Identifiers must resolve to identifiers in valid Lighting JSON schemas under the "lighting" directory. Biomes without this component will have default lighting settings.

Lighting Identifier Properties

Name Default Value Type Description Example Values
lighting_identifier not set Object Identifier of lighting definition to use

Sky Color item type

Set the sky color used during rendering. Biomes without this component will have default sky color behavior.

Sky Color Properties

Name Default Value Type Description Example Values
sky_color not set String RGB color of the sky
sky_color (Alternate 1) not set Array of numbers

Water Appearance item type

Set the water surface color used during rendering. Biomes without this component will have default water surface color behavior.

Water Appearance Properties

Name Default Value Type Description Example Values
surface_color not set String RGB color of the water surface
surface_color (Alternate 1) not set Array of numbers
surface_opacity not set Decimal number Opacity of the water surface (must be between 0 for invisible and 1 for opaque, inclusive)

Water Identifier item type

Set the identifier used for rendering water in Vibrant Visuals mode. Identifiers must resolve to identifiers in valid Water JSON schemas under the "water" directory. Biomes without this component will have default water settings.

Water Identifier Properties

Name Default Value Type Description Example Values
water_identifier not set Object Identifier of water definition to use

Description item type

Contains non-component settings for a Client Biome.

Client Biome Description Properties

Name Default Value Type Description Example Values
identifier not set String The name of the Client Biome, used by other features like the '/locate biome' command. Must match the name of a Biome defined by the game or a behavior pack. Value must match a regular expression pattern of "^[a-z0-9.%+-]+:[a-z0-9.%+-]+$".