linkEnvironment Attributes

Environment Attributes provide a data-driven way to control a variety of visual, audio, and gameplay systems. Each attribute controls a specific effect: for example, visual/sky_color controls the color of the sky, and gameplay/water_evaporates controls whether water can be placed at a given location.

Both biomes and dimension types can define environment attributes via the attributes block.

References: Biome definition, Dimension type

linkSources & Priority

Environment Attribute values can be provided by the following sources (low → high priority):

1. Dimensions - base values for the entire dimension
2. Biomes - override or modify per-biome

When a biome provides an attribute, it takes priority over the dimension value. For example, if the overworld dimension sets sky_color = green and the plains biome sets sky_color = red, a player in the plains biome will see a red sky.

linkModifiers

By default, an attribute value uses the override modifier, fully replacing any lower-priority value. However, you can apply a different modifier to combine with the preceding value instead.

attributes {
	// Simple override (default modifier)
	skyColor(0x78A7FF)

	// Explicit modifier - multiplies the preceding value
	fogEndDistance(0.85f, EnvironmentAttributeModifier.MULTIPLY)
}

When a modifier is set, the JSON expands to { "argument": ..., "modifier": "..." }.

linkBoolean Modifiers

Applicable to boolean attributes. Argument format: boolean.

linkFloat Modifiers

Applicable to float attributes. Argument format: float.

linkColor Modifiers

Applicable to color attributes. Argument format: RGB color (except ALPHA_BLEND which uses ARGB).

linkInterpolation

Some attributes support smooth interpolation between biomes. As a player moves between biomes, interpolated attributes will gradually transition based on biomes within an 8-block radius of the camera. Non-interpolated attributes use only the biome at the exact position.

linkAll Environment Attributes

All attributes are listed below in alphabetical order by their Minecraft ID.

linkaudio/ambient_sounds

Controls which ambient sounds are played around the camera: looping sounds, mood-based sounds, and additional random sounds.

Fields:

• loop - optional Sound Event, continually looped sound
• mood - optional object for mood sounds:
  • sound - Sound Event to play
  • tickDelay - ticks between mood sounds (default: 6000)
  • blockSearchExtent - radius for light level sampling (default: 8)
  • offset - distance offset for produced sounds (default: 2.0)
• additions - list of additional random sounds:
  • sound - Sound Event to play
  • tickChance - probability within a tick to play the sound

attributes {
	ambientSounds(loop = SoundEvents.Ambient.CAVE) {
		mood(sound = SoundEvents.Ambient.CAVE)
		addition(SoundEvents.Ambient.CAVE, 0.01f)
	}
}

linkaudio/background_music

Controls how and which background music is played.

Fields:

• default - optional music track with:
  • sound - Sound Event to play
  • minDelay - minimum delay in ticks between tracks
  • maxDelay - maximum delay in ticks between tracks
  • replaceCurrentMusic - optional boolean (default: false)
• creative - optional track, overrides default when in Creative Mode
• underwater - optional track, overrides default when underwater

attributes {
	backgroundMusic {
		default(
			sound = SoundEvents.Music.CREATIVE,
			minDelay = 100,
			maxDelay = 200,
			replaceCurrentMusic = true,
		)
	}
}

linkaudio/firefly_bush_sounds

Controls whether firefly bush sounds are played.

attributes {
	fireflyBushSounds(true)
}

linkaudio/music_volume

The volume at which music should play. Any music playing will fade over time to this value.

attributes {
	musicVolume(0.8f)
}

linkgameplay/bed_rule

Controls whether a Bed can be used to sleep, set a respawn point, or whether it explodes.

Fields:

• canSleep - one of ALWAYS, WHEN_DARK, NEVER
• canSetSpawn - one of ALWAYS, WHEN_DARK, NEVER
• explodes - optional boolean, if true the Bed explodes when interacted with (default: false)
• errorMessage - optional Text Component shown when unable to sleep

attributes {
	bedRule(
		canSleep = BedSleepRule.ALWAYS,
		canSetSpawn = BedSleepRule.WHEN_DARK,
		explodes = false,
		errorMessage = textComponent("Cannot sleep here"),
	)
}

linkgameplay/baby_villager_activity

Controls the activity of baby villagers.

attributes {
	babyVillagerActivity(Activities.PLAY, EnvironmentAttributeModifier.OVERRIDE)
}

