Uploaded image for project: 'Minecraft: Java Edition'
  1. Minecraft: Java Edition
  2. MC-241005

water_overlay.png is not an intuitive texture name

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Invalid
    • None
    • 1.17.1, 21w44a
    • Community Consensus
    • (Unassigned)

      Discovered while reading the comments on MC-128337.

      The bug

      Water has a separate texture file which is used when water borders certain transparent and translucent blocks (a fix for MC-35790). This file is called "water_overlay.png", which is a rather confusing name - its very easy to assume (as has been done several times before) that the "overlay" part of the name means that this texture is instead used to cover the screen when underwater, which it is not; a separate texture is used for this purpose instead.

      It is also inconsistent with other textures called "overlay", such as the grass block overlay texture, which is a texture overlaid on the sides of grass blocks for tinting, or the several leather armor overlays, which are used for regions which are not tinted. Unlike any of these cases, "water_overlay" does not appear to be overlaid on anything, but rather is a fundamental texture used by the water model in select cases.

      How to reproduce

      Easy - just compare the two files after extracting the jar.

      The following steps can be used to prove what each texture is used for, and that they have distinct uses:

      1. Download and apply the attached "water distinguisher" resource pack
      2. Dive underwater
        1. Note how the underwater overlay texture looks
      3. Now place glass next to water and note how the sides of the water look through the glass
        1. Note how the texture used here is different from the underwater overlay texture

      Expected results

      As from my testing it does not at all appear to be an overlay, that "water_overlay.png" would be named something less confusing, such as "water_behind_glass.png" or "water_still_side.png".

      Actual results

      The confusing name detailed here.

        1. 2021-11-08_22.59.35.png
          2021-11-08_22.59.35.png
          257 kB
        2. 2021-11-08_23.00.12.png
          2021-11-08_23.00.12.png
          240 kB
        3. 2021-11-08_23.01.21.png
          2021-11-08_23.01.21.png
          164 kB
        4. 2021-11-08_23.01.59.png
          2021-11-08_23.01.59.png
          427 kB
        5. water-distinguisher-21w44a-v1.0.zip
          2 kB

            Unassigned Unassigned
            Awesoman3000 Connor Steppie
            Votes:
            1 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved:
              CHK: