Java Edition 25w42a

• Provides a data-driven way to control a variety of visual and gameplay systems.
• Each Environment Attribute controls a specific visual or gameplay effect:
  • For example, minecraft:visual/sky_color controls the color of the sky, and minecraft:gameplay/water_evaporates controls whether water can be placed at a given location.

• Sources
  • Environment Attribute values can be provided by the following Environment Attribute sources (in order of low to high priority):
    • Dimensions
    • Biomes
  • The "effective" value of the Environment Attribute (i.e. what will actually show up in game) will be some combination of the values provided by each source according to their priority.
    • For example, in the following scenario:
      • The overworld dimension provides sky_color = #00ff00 (green)
      • The plains biome provides sky_color = #ff0000 (red)
    • When the player is in the plains biome, they will see the red sky_color, while anywhere else in the overworld they will see green.
  • When an Environment Attribute source provides an Environment Attribute, it can:
    • Override the value, such as the plains biome overriding the overworld's sky_color in the above scenario.
    • Apply a modifier to a previous value.

• Modifiers
  • An environment attribute source may simply override the value of a particular attribute.
    • However, it is sometimes also desirable to rather apply a modifier to a value provided by a source with lower priority.
    • For example, in the following scenario:
      • The overworld dimension provides water_fog_radius = 96.0
      • The plains biome modifies water_fog_radius with a multiply modifier of 0.85
    • When in the plains biome, the water_fog_radius will be resolved to ${\displaystyle 96.0*0.85=81.6}$, while in any other Overworld biome, it will resolve to 96.0.
  • The kinds of modifiers available depends on the type of Environment Attribute.
    • The most basic modifier, supported by every Environment Attribute, is the override modifier.
    • This behaves purely as an override of the preceding value.
      • If not specified by an Environment Attribute source, the modifier will always be assumed to be override.

• Interpolation
  • Interpolation describes the combination of values within a source.
  • Is performed on values from a source after modifiers have been applied.
  • Only some Environment Attributes support interpolation. This allows for the smooth transition between two or more values, such as when moving between two biomes.
  • Biomes
    • sky_color is one attribute that will transition smoothly based on position.
    • For example, in the following scenario:
      • The plains biome provides sky_color = #ff0000 (red)
      • The desert biome provides sky_color = #ffff00 (yellow)
    • In the above scenario, as a player moves from a plains to a desert biome, the sky color will gradually shift from red to yellow.
    • Other attributes, such as water_evaporates, represent discrete values and will not be smoothly transitioned - only the biome exactly at a subject position will be considered.
    • Smooth transitions between biomes are based on the biomes within an 8 block radius of the camera. Biomes that occupy a larger portion of that radius and are closer to the camera will have a stronger influence on the final interpolated value.

• Environment Attribute Map
  • Dimension Type and Biome definitions contain a new attributes field, enabling them to define Environment Attributes.
  • This map generally takes the form of an object mapping between Environment Attribute IDs and their corresponding values, for example:

"attributes": { "minecraft:visual/fog_color": "#ffaa00", "minecraft:gameplay/water_evaporates": true }

• Values defined as above will always be assumed to use the override modifier.
  • The value object can however be expanded in order to express different modifiers, in the format of an object with the following fields:
    • modifier: optional string modifier ID, dependent on the Attribute Type.
      • Default: override
    • argument: the modifier argument (format dependent on the chosen modifier).
      • How the argument is used also depends on the type of modifier.
    • For example, the following definition describes multiplying water_fog_radius by 85%:

"attributes": { "minecraft:visual/water_fog_radius": { "modifier": "multiply", "argument": 0.85 } }

• Common Data Types
  • The following data types are reused in various parts of the Environment Attributes system.
  • RGB Color
    • Format can be one of the following:
      • A hex color RGB string, in the form #rrggbb
      • A float array with 3 components, between 0 and 1, in the form [r, g, b]
      • An integer in packed RGB form.
  • ARGB Color
    • Format can be one of the following:
      • A hex color ARGB string, in the form #aarrggbb
      • A float array with 4 components, between 0 and 1, in the form [a, r, g, b]
      • An integer in packed ARGB form.
  • Particle Options
    • A full definition of a particle, including any type-specific properties (as in the /particle command).
      • For example:

{ "type": "minecraft:block_crumble", "block_state": { "Name": "minecraft:dirt" } }

