Minecraft:Fog definition: Difference between revisions

Latest revision as of 11:07, 26 May 2026

Minecraft:Fog settings are stored as JSON files in a resource pack in the Template:File directory. Multiple fog settings can be created and each Minecraft:biome can be assigned a fog setting in the client biome JSON files. Fog settings can also be applied with the Template:Cmd command, which will override the biome fog settings.

All fog settings are optional, if not specified they will equal to lower settings in the fog stack, first data default values and then hardcoded values. Default fog settings can be specified in the biomes_client.json file which will overwrite all fog settings that are not specified in the resource pack.

Template:INUpcoming, configurations for volumetric fog can be key framed to change effects with the Minecraft:daylight cycle. Instead of specifying one float or color, they are objects containing keys and the values. The key can be 0-1, corresponding to the daylight cycle (1 is noon). Values are linearly interpolated between keys.

JSON format

Template:Nbt The root tag
- Template:Nbt: The 3-part schema version used in the file, usually 1.16.110 or 1.21.90.
- Template:Nbt
  - Template:Nbt
    - Template:Nbt: The identifier for these settings, which can be specified in the Template:File files. Must include a namespace. For a full list of vanilla identifiers that are applied to biomes, see Template:Slink.
  - Template:Nbt: The regular fog settings that are always visible.
    - Template:Nbt: Fog settings while the camera is inside Minecraft:air.
      - Template:Nbt: The distance where fog will begin to appear.
      - Template:Nbt: The distance where fog becomes opaque.
      - Template:Nbt: The type of measuring used for fog distances. When set to render, the above values are measured in decimals as a percentage of the current render distance. When set to fixed, the above values are measured in blocks and the fog distance does not change with the render distance.
      - Template:Nbt Template:Nbt: The color of the fog, supports RGB array or HEX string. Overridden by Minecraft:atmospherics with Vibrant Visuals for air and weather fog.
    - Template:Nbt: Fog settings while the camera is inside Minecraft:lava.
    - Template:Nbt: Fog settings while the camera is inside lava under the Minecraft:Fire Resistance effect.
    - Template:Nbt: Fog settings while the camera is inside Minecraft:water.
      - Template:Nbt: Settings for the transition between fogs when the camera has just entered water.
        Template:Nbt: Fog settings for the initial fog applied when the camera has just entered water.
        
        Template:Nbt: The minimum progress of fog transition.
        
        Template:Nbt: The time it takes to reach the mid_percent of fog transition in seconds.
        
        Template:Nbt: The progress of fog transition after the specified seconds.
        
        Template:Nbt: Total amount of time it takes to complete transition in seconds, when the transition fog completely disappears.
    - Template:Nbt: Fog settings while the camera is inside air during Minecraft:precipitation.
  - Template:Nbt:Template:Fn Volumetric fog settings exclusive to Minecraft:Vibrant Visuals and Minecraft:ray tracing.
    - Template:Nbt
      - Template:Nbt: Volumetric fog settings while the camera is inside Minecraft:air.
        Template:Nbt: The multiplier on how much fog disrupts the light, between 0.0 (no fog) and 1.0 (opaque). Can be key framed in 26.30.Template:Upcoming
        
        Template:Nbt: Whether fog density is distributed evenly across all heights.
        
        Template:Nbt: The height in blocks that fog will begin to appear, when uniform is false. Can be key framed in 26.30.Template:Upcoming
        
        Template:Nbt: The height in blocks that fog reaches its maximum density value, when uniform is false. Can be key framed in 26.30.Template:Upcoming
      - Template:Nbt: Volumetric fog settings while the camera is inside Minecraft:lava.
      - Template:Nbt: Volumetric fog settings while the camera is inside lava under the Minecraft:Fire Resistance effect.
      - Template:Nbt: Volumetric fog settings while the camera is inside Minecraft:water.
      - Template:Nbt: Volumetric fog settings while the camera is inside air during Minecraft:precipitation.
    - Template:Nbt
      - Template:Nbt: Fog effects applied to light when it passes through Minecraft:air.
        Template:Nbt Template:Nbt: How much of each RGB color of the light is spread by the fog; supports RGB array or HEX string. Can be key framed in 26.30.Template:Upcoming
        
        Template:Nbt Template:Nbt: How much of each RGB color of the light is absorbed by the fog; supports RGB array or HEX string. Can be key framed in 26.30.Template:Upcoming
      - Template:Nbt: Fog effects applied to light when it passes through Minecraft:clouds.
      - Template:Nbt: Fog effects applied to light when it passes through Minecraft:water.
    - Template:Nbt: Exclusive to Minecraft:Vibrant Visuals, requires format version 1.21.90.
      - Template:Nbt
        Template:Nbt: Controls the distribution of scattered light in air, between -1.0 and 1.0, defaults to 0.75. Positive values result in forward-scattering while negative values result in backward-scattering. Can be key framed in 26.30.Template:Upcoming
      - Template:Nbt
        Template:Nbt: Controls the distribution of scattered light in water, between -1.0 and 1.0, defaults to 0.6. Positive values result in forward-scattering while negative values result in backward-scattering. Can be key framed in 26.30.Template:Upcoming

