Minecraft:Fog definition: Difference between revisions
More actions
Fix template calls: add MC/ prefix |
Sync: updated from Minecraft |
||
| (One intermediate revision by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{ | {{Exclusive|bedrock}} | ||
Fog settings are stored as JSON files in a resource pack in the {{File|directory|fogs|inline=1}} 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 {{ | [[Minecraft:Fog]] settings are stored as JSON files in a resource pack in the {{File|directory|fogs|inline=1}} directory. Multiple fog settings can be created and each [[Minecraft:biome]] can be assigned a fog setting in the [[Minecraft:Resource pack#Biomes|client biome JSON files]]. Fog settings can also be applied with the {{cmd|fog}} 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 <code>biomes_client.json</code> file which will overwrite all fog settings that are not specified in the resource pack. | 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 == | == JSON format == | ||
<div class="treeview"> | <div class="treeview"> | ||
* {{ | * {{nbt|compound}} The root tag | ||
** {{ | ** {{nbt|string|format_version}}: The 3-part schema version used in the file, usually <code>1.16.110</code> or <code>1.21.90</code>. | ||
** {{ | ** {{nbt|compound|minecraft:fog_settings}} | ||
*** {{ | *** {{nbt|compound|description}} | ||
**** {{ | **** {{nbt|string|identifier}}: The identifier for these settings, which can be specified in the {{File|file|''biome''.client_biome.json|inline=1}} files. Must include a namespace. For a full list of vanilla identifiers that are applied to biomes, see {{Slink|Fog|Vanilla fog settings}}. | ||
*** {{ | *** {{nbt|compound|distance}}: The regular fog settings that are always visible. | ||
**** {{ | **** {{nbt|compound|air}}: Fog settings while the camera is inside [[Minecraft:air]]. | ||
***** {{ | ***** {{nbt|float|fog_start}}: The distance where fog will begin to appear. | ||
***** {{ | ***** {{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. 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. | ||
**** {{ | **** {{nbt|compound|water}}: Fog settings while the camera is inside [[Minecraft:water]]. | ||
***** {{ | ***** {{nbt|compound|transition_fog}}: Settings for the transition between fogs when the camera has just entered water. | ||
****** {{ | ****** {{nbt|compound|init_fog}}: Fog settings for the initial fog applied when the camera has just entered water. | ||
****** {{ | ****** {{nbt|float|min_percent}}: The minimum progress of fog transition. | ||
****** {{ | ****** {{nbt|float|mid_seconds}}: The time it takes to reach the <code>mid_percent</code> of fog transition in seconds. | ||
****** {{ | ****** {{nbt|float|mid_percent}}: The progress of fog transition after the specified seconds. | ||
****** {{ | ****** {{nbt|float|max_seconds}}: Total amount of time it takes to complete transition in seconds, when the transition fog completely disappears. | ||
**** {{ | **** {{nbt|compound|weather}}: Fog settings while the camera is inside air during [[Minecraft:precipitation]]. | ||
*** {{ | *** {{nbt|compound|volumetric}}:{{Fn|Only in resource packs with <code>"pbr"</code> capability|name=pbr}} Volumetric fog settings exclusive to [[Minecraft:Vibrant Visuals]] and [[Minecraft:ray tracing]]. | ||
**** {{ | **** {{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). 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. 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. 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. | ||
***** {{ | ***** {{nbt|compound|water}}: Volumetric fog settings while the camera is inside [[Minecraft:water]]. | ||
***** {{ | ***** {{nbt|compound|weather}}: Volumetric fog settings while the camera is inside air during [[Minecraft:precipitation]]. | ||
**** {{ | **** {{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. 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. 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. 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. Can be key framed in 26.30.{{upcoming}} | ||
</div>{{ | </div>{{Fnlist}} | ||
== History == | == History == | ||
{{HistoryTable | {{HistoryTable | ||
|{{ | |{{HistoryLine|bedrock}} | ||
|{{ | |{{HistoryLine||1.16.100|dev=beta 1.16.100.54|Separated fog settings from <code>[[Minecraft:Resource pack#Biomes|biomes_client.json]]</code> in favor of new fog definitions for each biome, with many more customization options.|Added volumetric fog options used for ray tracing.}} | ||
|{{ | |{{HistoryLine||1.16.200|exp=Caves and Cliffs|dev=beta 1.16.200.52|Added powder snow fog.}} | ||
|{{ | |{{HistoryLine||Preview 1.20.60.21|exp=Render Dragon Features for Creators|Added volumetric fog and light shafts to [[Minecraft:Deferred Technical Preview|deferred lighting]].}} | ||
|{{ | |{{HistoryLine||Preview 1.21.10.20|exp=Render Dragon Features for Creators|Volumetric fog density settings are now supported for [[Minecraft:weather]] when a format version of <code>1.21.0</code> or higher is specified.}} | ||
|{{ | |{{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.}} | |||
}} | }} | ||
| Line 69: | Line 73: | ||
== Navigation == | == Navigation == | ||
{{ | {{Navbox resource packs}} | ||
{{ | {{Navbox Bedrock Edition}} | ||
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.110or1.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 tofixed, the above values are measured in blocks and the fog distance does not change with the render distance. - Template:NbtTemplate: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_percentof 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: Settings for the transition between fogs when the camera has just entered water.
- Template:Nbt: Fog settings while the camera is inside air during Minecraft:precipitation.
- Template:Nbt: Fog settings while the camera is inside Minecraft:air.
- 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
uniformis false. Can be key framed in 26.30.Template:Upcoming - Template:Nbt: The height in blocks that fog reaches its maximum density value, when
uniformis 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: Volumetric fog settings while the camera is inside Minecraft:air.
- Template:Nbt
- Template:Nbt: Fog effects applied to light when it passes through Minecraft:air.
- Template:NbtTemplate: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:NbtTemplate: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: Fog effects applied to light when it passes through Minecraft:air.
- 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:Nbt
- Template:Nbt
- Template:Nbt
- Template:Nbt: The 3-part schema version used in the file, usually
History
External links
Template:Navbox resource packs Template:Navbox Bedrock Edition