Minecraft Data Pack Biome
Configuration file defining a biome for a data pack for Minecraft
**/data/*/worldgen/biome/*.json
Validate
Check your file against this schema
Opens the validator with this schema already loaded. Paste your
**/data/*/worldgen/biome/*.json and it validates in your browser — nothing is uploaded.
Validate a **/data/*/worldgen/biome/*.json → View raw schema
Reference
Fields
Generated directly from the schema, following local
$refs, to two levels of nesting.
| Field | Type | Description |
|---|---|---|
depth | number | Used for terrain noise generation. Biomes with positive depth are considered land, biomes with negative depth are oceans https://minecraft.wiki/w/Custom_biome |
scale | number | Used for terrain noise generation. Vertically stretches the terrain. Lower values produce flatter terrain https://minecraft.wiki/w/Custom_biome |
has_precipitation | boolean | Controls if the current biome has precipitation |
category | string | — one of: "none", "taiga", "extreme_hills", "jungle", "mesa", "plains" … (+11) |
temperature | number | A temperature for the current biome https://minecraft.wiki/w/Custom_biome |
temperature_modifier | string | A temperature modifier for the current biome https://minecraft.wiki/w/Custom_biome default: "none"one of: "none", "frozen" |
downfall | number | A grass and foliage color for the current biome https://minecraft.wiki/w/Custom_biome |
player_spawn_friendly | boolean | — |
creature_spawn_friendly | number | Spawns passive mobs as long as random value is less than this https://minecraft.wiki/w/Custom_biome |
effects | object | Effect options for the current biome https://minecraft.wiki/w/Custom_biome |
effects.fog_color | integer | A fog color https://minecraft.wiki/w/Custom_biome |
effects.foliage_color | integer | Decimal value converted from Hex color to use for tree leaves and vines. If not present, the value depends on humidity and temperature https://minecraft.wiki/w/Custom_biome |
effects.grass_color | integer | A grass color https://minecraft.wiki/w/Custom_biome |
effects.sky_color | integer | A sky color https://minecraft.wiki/w/Custom_biome |
effects.water_color | integer | A water color https://minecraft.wiki/w/Custom_biome |
effects.water_fog_color | integer | Decimal value converted from Hex color to use for fog https://minecraft.wiki/w/Custom_biome |
effects.grass_color_modifier | string | A grass color modifier https://minecraft.wiki/w/Custom_biome default: "none"one of: "none", "dark_forest", "swamp" |
effects.particle | object | Particle options for the current biome https://minecraft.wiki/w/Custom_biome |
effects.particle.probability | number | A particle spawning frequency for the current biome https://minecraft.wiki/w/Custom_biome |
effects.particle.options | object | A particle type for the current biome https://minecraft.wiki/w/Custom_biome |
effects.ambient_sound | string | Sound event to use for ambient sound https://minecraft.wiki/w/Custom_biome |
effects.mood_sound | object | Settings for mood sound https://minecraft.wiki/w/Custom_biome |
effects.mood_sound.sound | string | Sound event to use https://minecraft.wiki/w/Custom_biome |
effects.mood_sound.tick_delay | integer | — |
effects.mood_sound.block_search_context | integer | Determines the cubic range of possible positions to play the mood sound. The player is at the center of the cubic range, and the edge length is 2 * block_search_extent + 1 https://minecraft.wiki/w/Custom_biome |
effects.mood_sound.offset | integer | — |
effects.additions_sound | object | Settings for additions sound https://minecraft.wiki/w/Custom_biome |
effects.additions_sound.sound | string | Sound event to use https://minecraft.wiki/w/Custom_biome |
effects.additions_sound.tick_chance | integer | — |
effects.music | object | Specific music that should be played in the biome https://minecraft.wiki/w/Custom_biome |
effects.music.sound | string | Sound event to use https://minecraft.wiki/w/Custom_biome |
effects.music.min_delay | integer | — |
effects.music.max_delay | integer | — |
effects.music.replace_current_music | boolean | Whether or not to replace music which is already playing https://minecraft.wiki/w/Custom_biome |
surface_builder | string | The namespaced id of the configured surface builder to use https://minecraft.wiki/w/Custom_biome |
carvers | object | Carvers to use for the current biome https://minecraft.wiki/w/Custom_biome |
carvers.air | array<string> | Carvers used during air generation step for the current biome https://minecraft.wiki/w/Custom_biome |
carvers.liquid | array<string> | Carvers used during liquid generation step for the current biome https://minecraft.wiki/w/Custom_biome |
features | array<['string', 'array']> | Features for the current biome https://minecraft.wiki/w/Custom_biome |
creature_spawn_probability | number | A creature spawn probability for the current biome https://minecraft.wiki/w/Custom_biome |
starts | array<string> | The structures to generate in this biome https://minecraft.wiki/w/Custom_biome |
spawners | object | Entity spawning options for the current biome https://minecraft.wiki/w/Custom_biome |
spawners.monster | array<object> | Spawner options for the current biome https://minecraft.wiki/w/Custom_biome |
spawners.creature | array<object> | Spawner options for the current biome https://minecraft.wiki/w/Custom_biome |
spawners.ambient | array<object> | Spawner options for the current biome https://minecraft.wiki/w/Custom_biome |
spawners.water_creature | array<object> | Spawner options for the current biome https://minecraft.wiki/w/Custom_biome |
spawners.underground_water_creature | array<object> | Spawner options for the current biome https://minecraft.wiki/w/Custom_biome |
spawners.water_ambient | array<object> | Spawner options for the current biome https://minecraft.wiki/w/Custom_biome |
spawners.misc | array<object> | Spawner options for the current biome https://minecraft.wiki/w/Custom_biome |
spawners.axolotls | array<object> | Spawner options for the current biome https://minecraft.wiki/w/Custom_biome |
spawn_costs | object | Entity identifiers for the current biome https://minecraft.wiki/w/Custom_biome |
Audit
What we found in this schema
- Declared draft: draft-07
- Validates cleanly against its own meta-schema.
- 106 properties, 78% carrying a description, max nesting depth 18.
Standards
Specification sections for the keywords in this schema
| Keyword | Document | Section |
|---|---|---|
$comment | JSON Schema Core, draft 2020-12 | §8.3 — Comments With "$comment" |
$id | JSON Schema Core, draft 2020-12 | §8.2.1 — The "$id" Keyword |
$ref | JSON Schema Core, draft 2020-12 | §8.2.3.1 — Direct References with "$ref" |
$schema | JSON Schema Core, draft 2020-12 | §8.1.1 — "$schema" |
additionalProperties | JSON Schema Core, draft 2020-12 | §10.3.2.3 — "additionalProperties" |
allOf | JSON Schema Core, draft 2020-12 | §10.2.1.1 — "allOf" |
const | JSON Schema Validation, draft 2020-12 | §6.1.3 — "const" |
default | JSON Schema Validation, draft 2020-12 | §9.2 — "default" |
description | JSON Schema Validation, draft 2020-12 | §9.1 — "title" and "description" |
enum | JSON Schema Validation, draft 2020-12 | §6.1.2 — "enum" |
if | JSON Schema Core, draft 2020-12 | §10.2.2.1 — "if" |
items | JSON Schema Core, draft 2020-12 | §10.3.1.2 — "items" |
maxItems | JSON Schema Validation, draft 2020-12 | §6.4.1 — "maxItems" |
maximum | JSON Schema Validation, draft 2020-12 | §6.2.2 — "maximum" |
minItems | JSON Schema Validation, draft 2020-12 | §6.4.2 — "minItems" |
minLength | JSON Schema Validation, draft 2020-12 | §6.3.2 — "minLength" |
minimum | JSON Schema Validation, draft 2020-12 | §6.2.4 — "minimum" |
properties | JSON Schema Core, draft 2020-12 | §10.3.2.1 — "properties" |
then | JSON Schema Core, draft 2020-12 | §10.2.2.2 — "then" |
type | JSON Schema Validation, draft 2020-12 | §6.1.1 — "type" |
uniqueItems | JSON Schema Validation, draft 2020-12 | §6.4.3 — "uniqueItems" |
Documents
- JSON Schema Core, draft 2020-12 — JSON Schema: A Media Type for Describing JSON Documents, A. Wright, H. Andrews, B. Hutton, G. Dennis, Eds., 2022. draft-bhutton-json-schema-01. An expired Internet-Draft with no formal standing in the IETF standards process; it is nonetheless the specification of record for JSON Schema 2020-12, published by json-schema.org.
- JSON Schema Validation, draft 2020-12 — JSON Schema Validation: A Vocabulary for Structural Validation of JSON, A. Wright, H. Andrews, B. Hutton, Eds., 2022.
- RFC 8259 (STD 90) — The JavaScript Object Notation (JSON) Data Interchange Format, T. Bray, Ed., 2017. The format a schema describes.
- RFC 6901 — JavaScript Object Notation (JSON) Pointer. Defines the pointer syntax used by $ref fragments and the ~0 / ~1 escapes.
Source
Attribution
This schema comes from SchemaStore, distributed under the Apache License 2.0. Copyright 2015–present Mads Kristensen and contributors. View the original file. The field table and audit on this page are generated by JSONTools.tools; the schema itself is unmodified.