Config Visuals

[plane]: client

This section covers the murk's visible surface. It is client-side, so a server can't override it.

Option	Default	Range	Description
renderPlane	true		Draws the separation plane.
planeColor	0xFF406440	ARGB	Plane colour. Alpha is ignored because the plane is always opaque.
foamColor	0xFF70947A	ARGB	Foam colour. Alpha sets how strongly the foam shows.
foamWidth	2.25	0 – 8	How far foam reaches from edges. 0 turns foam off.
foamReach	1.0	0 – 4	How far above or below the plane something still raises foam. Below about 0.65, foam won't reach the block row underneath.
planeSoftOcclusion	true		Soft edges against blocks, mobs and ships, plus a clear disc around anything crossing the boundary. Turn this off first if the murk looks wrong with shaders or other render mods.
murkDarkness	0.35	0 – 1	How much darker things under the boundary are drawn.
waterlineCellsPerBlock	4	1 – 4	Foam grid resolution. Halving it quarters the foam cost.

[plane.dither]

The plane dissolves into a pixel dither near the camera. Under an Iris shader pack, the whole murk is drawn this way.

Option	Default	Range	Description
planeNearDither	true		Dither the plane near the camera.
nearDitherStart	0.5	0 – 32	Inside this distance, the plane is at its thinnest.
nearDitherEnd	4.0	0 – 64	Beyond this distance, the plane is solid.
nearDitherMinVisibility	0.25	0 – 1	How much of the plane is left at the camera.
ditherPixelSize	2	1 – 8	Screen pixels per dither cell.

[plane.vapor]

Mist sheets over the surface keep the plane from looking flat.

Option	Default	Range	Description
vaporColorOffsetRed	0.45	-1 – 1	Red offset from the plane colour.
vaporColorOffsetGreen	0.50	-1 – 1	Green offset.
vaporColorOffsetBlue	0.55	-1 – 1	Blue offset. The defaults give an icy white-blue.
vaporStrength	0.95	0 – 1	Mist opacity.
vaporSheets	5	0 – 8	Number of sheets. 0 turns the mist off entirely.
vaporUndulation	1.5	0 – 16	Maximum rise of the sheets, in blocks.
vaporUnderside	false		Mirrors the mist under the plane too.
vaporUnderwater	true		Draws an extra copy before water so lakes cover the mist. Off halves the cost.

[plane.motes]

Specks drift in the murk around the camera.

Option	Default	Range	Description
motesPerTick	6	0 – 64	Specks spawned per tick. 0 turns them off.
motesRange	12.0	1 – 64	Spawn radius, capped at fogDistance.
motesDrift	0.01	0 – 0.5	Drift speed, in blocks per tick.

Performance tips

To make the murk cheaper to render:

• Lower vaporSheets, or set it to 0.
• Set vaporUnderwater = false.
• Set waterlineCellsPerBlock = 2.
• Set planeSoftOcclusion = false.