Objects

AND(AND)

AND

list of MultiPartCondition

AboveBottom(above_bottom)

above_bottom

int

AboveRootPlacement(above_root_provider, above_root_placement_chance)

above_root_provider

BlockStateProviderRef

above_root_placement_chance

number 0..1

Absolute(absolute)

absolute

int

Advancement(criteria, parent?, display?, requirements?, rewards?, sends_telemetry_event?)

criteria

map of string to AdvancementCriterion

If requirements is not defined, all defined criteria will be required.

parentoptional

advancement id

If this field is absent, this advancement is a root advancement. Circular references cause a loading failure.

displayoptional

any (depends on parent)

If present, advancement will be visible in the advancement tabs.

requirementsoptional

list of (list of string (at least 1)) (at least 1)

If all criteria are required at once, this may be omitted. Contains all of the criteria keys. If all of the lists each have at least one criteria met, the advancement is complete (basically AND grouping of OR groups).

rewardsoptional

AdvancementRewards

Provided to the player when this advancement is obtained.

sends_telemetry_eventoptional

bool

Defaults to false. The vanilla game client only reads this for advancements from the minecraft namespace.

AdvancementRewards(experience?, loot?, recipes?, function?)

experienceoptional

int

XP to add.

lootoptional

LootTableListRef

Loot tables to give.

recipesoptional

list of recipe ids

Recipes to unlock.

functionoptional

function id

Function to run as and at the player. Function tags are not allowed.

Aquifer(barrier, fluid_level_floodedness, fluid_level_spread, lava, exclusion, surface_level)

barrier

DensityFunctionRef

fluid_level_floodedness

DensityFunctionRef

fluid_level_spread

DensityFunctionRef

lava

DensityFunctionRef

exclusion

DensityFunctionRef

surface_level

DensityFunctionRef

AssetId(asset_id)

asset_id

texture id

Atlas(sources)

sources

list of SpriteSource

List of sprite sources which can add or remove sprite textures to this atlas.

AttributeEntry(attribute, id, amount, operation)

attribute

attribute id

Attribute type to modify.

id

attribute_modifier id

The unique identifier of this attribute modifier.

amount

number

Change in the attribute.

operation

AttributeOperation

The operation used for this modifier.

AttributeModifier(attribute, id, amount, operation, slot)

attribute

attribute id

Attribute type to modify.

id

attribute_modifier id

The unique identifier of this attribute modifier.

amount

FloatNumberProviderRef

operation

AttributeOperation

The operation used for this modifier.

slot

EquipmentSlotGroup | list of EquipmentSlotGroup

If a list, one of the listed slots will be chosen randomly.

AxisAngle(axis, angle)

axis

list of number (exactly 3)

Local position of the axis in [x, y, z].

angle

number

Angle to rotate around the axis in radians.

BannerPattern(asset_id, translation_key)

asset_id

texture id

Also resolves to assets/<namespace>/textures/entity/shield/<name>.png.

translation_key

string

Translation key prefix per dye color (e.g. block.minecraft.banner.custom.pattern resolves to block.minecraft.banner.custom.pattern.<dye color>).

BannerPatternLayer(pattern, color)

pattern

banner_pattern id

color

DyeColor

BelowTop(below_top)

below_top

int

Biome(temperature, downfall, has_precipitation, effects, carvers, features, attributes?, temperature_modifier?)

temperature

number

downfall

number

has_precipitation

bool

effects

BiomeEffects

carvers

CarverListRef

features

