S3ctor's S3cret St4sh

H3 components are passive layout builders for registered menu and player scripts. Each call returns an OpenMW layout; it does not create an element or own your state. Start with UI Layouts and Lifecycle, jump to a UI recipe for a complete surface, or use H3UI when you want recipes, player-configured appearance, tokens, and a style cascade above these primitives.

A content-only root uses ui.TYPE.Container so it sizes itself to its children. The default ui.TYPE.Widget is also valid, but needs explicit geometry.

Choose by job

Need	Components
Basic layout shape	widget, container, row, column
Text, images, and spacing	text, image, spacer
Lists and repeated content	list, listItem, grid
Framed content	box, bookFrame, dialog, tooltip
Actions and indicators	button, iconButton, meter, itemSlot
State and input	toggle, slider, selector, numberInput, searchInput, textInput
Tabbed or expandable content	tabs, collapsible
Morrowind window chrome	headBlock, caption, pinButton, window

Shared layout options

Most builders accept these layout fields:

Field	Type	Description
`name`	string?	Name a child for lookup from its owning `Content`.
`props`	table?	Set layout properties such as `size`, `position`, or `visible`.
`external`	table?	Set parent-facing properties such as `grow` or `stretch`.
`events`	table?	Supply low-level OpenMW callbacks. Wrap them with `async:callback`.
`userData`	any?	Attach caller-owned data to a layout.
`template`	openmw.ui.Template?	Override the default template where supported.
`content`	openmw.ui.Content?	Provide child content; takes precedence over `children`.
`children`	openmw.ui.LayoutOrElement[]?	Provide child layouts when `content` is absent.

The builders shallow-copy props and external. They do not copy child layouts, textures, or caller state deeply.

Mount a component

local ui = require 'openmw.ui'
local column = require 'scripts.s3.components.column'
local text = require 'scripts.s3.components.text'
local util = require 'openmw.util'

ui.create {
  type = ui.TYPE.Container,
  layer = 'Windows',
  props = {
    position = util.vector2(80, 80),
  },
  content = ui.content {
    column {
      children = {
        text {
          text = 'Hello from H3',
        },
      },
    },
  },
}

Keep element when a callback changes layout state, then call element:update(). Rebuild the root for structural changes. The component tests provide larger executable constructions.

bookFrame Frame content with the solid Morrowind book treatment. box Put content in the shared H3UI box treatment. button Build an H3UI text button. caption Build a centered Morrowind title strip with optional controls. collapsible Build an expandable disclosure header and body. column Arrange children in a vertical Flex layout. container Group children in a passive OpenMW Container. dialog Compose a dialog-style body without owning a window. grid Arrange items into fixed-column horizontal rows. headBlock Draw a scalable vanilla Morrowind title border. iconButton Build an H3UI button with a caller-provided icon and optional label. image Place a caller-provided texture resource in a layout. itemSlot Display an icon in a bordered slot with an optional count. list Build a vertical list from items or child layouts. listItem Build a padded row for one list entry. meter Show a bounded horizontal fill and empty indicator. numberInput Edit a number with commit-time clamping and stepping. pinButton Build the fixed-size Morrowind pinned-state control. row Arrange children in a horizontal Flex layout. searchInput Build a text search field with an optional clear button. selector Choose one item with previous and next buttons. slider Build a bounded pointer-controlled numeric slider. spacer Add fixed space or flexible empty room to a layout. tabs Build a selectable tab strip without owning page content. text Add Morrowind-styled text to a layout. textInput Build a plain OpenMW TextEdit line. toggle Build a state-labelled yes/no button. tooltip Build boxed explanatory content without positioning it. widget Build a passive base Widget layout. window Build a caller-owned movable and resizable framed surface.