Features / Options
This page lists shaders.properties directives related to display/HUD options, disabling features of the sky/clouds, and controlling legacy lighting options.
clouds
Sets the clouds option, equivalent to the options in “Video Settings” however this setting overrides the user controlled setting if set.
moon
Enables or disables rendering of the moon texture in gbuffers_skytextured
.
sun
Enables or disables rendering of the sun texture in gbuffers_skytextured
.
sky Iris Exclusive
Enables or disables rendering of the vanilla sky in gbuffers_skybasic
. This includes the sky disc, horizon, and void, however it does not include stars
stars Iris Exclusive
Enables or disables rendering of the vanilla star geometry in gbuffers_skybasic
.
underwaterOverlay
Enables or disables the water texture overlay when the player is underwater.
vignette
Enables or disables rendering of the vignette overlay, an effect which darkens the edge of the screen slightly.
oldHandLight
Sets a fallback for older shaders which don’t support main and alt hands. If oldHandLight
is set to true
, heldBlockLightValue
will take the value of the highest light value. The default value is true
due to legacy support.
oldLighting
Enables the “old lighting”, which applies a lighting multiplier in the color attribute based on the block’s orientation (this is the same as vanilla). This value is set to false
by default, as most shaders use their own lighting.
separateAo
Normally a vanilla AO (ambient occlusion) value is stored in the rgb components of the color vertex attribute. Enabling separateAo
moves this into the alpha channel of the color attribute. separateAo
is disabled by default.
supportsColorCorrection Iris Exclusive
Iris 1.6.4 added support for additional color spaces beyond sRGB (DCI_P3, Display P3, REC2020, and Adobe RGB). This does not allow for outputting HDR values, it simply applies a tonemapping operation in the given color space instead of sRGB.
By default, Iris will assume all shaders output sRGB, and if a different color spaces is selected it will convert the sRGB output to that color space for display. If supportsColorCorrection = true
is in shaders.properties however, this conversion will be left up to the shader. In all scenarios, the chosen colorspace is avaliable through the uniform currentColorSpace
.
weather Iris Exclusive
Enables or disables weather (rain & snow) geometry and rain splash particles. Both components are true
by default.
This directive requires an Iris version supporting CAN_DISABLE_WEATHER
, and is recommended to be used with that feature flag specified.