biomes.json

{"$schema":"http://json-schema.org/draft-07/schema","$id":"blockception.minecraft.resource.biomes","title":"Client Biome","description":"Minecraft client_biome files define client-side settings for biomes in resource packs. This is the new preferred location for per-biome settings that used to be in biomes_client.json.","type":"object","required":["format_version","minecraft:client_biome"],"additionalProperties":false,"properties":{"format_version":{"$ref":"#/definitions/A"},"minecraft:client_biome":{"$ref":"#/definitions/B"}},"defaultSnippets":[{"label":"New client biome","body":{"format_version":"${1:1.21.40}","minecraft:client_biome":{"description":{"identifier":"${3:${TM_FILENAME/[\\.].*//}}"},"components":"^{$4}"}}}],"definitions":{"A":{"title":"Format Version","description":"A version that tells minecraft what type of data format can be expected when reading this file.","pattern":"^([1-9]+)\\.([0-9]+)\\.([0-9]+)$","type":"string","default":"1.21.60","examples":["1.21.50","1.20.80","1.20.40","1.19.0","1.12.0","1.10.0","1.8.0"],"defaultSnippets":[{"label":"New Format version","body":"1.${1|8,10,12,17,18,19,20|}.${3|2|0|}"}]},"B_components_ref":{"type":"object","title":"Components","description":"Any components that this Client Biome uses.","additionalProperties":false,"properties":{"minecraft:ambient_sounds":{"$ref":"#/definitions/C"},"minecraft:atmosphere_identifier":{"$ref":"#/definitions/D"},"minecraft:biome_music":{"$ref":"#/definitions/E"},"minecraft:color_grading_identifier":{"$ref":"#/definitions/F"},"minecraft:dry_foliage_color":{"$ref":"#/definitions/G"},"minecraft:fog_appearance":{"$ref":"#/definitions/H"},"minecraft:foliage_appearance":{"$ref":"#/definitions/I"},"minecraft:grass_appearance":{"$ref":"#/definitions/J"},"minecraft:lighting_identifier":{"$ref":"#/definitions/BA"},"minecraft:sky_color":{"$ref":"#/definitions/BB"},"minecraft:water_appearance":{"$ref":"#/definitions/BC"},"minecraft:water_identifier":{"$ref":"#/definitions/BD"}}},"C":{"title":"Ambient Sounds","description":"Sets the ambient sounds for the biome. These sounds must be in the 'individual_named_sounds' in a 'sounds.json' file.","type":"object","additionalProperties":false,"properties":{"addition":{"title":"Addition","description":"Named sound that occasionally plays at the listener position.","type":"string"},"loop":{"title":"Loop","description":"Named sound that loops while the listener position is inside the biome.","type":"string"},"mood":{"title":"Mood","description":"Named sound that rarely plays at a nearby air block position when the light level is low.","type":"string","default":"ambient.cave"}}},"D":{"title":"Atmosphere Identifier","description":"[INTERNAL - WORK IN PROGRESS] Set the atmosphere settings used during deferred rendering.\nBiomes without this component will have default atmosphere settings.","type":"object","additionalProperties":false,"required":["atmosphere_identifier"],"properties":{"atmosphere_identifier":{"title":"Atmosphere Identifier","description":"Identifier of atmosphere definition to use","type":"string"}}},"E":{"title":"Biome Music","description":"Affects how music plays within the biome.","type":"object","additionalProperties":false,"properties":{"volume_multiplier":{"title":"Volume Multiplier","description":"Multiplier temporarily and gradually applied to music volume when within this biome.","type":"number","minimum":0,"maximum":1}}},"F":{"title":"Color Grading Identifier","description":"[INTERNAL - WORK IN PROGRESS] Set the color_grading settings used during deferred rendering.\nBiomes without this component will have default color_grading settings.","type":"object","additionalProperties":false,"required":["color_grading_identifier"],"properties":{"color_grading_identifier":{"title":"Color Grading Identifier","description":"Identifier of color_grading definition to use","type":"string"}}},"G":{"title":"Dry Foliage Color","description":"Set the dry foliage color used during rendering. Biomes without this component will have default dry foliage color behavior.","type":"object","additionalProperties":false,"required":["color"],"properties":{"color":{"title":"Color","description":"RGB color of dry foliage","oneOf":[{"type":"string","format":"colox-hex","default":"#FFFFFF"},{"type":"array","items":[{"title":"Red","type":"integer","default":0,"minimum":0,"maximum":255},{"title":"Green","type":"integer","default":0,"minimum":0,"maximum":255},{"title":"Blue","type":"integer","default":0,"minimum":0,"maximum":255}]}]}}},"H":{"title":"Fog Appearance","description":"Set the fog settings used during rendering. Biomes without this component will have default fog settings.","type":"object","required":["fog_identifier"],"additionalProperties":false,"properties":{"fog_identifier":{"title":"Fog Identifier","description":"Identifier of fog definition to use.","type":"string"}}},"I":{"title":"Foliage Appearance","description":"Set the foliage color or color map used during rendering. Biomes without this component will have default foliage appearance.","type":"object","required":["color"],"additionalProperties":false,"properties":{"color":{"title":"Color","description":"RGB color of foliage, or a Foliage Color Map object.","default":{"color_map":"foliage"},"examples":["#FFFFFF",[255,255,255]],"oneOf":[{"type":"string","format":"color-hex"},{"type":"array","minItems":3,"maxItems":3,"additionalItems":false,"items":{"type":"integer","minimum":0,"maximum":255}},{"type":"object","required":["color_map"],"additionalProperties":false,"properties":{"color_map":{"title":"Color Map","description":"Color map from textures/colormap to determine color of foliage.","enum":["birch","evergreen","foliage","mangrove_swamp_foliage","swamp_foliage"],"default":"foliage"}}}]}}},"J":{"title":"Grass Appearance","description":"Set the grass color or color map used during rendering. Biomes without this component will have default grass appearance.","type":"object","required":["color"],"additionalProperties":false,"properties":{"color":{"title":"Color","description":"RGB color of grass, or a Grass Color Map object.","default":{"color_map":"grass"},"examples":["#FFFFFF",[255,255,255]],"oneOf":[{"type":"string","format":"color-hex"},{"type":"array","minItems":3,"maxItems":3,"additionalItems":false,"items":{"type":"integer","minimum":0,"maximum":255}},{"type":"object","required":["color_map"],"additionalProperties":false,"properties":{"color_map":{"title":"Color Map","description":"Color map from textures/colormap to determine color of grass.","enum":["grass","swamp_grass"],"default":"grass"}}}]}}},"BA":{"title":"Lighting Identifier","description":"[INTERNAL - WORK IN PROGRESS] Set the lighting settings used during deferred rendering.\nBiomes without this component will have default lighting settings.","type":"object","additionalProperties":false,"required":["lighting_identifier"],"properties":{"lighting_identifier":{"title":"Lighting Identifier","description":"Identifier of lighting definition to use","type":"string"}}},"BB":{"title":"Sky Color","description":"Set the sky color used during rendering. Biomes without this component will have default sky color behavior.","type":"object","required":["sky_color"],"additionalProperties":false,"properties":{"sky_color":{"title":"Sky Color","description":"RGB color of the sky.","type":"string","format":"color-hex","examples":["#FFFFFF"]}}},"BC":{"title":"Water Appearance","description":"Set the water surface color used during rendering. Biomes without this component will have default water surface color behavior.","type":"object","required":["surface_color"],"additionalProperties":false,"properties":{"surface_color":{"title":"Surface Color","description":"RGB color of the water surface.","type":"string","format":"color-hex","examples":["#FFFFFF"]},"surface_opacity":{"title":"Surface Opacity","description":"Opacity of the water surface (0 for invisible and 1 for opaque)","type":"number","minimum":0,"maximum":1}}},"BD":{"title":"Water Identifier","description":"[INTERNAL - WORK IN PROGRESS] Set the water settings used during deferred rendering.\nBiomes without this component will have default water settings.","type":"object","additionalProperties":false,"required":["water_identifier"],"properties":{"water_identifier":{"title":"Water Identifier","description":"Identifier of water definition to use","type":"string"}}},"B":{"title":"Client Biome Definitions","description":"A client biome definition.","type":"object","additionalProperties":false,"required":["description","components"],"properties":{"description":{"title":"Client Biome Description","description":"Contains non-component settings for a Client Biome.","type":"object","additionalProperties":false,"required":["identifier"],"properties":{"identifier":{"title":"Identifier","description":"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.","type":"string"}}},"components":{"$ref":"#/definitions/B_components_ref"}}}}}