Template:Fnlist

History

Template:HistoryTable

External links

Navigation

Template:Navbox resource packs Template:Navbox Bedrock Edition

@@ Line 4: / Line 4: @@
 All fog settings are optional, if not specified they will equal to lower settings in the fog stack, first data default values and then hardcoded values. Default fog settings can be specified in the <code>biomes_client.json</code> file which will overwrite all fog settings that are not specified in the resource pack.
+{{INUpcoming|be 26.30}}, configurations for volumetric fog can be [[Minecraft:Vibrant Visuals#Atmospherics|key framed]] to change effects with the [[Minecraft:daylight cycle]]. Instead of specifying one float or color, they are objects containing keys and the values. The key can be 0-1, corresponding to the daylight cycle (1 is noon). Values are linearly interpolated between keys.
 == JSON format ==
@@ Line 17: / Line 19: @@
 ***** {{nbt|float|fog_end}}: The distance where fog becomes opaque.
 ***** {{nbt|string|render_distance_type}}: The type of measuring used for fog distances. When set to <code>render</code>, the above values are measured in decimals as a percentage of the current render distance. When set to <code>fixed</code>, the above values are measured in blocks and the fog distance does not change with the render distance.
-***** {{nbt|int array}}{{nbt|string|fog_color}}: The color of the fog, supports RGB array or HEX string.
+***** {{nbt|int array}}{{nbt|string|fog_color}}: The color of the fog, supports RGB array or HEX string. Overridden by [[Minecraft:atmospherics]] with Vibrant Visuals for air and weather fog.
 **** {{nbt|compound|lava}}: Fog settings while the camera is inside [[Minecraft:lava]].
 **** {{nbt|compound|lava_resistance}}: Fog settings while the camera is inside lava under the [[Minecraft:Fire Resistance]] effect.
@@ Line 31: / Line 33: @@
 **** {{nbt|compound|density}}
 ***** {{nbt|compound|air}}: Volumetric fog settings while the camera is inside [[Minecraft:air]].
-****** {{nbt|float|max_density}}: The multiplier on how much fog disrupts the light, between 0.0 (no fog) and 1.0 (opaque).
+****** {{nbt|float|max_density}}: The multiplier on how much fog disrupts the light, between 0.0 (no fog) and 1.0 (opaque). Can be key framed in 26.30.{{upcoming}}
 ****** {{nbt|bool|uniform}}: Whether fog density is distributed evenly across all heights.
-****** {{nbt|float|zero_density_height}}: The height in blocks that fog will begin to appear, when <code>uniform</code> is false.
+****** {{nbt|float|zero_density_height}}: The height in blocks that fog will begin to appear, when <code>uniform</code> is false. Can be key framed in 26.30.{{upcoming}}
-****** {{nbt|float|max_density_height}}: The height in blocks that fog reaches its maximum density value, when <code>uniform</code> is false.
+****** {{nbt|float|max_density_height}}: The height in blocks that fog reaches its maximum density value, when <code>uniform</code> is false. Can be key framed in 26.30.{{upcoming}}
 ***** {{nbt|compound|lava}}: Volumetric fog settings while the camera is inside [[Minecraft:lava]].
 ***** {{nbt|compound|lava_resistance}}: Volumetric fog settings while the camera is inside lava under the [[Minecraft:Fire Resistance]] effect.
@@ Line 41: / Line 43: @@
 **** {{nbt|compound|media_coefficients}}
 ***** {{nbt|compound|air}}: Fog effects applied to light when it passes through [[Minecraft:air]].
-****** {{nbt|int array}}{{nbt|string|scattering}}: How much of each RGB color of the light is spread by the fog; supports RGB array or HEX string.
+****** {{nbt|int array}}{{nbt|string|scattering}}: How much of each RGB color of the light is spread by the fog; supports RGB array or HEX string. Can be key framed in 26.30.{{upcoming}}
-****** {{nbt|int array}}{{nbt|string|absorption}}: How much of each RGB color of the light is absorbed by the fog; supports RGB array or HEX string.
+****** {{nbt|int array}}{{nbt|string|absorption}}: How much of each RGB color of the light is absorbed by the fog; supports RGB array or HEX string. Can be key framed in 26.30.{{upcoming}}
 ***** {{nbt|compound|cloud}}: Fog effects applied to light when it passes through [[Minecraft:clouds]].
 ***** {{nbt|compound|water}}: Fog effects applied to light when it passes through [[Minecraft:water]].
 **** {{nbt|compound|henyey_greenstein_g}}: Exclusive to [[Minecraft:Vibrant Visuals]], requires format version <code>1.21.90</code>.
 ***** {{nbt|compound|air}}
-****** {{nbt|float|henyey_greenstein_g}}: Controls the distribution of scattered light in air, between -1.0 and 1.0, defaults to 0.75. Positive values result in forward-scattering while negative values result in backward-scattering.
+****** {{nbt|float|henyey_greenstein_g}}: Controls the distribution of scattered light in air, between -1.0 and 1.0, defaults to 0.75. Positive values result in forward-scattering while negative values result in backward-scattering. Can be key framed in 26.30.{{upcoming}}
 ***** {{nbt|compound|water}}
-****** {{nbt|float|henyey_greenstein_g}}: Controls the distribution of scattered light in water, between -1.0 and 1.0, defaults to 0.6. Positive values result in forward-scattering while negative values result in backward-scattering.
+****** {{nbt|float|henyey_greenstein_g}}: Controls the distribution of scattered light in water, between -1.0 and 1.0, defaults to 0.6. Positive values result in forward-scattering while negative values result in backward-scattering. Can be key framed in 26.30.{{upcoming}}
 </div>{{Fnlist}}
@@ Line 61: / Line 63: @@
 |{{HistoryLine||1.21.90|dev=Preview 1.21.90.20|Added [[Minecraft:Vibrant Visuals]] in stable releases outside of experiments, which allows usage of volumetric fog.}}
 |{{HistoryLine|||dev=Preview 1.21.90.26|Added <code>henyey_greenstein_g</code> settings to the fog json files, exclusive to [[Minecraft:Vibrant Visuals]].}}
+|{{HistoryLine|bedrock upcoming}}
+|{{HistoryLine||26.30|dev=Preview 26.30.25|Configurations for volumetric fog can now be key framed in order to let effects change with the daylight cycle, in the <code>1.21.20</code> schema.}}
 }}