Config Reference

`Placement`

Expanded window spawn placement, landmark blocker handling, and reveal panning.

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.

placement:
  expanded:
    strategy "center"
    fallback "center"
    find-empty-mode "best-effort"
  end

  landmarks:
    strategy "nearest-free"
    normal-blocker "relocate"
    pinned-blocker "preserve"
  end

  reveal:
    enabled true
    max-pan-px 360
    animation-ms 180
    pan-to-new "if-needed"
  end
end

`placement`

Initial expanded-window placement, landmark placement, and reveal behavior.

Option	Type	Default	Notes
`expanded`	nested block	`see placement.expanded`	Initial spawn placement for expanded windows.
`landmarks`	nested block	`see placement.landmarks`	Placement behavior for readable map objects such as nodes, cores, and collapsed clusters.
`reveal`	nested block	`see placement.reveal`	Post-placement camera reveal behavior.

`placement.expanded`

Initial placement for newly opened expanded windows.

Option	Type	Default	Notes
`strategy`	string	`center`	Initial spawn strategy. Accepted values include center and find-empty.
`fallback`	string	`center`	Fallback strategy when the primary strategy cannot place a window.
`find-empty-mode`	string	`best-effort`	Find-empty behavior. Expanded windows are ignored as hard blockers because expanded overlap is normal in v0.3.0.

`placement.landmarks`

Placement behavior for collapsed readable objects on the field.

Option	Type	Default	Notes
`strategy`	string	`nearest-free`	Strategy for collapsed nodes, cluster cores, and landmarks.
`normal-blocker`	string	`relocate`	Behavior when an unpinned landmark blocks placement.
`pinned-blocker`	string	`preserve`	Behavior when a pinned landmark blocks placement.

`placement.reveal`

Camera reveal behavior after window placement.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables post-placement reveal panning.
`max-pan-px`	f32	`360`	Maximum reveal pan distance in pixels.
`animation-ms`	u64	`180`	Reveal pan animation duration.
`pan-to-new`	string	`if-needed`	Controls new-window reveal panning. Accepted values: never, if-needed, always.