list of (#placed_feature tag | list of PlacedFeatureRef) (at most 11)

attributesoptional

PositionalEnvironmentAttributeMap

temperature_modifieroptional

TemperatureModifier

BiomeEffects(water_color, grass_color?, foliage_color?, dry_foliage_color?, grass_color_modifier?)

water_color

StringRGB

grass_coloroptional

StringRGB

foliage_coloroptional

StringRGB

dry_foliage_coloroptional

StringRGB

grass_color_modifieroptional

GrassColorModifier

BlockColumnLayer(height, provider)

height

IntProvider of int 0..

provider

BlockStateProviderRef

BlockPredicate(blocks?, state?, nbt?, components?, predicates?)

blocksoptional

block id | #block tag | list of block ids

stateoptional

BlockPredicateState

nbtoptional

string | any (depends on blocks)

componentsoptional

DataComponentExactPredicate

Match exact data component values on the block entity.

predicatesoptional

DataComponentPredicate

Test data component values on the block entity.

BlockPredicateState()

BlockTransformData(block_state_provider, sound?, particle?, disallowed_faces?, loot?, drop_strategy?, transform_type?, update_from_neighbors?, consume_on_use?, item_damage_per_use?)

block_state_provider

BlockStateProviderRef

If the provider returns no result, the next transformer will be attempted.

soundoptional

SoundEventRef

Defaults to not playing sound.

particleoptional

BlockTransformParticle

Defaults to none.

disallowed_facesoptional

list of Direction

If a disallowed face is interacted with, the next transformer will be attempted. Defaults to empty (allowing all faces).

lootoptional

loot_table id

The loot to drop on a successful transformation. Defaults to drop nothing.

drop_strategyoptional

BlockTransformDropStrategy

Where the loot should drop. Defaults to from_middle.

transform_typeoptional

BlockTransformType

How nearby blocks are affected by the transformation. Defaults to single_block.

update_from_neighborsoptional

bool

Whether the transformed block should update based on neighboring blocks. Defaults to true.

consume_on_useoptional

bool

Only has effect on stackable items. Defaults to true.

item_damage_per_useoptional

int 0..

Only has effect on unstackable items. Defauls to 1.

Button(label, tooltip?, width?, action?)

label

Text

tooltipoptional

Text

widthoptional

int 1..1024

Width of the button. Defaults to 150.

actionoptional

ClickAction

If not present, clicking button will simply close dialog without any action.

CanyonShape(distance_factor, thickness, width_smoothness, horizontal_radius_factor, vertical_radius_default_factor, vertical_radius_center_factor, y_scale)

distance_factor

FloatProvider of number

thickness

FloatProvider of number

width_smoothness

int 0..

horizontal_radius_factor

FloatProvider of number

vertical_radius_default_factor

number

vertical_radius_center_factor

number

y_scale

FloatProvider of number

CatSounds(ambient_sound, stray_ambient_sound, hiss_sound, hurt_sound, death_sound, eat_sound, beg_for_food_sound, purr_sound, purreow_sound)

ambient_sound

SoundEventRef

stray_ambient_sound

SoundEventRef

hiss_sound

SoundEventRef

hurt_sound

SoundEventRef

death_sound

SoundEventRef

eat_sound

SoundEventRef

beg_for_food_sound

SoundEventRef

purr_sound

SoundEventRef

purreow_sound

SoundEventRef

CatVariant(asset_id, baby_asset_id, spawn_conditions)

asset_id

texture id

The cat texture to use for this variant.

baby_asset_id

texture id

The baby cat texture to use for this variant.

spawn_conditions

list of SpawnPrioritySelector

The spawn conditions for this variant. Selection process: - Conditions for all variants for the given entity type are evaluated for the spawn position - Entries with a priority lower than the maximum priority of the remaining entries are removed - A random entry is picked out of the remaining ones - If no conditions are remaining, the variant remains unchanged from the default

ChatDecoration(translation_key, parameters, style?)

translation_key

string

parameters

list of ChatDecorationParameter

styleoptional

TextStyle

ChatType(chat, narration)

chat

ChatDecoration

narration

ChatDecoration

ChickenVariant(asset_id, baby_asset_id, spawn_conditions, model?)

asset_id

texture id

The chicken texture to use for this variant.

baby_asset_id

texture id

The baby chicken texture to use for this variant.

spawn_conditions

list of SpawnPrioritySelector

The spawn conditions for this variant. Selection process: - Conditions for all variants for the given entity type are evaluated for the spawn position - Entries with a priority lower than the maximum priority of the remaining entries are removed - A random entry is picked out of the remaining ones - If no conditions are remaining, the variant remains unchanged from the default

modeloptional

ChickenModelType

CollectionPredicate(contains?, count?, size?)

containsoptional

list of EntityEffectsPredicate

A list of tests. For each test, there must be at least one entry whose contents match exactly.

countoptional

list of { test: EntityEffectsPredicate, count: MinMaxBounds of int }

sizeoptional

MinMaxBounds of int

When set, total number of entries in the this collection.

ColorWhenUndyed(color_when_undyed?)

color_when_undyedoptional

RGB

If the item is not dyed, this color is used instead. If not specified and the item is not dyed, this layer will be hidden.

ContactDamage(damage_type, amount, attribute_to_source)

damage_type

damage_type id

amount

FloatProvider of number 0..

attribute_to_source

bool

Whether the damage is attributed to the sulfur cube.

CowSounds(ambient_sound, hurt_sound, death_sound, step_sound)

ambient_sound

SoundEventRef

hurt_sound

SoundEventRef

death_sound

SoundEventRef

step_sound

SoundEventRef

CowVariant(asset_id, baby_asset_id, spawn_conditions, model?)

asset_id

texture id

The cow texture to use for this variant.

baby_asset_id

texture id

The baby cow texture to use for this variant.

spawn_conditions

list of SpawnPrioritySelector

The spawn conditions for this variant. Selection process: - Conditions for all variants for the given entity type are evaluated for the spawn position - Entries with a priority lower than the maximum priority of the remaining entries are removed - A random entry is picked out of the remaining ones - If no conditions are remaining, the variant remains unchanged from the default

modeloptional

CowModelType

CustomDataMap()

DamagePredicate(dealt?, taken?, blocked?, source_entity?, type?)

dealtoptional

MinMaxBounds of number

Amount of incoming damage before damage reduction.

takenoptional

MinMaxBounds of number

Amount of incoming damage after damage reduction.

blockedoptional

bool

Whether the damage was successfully blocked.

source_entityoptional

EntityPredicate

Source of the damage (eg: a skeleton shooting an arrow or player igniting tnt).

typeoptional

DamageSourcePredicate

DamageSourcePredicate(tags?, source_entity?, direct_entity?, is_direct?)

tagsoptional

list of DamageTagPredicate

Damage type tags that the damage type is in.

source_entityoptional

EntityPredicate

Source of the damage (eg: a skeleton shooting an arrow or player igniting tnt).

direct_entityoptional

EntityPredicate

Direct entity responsible for the damage (eg: the arrow or tnt).

is_directoptional

bool

Damage is direct when its direct and source entities are the same.

DamageTagPredicate(id, expected)

id

damage_type id | #damage_type tag | list of damage_type ids

expected

bool

Whether the damage is expected to have or not have the tag.

DamageType(message_id, exhaustion, scaling, effects?, death_message_type?)

message_id

string

The message id used for deaths caused by this damage type. Is combined with the result of death_message_type to form a translation key.

exhaustion

number 0..

Amount of hunger exhaustion to cause.

scaling

DamageScaling

Whether to scale damage with difficulty levels.

effectsoptional

DamageEffects

Controls how damage manifests when inflicted on players. Defaults to hurt.

death_message_typeoptional

DeathMessageType

Controls if special death message variants are used. Defaults to default. For more info see: https://minecraft.wiki/w/Damage_type#Death_messages

DataComponentExactPredicate()

DataComponentPatch()

DataComponentPredicate()

DebugFunctionEntry(label, function)

label

string

function

DensityFunctionRef

DecoratedPotPattern(asset_id)

asset_id

texture id

Dimension(type, generator)

type

DimensionTypeRef

generator

ChunkGenerator

DimensionType(has_skylight, has_ceiling, has_ender_dragon_fight, coordinate_scale, ambient_light, logical_height, infiniburn, min_y, height, monster_spawn_light_level, monster_spawn_block_light_limit, attributes?, default_clock?, timelines?, has_fixed_time?, skybox?, cardinal_light?)

has_skylight

bool

Affects the weather, lighting engine and respawning rules.

has_ceiling

bool

Affects the weather, map items and respawning rules.

has_ender_dragon_fight

bool

coordinate_scale

number 1e-05..3e+07

ambient_light

number 0..1

logical_height

int 0..4064

Portals can't spawn and chorus fruit can't teleport players above this height.

infiniburn

block id | #block tag | list of block ids

Defining what blocks keep fire infinitely burning.

min_y

int -2032..2031

The minimum height in which blocks can exist.

height

int 16..4064

The total height in which blocks can exist. Max Y = Min Y + Height.

monster_spawn_light_level

IntProvider of int 0..15

monster_spawn_block_light_limit

int 0..15

attributesoptional

GlobalEnvironmentAttributeMap

default_clockoptional

world_clock id

timelinesoptional

timeline id | #timeline tag | list of timeline ids

has_fixed_timeoptional

bool

Defaults to false.

skyboxoptional

SkyboxType

Skybox type. Defaults to overworld.

cardinal_lightoptional

CardinalLightType

The direction of cardinal lighting that affects blocks.

Dimensions(dimensions)

dimensions

map of dimension id to Dimension

DistancePredicate(x?, y?, z?, absolute?, horizontal?)

xoptional

MinMaxBounds of number

yoptional

MinMaxBounds of number

zoptional

MinMaxBounds of number

absoluteoptional

MinMaxBounds of number

horizontaloptional

MinMaxBounds of number

Dyeable(color_when_undyed?)

color_when_undyedoptional

RGB

If the item is not dyed, this color is used instead. If not specified and the item is not dyed, this layer will be hidden.

Enchantment(description, supported_items, weight, max_level, min_cost, max_cost, anvil_cost, slots, exclusive_set?, primary_items?, effects?)

description

Text

supported_items

item id | #item tag | list of item ids

weight

int 1..1024

How commonly the Enchantment appears, compared to the total combined weight of all available Enchantments.

max_level

int 1..255

Maximum level of the enchantment.

min_cost

EnchantmentCost

Minimum experience cost.

max_cost

EnchantmentCost

Maximum experience cost.

anvil_cost

int 0..

Halved when an Enchantment is added to a book. The effective fee is multiplied by the level of the Enchantment.

slots

list of EquipmentSlotGroup

exclusive_setoptional

enchantment id | #enchantment tag | list of enchantment ids

primary_itemsoptional

item id | #item tag | list of item ids

Item types for which this Enchantment shows up in Enchanting Tables and on traded equipment. Must be a subset of supported_items.

effectsoptional

EnchantmentEffectComponentMap

EnchantmentCost(base, per_level_above_first)

base

int

Base cost at level 1.

per_level_above_first

int

Cost increase per level above 1.

EnchantmentEffectComponentMap()

EndSpike(centerX, centerZ, radius, height, guarded?)

centerX

int

centerZ

int

radius

int

height

int

guardedoptional

bool

EntityEffectsPredicate()

EntitySubPredicateMap()

EnvironmentAttributeMap()

EnvironmentAttributeTrackMap()

Equipment(layers, trim_overrides?)

layers

Layers

List of layers for each model layer type.

trim_overridesoptional

list of TrimOverride

Replaces trim texture based on armor trim. Only the first entry that matches is applied.

ExclusionZone(other_set, chunk_count)

other_set

StructureSetRef

chunk_count

int 1..16

Explosion(shape, colors?, fade_colors?, has_trail?, has_twinkle?)

shape

FireworkShape

The shape of the explosion.

colorsoptional

list of int

Colors of the initial particles of the explosion, randomly selected from. Calculated as RED << 16 | GREEN << 8 | BLUE. Each of these fields must be between 0 and 255, inclusive.

fade_colorsoptional

list of int

Colors of the fading particles of the explosion

has_trailoptional

bool

Added to a firework star via Diamond.

has_twinkleoptional

bool

Added to a firework star via Glowstone Dust.

ExplosionData(fuse, power, causes_fire)

fuse

int 1..

The fuse time in ticks when ignited. When ignited by an explosion, the fuse will be a random value between explosion_fuse / 8 and 3 * explosion_fuse / 8.

power

int 0..

The explosion power.

causes_fire

bool

Whether the explosion causes fire.

FilterPattern(namespace?, path?)

namespaceoptional

string

pathoptional

string

FlatGeneratorLayer(height, block)

height

int 0..4096

block

block id

FlatGeneratorPreset(display, settings)

display

item id

settings

FlatGeneratorSettings

FlatGeneratorSettings(layers, biome?, lakes?, features?, structure_overrides?)

layers

list of FlatGeneratorLayer

biomeoptional

biome id

lakesoptional

bool

featuresoptional

bool

structure_overridesoptional

structure_set id | #structure_set tag | list of structure_set ids

FlatWeightedEntry(weight, type, count)

weight

int 0..

type

entity_type id

count

IntProvider of int

FluidPredicate(fluids?, state?)

fluidsoptional

fluid id | #fluid tag | list of fluid ids

stateoptional

map of string to MinMaxBounds of int | bool | string

Font(providers)

providers

list of GlyphProvider

FrogVariant(asset_id, spawn_conditions)

asset_id

texture id

The frog texture to use for this variant.

spawn_conditions

list of SpawnPrioritySelector

The spawn conditions for this variant. Selection process: - Conditions for all variants for the given entity type are evaluated for the spawn position - Entries with a priority lower than the maximum priority of the remaining entries are removed - A random entry is picked out of the remaining ones - If no conditions are remaining, the variant remains unchanged from the default

FullBlockState(id, properties?)

id

block id

propertiesoptional

any (depends on id)

GeodeBlockSettings(filling_provider, inner_layer_provider, alternate_inner_layer_provider, middle_layer_provider, outer_layer_provider, inner_placements, cannot_replace, invalid_blocks)

filling_provider

BlockStateProviderRef

inner_layer_provider

BlockStateProviderRef

alternate_inner_layer_provider

BlockStateProviderRef

middle_layer_provider

BlockStateProviderRef

outer_layer_provider

BlockStateProviderRef

inner_placements

list of BlockState (at least 1)

cannot_replace

block id | #block tag | list of block ids

Blocks that will not be replaced by the geode.

invalid_blocks

block id | #block tag | list of block ids

When encountering an invalid block, feature placement is cancelled.

GeodeCrackSettings(generate_crack_chance?, base_crack_size?, crack_point_offset?)

generate_crack_chanceoptional

number 0..1

base_crack_sizeoptional

number 0..5

crack_point_offsetoptional

int 0..10

GeodeLayerSettings(filling?, inner_layer?, middle_layer?, outer_layer?)

fillingoptional

number 0.01..50

inner_layeroptional

number 0.01..50

middle_layeroptional

number 0.01..50

outer_layeroptional

number 0.01..50

Instrument(sound_event, range, use_duration, description, durability_damage?)

sound_event

SoundEventRef

range

number 0..<

Maximum range in blocks that the sound can be heard

use_duration

number 0..

Duration of use in seconds, used as item cooldown

description

Text

durability_damageoptional

int 0..

InternalTarget(width?, height?, persistent?, clear_color?)

widthoptional

int

heightoptional

int

persistentoptional

bool

If true, target will be persistent across frames. Defaults to false. The contents of the target will be cleared when the screen is resized.

clear_coloroptional

RGBA

Target will be filled with this color when created or cleared. Defaults to 0.

ItemDefinition(model, hand_animation_on_swap?, oversized_in_gui?, swap_animation_scale?)

model

ItemModel

hand_animation_on_swapoptional

bool

Whether the down-and-up animation should be played in first-person view when the item stack is changed. Defaults to true.

oversized_in_guioptional

bool

Whether the item model is allowed to be bigger than its item slot. Defaults to false, which clips the item model in GUI to the item slot size. The behavior of true is **not** officially supported.

swap_animation_scaleoptional

number

How fast the item moves up and down when swapping items in hotbar. Defaults to 1.0

ItemStackOfComponent(id, components?, count?)

id

item id

ID of the item.

componentsoptional

DataComponentPatch

countoptional

int 1..99

Number of items in the stack. Defaults to 1.

ItemUesdOnLocationConditions(player?, location?)

playeroptional

AdvancementEntityPredicate

Predicate context: Advancement Entity.

locationoptional

AdvancementLocationPredicate

Predicate context: Advancement Location.

JukeboxSong(description, comparator_output, length_in_seconds, sound_event)

description

Text

Displayed in the HUD actionbar & item tooltip.

comparator_output

int 0..15

length_in_seconds

number 0..<

sound_event

SoundEventRef

KnockbackModifiers(horizontal_power, vertical_power)

horizontal_power

number

The horizontal power of the knockback.

vertical_power

number

The vertical power of the knockback.

Lang()

Layer(texture, dyeable?)

texture

texture id

Texture location for this layer, inside entity/equipment/<layer>/.

dyeableoptional

Dyeable

If specified, this layer will be tinted by the color contained in the dyed_color component.

Layers(humanoid?, humanoid_leggings?, humanoid_baby?, wings?, wolf_body?, horse_body?, llama_body?, happy_ghast_body?, nautilus_saddle?, nautilus_body?, pig_saddle?, strider_saddle?, camel_husk_saddle?, camel_saddle?, horse_saddle?, donkey_saddle?, mule_saddle?, zombie_horse_saddle?, skeleton_horse_saddle?)

humanoidoptional

list of Layer of texture id

humanoid_leggingsoptional

list of Layer of texture id

humanoid_babyoptional

list of Layer of texture id

wingsoptional

list of WingsLayer of texture id

wolf_bodyoptional

list of Layer of texture id

horse_bodyoptional

list of Layer of texture id

llama_bodyoptional

list of Layer of texture id

happy_ghast_bodyoptional

list of Layer of texture id

nautilus_saddleoptional

list of Layer of texture id

nautilus_bodyoptional

list of Layer of texture id

pig_saddleoptional

list of Layer of texture id

strider_saddleoptional

list of Layer of texture id

camel_husk_saddleoptional

list of Layer of texture id

camel_saddleoptional

list of Layer of texture id

horse_saddleoptional

list of Layer of texture id

donkey_saddleoptional

list of Layer of texture id

mule_saddleoptional

list of Layer of texture id

zombie_horse_saddleoptional

list of Layer of texture id

skeleton_horse_saddleoptional

list of Layer of texture id

Light(light?)

lightoptional

MinMaxBounds of int 0..15

LocationPredicate(position?, biomes?, structures?, dimension?, light?, block?, fluid?, smokey?, can_see_sky?)

positionoptional

{ x?: MinMaxBounds of number, y?: MinMaxBounds of number, z?: MinMaxBounds of number }

biomesoptional

biome id | #biome tag | list of biome ids

structuresoptional

structure id | #structure tag | list of structure ids

dimensionoptional

dimension id

lightoptional

Light(…)

Calculated using: max(sky-darkening, block).

blockoptional

BlockPredicate

fluidoptional

FluidPredicate

smokeyoptional

bool

Whether the block is above (5 blocks or less) a campfire or soul campfire.

can_see_skyoptional

bool

Whether the location has the maximum possible level of sky light

LootPool(rolls, entries)

rolls

IntNumberProviderRef

entries

list of LootPoolEntry

LootTable(type?, pools?, modifier?, random_sequence?)

typeoptional

LootContextParamSets

poolsoptional

list of LootPool

modifieroptional

ItemModifier

random_sequenceoptional

random_sequence id

MangroveRootPlacement(max_root_width, max_root_length, random_skew_chance, can_grow_through, muddy_roots_in, muddy_roots_provider)

max_root_width

int 1..12

max_root_length

int 1..64

random_skew_chance

number 0..1

can_grow_through

block id | #block tag | list of block ids

muddy_roots_in

block id | #block tag | list of block ids

muddy_roots_provider

BlockStateProviderRef

MobEffectPredicate(amplifier?, duration?, ambient?, visible?)

amplifieroptional

MinMaxBounds of int

durationoptional

MinMaxBounds of int

ambientoptional

bool

visibleoptional

bool

Model(parent?, ambientocclusion?, gui_light?, textures?, elements?, display?)

parentoptional

model id

ambientocclusionoptional

bool

gui_lightoptional

"front" | "side"

texturesoptional

map of string to texture id | TextureMaterial

elementsoptional

list of ModelElement

displayoptional

map of CustomizableItemDisplayContext to { rotation?: list of number (exactly 3), translation?: list of number -80..80 (exactly 3), scale?: list of number -4..4 (exactly 3) }

ModelElement(from, to, faces, rotation?, shade_direction_override?, light_emission?)

from

list of number -16..32 (exactly 3)

to

list of number -16..32 (exactly 3)

faces

map of Direction to object

rotationoptional

ModelElementRotation

shade_direction_overrideoptional

Direction

light_emissionoptional

int 0..15

ModelVariantBase(model, x?, y?, z?, uvlock?)

model

ModelRef

xoptional

0 | 90 | 180 | 270

yoptional

0 | 90 | 180 | 270

zoptional

0 | 90 | 180 | 270

uvlockoptional

bool

If set to true, the textures are not rotated with the block.

MultiNoiseBiomeSourceParameterList(preset)

preset

MultiNoisePreset

Multipart(multipart)

multipart

list of { when?: MultiPartCondition, apply: ModelVariant }

NoiseGeneratorSettings(default_block, default_fluid, sea_level, disable_mob_generation, legacy_random_source, noise, noise_router, spawn_target, material_rule, aquifers?, debug_functions?)

default_block

BlockState

default_fluid

BlockState

sea_level

int

disable_mob_generation

bool

If true, mobs will not spawn during generation.

legacy_random_source

bool

noise

NoiseSettings

noise_router

NoiseRouter

spawn_target

list of SpawnTargetPoint

material_rule

MaterialRuleRef

aquifersoptional

Aquifer

debug_functionsoptional

list of DebugFunctionEntry

NoiseParameters(base_octave, base_amplitude?, octave_count?, normalize?, amplitude_modifiers?)

base_octave

int -32..32

base_amplitudeoptional

number 0..1e+06

Defaults to 1.0.

octave_countoptional

int 1..32

Defaults to 1.

normalizeoptional

bool | "legacy"

Defaults to true.

amplitude_modifiersoptional

list of number 0..1e+06 (at most 32)

When empty or not present, defaults to all 1.0. Otherwise, the size must match octave_count.

NoiseRouter(temperature, vegetation, continents, erosion, depth, ridges, chunk_surface_level, final_density)

temperature

DensityFunctionRef

vegetation

DensityFunctionRef

continents

DensityFunctionRef

erosion

DensityFunctionRef

depth

DensityFunctionRef

ridges

DensityFunctionRef

chunk_surface_level

DensityFunctionRef

final_density

DensityFunctionRef

NoiseSettings(min_y, height)

min_y

int -2048..2047

Minimum height where blocks start generating.

height

int 0..4096

The total height where blocks can generate. Max Y = Min Y + Height.

OR(OR)

OR

list of MultiPartCondition

Option(id, display?, initial?)

id

string

String to send on submit.

displayoptional

Text

Label displayed on the button. When not present, id will be used instead.

initialoptional

bool

Whether this option is the initial value. Only one option can have this field set to true.

PaintingVariant(asset_id, width, height, title?, author?)

asset_id

texture id

width

int 1..16

Dimension in blocks.

height

int 1..16

Dimension in blocks.

titleoptional

Text

authoroptional

Text

Particle(textures)

textures

list of texture ids

PigVariant(asset_id, baby_asset_id, spawn_conditions, model?)

asset_id

texture id

The pig texture to use for this variant.

baby_asset_id

texture id

The baby pig texture to use for this variant.

spawn_conditions

list of SpawnPrioritySelector

The spawn conditions for this variant. Selection process: - Conditions for all variants for the given entity type are evaluated for the spawn position - Entries with a priority lower than the maximum priority of the remaining entries are removed - A random entry is picked out of the remaining ones - If no conditions are remaining, the variant remains unchanged from the default

modeloptional

PigModelType

PlacedFeature(feature, placement)

feature

ConfiguredFeatureRef

placement

list of PlacementModifier

PlainMessage(contents, width?)

contents

Text

A multiline label. Click events in the text trigger after_action like any other action.

widthoptional

int 1..1024

Maximum width of message. Defaults to 200.

Player(player?)

playeroptional

AdvancementEntityPredicate

Predicate context: Advancement Entity.

PlayerConditions(player?)

playeroptional

AdvancementEntityPredicate

Predicate context: Advancement Entity.

Pool(rolls, entries)

rolls

IntNumberProviderRef

entries

list of LootPoolEntry

PostEffect(targets?, passes?)

targetsoptional

Targets

passesoptional

list of Pass

PotionIngredient(item, potion_contents?)

item

Ingredient

potion_contentsoptional

PotionsPredicate

PotionsPredicate(potions?, effects?)

potionsoptional

PotionTypeMatch

effectsoptional

CollectionPredicate of EntityEffectsPredicate

Preset(preset)

preset

MultiNoisePreset

ProcessorRule(location_predicate, input_predicate, output_state, position_predicate?, block_entity_modifier?)

location_predicate

RuleTest

input_predicate

RuleTest

output_state

BlockState

position_predicateoptional

PosRuleTest

block_entity_modifieroptional

BlockEntityModifier

Processors(processors)

processors

list of Processor

ProfileProperty(name, value, signature?)

name

string (0 to 64)

Usually textures.

value

string (0 to 32767)

Base64 encoded JSON value of the texture index.

signatureoptional

string (0 to 1024)

Verifies the hash of the resulting texture.

ProfilePropertyMap()

Providers(providers)

providers

list of GlyphProvider

RelativeToSeaLevel(relative_to_sea_level)

relative_to_sea_level

int

RuinedPortalSetup(placement, air_pocket_probability, mossiness, overgrown, vines, can_be_cold, replace_with_blackstone, weight)

placement

RuinedPortalPlacement

air_pocket_probability

number 0..1

mossiness

number 0..1

overgrown

bool

vines

bool

can_be_cold

bool

replace_with_blackstone

bool

weight

number 0..

SoundSettings(hit_sound, push_sound, push_sound_impulse_threshold, push_sound_cooldown)

hit_sound

SoundEventRef

push_sound

SoundEventRef

push_sound_impulse_threshold

number

Minimum impact speed required to trigger the sound.

push_sound_cooldown

number

Cooldown in seconds for the sound effect.

SoundVariant(adult_sounds, baby_sounds)

adult_sounds

CatSounds

baby_sounds

CatSounds

Sources(sources)

sources

list of SpriteSource

List of sprite sources which can add or remove sprite textures to this atlas.

SpawnOverride(bounding_box, spawns)

bounding_box

BoundingBox

spawns

FlatWeightedList of SpawnerData

SpawnPrioritySelector(priority, condition?)

priority

int

The spawn priority to use.

conditionoptional

SpawnCondition

The spawn condition to check. If not present, the condition always matches.

SpawnTargetPoint()

SplinePoint(location, derivative, value)

location

number

derivative

number

value

CubicSpline

StewEffect(type, duration)

type

mob_effect id

The status effect of this stew effect.

duration

IntNumberProviderRef

The duration of this stew effect, in seconds.

StructureSet(structures, placement)

structures

list of StructureSetElement

placement

StructurePlacement

StructureSetElement(structure, weight)

structure

structure id

weight

int 1..

SulfurCubeArchetype(items, knockback_modifiers, attribute_modifiers, sound_settings, buoyant?, explosion?, contact_damage?)

items

item id | #item tag | list of item ids

knockback_modifiers

KnockbackModifiers

attribute_modifiers

list of AttributeEntry

sound_settings

SoundSettings

buoyantoptional

bool

Defaults to false.

explosionoptional

ExplosionData

When present, sulfur cube with this archetype will explode when ignited.

contact_damageoptional

ContactDamage

TargetBlock(target, state)

target

RuleTest

state

BlockState

TargetInput(target, sampler_name, use_depth_buffer?, bilinear?)

target

shader_target id

sampler_name

string

use_depth_bufferoptional

bool

bilinearoptional

bool

Targets()

TemplatePool(fallback, elements, name?)

fallback

template_pool id

elements

list of WeightedElement

nameoptional

string

TextStyle(color?, shadow_color?, font?, bold?, italic?, underlined?, strikethrough?, obfuscated?, insertion?, click_event?, hover_event?)

coloroptional

string | TextColor

shadow_coloroptional

RGBA

Overrides the shadow properties of the text. If specified as 0, the shadow will never be displayed.

fontoptional

font id

boldoptional

bool

italicoptional

bool

underlinedoptional

bool

strikethroughoptional

bool

obfuscatedoptional

bool

insertionoptional

string

click_eventoptional

ClickEvent

hover_eventoptional

HoverEvent

TextureInput(location, sampler_name, width, height, bilinear?)

location

texture id

sampler_name

string

width

int 1..

height

int 1..

bilinearoptional

bool

TextureMaterial(sprite, force_translucent?)

sprite

texture id

force_translucentoptional

bool

Whether the texture should be forced into the translucent render pass. Textures without any translucent pixels are not assigned to the translucent pass by default. Defaults to false.

Textures(textures)

textures

list of texture ids

TimeMarker(ticks, show_in_commands?)

ticks

int 0..

show_in_commandsoptional

bool

Whether the time marker shows up in command suggestions. The time marker is still available in commands even if it is not suggested. Defaults to false.

TimeMarkerMap()

Timeline(clock, period_ticks?, time_markers?, tracks?)

clock

world_clock id

The world clock this timeline is tied to.

period_ticksoptional

int 1..

When not present, the timeline will not repeat.

time_markersoptional

TimeMarkerMap

tracksoptional

EnvironmentAttributeTrackMap

TradeCost(id, components?, count?)

id

item id

ID of the item.

componentsoptional

DataComponentExactPredicate

countoptional

IntNumberProvider

Defaults to 1.

TradeSet(trades, amount, allow_duplicates?, random_sequence?)

trades

villager_trade id | #villager_trade tag | list of villager_trade ids

Possible trade generators.

amount

IntNumberProvider

Amount of trades to be generated.

allow_duplicatesoptional

bool

Whether the trade set can use the same generator multiple times and generate duplicate trades. Defaults to false.

random_sequenceoptional

random_sequence id

TransmuteResult(id?, count?, components?)

idoptional

item id

Defaults to the input item.

countoptional

int 1..99

Defaults to 1.

componentsoptional

DataComponentPatch

TrialSpawnerConfig(spawn_range?, total_mobs?, total_mobs_added_per_player?, simultaneous_mobs?, simultaneous_mobs_added_per_player?, ticks_between_spawn?, spawn_potentials?, loot_tables_to_eject?, items_to_drop_when_ominous?)

spawn_rangeoptional

int 1..128

Maximum distance from the spawner that en entity can spawn

total_mobsoptional

number

Total amount of entities that are spawned during one activation, when 1 player is nearby

total_mobs_added_per_playeroptional

number

Number added to total_mobs for each additional player

simultaneous_mobsoptional

number

Number of entities that that can be present at once, when 1 player is nearby

simultaneous_mobs_added_per_playeroptional

number

Number added to simultaneous_mobs for each additional player

ticks_between_spawnoptional

int

Ticks until the next spawn.

spawn_potentialsoptional

list of SpawnPotential

Entities that can be placed.

loot_tables_to_ejectoptional

WeightedList of loot_table id

Loot tables to use when ejecting loot. Chooses one loot table based on weight and then uses it as often as there are players nearby.

items_to_drop_when_ominousoptional

loot_table id

Loot table to use when summoning ominous item spawners. One roll seeded based on rough location to determine all items used during the battle.

TrimMaterial(palette_id, description)

palette_id

PaletteRef

Palette ID which will be used in the resource pack.

description

Text

Text displayed in the item tooltip.

TrimOverride(when, texture?, palette?)

when

{ pattern?: trim_pattern id, material?: trim_material id }

textureoptional

id

When present, overrides the base texture provided by trim pattern. The texture is located under trims/entity/<layer>/.

paletteoptional

PaletteRef

When present, overrides the palette texture provided by trim material.

TrimPattern(asset_id, description, decal?)

asset_id

id

ID of the pattern that will be used in the resource pack as an overlay on the armor. The texture is located under trims/entity/<layer>/.

description

Text

Text displayed in the item tooltip.

decaloptional

bool

Whether the pattern texture will be masked based on the underlying armor. Defaults to false.

UniformBlocks()

UniformIntProvider(min_inclusive, max_inclusive)

min_inclusive

int -16..0

max_inclusive

int -16..0

UniformValue(type, value, name?)

type

UniformValueType

value

any (depends on type)

nameoptional

string

Unused by the game, but good to set in practice.

UnihexOverrideRange(from, to, left, right)

from

string

Minimum in codepoint range (inclusive).

to

string

Maximum in codepoint range (inclusive).

left

int 0..255

Position of left-most column of the glyph.

right

int 0..255

Position of right-most column of the glyph.

UnstitchRegion(sprite, x, y, width, height)

sprite

texture id

x

number

y

number

width

number

height

number

Variants(variants)

variants

map of string to ModelVariant

VillagerTrade(wants, gives, additional_wants?, given_item_modifier?, max_uses?, reputation_discount?, xp?, merchant_predicate?, double_trade_price_enchantments?)

wants

TradeCost

Price item required by the merchant. The count is affected by various factors, including offered item, demand and player reputation.

gives

ItemStackTemplate

Item being offered by the merchant.

additional_wantsoptional

TradeCost

Second item required by the merchant. The count is not affected by any factors.

given_item_modifieroptional

ItemModifierWithoutRootRef

Modifiers applied to the gives item. Does **not** support reference item modifier. Some modifiers can affect the price through the additional_trade_cost transient component. The additional_trade_cost component is not saved on the offered item. ID reference is not allowed here.

max_usesoptional

IntNumberProvider

Maximum number of uses of this trade before the villager has to restock. Defaults to 4.

reputation_discountoptional

FloatNumberProvider

How much demand & reputation each affect the price, is serialized as priceMultiplier. Defaults to 0.0.

xpoptional

IntNumberProvider

Amount to increase the merchant's XP score by that determines their trade tier. Defaults to 1.

merchant_predicateoptional

Predicate

Check whether the trade should be offered by the merchant. Does **not** support the reference predicate.

double_trade_price_enchantmentsoptional

enchantment id | #enchantment tag | list of enchantment ids

If the offered enchanted book has the specified enchantments, the price will be affected by doubling the additional_trade_cost transient component.

WaypointStyle(sprites, near_distance?, far_distance?)

sprites

list of texture ids (at least 1)

near_distanceoptional

int 0..6e+07

Defaults to 128.

far_distanceoptional

int 0..6e+07

Defaults to 322.

WeightedElement(weight, element)

weight

int 1..150

element

Element

WeightedEntry(weight, data)

weight

int 0..

data

FloatRef

WingsLayer(texture, dyeable?, use_player_texture?)

texture

texture id

Texture location for this layer, inside entity/equipment/<layer>/.

dyeableoptional

Dyeable

If specified, this layer will be tinted by the color contained in the dyed_color component.

use_player_textureoptional

bool

Whether this layer texture should be overridden by the player's custom elytra texture. Defaults to false.

WolfVariant(assets, baby_assets, spawn_conditions)

assets

WolfVariantAssetInfo

The texture set to use for this wolf variant.

baby_assets

WolfVariantAssetInfo

The baby texture set to use for this wolf variant.

spawn_conditions

list of SpawnPrioritySelector

The spawn conditions for this variant. Selection process: - Conditions for all variants for the given entity type are evaluated for the spawn position - Entries with a priority lower than the maximum priority of the remaining entries are removed - A random entry is picked out of the remaining ones - If no conditions are remaining, the variant remains unchanged from the default

WolfVariantAssetInfo(wild, tame, angry)

wild

texture id

tame

texture id

angry

texture id

WorldPreset(dimensions)

dimensions

map of dimension id to Dimension

ZombieNautilusVariant(asset_id, spawn_conditions, model?)

asset_id

texture id

The zombie nautilus texture to use for this variant.

spawn_conditions

list of SpawnPrioritySelector

The spawn conditions for this variant. Selection process: - Conditions for all variants for the given entity type are evaluated for the spawn position - Entries with a priority lower than the maximum priority of the remaining entries are removed - A random entry is picked out of the remaining ones - If no conditions are remaining, the variant remains unchanged from the default

modeloptional

ZombieNautilusModelType