Config Reference

`Effects`

Backdrop quality for compositor overlays and renderer-level shadow layers.

Defaults

Defaults shown here are the effective built-in defaults for the selected wiki version.

Default Config Shape

Use this as the section shape when editing halley.rune.

effects:
  blur:
    overlays true
    method "dual-kawase"
    radius 24
    passes 3
    saturation 1.10
    noise 0.012
  end
  shadows:
    window:
      enabled true
      blur-radius 8
      offset-y 5
      colour "#05030530"
    end
  end
end

`effects`

Renderer effect groups.

Option	Type	Default	Notes
`blur`	nested block	`see effects.blur`	Backdrop blur quality. Client activation belongs in rules.
`shadows`	nested block	`see effects.shadows`	Window, node, and overlay shadows.

`effects.blur`

Dual Kawase blur used by opted-in compositor overlays and rules.

Option	Type	Default	Notes
`overlays`	bool	`true`	Allows compositor-owned overlays to use blur.
`method`	string	`dual-kawase`	The supported blur method.
`radius`	u32	`24`	Backdrop blur radius.
`passes`	u32	`3`	Downsample/upsample pass count.
`saturation`	f32	`1.10`	Backdrop saturation multiplier.
`noise`	f32	`0.012`	Frosted-glass noise amount.

`effects.shadows.window`

Shadow beneath managed windows.

Option	Type	Default	Notes
`enabled \| blur-radius \| spread \| offset-x \| offset-y \| colour`	shadow fields	`true \| 8 \| 0 \| 0 \| 5 \| #05030530`	Window shadow switch, geometry, and RGBA color.

`effects.shadows.node`

Shadow beneath nodes and cluster cores.

Option	Type	Default	Notes
`enabled \| blur-radius \| spread \| offset-x \| offset-y \| colour`	shadow fields	`true \| 14 \| 0 \| 0 \| 3 \| #05030524`	Node shadow switch, geometry, and RGBA color.

`effects.shadows.overlay`

Shadow beneath overlay containers.

Option	Type	Default	Notes
`enabled \| blur-radius \| spread \| offset-x \| offset-y \| colour`	shadow fields	`true \| 24 \| 1 \| 0 \| 7 \| #05030538`	Overlay shadow switch, geometry, and RGBA color.