• Common Modifiers
• Every Environment Attribute has a specific value type, which describes how values must be defined as well as what modifiers are available and how they are interpolated.
  • Some are very specific, while others are reused across many attributes.
  • Modifiers on Boolean Values
    • Argument format: boolean
      • override
      • and
      • nand
      • or
      • nor
      • xor
      • xnor
  • Modifiers on Float Values
    • Argument format: float
      • override
      • add
      • subtract
      • multiply
      • minimum
      • maximum
  • Modifiers on Color Values
    • Argument format: RGB color (except alpha_blend)
      • override
      • add - component-wise additive color blending
      • subtract - component-wise subtractive color blending..
      • multiply - component-wise multiplicative color blending.
      • alpha_blend - traditional alpha blending that might be seen in image editing software.
        • Argument format: ARGB Color
        • When the argument alpha is 1, it will behave as an override with no blending.

• New Environment Attributes
  • minecraft:visual/fog_color
    • The color of fog (when the camera is not submerged in another substance).
      • Value type: RGB color
      • Default value: #000000
      • Modifiers: Color Modifiers
      • Interpolated: yes
      • Resolved at the camera's position.
      • Replaces Biome effects.fog_color field.
    • Note: the final value is also affected by the time of day, weather, and potion effects.
  • minecraft:visual/extra_fog
    • Controls whether dense fog (like that of the Nether) should be used (when the camera is not submerged in another substance).
      • Value type: boolean
      • Default value: false
      • Modifiers: Boolean Modifiers
      • Interpolated: no
      • Resolved at the camera's position.
  • minecraft:visual/water_fog_color
    • The color of fog when submerged in water.
      • Value type: RGB color
      • Default value: #050533
      • Modifiers: Color Modifiers
      • Interpolated: yes
      • Resolved at the camera's position.
      • Replaces Biome effects.water_fog_color field.
    • Note: the final value is also affected by the time of day, weather, and potion effects.
  • minecraft:visual/water_fog_radius
    • The distance in blocks from the camera at which underwater fog reaches its maximum density.
      • Value type: non-negative float
      • Default value: 96.0
      • Modifiers: Float Modifiers
      • Interpolated: yes
      • Resolved at the camera's position.
      • Replaces #has_closer_water_fog Biome Tag.
    • Note: the final value is also modified by how long the player has been underwater.
  • minecraft:visual/sky_color
    • The color of the sky. This color is only visible for the overworld sky.
      • Value type: RGB color
      • Default value: #000000
      • Modifiers: Color Modifiers
      • Interpolated: yes
      • Resolved at the camera's position.
      • Replaces Biome effects.sky_color field.
    • Note: the final value is also affected by the time of day and weather.
  • minecraft:visual/cloud_opacity
    • The opacity of clouds. If 0, clouds are entirely disabled and happy ghasts will not regenerate health faster when at cloud height.
      • Value type: float between 0 and 1
      • Default value: 0.0
      • Modifiers: Float Modifiers
      • Interpolated: yes
      • Resolved at the camera's position for rendering, or at the position of a happy ghast for regeneration.
  • minecraft:visual/cloud_height
    • The height at which all clouds appear.
      • Value type: float
      • Default value: 192.33
      • Modifiers: Float Modifiers
      • Interpolated: yes
      • Resolved at the camera's position for rendering, or at the position of a happy ghast for regeneration.
      • Replaces Dimension Type cloud_height field.
  • minecraft:visual/default_dripstone_particle
    • The default particle to be dripped from dripstone blocks when no fluid is placed above.
      • Value type: Particle Options
      • Default value: {type:"minecraft:dripping_dripstone_water"}
      • Modifiers: override
      • Interpolated: no
      • Resolved at the position of the dripstone block.
      • Replaces Dimension Type ultrawarm field.
  • minecraft:visual/ambient_particles
    • Controls ambient particles that randomly spawn around the camera.
      • Value type: list of objects with fields
        • particle: Particle Options to spawn.
        • probability: float between 0 and 1, the probability to spawn the particle in an empty space when randomly ticked.
      • Default value: []
      • Modifiers: override
      • Interpolated: no
      • Resolved at the camera's position.
      • Replaces Biome effects.particle field.
  • minecraft:audio/background_music
    • Controls how and which background music is played.
      • Value type: object with fields
        • default: optional object with fields:
          • sound: Sound Event to play.
          • min_delay: int, minimum delay in ticks between tracks.
          • max_delay: int, maximum delay in ticks between tracks.
          • replace_current_music: optional boolean, whether this track can replace whatever is currently playing.
            • Default: false
          • If not defined and not overridden, no music will start playing while this attribute is active.
        • underwater: optional object with fields in the same format as default - if present and the player is underwater, will override default.
        • creative: optional object with fields in the same format as default - if present and the player is in Creative Mode, will override default.
      • Default value: {}
      • Modifiers: override
      • Interpolated: no
      • Resolved at the camera's position.
      • Replaces Biome effects.music field.
  • minecraft:audio/music_volume
    • The volume at which music should play. Any music playing will fade over time to this value.
      • Value type: float between 0 and 1
      • Default value: 1.0
      • Modifiers: Float Modifiers
      • Interpolated: no
      • Resolved at the camera's position.
      • Replaces Biome effects.music_volume field.
  • minecraft:audio/ambient_sounds
    • Controls which ambient sounds are played around the camera, and when.
      • Value type: object with fields
        • loop: optional Sound Event, sound to be continually looped.
        • mood: object with fields, sounds that will be randomly played based on surrounding darkness.
          • sound: Sound Event to play.
          • tick_delay: int, the number of ticks between mood sounds, assuming a light level of 0.
          • block_search_extent: int, the radius in which light levels are sampled.
          • offset: double, an additional distance offset to apply to sounds produced.
        • additions: list of objects with fields, sounds that will be randomly played.
          • sound: Sound Event to play
          • tick_chance: float between 0 and 1, probability within a tick to play a given sound.
      • Default value: {}
      • Modifiers: override
      • Interpolated: no
      • Resolved at the camera's position.
      • Replaces Biome effects.ambient_sound, effects.mood_sound, and effects.additions_sound fields.
  • minecraft:gameplay/can_start_raid
    • If false, a raid cannot be started by a player with raid omen.
      • Value type: boolean
      • Default value: true
      • Modifiers: Boolean Modifiers
      • Interpolated: no
      • Resolved at the position that the Raid would be started.
      • Replaces Dimension Type has_raids field.
  • minecraft:gameplay/water_evaporates
    • If true, water cannot be placed with a bucket, melting ice will not produce water, wet sponge will dry out when placed, and dripstone will not produce water from mud blocks.
      • Value type: boolean
      • Default value: false
      • Modifiers: Boolean Modifiers
      • Interpolated: no
      • Resolved at the position of the interaction.
      • Replaces Dimension Type ultrawarm field.
  • minecraft:gameplay/bed_rule
    • Controls whether a bed can be used to sleep, and whether it can be used to set a respawn point.
      • Value type: object with fields.
        • can_sleep: one of:
          • always - the bed can always be used to sleep (assuming the bed is not obstructed and there are no monsters nearby).
          • when_dark - bed bed can only be used to be sleep when the global skylight level is less than 4.
          • never - the bed can never be used to sleep.
        • can_set_spawn - same as can_sleep
        • explodes - optional boolean, if true the bed will explode when interacted with.
          • Default: false
        • error_message: optional Text Component, the message to show if the player is unable to sleep or set their spawn.
      • Default value: {type:"can_sleep_when_dark",error_message:{translate:"block.minecraft.bed.no_sleep"}}
      • Modifiers: override
      • Interpolated: no
      • Resolved at the head position of the Bed block.
      • Replaces Dimension Type bed_works field.
  • minecraft:gameplay/respawn_anchor_works
    • Controls whether respawn anchors can be used to set spawn (or respawn).
    • If false, the respawn anchor will explode once charged.
      • Value type: boolean
      • Default value: false
      • Modifiers: Boolean Modifiers
      • Interpolated: no
      • Resolved at the position of the Respawn Anchor block.
      • Replaces Dimension Type respawn_anchor_works field.
  • minecraft:gameplay/nether_portal_spawns_piglin
    • Controls whether nether portal blocks can spawn piglins.
      • Value type: boolean
      • Default value: false
      • Modifiers: Boolean Modifiers
      • Interpolated: no
      • Resolved at the position of a random Nether Portal block.
      • Replaces Dimension Type natural field.
  • minecraft:gameplay/fast_lava
    • Controls whether Lava should spread faster and further, as well as have a stronger pushing force on entities when flowing.
      • Value type: boolean
      • Default value: false
      • Modifiers: Boolean Modifiers
      • Interpolated: no
      • Resolved for a whole dimension (cannot be specified on a Biome).
      • Replaces Dimension Type ultrawarm field.
  • minecraft:gameplay/increased_fire_burnout
    • Controls whether fire blocks burn out more rapidly than normal.
      • Value type: boolean
      • Default value: false
      • Modifiers: Boolean Modifiers
      • Interpolated: no
      • Resolved at the position of the burning Fire block.
      • Replaces #increased_fire_burnout Biome Tag.
  • minecraft:gameplay/piglins_zombify
    • Controls whether piglins and hoglins should zombify.
      • Value type: boolean
      • Default value: true
      • Modifiers: Boolean Modifiers
      • Interpolated: no
      • Resolved at the position of the zombifying entity.
      • Replaces Dimension Type piglin_safe field.
  • minecraft:gameplay/snow_golem_melts
    • Controls whether a snow golem should be damaged.
      • Value type: boolean
      • Default value: false
      • Modifiers: Boolean Modifiers
      • Interpolated: no
      • Resolved at the position of the snow golem.
      • Replaces #snow_golem_melts Biome Tag.