3D Skin Layers Compatibility Modes for Iris, Sodium, and Fast Render

guide

3D Skin Layers renders player skin layers as 3D models, and its compatibility settings let you fix visual problems caused by other rendering mods. This guide covers the compatibility modes for Iris shaders and Sodium, plus the fast-render option, and explains when to turn each one on.

Compatibility Mode

Compatibility Mode is a general-purpose alternative rendering method for the skin layers. It exists to address conflicts with other mods that change how the game draws things. If the 3D layers look wrong or fail to appear correctly alongside another mod, enabling this setting may resolve it.

Treat it as a fallback rather than a default. Turn it on only when you actually see a problem, and turn it back off if it does not help or introduces new issues.

Iris Compatibility Mode

Iris Compatibility Mode is a separate, more specific alternative rendering path. Its purpose is to fix strange shadows and incorrect colors that appear on the 3D skin layers when Iris shaders are active.

Two important caveats come with this setting:

Enable it only when you need it. It is not meant to stay on permanently.
It will break the corner connections of the 3D layers. In other words, the way the layer geometry joins at corners will no longer look correct.

If you use Iris shaders and notice odd shading or discoloration on the layers, switch this on. If your layers already look right with shaders, leave it off.

Sodium Workaround

Sodium has, in some versions, flipped the sides of cubes. When that happens, the sides of the 3D skin layers can go missing. There is a dedicated workaround setting for exactly this situation.

Enable it only if both conditions are true:

You are running Sodium.
You can see visual problems where the sides of the skin layers are absent.

Do not enable it otherwise, since it exists purely to counteract that specific flipped-cube behavior.

Fast Render

Fast Render draws the 3D models as quickly as possible. The trade-off is graphical glitches related to transparency. If you value performance over perfect transparency rendering, turn it on; if transparent parts of the layers look wrong and that bothers you, leave it off.

The same settings screen, 3D Skin Layer Settings, controls what gets rendered in 3D and how detailed it is. These are useful context for judging whether a compatibility issue is really a compatibility issue:

Each body layer has its own toggle: hat, jacket, left sleeve, right sleeve, left pants, and right pants. Each one renders that layer as a 3D model.
Player heads can be rendered as 3D models both as a block and as an item.
Level Of Detail Distance sets how far away a model switches to a lower level of detail, which is the vanilla 2D form.
Voxel size settings control the granularity of the 3D geometry for players overall, the head, the body height, the torso width, player heads, and the hand in first person. The body height and torso width values exist to prevent clipping into the head or arms.

If a layer looks broken, first confirm the relevant layer toggle is on and the voxel sizes are sensible. Only then reach for a compatibility mode.

Quick Reference

Weird shadows or colors with Iris shaders: enable Iris Compatibility Mode, accept broken corner connections, and disable it when not needed.
Missing layer sides while using Sodium: enable the Sodium workaround.
General conflicts with other mods: try Compatibility Mode.
Transparency glitches acceptable in exchange for speed: enable Fast Render.

All of these are toggles in the mod's settings interface. Open that interface using the corresponding hotkey (set it in the controls menu), then adjust the options described above.