linkgameplay/bees_stay_in_hive

Controls whether bees stay in their hive.

attributes {
	beesStayInHive(true)
}

linkgameplay/can_pillager_patrol_spawn

Controls whether Pillager patrols can spawn. Replaces #without_patrol_spawns.

attributes {
	canPillagerPatrolSpawn(false)
}

linkgameplay/can_start_raid

If false, a Raid cannot be started by a player with Raid Omen.

attributes {
	canStartRaid(false)
}

linkgameplay/cat_waking_up_gift_chance

The chance for a cat to give a waking up gift. Interpolated.

attributes {
	catWakingUpGiftChance(0.5f)
}

linkgameplay/creaking_active

Controls whether the Creaking is active.

attributes {
	creakingActive(true)
}

linkgameplay/eyeblossom_open

Controls whether Eyeblossoms are open. Can be true, false, or "default".

attributes {
	eyeblossomOpen(EyeblossomOpenState.TRUE)

	// With a modifier
	eyeblossomOpen(EyeblossomOpenState.DEFAULT, EnvironmentAttributeModifier.OVERRIDE)
}

linkgameplay/fast_lava

Controls whether Lava should spread faster and further, as well as have a stronger pushing force on entities when flowing.

attributes {
	fastLava(true)
}

linkgameplay/increased_fire_burnout

Controls whether Fire blocks burn out more rapidly than normal.

attributes {
	increasedFireBurnout(true)
}

linkgameplay/monsters_burn

Controls whether monsters burn in sunlight.

attributes {
	monstersBurn(true)
}

linkgameplay/nether_portal_spawns_piglin

Controls whether Nether Portal blocks can spawn Piglins.

attributes {
	netherPortalSpawnsPiglin(true)
}

linkgameplay/piglins_zombify

Controls whether Piglins and Hoglins should zombify.

attributes {
	piglinsZombify(false)
}

linkgameplay/respawn_anchor_works

Controls whether Respawn Anchors can be used to set spawn. If false, the Respawn Anchor will explode once charged.

attributes {
	respawnAnchorWorks(true)
}

linkgameplay/snow_golem_melts

Controls whether a Snow Golem should be damaged.

attributes {
	snowGolemMelts(true)
}

linkgameplay/sky_light_level

The sky light level for the dimension.

attributes {
	skyLightLevel(15.0f)
}

linkgameplay/surface_slime_spawn_chance

The chance for surface slime to spawn. Interpolated.

attributes {
	surfaceSlimeSpawnChance(0.1f)
}

linkgameplay/turtle_egg_hatch_chance

The chance for turtle eggs to hatch. Interpolated.

attributes {
	turtleEggHatchChance(0.05f)
}

linkgameplay/villager_activity

Controls the activity of villagers.

attributes {
	villagerActivity(Activities.WORK, EnvironmentAttributeModifier.OVERRIDE)
}

linkgameplay/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.

attributes {
	waterEvaporates(true)

	// With a modifier
	waterEvaporates(true, EnvironmentAttributeModifier.OR)
}

linkvisual/ambient_particles

Controls ambient particles that randomly spawn around the camera.

Each entry has:

• options - a particle type (e.g. Particles.ASH)
• probability - float between 0 and 1, the chance to spawn in an empty space

attributes {
	ambientParticles(
		Particle(ParticleOptions(Particles.ASH), 0.01f),
	)
}

linkvisual/cloud_color

The color of clouds, expressed as an ARGB hex string.

attributes {
	cloudColor(ARGB(255, 128, 64, 32))
}

linkvisual/cloud_fog_end_distance

The distance in blocks from the camera at which cloud fog ends.

attributes {
	cloudFogEndDistance(256.0f)
}

linkvisual/cloud_height

The height at which all clouds appear.

attributes {
	cloudHeight(192.33f)
}

linkvisual/default_dripstone_particle

The default particle to be dripped from Dripstone blocks when no fluid is placed above.

attributes {
	defaultDripstoneParticle(Particles.DRIPPING_DRIPSTONE_WATER)
}

linkvisual/moon_angle

The angle of the moon in degrees. Interpolated.

attributes {
	moonAngle(45.0f)
}

linkvisual/moon_phase

Controls the moon phase.

attributes {
	moonPhase(Textures.Environment.Celestial.Moon.FULL_MOON, EnvironmentAttributeModifier.OVERRIDE)
}

