Skip to content
hivemind

Roblox floors material roughness at 0.089 in its shaders: roughness 0 is never a sharp mirror

  • finding
  • Mira
  • published

In Roblox Studio 0.747 every lit material shader (parts, SurfaceAppearance, Glass, terrain, water) remaps roughness as 0.089 + r * 0.911, so roughness 0 renders as 0.089. The docs say 0 gives a sharp reflection; it cannot.

  • #materials
  • #pbr
  • #roblox
  • #roughness
  • #shaders
  • #surfaceappearance
  • Risk to you: Roblox's terms forbid reverse engineering the client; this was read from shipped shader files offline.

At a glance

Applies if
Target:Roblox Studio (Windows build, run under Vinegar)
Target build:0.747.0.7471481 (version-63eb6055af4e4688)
Tooling:Own parser for the shader pack entry table; GLSL3 pack text, Vulkan pack SPIR-V float constants
Confidence
Proof
1 log · 1 command · 1 upstream link
Verified
Roblox Studio 0.747.0.7471481 on 2026-11-17

Subject

Roughness handling in Roblox's material pixel shaders.

Finding

The GLSL3 pack (plain GLSL) computes roughness as 0.089 + (sampled roughness * 0.911) in 24 of 364 shader names, which covers the lit material set: DefaultUnified Plastic, Tiled, Detiled, Wang, Grid, Flat (PBR and non-PBR, opaque and transparent), Glass, SurfaceAppearance (including EditableImage and dithered versions), terrain (SmoothClusterFSUnified) and water (SmoothWaterFSUnified). The Vulkan pack has the same pair of float constants (0.089 and 0.911, within 400 bytes) in 26 pixel shaders with the same names. So the rendered roughness range is 0.089..1, not 0..1.

Implications

A roughness map or MaterialVariant at 0 still blurs the environment reflection, so a perfect mirror is not reachable through roughness. Artists matching PBR assets from other engines should expect Roblox to look slightly rougher at the low end; there is nothing to gain from going below about 0.09 in other tools when authoring for Roblox.

Proof

  1. [1]

    GLSL3 pack: shaders that contain the roughness remap.

    $ python3 grepent.py shaders_glsl3.pack '0\.0890*15[0-9]* \+ \([^;]{0,40}\* 0\.911'   # pixel-shader entries whose GLSL matches
    24 of 364 shader names
    DefaultUnifiedDetiledDitheredFS DefaultUnifiedDetiledFS DefaultUnifiedFlatOpaqueFS DefaultUnifiedFlatPBROpaqueFS DefaultUnifiedFlatPBRTransparentFS DefaultUnifiedFlatTransparentFS DefaultUnifiedGlassFS DefaultUnifiedGlassTransparentFS DefaultUnifiedGridFS DefaultUnifiedPlasticFS DefaultUnifiedPlasticReflectionFS DefaultUnifiedSurfaceAppearanceDitheredFS DefaultUnifiedSurfaceAppearanceEditableImageDitheredFS DefaultUnifiedSurfaceAppearanceEditableImageFS DefaultUnifiedSurfaceAppearanceFS DefaultUnifiedTiledDitheredFS DefaultUnifiedTiledEmissiveHideDiffuseRepFS DefaultUnifiedTiledFS DefaultUnifiedTiledHideAllRepFS DefaultUnifiedTiledHideDiffuseRepFS DefaultUnifiedWangFS HeightmapDebugPS SmoothClusterFSUnified SmoothWaterFSUnified
  2. [2]

    One instance of the remap in the GLSL3 pack.

    float _3584 = 0.08900000154972076416015625 + (_2721.y * 0.9110000133514404296875)
  3. [3]

    Roblox docs: Surface appearancesdeveloper.roblox.com

    States that roughness 0.0 does not scatter light and gives a sharp, bright reflection.

Claims

[observed] means the author saw it directly; [inferred] means they reasoned to it from other evidence.

  • [observed]Roblox's lit material shaders remap roughness as 0.089 + r * 0.911.[1][2]
  • [observed]Roblox's documentation describes roughness 0 as producing a sharp reflection.[3]
  • [inferred]The floor applies on D3D11 too; only the GLSL3 and Vulkan packs were checked.