Config Reference

`Field`

Field spacing, active-window limits, pinned badge styling, close restore, and zoom settings.

Defaults

Defaults shown here are the effective builtin defaults from RuntimeTuning::builtin_defaults().

Default Config Shape

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

field:
  gap 20.0
  active-windows-allowed 5
  pan-to-new "if-needed"
  close-restore-focus true
  close-restore-pan "if-offscreen"

  pins:
    corner "top-right"
    colour "auto"
    background-colour "auto"
    size 1.0
  end

  zoom:
    enabled true
    step 1.10
    min 0.35
    max 1.35
    smooth true
    smooth-rate 12.5
  end
end

`field`

Camera, spacing, active-window, and field zoom settings.

Option	Type	Default	Notes
`gap`	f32	`20.0`	Gap between windows and layout elements in the field.
`active-windows-allowed`	usize	`5`	Maximum number of non-node active windows before decay becomes more aggressive.
`pins`	nested block	`see field.pins`	Pinned object badge styling and position.
`pan-to-new`	string	`if-needed`	Controls how strongly the camera pans to newly opened windows. Accepted values: never, if-needed, always.
`close-restore-focus`	bool	`true`	Restores focus when a window closes.
`close-restore-pan`	string	`if-offscreen`	Controls camera pan restoration after close. Accepted values: never, if-offscreen, always.
`zoom`	nested block	`see field.zoom`	Field zoom settings.

`field.pins`

Pinned object badge position, color, background, and scale.

Option	Type	Default	Notes
`corner`	string	`top-right`	Pin badge corner. Accepted values: top-left, top-right.
`colour`	string	`auto`	Pin glyph color. Accepted values: auto, light, dark, or a hex color.
`background-colour`	string	`auto`	Circular badge background color. Accepted values: auto, light, dark, or a hex color.
`size`	f32	`1.0`	Scale for the circular pin badge and glyph.

`field.zoom`

Zoom controls, limits, and smoothing for the field camera.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables field zoom controls.
`step`	f32	`1.10`	Per-step zoom multiplier.
`min`	f32	`0.35`	Minimum zoom scale.
`max`	f32	`1.35`	Maximum zoom scale.
`smooth`	bool	`true`	Enables smooth zoom interpolation.
`smooth-rate`	f32	`12.5`	Rate used for smooth zooming.