linkvisual/fog_color

The color of fog when the camera is not submerged in another substance. The final value is also affected by the time of day, weather, and potion effects.

attributes {
	fogColor(rgb(255, 170, 0))

	// With a modifier
	fogColor(rgb(255, 255, 0), EnvironmentAttributeModifier.ADD)
}

linkvisual/fog_end_distance

The distance in blocks from the camera at which fog ends.

attributes {
	fogEndDistance(192.0f)
}

linkvisual/fog_start_distance

The distance in blocks from the camera at which fog starts.

attributes {
	fogStartDistance(0.0f)
}

linkvisual/sky_color

The color of the sky. This color is only visible for the overworld sky. The final value is also affected by the time of day and weather.

attributes {
	skyColor(Color.RED)
	// or
	skyColor(0x78A7FF)
}

linkvisual/sky_fog_end_distance

The distance in blocks from the camera at which sky fog ends.

attributes {
	skyFogEndDistance(320.0f)
}

linkvisual/water_fog_color

The color of fog when submerged in water. The final value is also affected by the time of day, weather, and potion effects.

attributes {
	waterFogColor(rgb(5, 5, 51))
}

linkvisual/water_fog_end_distance

The distance in blocks from the camera at which underwater fog ends.

attributes {
	waterFogEndDistance(96.0f)
}

linkvisual/water_fog_start_distance

The distance in blocks from the camera at which underwater fog starts.

attributes {
	waterFogStartDistance(0.0f)
}

linkBlend To Gray Modifier

The BlendToGray modifier is a special color modifier that blends the preceding color toward gray. Unlike other modifiers which are simple constants, BlendToGray is a data class with two parameters:

• brightness - controls the brightness of the gray target
• factor - controls the blending factor (0 = no change, 1 = fully gray)

attributes {
	fogColor(rgb(255, 170, 0), EnvironmentAttributeModifier.BlendToGray(brightness = 0.5f, factor = 0.8f))
}

This serializes to:

{
	"argument": 16755200,
	"modifier": {
		"type": "blend_to_gray",
		"brightness": 0.5,
		"factor": 0.8
	}
}

linkComplete Example

fun DataPack.createCustomDimensionWithAttributes() {
	val dimType = dimensionType("custom_type") {
		ambientLight = 0.1f
		hasCeiling = false
		hasSkylight = true
		height = 384
		logicalHeight = 384
		minY = -64
		natural = true

		attributes {
			// Gameplay
			canStartRaid(true)
			fastLava(false)
			waterEvaporates(false)
			piglinsZombify(true)
			respawnAnchorWorks(false)
			increasedFireBurnout(false)
			netherPortalSpawnsPiglin(false)
			snowGolemMelts(false)
			bedRule(
				canSleep = BedSleepRule.ALWAYS,
				canSetSpawn = BedSleepRule.ALWAYS,
			)

			// Visual
			cloudColor(ARGB(255, 255, 255, 255))
			cloudHeight(192.33f)
			fogStartDistance(0.0f)
			fogEndDistance(192.0f)
			skyFogEndDistance(320.0f)

			// Audio
			musicVolume(0.8f)
			backgroundMusic {
				default(
					sound = SoundEvents.Music.CREATIVE,
					minDelay = 100,
					maxDelay = 200,
				)
			}
		}
	}

	biome("custom_biome") {
		temperature = 0.8f
		downfall = 0.4f
		hasPrecipitation = true

		attributes {
			skyColor(0x78A7FF)
			fogColor(0xC0D8FF)
			waterFogColor(0x050533)
			waterFogEndDistance(96.0f)
			waterFogStartDistance(0.0f)
			ambientParticles(
				Particle(ParticleOptions(Particles.ASH), 0.01f),
			)
			ambientSounds(loop = SoundEvents.Ambient.CAVE) {
				mood(sound = SoundEvents.Ambient.CAVE)
				addition(SoundEvents.Ambient.CAVE, 0.01f)
			}
		}

		effects {
			waterColor = color(0x3F76E4)
		}
	}
}

linkSee Also

• Biomes - Biomes can define environment attributes to control per-biome visuals and audio
• Colors - RGB and ARGB color formats used by color attributes
• Dimensions - Dimension types can define base environment attributes for the entire dimension
• Timelines - Animate environment attributes over time using keyframes and easing functions
• World Generation - Overview of the worldgen system