Settings Renderers

renderers.lua is a menu-context provider script installed by the H3 plugin. It registers custom interfaces.Settings renderers when the plugin loads; consumers do not call a constructor or require a returned API.

ScreenPosition

The ScreenPosition renderer edits a normalized openmw.util.Vector2 position. It shows a preview marker, opens a larger picker on click, and clamps the draft to [0, 1]. While dragging, a primary-button release commits the current draft through the Settings setter; if the release is inside the picker, the release offset is applied once more before the commit.

Apply closes the picker. Cancel restores the original value when the draft changed, then closes the picker.

The optional argument can provide a plain title, or an l10n group and name pair for a localized title. The renderer's z-less position is UI data: it is not a world position and does not perform camera projection.

List

The List renderer edits an array of strings. It provides a text input used by an Add action and a Remove action for each current entry. Newly added strings retain the casing entered by the user. The renderer copies the incoming array before editing and calls the supplied Settings setter with the edited array.

These controls are registered by H3's menu renderer provider. The provider owns the H3 localization keys such as button_add, button_remove, button_apply, and button_cancel. Settings authors only need to provide their own localization group when using the { l10n, name } title argument for ScreenPosition.

H3UI appearance renderers

H3UIColor displays a color swatch and accepts a six-digit hexadecimal value. A valid edit writes the color to the H3UI player settings and selects Custom. H3UITheme lists the built-in and registered H3UI presets; choosing a preset copies its canonical colors into the player settings. H3UIReset restores the canonical Morrowind palette.