Skip to content

Biome and Dimension Uniforms

These uniforms store information about the current biome and dimension.

biome Optifine Custom Uniforms / Iris

uniform int biome;

This uniform identifies the biome currently occupied by the player. It’s value can be compared with the same predefined constants as custom uniforms using biome, for example: BIOME_PLAINS, BIOME_RIVER, BIOME_DESERT, BIOME_SWAMP, etc. For more information on biomes, see the Minecraft Wiki.

This uniform functions similarly to the value available for custom unfiroms in Optifine, however Iris additionally provides them as standard uniforms.

In Optifine, this value is only available to custom uniforms, in Iris it is also accessible as a normal uniform.


biome_category Optifine Custom Uniforms / Iris

uniform int biome_category;

This uniform identifies the biome category currently occupied by the player. It’s value can be compared with the same predefined constants as custom uniforms, the following are recognized:

CAT_NONE, CAT_TAIGA, CAT_EXTREME_HILLS, CAT_JUNGLE, CAT_MESA, CAT_PLAINS, CAT_SAVANNA, CAT_ICY, CAT_THE_END, CAT_BEACH, CAT_FOREST, CAT_OCEAN, CAT_DESERT, CAT_RIVER, CAT_SWAMP, CAT_MUSHROOM, CAT_NETHER

For more information on biomes, see the Minecraft Wiki.

This uniform functions similarly to the value available for custom unfiroms in Optifine, however Iris additionally provides them as standard uniforms.

In Optifine, this value is only available to custom uniforms, in Iris it is also accessible as a normal uniform.


biome_precipitation Optifine Custom Uniforms / Iris

uniform int biome_precipitation;

This uniform identifies what type of precipitation occurs in this biome: 0 is no precipitation, 1 is rain, 2 is snow. The following defines can also be used: PPT_NONE, PPT_RAIN, PPT_SNOW. For more information on biomes, see the Minecraft Wiki.

This uniform functions similarly to the value available for custom unfiroms in Optifine, however Iris additionally provides them as standard uniforms.

In Optifine, this value is only available to custom uniforms, in Iris it is also accessible as a normal uniform.


rainfall Optifine Custom Uniforms / Iris

uniform float rainfall;

This value stores the rainfall property of the current biome as defined by Minecraft internally, and ranges from 0 to 1. This value does not depend on the current weather, but is a property of the biome. For more information on biomes, see the Minecraft Wiki.

In Optifine, this value is only available to custom uniforms, in Iris it is also accessible as a normal uniform.


temperature Optifine Custom Uniforms / Iris

uniform float temperature;

This value stores the temperature property of the current biome as defined by Minecraft internally. In vanilla Minecraft this will range in value from -0.7 to 2.0, however mods may have values outside that range. For more information on biomes, see the Minecraft Wiki.

In Optifine, this value is only available to custom uniforms, in Iris it is also accessible as a normal uniform.


ambientLight Iris Exclusive

uniform float ambientLight;

This value stores the ambient light property of the current dimension. This roughly correlates to how much sky lighting affects lighting values. More information can be found in the Minecraft Wiki under “ambient_light”.


bedrockLevel Iris Exclusive

uniform int bedrockLevel;

This value stores the height (y coordinate) of the bedrock floor in the current dimension. More information can be found in the Minecraft Wiki under “min_y”.


cloudHeight Iris Exclusive

uniform float cloudHeight;

This uniform stores the height (y coordinate) of vanilla clouds in blocks based on the current user settings. Value is NaN for dimensions without clouds.


hasCeiling Iris Exclusive

uniform bool hasCeiling;

This value is true if the current dimension has a ceiling acording to its dimension properties, and false otherwise. More information can be found in the Minecraft Wiki under “has_ceiling”.


hasSkylight Iris Exclusive

uniform bool hasSkylight;

This value is true if the current dimension has a sky and sky lighting, and false otherwise. More information can be found in the Minecraft Wiki under “has_skylight.


heightLimit Iris Exclusive

uniform int heightLimit;

This value stores the difference in height (y coordinate) between the lowest block and the highest block that can be placed in the current dimension. More information can be found in the Minecraft Wiki under “height”.


logicalHeightLimit Iris Exclusive

uniform int logicalHeightLimit;

This value stores the logical height of the current dimension, which refers to the maximum height to which chorus fruits can grow and that nether portals can bring players within the dimension. More information can be found in the Minecraft Wiki under “logical_height”.