Underwater "fog" color does not match water block color
Linked Issues
relates to5
Created Issue:
Underwater "fog" color does not match water block color
The ambient fog color underwater does not match the new colors of the water blocks themselves. The underwater fog is much brighter and more saturated compared to the color of the water blocks.
Environment
Windows 7 64-bit
Java 1.8.0_25
The ambient fog color underwater does not match the new colors of the water blocks themselves. The underwater fog is much brighter and more saturated compared to the color of the water blocks.
Windows 7 64-bit
Java 1.8.0_25
relates to
relates to
relates to
This weird color saturation can be confirmed for regular oceans, cold oceans, freezing oceans, and most land biomes.
This also relates to MC-127061 (though I think it might be forward resolved to this due to both reports pointing out that water colors are mismatched in certain biomes)
Relates to
MC-129794as it too relates to legacy water colours not changing.
The bug
A multitude of cold biomes are configured to tint water a deeper blue than normal. However, this only applies to some biomes - others (notably including the cold mountain biomes added in 1.18) just use the default water color instead, which is wrong.
Table of biome colors
This table details what biomes use what approximate colors. Also refer to the screenshots attached to this ticket.
| Biome | Color used | Notes |
|---|---|---|
| minecraft:plains | Included here for reference | |
| minecraft:ocean | Included here for reference | |
| minecraft:deep_ocean | Included here for reference | |
| minecraft:river | Included here for reference | |
| minecraft:cold_ocean | ||
| minecraft:deep_cold_ocean | ||
| minecraft:frozen_ocean | ||
| minecraft:deep_frozen_ocean | ||
| minecraft:frozen_river | ||
| minecraft:snowy_plains | ||
| minecraft:ice_spikes | ||
| minecraft:snowy_taiga | ||
| minecraft:snowy_beach | ||
| minecraft:snowy_slopes | ||
| minecraft:frozen_peaks | ||
| minecraft:jagged_peaks | ||
| minecraft:grove |
Expected results
The biomes marked
in the above table would use water colors which are bluer than default.
Actual results
Said biomes just reuse the default water coloring, causing inconsistencies.
How to fix
There are several ways in which this could be fixed. I have listed three different methods below, starting with the most basic and ending with the most preferable.
Quick and dirty
The first, and worst, approach would be to simply changing the
marked biomes to use a slightly bluer water color instead of having them just use the default color water uses. This way they'd line up with other cold biomes.
Bedrock Edition parity
A better idea than this, though, would be to port the water colors from Bedrock Edition, which are defined for a much more diverse set of biomes than is currently the case on Java Edition. With 1.18 making major changes to biomes and aiming for seed parity, not only would this be another step towards parity, but could also fix other biome color bugs such as MC-130445 and MC-194412. A list can be found here: https://minecraft.wiki/w/Block_colors#Water_colors_2
- Click on the wiki link above
- Modify each biome's json file to set their respective water colors to the respective values in the above Bedrock Edition table (which should include the biomes considered inconsistent here)
Revive watercolor.png (Preferable fix - future-proof)
The final proposed fix requires code changes, but would prevent any future cases similar to this bug from happening, as only a small subset of biomes would require an explicit override for the biome color. All of the problem biomes mentioned within this ticket would be fixed automatically, due to not belonging to this subset.
This would specifically involve the use an an unused, since-removed water colormap file that existed in versions from Beta 1.6 Test Build 3 and was removed in 1.6 (13w24a) due to ultimately being unused at the time. Originally intended for use on biome-specific water colors (like was done for grass and leaves at the time), the snippet of code that referenced it also went unused.
This file could be reimplemented into modern versions to handle water colors for most biomes (with swamps and mangrove swamps being the only exceptions that would need an explicit definition, as well as possibly nether and end biomes if parity is also desired). As such, manually-specified water color values could be removed from all other biomes, as this colormap file would fill in for them instead.
- Obtain the file from any version that has it (such as 1.5.2) - it can be found as [jar]/misc/watercolor.png
- Place this file into the current version and rename it: [jar]/assets/minecraft/textures/colormap/water.png
- Remove the explicitly defined water colors from all biome json files, excluding minecraft:swamp, minecraft:mangrove_swamp and possibly minecraft:meadow
- Change the code that handles biome colors such that if no color is defined for water, it instead refers to colormap/water.png and picks a color depending on the temperature and humidity values (which is how grass and foliage are handled currently)
- (optional but recommended) Also define colors for all Nether and End biomes to be what they're defined as in Bedrock Edition, for the sake of parity, since the colormap's definitions for those might not look as good
- (also optional) The minecraft:mushroom_fields biome color could also be ported over from Bedrock Edition and explicitly defined instead of using the color map
- Rejoice in the fact that oversights like this will never crop up again in future

The water colours not working is most probably caused by a bug:
MC-130430. The water fog colours ares still working, thus the discrepancy between the two.Otherwise water / fog / biome colours see
MC-128455Seems to affect 1.13-pre6
Affects 1.13-pre7
Still affecting the full release of 1.13
Still in 1.16rc1
In 1.16.4 and 20w46a
Blocked by
MC-218597