acdream/docs/research/2026-08-10-options-panel-structure.md

# Retail Options panel — structure, open path, Apply/Reset/Defaults, Chat + Config tab contents

**Date:** 2026-08-10
**Lane:** Settings-track RESEARCH LANE A (handoff questions Q1 and Q3, plus the
Chat/Config tab derivation).
**Status:** RESEARCH ONLY — no production code changed, nothing built, nothing launched.
**Handoff this answers:** `docs/research/2026-08-10-settings-track-handoff.md` §"Research
questions" items 1 and 3, with partial pre-work on items 5 and 6.

## Primary sources and evidence discipline

- `docs/research/named-retail/acclient_2013_pseudo_c.txt` (Binary Ninja pseudo-C, Sept 2013
  EoR build, PDB names) and `docs/research/named-retail/symbols.json`.
- **Byte-verified** against the PDB-paired binary `C:\Users\erikn\Downloads\acclient.exe`.
  `py tools/pdb-extract/check_exe_pdb.py "C:/Users/erikn/Downloads/acclient.exe"` reports
  `=== MATCH: this exe pairs with our acclient.pdb ===` (linker UTC 2013-09-06T00:17:56,
  CodeView GUID `9e847e2f-777c-4bd9-886c-22256bb87f32`). Every load-bearing constant below
  that BN rendered as `0` or as a zero-idiom was re-read from the raw section bytes with a
  throwaway PE reader (scratchpad `peread.py` / `decode_addchild.py`, not committed).
- The **installed DATs** at `%USERPROFILE%\Documents\Asheron's Call\` read through
  `Chorizite.DatReaderWriter` 2.1.7 via `DatCollection` — the same reader production uses.
  Throwaway scratchpad probe (not committed); recipe per
  `docs/research/2026-08-10-retail-ui-text-style.md` §tooling. **NOTE:** a standalone
  `PortalDatabase`/`LocalDatabase` throws on `LayoutDesc` unpack
  (`writer.Database.DatCollection is null!`) — you must open a `DatCollection`.
- The retail `UserPreferences.ini` sitting next to the user's DATs — a live retail artifact
  that independently cross-checks the Config tab's preference keys and default values.

Everything marked UNKNOWN / UNVERIFIED below is genuinely not established. Nothing is guessed.

---

## 0. Headline

Retail's Options panel is **one LayoutDesc** — `0x2100002B` — that carries the tab control,
the four mounted tab pages, **and** the option-row template list, all in one file. The four
pages are four separate `UIElement` classes registered by class id, each authored in its own
LayoutDesc and mounted into the tab host by `BaseLayoutId`/`BaseElement`. The panel is
opened by input action **`0x1000001A` = `ToggleOptionsPanel`** (F11 by default, and the
toolbar's options button fires the same action).

The Apply model is the opposite of what a modern designer would build: **every LED click
applies immediately**. "Apply" only commits the undo baseline (and flushes the
character-options blob); "Reset" reverts to that baseline; "Defaults" loads the retail
default and applies it live without committing. Hiding a page auto-reverts uncommitted
edits.

---

## 1. The class family and the layout inventory (Q1)

### 1.1 Classes

| Retail class | Element class id | `Register` | `Create` | `InitOptions` | Purpose |
|---|---|---|---|---|---|
| `OptionPage` | — (abstract) | — | — | — | base: registered-option array + save/restore/changed |
| `PlayerOptionPage : OptionPage` | — (abstract) | — | — | — | base: ListBox-backed row builders |
| `gmGameplayOptionsUI` | `0x10000029` | `0x0049E0F0` | `0x0049E060` | *(none — pure button list)* | Tab 1 "Gameplay Options" |
| `gmCharacterSettingsUI` | `0x10000027` | `0x004A02D0` | `0x004A01D0` | `0x004A02F0` | Tab 2 "Character" |
| `gmChatOptionsUI` | `0x10000042` | `0x0049FC40` | `0x0049FBA0` | `0x0049FC60` | Tab 3 "Chat" |
| `gmConfigUI` | `0x10000028` | `0x0049E8D0` | `0x0049E340` | `0x0049E400` | Tab 4 "Config" |
| `gmKeyboardUI` | `0x1000000E` | `0x004DCF70` | `0x004DC080` | `0x004DD8B0` | "Configure Keyboard" screen (separate window) |

`OptionPage` members (`symbols.json`): `RegisterOption 0x004F2E90`, `SaveCurrentValues
0x004F2C60`, `RestoreSavedValues 0x004F2D00`, `RestoreDefaultValues 0x004F2CB0`, `Changed
0x004F2D60`.

`PlayerOptionPage` members: `AddHeader 0x004F28B0`, `AddSeperator 0x004F2730` *(retail's own
spelling)*, `AddToggleOption` **two overloads** `0x004F2990` (`PStringBase<char>` prefName)
and `0x004F2A00` (`enum PlayerOption`), `AddToggleWithSliderOption 0x004F2930`,
`AddSliderOption 0x004F2A70`, `AddMenuOption 0x004F2AF0`, `SetToggleLabel 0x004F2750`,
`SetSliderLabel 0x004F2B80`, `OnOptionChanged 0x004F27D0`, `OnOptionChangeConfirmed
0x004F2850`, `OnVisibilityChanged 0x004F26E0`, `SaveCurrentValues 0x004F2710`.

`UIOption` widget classes (the row leaves), by DynamicCast id:

| DynamicCast id | Class | Row child element looked up |
|---|---|---|
| `0x10000035` | `UIOption_Checkbox` | `0x10000219` |
| `0x10000036` | `UIOption_CheckboxSlider` | *(the row root itself)* |
| `0x10000037` | `UIOption_Slider` | `0x1000021C` |
| `0x10000038` | `UIOption_Menu` | `0x10000224` |
| `0x10000044` | `UIOption_CheckboxBitfield64` | *(the row root itself)* |

There is also `UIOption_ActionKeyMap` (keyboard screen) and `UIOption_CheckboxBitfield`
(32-bit variant, `Apply 0x00486490` — **not used by any of the four Options tabs**).

### 1.2 LayoutDescs (all in `client_local_English.dat`)

| LayoutDesc | Root element | Root `Type` | Size | What it is |
|---|---|---|---|---|
| **`0x2100002B`** | `0x10000208` | `0x00000008` (TabControl) | **300 × 600** | **The Options panel**: tab strip + 4 mounted pages + 7 row templates |
| `0x2100002A` | `0x10000202` | `0x10000029` | 300 × 337 | Gameplay Options page |
| `0x21000028` | `0x100001F9` | `0x10000027` | 292 × 600 | Character page |
| `0x2100005C` | `0x1000050A` | `0x10000042` | 292 × 600 | Chat page |
| `0x21000029` | `0x100001FF` | `0x10000028` | 292 × 600 | Config page |
| `0x21000009` | `0x1000001F` | `3` | 800 × 600 | Configure Keyboard full-screen screen (contains `0x10000020` `T=0x1000000E`, 590 × 462) |

Each page root also carries `P0x58 = enum 1` and a `P0x57` enum — see §2.3.

### 1.3 The tab control — element `0x10000208`, Type `8`

Authored properties on the tab-host root:

```
P0x58 = enum 1
P0x57 = enum 0x1000001A          <- the input action that toggles this window (see §2)
P0x2E = ARRAY of 4 StructBaseProperty (MasterPropertyId 0x2F), each:
          0x30 = <tab button element id>
          0x31 = <tab page element id>
          0x32 = bool  (true on exactly one entry = the initially selected tab)
```

The four decoded entries, **in authored array order**:

| # | `0x30` tab button | `0x31` page slot | `0x32` default | Tab label (StringId, table `0x23000001`) |
|---|---|---|---|---|
| 0 | `0x1000020D` (0,0) 106×25 | `0x10000212` | **True** | `0x0AFFD072` → **"Gameplay Options"** |
| 1 | `0x1000020E` (106,0) 64×25 | `0x10000211` | False | **"Character"** |
| 2 | `0x1000050B` (172,0) 50×25 | `0x1000050C` | False | **"Chat"** |
| 3 | `0x1000020F` (222,0) 56×25 | `0x10000213` | False | **"Config"** |

Left-to-right x order = 0, 106, 172, 222 → **Gameplay Options | Character | Chat | Config**,
exactly matching the user's screenshot. Tab buttons all inherit base `0x2100004D/0x1000043A`.

Additional children of `0x10000208`:

| Element | Geometry | Notes |
|---|---|---|
| `0x10000209` | (0,25) 2×575, image | left border strip beside the page area |
| `0x10000210` | (276,0) 24×25 | **close (X) button**; `P0x12 = enum 0x1000001A`; has `Normal` + `Normal_pressed` media |
| `0x10000211` | (2,25) 298×575 | Character page slot ← base `0x21000028/0x100001F9` |
| `0x10000212` | (2,25) 298×575 | Gameplay page slot ← base `0x2100002A/0x10000202` |
| `0x1000050C` | (2,25) 298×575 | Chat page slot ← base `0x2100005C/0x1000050A` |
| `0x10000213` | (2,25) 298×575 | Config page slot ← base `0x21000029/0x100001FF` |

### 1.4 Where the Options panel is *hosted*

`0x2100002B/0x10000208` is mounted (by base reference) into exactly two host layouts, both
at slot element `0x1000018D` inside a shared page-stack container `0x10000180`:

| Host LayoutDesc | Root | Root type | Root size | Container | Slot key `P0x10000029` |
|---|---|---|---|---|---|
| `0x21000017` | `0x1000017B` | `0x10000008` = **`gmPanelUI`** (Register `0x004BC9AA`) | 309×482 @ (491,28), ZLevel 800 | `0x10000180` (9,120) 300×362 | `0x1000018D` → **10 (0xA)** |
| `0x2100006E` | `0x100005FE` | `0x1000004F` = **`gmFloatyPanelUI`** (Register `0x004D1A1A`) | 310×372 | `0x10000180` (5,5) 300×362 | `0x1000018D` → **10 (0xA)** |

`0x21000017` is the legacy docked right-hand panel (it also carries the radar,
`0x1000003D` `T=0x10000010` = `gmRadarUI`). `0x2100006E` is the modern **floating,
resizable** window frame — eight 5 px border strips (`0x10000653`–`0x1000065A`) plus
`T=9` resize grips / `T=2` dragbar, which is the same shell family Campaign CH6 ported.
The page-stack slot is authored 300×362; the panel content is authored 300×600, so retail's
parent-resize policy scales it — and because the floaty frame is resizable, the user's tall
screenshot is the resized state, not a third layout. The whole panel is 300 px wide and the
option ListBox is 276 px wide with a 16 px scrollbar.

> The same `0x10000180` stack holds ~16 sibling panels (allegiance, skills, attributes,
> inventory, character info …), each keyed by `P0x10000029`. The Options panel's key is 10.

### 1.5 The row mechanism — a ListBox with an authored template list

`PostInit` on each page fetches its ListBox and stores it as `m_pOptionBox`:

| Page | `GetChildRecursive(this, …)` | ListBox element | Cast |
|---|---|---|---|
| Character | `0x100001FA` (`gmCharacterSettingsUI::PostInit @0x004A0280`) | `0x100001FA` 276×560, `T=5` | `DynamicCast(5)` |
| Config | `0x10000200` (`gmConfigUI::PostInit @0x0049E840`) | `0x10000200` 276×560, `T=5` | `DynamicCast(5)` |
| Chat | `0x1000050D` (`gmChatOptionsUI::PostInit @0x0049F100`) | `0x1000050D` 276×560, `T=5` | `DynamicCast(5)` |

Every row is created by `UIElement_ListBox::AddItemFromTemplateList(m_pOptionBox, <index>,
nullptr)`. **The template list is authored on the ListBox as property `0x64`** — an array of
`StructBaseProperty` where `0x63` = template LayoutDesc DID and `0x62` = template element id.
All templates live in `0x2100002B`.

**Template arrays as authored (index → element):**

| idx | Character (`0x100001FA`) | Config (`0x10000200`) | Chat (`0x1000050D`) | Template element | Builder |
|---|---|---|---|---|---|
| 0 | `0x10000216` | `0x10000216` | `0x10000216` | 292×22, base `0x2100003F/0x1000038C` | `AddHeader` |
| 1 | `0x10000217` | `0x10000217` | `0x10000217` | 292×8, image | `AddSeperator` |
| 2 | `0x10000218` | `0x10000218` | `0x10000218` | 272×20, child `0x10000219` (checkbox) | `AddToggleOption` |
| 3 | — | `0x1000021A` | `0x1000021A` | 272×20, label `0x1000021B` + slider `0x1000021C` | `AddSliderOption(arg3 == 0)` |
| 4 | — | `0x10000222` | `0x10000222` | 272×20, label `0x10000223` + menu `0x10000224` | `AddMenuOption` |
| 5 | — | `0x10000220` | `0x10000220` | 272×20, `T=0x10000036` | `AddToggleWithSliderOption` |
| 6 | — | `0x1000021D` | `0x1000021D` | 272×**36**, + range labels `0x1000021E`/`0x1000021F` | `AddSliderOption(arg3 != 0)` |
| 7 | — | `0x10000221` | `0x10000221` | 272×**36**, `T=0x10000036` + range labels | *(unused by the four tabs)* |
| 8 | — | — | `0x10000520` | 272×100, `T=0x10000044` | `CheckboxBitfield64` block |

`0x10000521` (272×20, child `0x10000219` with base `0x21000044/0x10000329`) exists in
`0x2100002B` but is **not** in any of the three template arrays — UNKNOWN consumer.

**Byte-verified slider index selection.** BN renders `PlayerOptionPage::AddSliderOption`'s
index as `(((eax - eax) & 3) + 3)`, which is the known `neg`/`sbb` zero-idiom artifact class.
The real instruction sequence at `0x004F2A80`–`0x004F2A90` is `neg eax; sbb eax,eax; and
eax,3; add eax,3`, i.e. **index 6 when `arg3 != 0`, index 3 when `arg3 == 0`**. This is
corroborated behaviourally: every `AddSliderOption(..., 1)` call in `gmConfigUI::InitOptions`
is followed by a `SetSliderLabel` (which writes children `0x1000021E`/`0x1000021F` — present
only on template 6), and the one `AddSliderOption(..., 0)` call
(`Input_MouseLookSensitivity`) is not.

`PlayerOptionPage::AddHeader` casts the created row to `0xC` (`UIElement_Text`) and writes
`StringInfo::SetStringIDandTableEnum(&si, arg2, 0x10000003)`. **Table enum `0x10000003`
resolves to StringTable DID `0x23000003`** — confirmed by hashing every `ID_*` label name
below and finding it in that table. `SetToggleLabel` writes the same table for both label
(`UIElement_Text::SetStringInfo`) and tooltip (`vtable+0x2B4`).

---

## 2. How the panel opens and closes (Q1c)

### 2.1 Keybind — action `0x1000001A` = `ToggleOptionsPanel`, default **F11**

- `docs/research/named-retail/keymap-default.txt:139` —
  `F11 (scan=0x57, dev=0) Action=0x1000001A Activation=0x03`
- `docs/research/named-retail/retail-default.keymap.txt:148` —
  `ToggleOptionsPanel [ "" [ 0 DIK_F11 ] ]` under the `UICommands` group.

acdream's `KeyBindings.RetailDefaults()` already carries this row (F11 opens the current
non-retail settings panel).

### 2.2 Toolbar button — `0x1000019B` in `LayoutDesc 0x21000016`

From the committed fixture `tests/AcDream.App.Tests/UI/Layout/fixtures/toolbar_21000016.json`:

```
/0x10000191/0x1000019B   T=0x00000001 (UIElement_Button)   pos=(204,0)  34x27
   P0x12 = Enum 268435482 = 0x1000001A
   Normal    media 0x0600051C
   Highlight media 0x0600051E
```

Property `0x12` on a `UIElement_Button` is the **input-action enum the button fires** —
already established by Campaign CH (`docs/research/2026-08-09-chat-retail-window-shell.md`
lines 208-214, `UIElement_Button` reading its own `0x12` at `0x00471E65`). The dispatch is
`UIElementManager::BroadcastGlobalMessage(inst, 1, <actionId>)` — global message **1 = "an
input action fired"**, param = the action id (confirmed by `gmToolbarUI::ListenToGlobalMessage
@0x004BE4E0`, which switches on `arg3` in `0x10000042…0x1000004D` to fire shortcut slots).

For orientation, the toolbar's full action row (same fixture):

| Element | x | Action `P0x12` |
|---|---|---|
| `0x10000197` | 55 | `0x1000000D` |
| `0x10000198` | 85 | `0x10000010` |
| `0x10000199` | 115 | `0x10000013` |
| `0x1000055A` | 145 | `0x100001E7` |
| `0x1000019A` | 175 | `0x10000016` |
| **`0x1000019B`** | **204** | **`0x1000001A` — Options** |
| `0x100001B1` | 238 | `0x10000019` |

### 2.3 Close — the same action

The tab-host close button `0x10000210` carries `P0x12 = 0x1000001A`, i.e. it fires the same
`ToggleOptionsPanel` action. The tab-host root `0x10000208` carries `P0x57 = 0x1000001A`.
Each page root carries its own `P0x57`: Gameplay `0x1000001B`, Character `0x1000001C`,
Config `0x1000001D`, Chat `0x10000113`.

> **UNVERIFIED:** the exact semantics of property `0x57`. The correlation (host `0x57` ==
> close button's `0x12`) makes "the toggle action this element registers itself under" the
> obvious reading, but I did not locate the `GetAttribute_Enum(this, 0x57, …)` read site in
> the decomp. Treat as strongly-indicated, not proven.

---

## 3. Apply / Reset / Defaults (Q3)

### 3.1 The three buttons

`gmCharacterSettingsUI::ListenToElementMessage @0x0049E3A0` — **the same address is bound to
`gmChatOptionsUI::ListenToElementMessage` and `gmConfigUI::ListenToElementMessage`** in the
PDB (identical-COMDAT folding; all three pages share one handler body):

```
0049e3b5   if (idElement == 0x100001FC)  this->vtable->SaveCurrentValues();     // APPLY
0049e3b8   if (idElement == 0x100001FD)  this->vtable->RestoreSavedValues();    // RESET
0049e3bb   if (idElement == 0x100001FE)  this->vtable->RestoreDefaultValues();  // DEFAULTS
```

Authored geometry (identical on all three pages that have them — Character `0x21000028`,
Config `0x21000029`, Chat `0x2100005C`; all base `0x21000040/0x100002CD`, 80×32, y = 564):

| Element | x | Label |
|---|---|---|
| `0x100001FC` | 16 | **Apply** (`0x00A09C49` on Character, `0x09BA3C39` on Config/Chat — different StringIds, same literal) |
| `0x100001FD` | 106 | **Reset** (`0x00D024B4` / `0x09CA84C4`) |
| `0x100001FE` | 196 | **Defaults** (`0x051FC993` / `0x0F183833`) |

**The Gameplay Options page (`0x2100002A`) has no Apply/Reset/Defaults** — it is a pure
button list. This matches the user's screenshot note ("Apply / Reset / Defaults at the bottom
of (at least) the Character tab").

### 3.2 Per-tab, not global

Each page is its own `OptionPage` with its own `m_UIOptionArray`. Apply/Reset/Defaults act on
**that page's registered options only**. The Character page's Apply does not touch the Config
page's sliders.

### 3.3 What each one does

`OptionPage` (all three iterate `m_UIOptionArray` and `&=` the results, then call
`this->vtable->OnOptionChanged(0)`):

| Button | `OptionPage` method | Per-option call | Gated on `Changed()`? |
|---|---|---|---|
| Apply | `SaveCurrentValues @0x004F2C60` | vtable `+0x2C8` = `SaveCurrentValue()` | **No** — every option |
| Reset | `RestoreSavedValues @0x004F2D00` | vtable slot `RestoreSavedValue()` | **Yes** — only options whose `+0x2BC Changed()` is true |
| Defaults | `RestoreDefaultValues @0x004F2CB0` | vtable `+0x2C4` = `RestoreDefaultValue()` | **No** — every option |

`OptionPage::Changed @0x004F2D60` returns true if **any** registered option's `Changed()` is true.

Leaf semantics (`UIOption_Checkbox`, the canonical case):

```
Changed            @0x004868C0   return m_saved != m_current;
SaveCurrentValue   @0x004868E0   m_current = GetValue(); m_saved = m_current; return 1;
RestoreSavedValue  @0x00486900   m_current = m_saved;    Apply(0); Refresh();
RestoreDefaultValue@0x00486930   m_current = m_default;  Apply(0); Refresh();
SetDefaultValue    @0x00486960   m_default = arg2;
SetCurrentValue    @0x00486970   m_current = arg2; SetAttribute_Bool(this, 0xE, arg2); Apply(1);
```

**The load-bearing consequence: `SetCurrentValue` — which is what the user's click on the LED
runs — calls `Apply(1)` immediately.** The option takes effect in the live game the instant
you click it. `Apply` is therefore *not* "now do the thing"; it is "commit this as the new
undo baseline".

- **Apply** = `m_saved = m_current` per option ⇒ `Changed()` goes false ⇒ Reset can no longer
  undo. (Plus the blob flush, §3.5.)
- **Reset** = `m_current = m_saved` and re-`Apply(0)` ⇒ reverts the live game state to the
  last committed baseline.
- **Defaults** = `m_current = m_default` and `Apply(0)` ⇒ pushes the retail default into the
  live game state, but does **not** commit; `Changed()` becomes true, so Apply/Reset light up
  and Reset still undoes it. Defaults comes from `SetDefaultValue`, which is authored *in code*
  in each page's `InitOptions` (Config and Chat) or is UNKNOWN-defaulted (Character — see below).

### 3.4 Button enable/disable

`PlayerOptionPage::OnOptionChanged @0x004F27D0`:

```
eax   = GetChildRecursive(<the gm*UI element>, 0x100001FC);   // Apply
eax_1 = GetChildRecursive(<the gm*UI element>, 0x100001FD);   // Reset
if (OptionPage::Changed(...) == 0) { SetState(0x0D) on both }  // disabled
else                               { SetState(0x01) on both }  // enabled
```

**Defaults (`0x100001FE`) is never enable-gated — it is always clickable.**
`PostInit` calls `InitOptions()` then `OnOptionChanged(0)` so the buttons start disabled.

`PlayerOptionPage::OnOptionChangeConfirmed @0x004F2850` calls back into the owning element
when `arg3 != 0`.

### 3.5 What Apply *sends* — the character-options blob and its dirty timer

`PlayerOptionPage::SaveCurrentValues @0x004F2710` overrides the base and does **two** things:

```
004f271d   CPlayerModule::SaveToServer(&CPlayerSystem::GetPlayerSystem()->playerModule, 0);
004f2725   return OptionPage::SaveCurrentValues(this);      // tailcall
```

`CPlayerModule::SaveToServer @0x0059A660`:

```
if (m_bDirty != 0 || arg2 != 0)
    CM_Character::Event_CharacterOptionsEvent(&this->vtable);   // 0x006A10C0 — the full blob
m_bDirty = 0;
```

`CM_Character::Event_CharacterOptionsEvent @0x006A10C0` is the full-blob
`SetCharacterOptions` sender (**the `0x01A1` builder that CH3 deleted — exact field layout is
Lane B / handoff Q4**).

The dirty flag is set by `CPlayerModule::OnChanged`:

- `OnChanged(BaseProperty*, uint32) @0x0059A890` — sends
  `CM_UI::SendNotice_GameplayOptionChanged`, then, **only if not already dirty**, sets
  `m_bDirty = 1` (offset `+0x1A8`) and stamps `m_timeFirstDirtied` (offset `+0x1AC`, double)
  with `Timer::cur_time`.
- `OnChanged(PlayerOption) @0x0059A8E0` — sends `CM_UI::SendNotice_PlayerOptionChanged`,
  applies the immediate local side effects (case 4 → `SmartBox::EnableWeather`, case 5 →
  `LScape::SetDay`, case 7 → `ClientCombatSystem::TrackTarget`, case `0x30` →
  `LScape::m_fFogEnabled`, cases 2/`0x12` → the mutual exclusion between
  `IgnoreFellowshipRequests` and `FellowshipAutoAcceptRequests`), then:
  ```
  0059a99d   if (CPlayerModule::IsAutoSaveOption(this-4, arg2))
  0059a9ac       CM_Character::Event_PlayerOptionChangedEvent(arg2, GetOption(this, arg2));  // SINGLE-option send
  0059a9c1   else  { if (!dirty) { dirty = 1; m_timeFirstDirtied = Timer::cur_time; } }
  ```
  **So retail has BOTH paths.** An option that `CPlayerModule::IsAutoSaveOption` returns true
  for is sent immediately as a single-option event (this is the `SetSingleCharacterOption
  0x0005` family acdream already implements). Everything else is batched into the blob.
  *Which options are auto-save is UNKNOWN here — enumerate `CPlayerModule::IsAutoSaveOption`
  in Lane B; it is the discriminator for "0x0005 per change vs one 0x01A1 blob".*

**Byte-verified auto-flush timer** — `CPlayerModule::UseTime @0x0059A710`:

```
0059a713  mov  al, [esi+0x1A8]          ; m_bDirty
0059a719  test al, al
0059a71b  jz   0059a749                 ; not dirty -> return
0059a71d  fld  qword [0x007E5358]       ; constant
0059a723  fadd qword [esi+0x1B0]        ; + m_timeFirstDirtied
0059a729  fcomp qword [0x008369A8]      ; vs Timer::cur_time
0059a72f  fnstsw ax
0059a731  test ah, 0x41
0059a734  jp   0059a749                 ; ST0 > cur_time (or unordered) -> skip
0059a736  lea  eax,[esi+4] / push / call CM_Character::Event_CharacterOptionsEvent
0059a742  mov  byte [esi+0x1A8], 0
```

Raw bytes at `0x007E5358` = `00 00 00 00 00 00 7e 40` = **`480.0`**. So: *if any non-auto-save
option is dirty, the blob is flushed automatically **480 seconds (8 minutes) after the first
change**, measured from the first dirtying, not the last.*

**Other `SaveToServer` callers:** `CPlayerSystem::LogOffCharacter @0x00563520` calls
`SaveToServer(&playerModule, 0)` before `ExecuteLogOff`. Those are the only two call sites
in the binary.

### 3.6 Showing/hiding a page auto-applies / auto-reverts

`PlayerOptionPage::OnVisibilityChanged @0x004F26E0`:

```
UIElement::OnVisibilityChanged(this, arg2);
if (arg2 != 0)  this->vtable->SaveCurrentValues();     // becoming visible  -> APPLY
else            this->vtable->RestoreSavedValues();    // becoming hidden   -> RESET
```

**Switching tabs, or closing the Options window, silently reverts any uncommitted edits on
the page you left.** This is a real, user-visible retail behaviour and must be ported, not
"improved".

### 3.7 `UIOption::Apply` — the three write targets

`UIOption_Checkbox::Apply @0x00486C60` branches on how the option was bound:

1. **`m_propName != 0`** → gameplay-option property bag:
   `BaseProperty::SetPropertyName(&p, m_propName)`, set value = `m_current`, then
   `PlayerModule::SetOption(pm, &p)` (`0x005D52C0` — `HashTable::set` into
   `m_colGameplayOptions` then `OnChanged(prop, 0)`).
2. **`m_prefName` path** → `UIPreferences::ModifyPreference(m_prefName, m_current)`, and on
   success `CM_UI::SendNotice_UserPreferenceChanged(m_prefName)`. This is the
   `UserPreferences.ini` path used by the whole Config tab. **Nothing goes over the wire.**
   *(BN renders the branch predicate as `m_playerOption == ~AutoRepeatAttack_PlayerOption`,
   which is a `not`/`cmp` artifact. The branch's BODY is unambiguous; the exact predicate is
   UNVERIFIED. It is almost certainly "no PlayerOption bound", i.e. the prefName binding.)*
3. **else** → `PlayerModule::SetOption(pm, m_playerOption, m_current)` (`0x005D3EB0` — a
   switch over `enum PlayerOption` writing the `options_` word bits and calling
   `OnChanged(option)`). This is the Character tab path.

All three then call `this->vtable->HandleDialogAndNotices(arg2)`.

`UIOption::HandleDialogAndNotices @0x004EFB90`:

```
if (m_confirmChange && arg2)          UIOption::HandleDialog(this);
if (m_shouldReloadOptions)            CM_Character::SendNotice_ReloadOptions();
if (m_shouldRefreshOptionsPanel)      CM_UI::SendNotice_RefreshOptionsPanel();
if (m_noticeFuncPtr)                  m_noticeFuncPtr();
if (m_pOCH && arg2)                   m_pOCH->OnOptionChanged(this);
```

So `Apply(1)` (user click) may raise the confirmation dialog and notifies the page (which
re-runs `Changed()` and lights up Apply/Reset). `Apply(0)` (from Reset/Defaults) skips both —
the page calls `OnOptionChanged(0)` itself afterwards.

`UIOption::SetConfirmChange` is used exactly once on the four tabs:
`gmConfigUI::InitOptions @0x0049E5BF` sets it on the `Display_Resolution` menu.

`UIOption_CheckboxBitfield64::Apply @0x00485FF0` has the same shape but dispatches on
`m_propType`:

```
004860b3   if (m_propType == Normal_PropType)  PlayerModule::SetOption(pm, &prop);
004860c4   else if (m_propType == 1)           PlayerModule::SetChatWindowOption(pm, m_nUserData, &prop);
```

`m_nUserData` is set by `UIOption::SetUserData(option, <retail window id>)`. The other
`SetChatWindowOption` call sites in the binary pass `this->m_eWindowID` — which independently
confirms Campaign CH6's identity model (main = 8, floaties = 2..5) and confirms that the
Chat tab's `SetUserData` argument *is* the retail window id.

---

## 4. The **Config** tab — complete row map (`gmConfigUI::InitOptions @0x0049E400`)

Six sections, **6 headers / 5 interior separators + 1 trailing / 27 option rows** (corrected 2026-08-11 at the OP6 re-review — the original 24 was a miscount; the decomp has 27 `Add*Option` calls and the OP6 slice's 39-item count pin (6+6+27) is the authoritative tally). Bindings
are `PStringBase<char>` preference-key globals whose names are `Section_Key`; they map
one-to-one onto `UserPreferences.ini` sections (verified against the user's live retail
`UserPreferences.ini`). All headers byte-verified from `mov eax,[global]; push eax` operands.

| # | Header global (VA) | StringId | Literal |
|---|---|---|---|
| 1 | `ID_Sound_SoundSection` (`0x0083E750`) | `0x09FB638E` | **Sound Options** |
| 2 | `ID_Camera_CameraSection` (`0x0083E754`) | `0x08A8429E` | **Camera Options** |
| 3 | `ID_Graphics_GraphicsSection` (`0x0083E758`) | `0x0D95A11E` | **Graphics Options** |
| 4 | `ID_Graphics_TextureSection` (`0x0083E75C`) | `0x018580EE` | **Rendering Quality Options** |
| 5 | `ID_Input_InputSection` (`0x0083E760`) | `0x01BAE38E` | **Input Options** |
| 6 | `ID_UI_UISection` (`0x0083E764`) | `0x0D25AC1E` | **UI Options** |

| Section | # | Widget | Preference key | `SetDefaultValue` | Decomp VA |
|---|---|---|---|---|---|
| Sound Options | 1 | Menu (UIPreference) | `Sound_SoundFeatures` | `0` | `0x0049E418` |
| | 2 | Toggle+Slider | `Sound_SoundDisabled` / `Sound_SoundVolume` | `1`, `0x3F800000` = 1.0f | `0x0049E435` |
| | 3 | Toggle+Slider | `Sound_AmbientSoundDisabled` / `Sound_AmbientSoundVolume` | `1`, 1.0f | `0x0049E457` |
| | 4 | Toggle+Slider | `Sound_InterfaceSoundDisabled` / `Sound_InterfaceSoundVolume` | `1`, 1.0f | `0x0049E479` |
| | 5 | Toggle | `Sound_PlaySoundOnlyWhenActive` | `1` | `0x0049E496` |
| Camera Options | 6 | Slider (labelled) | `Camera_Stiffness` | `0x3EE66666` = **0.45f** | `0x0049E4C4` |
| | 7 | Slider (labelled) | `Camera_AdjustmentSpeed` | `0x42200000` = **40.0f** | `0x0049E501` |
| | 8 | Slider (labelled) | `Render_FieldOfView` | `0x42B40000` = **90.0f** | `0x0049E53E` |
| | 9 | Toggle | `Camera_AlignToSlope` | `1` | `0x0049E571` |
| Graphics Options | 10 | Menu (**UserPreference**, `arg3 == 0`) | `Display_Resolution` | `0x03200258` = **800 × 600**; `SetConfirmChange(1)` | `0x0049E5A5` |
| | 11 | Toggle | `Display_FullScreen` | `1` | `0x0049E5CB` |
| | 12 | Toggle | `Display_SyncToRefresh` | `0` | `0x0049E5E3` |
| | 13 | Slider (labelled) | `Render_ScreenBrightness` | `0` = 0.0f | `0x0049E5FD` |
| | 14 | Toggle | `Render_AutomaticDegrades` | `0` | `0x0049E62C` |
| | 15 | Slider (labelled) | `Render_GraphicsPerformance` | `0` = 0.0f | `0x0049E646` |
| | 16 | Slider (labelled) | `Render_DegradeDistance` | `0x42480000` = **50.0f** | `0x0049E677` |
| Rendering Quality | 17 | Menu | `Render_LandscapeTextureDetail` | `2` | `0x0049E6BF` |
| | 18 | Menu | `Render_EnvironmentTextureDetail` | `1` | `0x0049E6D9` |
| | 19 | Menu | `Render_TextureFiltering` | `1` | `0x0049E6F3` |
| | 20 | Menu | `Render_LandscapeDrawDistance` | `8` | `0x0049E70D` |
| | 21 | Toggle | `Render_BuildingDetailTextures` | `1` | `0x0049E725` |
| | 22 | Toggle | `Render_MultiPassAlpha` | `0` | `0x0049E73D` |
| Input Options | 23 | Slider (**unlabelled**, `arg3 == 0`) | `Input_MouseLookSensitivity` | `0x3F0CCCCD` = **0.55f** | `0x0049E76B` |
| | 24 | Toggle | `Input_InvertMouseLookYAxis` | `0` | `0x0049E78C` |
| | 25 | Toggle | `Input_UseMouseTurning` | `0` | `0x0049E7AA` |
| UI Options | 26 | Menu | `UI_ChatFontFace` | `2` | `0x0049E7DE` |
| | 27 | Menu | `UI_ChatFontSize` | `1` | `0x0049E7F8` |

*(27 `Add*` calls; the three toggle+slider rows are one widget each, so the visible row count
is 27.)*

**Cross-validated against the user's live retail `UserPreferences.ini`:** `Camera Stiffness =
0.45`, `AdjustmentSpeed = 40.00`, `FieldOfView = 90.00`, `SoundVolume/AmbientSoundVolume/
InterfaceSoundVolume = 1.00`, `ScreenBrightness = 0.00`. Every decomp default that the ini
still holds at its default value matches exactly.

Slider range labels come from `ID_Graphics_Value_*` globals at `0x0083E768`–`0x0083E794`:
`Dark/Bright`, `Speed/Detail`, `Close/Far`, `Narrow/Wide`, `Slow/Fast`, `Soft/Hard`
(six labelled sliders, six label pairs — the pairing order is UNVERIFIED; the exact
`SetSliderLabel` operand pairs would need the same push-imm decode I ran on `AddHeader`).

`gmConfigUI` extras:
- `PostInit` also `RegisterNoticeHandler(0x4DD276, …)` and
  `UIListener::RegisterForGlobalMessage(this, 0x0C)`.
- `ListenToGlobalMessage @0x0049EB90`: `if (arg2 == 0x0C) SetMouseTurningDefaults(this)`.
- `SetMouseTurningDefaults @0x0049E8F0` clamps `m_pStiffness` to `0.95f` (when below) and
  prints a chat line (`"Camera Stiffness was changed fro…"`), plus the same treatment on
  `m_pAdjustmentSpeed`, `m_pSensitivity`, `m_pInvert`, `m_pMouseTurn`, `m_pSlope`. Exact
  clamp set is out of Lane A scope.
- `RecvNotice_UserPreferenceChanged_Menu @0x0049EBA0` reacts to
  `Render_LandscapeTextureDetail` changes.

**Not on the 2013 Config tab, though present in `UserPreferences.ini`:**
`Render_SceneryDrawDistance`, `Render_DisplayAdapter`, `Render_AspectRatio`,
`Render_LandscapeDetailTextures`, `Display_RefreshRate`, `Net_*`, `Misc_TooltipDelay`,
`Misc_TooltipEnable` (globals exist at `0x0083EAA4`/`0x0083EAA8` and strings "Tooltip Delay"
exists in table `0x23000003`), `International_UseIME`, `Input_MouseLookSmoothingAmount`,
`Input_KeymapFile`. Those are either the external config/launcher's surface or a later
build's rows. **UNKNOWN which.**

---

## 5. The **Chat** tab — complete row map (`gmChatOptionsUI::InitOptions @0x0049FC60`)

Six sections. Headers byte-verified from the `mov <reg>,[global]` operands:

| # | Header global (VA) | Section content |
|---|---|---|
| 1 | `ID_ChatOption_GeneralOptions_Section` (`0x0083E810`) | the two opacity sliders |
| 2 | `ID_ChatOption_MainChatWindow_Section` (`0x0083E814`) | filter block, `SetUserData(8)` |
| 3 | `ID_ChatOption_FloatyChatWindow1_Section` (`0x0083E818`) | filter block, `SetUserData(2)` |
| 4 | `ID_ChatOption_FloatyChatWindow2_Section` (`0x0083E81C`) | filter block, `SetUserData(3)` |
| 5 | `ID_ChatOption_FloatyChatWindow3_Section` (`0x0083E820`) | filter block, `SetUserData(4)` |
| 6 | `ID_ChatOption_FloatyChatWindow4_Section` (`0x0083E824`) | filter block, `SetUserData(5)` |

*(Table `0x23000003` also holds "Chat Window 1"…"Chat Window 4" at `0x0DC3B9FE`/`0x0DC3B8FE`/
`0x0DC3B7FE`/`0x0DC3B6FE`; the six headers above are the ones actually pushed.)*

### 5.1 General Options — two linked opacity sliders

| Slider | Template idx | Gameplay option property | Notes |
|---|---|---|---|
| 1 | **3** (unlabelled row) | `0x10000080` `Option_DefaultOpacity_Property` | `UIOption_Slider::SetGameplayOptionProperty @0x0049FCC0` |
| 2 | **6** (labelled row) | `0x10000081` `Option_ActiveOpacity_Property` | `@0x0049FD1A`; then `SetSliderLabel(this, slider2, <min>, <max>)` |

Range labels come from `ID_UI_Value_Transparent` (`0x0083E828`) and `ID_UI_Value_Opaque`
(`0x0083E82C`). The two sliders are then **linked**:

```
0049fd5c   DualHash<UIOption_Slider*,UIOption_Slider*>::add(&this->m_hashSliderLinks, &slider1, &slider2);
```

which is the "linking DRAGS the other value (never clamps)" behaviour CH6c already ported.

### 5.2 The five per-window text-type filter blocks

Each block is one `UIOption_CheckboxBitfield64` created from **template index 8**
(`0x10000520`, `T=0x10000044`, 272×100), bound with
`SetGameplayOptionProperty(opt, 0x1000007F, Chat_PropType)` (`Chat_PropType == 1`, so
`Apply` routes through `PlayerModule::SetChatWindowOption(pm, m_nUserData, prop)`),
`SetUserData(<windowId>)`, `SetDefaultValue(<low>, <high>)`, then N `AddChild(lowMask,
highMask, labelId, tooltipId)` and one `CreateChildren`.

Windows 2/3/4 go through the shared helper
`gmChatOptionsUI::AddCheckboxBitfield64Option @0x0049EDA0`; windows 8 and 5 are written
inline in `InitOptions` (the helper is inlined at those two sites — the helper's own switch
covers cases 2/3/4/5/8, so the semantics are identical).

**Defaults, byte-verified from the helper's switch and the inline blocks:**

| Retail window id | Default filter (high:low) | Site |
|---|---|---|
| **8** (main) | `0x00000000_FBFFFFFF` | `0x0049FDD1` / helper case 8 `0x0049EE16` |
| **2** (floaty 1) | `0x00000000_0000101C` | helper case 2 `0x0049EE2B` |
| **3** (floaty 2) | `0x00000000_00040C00` | helper case 3 `0x0049EE34` |
| **4** (floaty 3) | `0x00000000_00080000` | helper case 4 `0x0049EE3D` |
| **5** (floaty 4) | `0x00000000_78000000` | helper case 5 `0x0049EE46` / inline `0x004A0010` |

The main window's default `0xFBFFFFFF` matches CH6's finding exactly (Society bit `0x20…`
opt-in).

**The checkbox rows** — byte-decoded from the `mov <reg>,[global]; push; push; push high;
push low; call AddChild` sequences (`decode_addchild.py` over the raw section bytes; masks
are 64-bit, `high:low`):

| Row | Mask (high:low) | Label global | Label literal (table `0x2300000D` — CORRECTED 2026-08-11 at #372: the TextFilter label/tooltip family lives in its OWN table, dat-verified by exhaustive sweep; the original 0x23000003 attribution was inferred) |
|---|---|---|---|
| **0** | `0x00000000_83912021` | `ID_ChatOption_TextFilter_Gameplay` (`0x0083E840`) | Gameplay |
| 1 | `0x00000000_00600040` | `ID_ChatOption_TextFilter_Combat` (`0x0083E830`) | Combat |
| 2 | `0x00000000_00020080` | `ID_ChatOption_TextFilter_Magic` (`0x0083E848`) | Magic |
| 3 | `0x00000000_00001004` | `ID_ChatOption_TextFilter_AreaSpeech` (`0x0083E838`) | Area Speech |
| 4 | `0x00000000_00000018` | `ID_ChatOption_TextFilter_Tells` (`0x0083E850`) | Tells |
| 5 | `0x00000000_00040C00` | `ID_ChatOption_TextFilter_Allegience` (`0x0083E858`) | Allegiance *(retail's own misspelling in the symbol)* |
| 6 | `0x00000000_00080000` | `ID_ChatOption_TextFilter_Fellowship` (`0x0083E860`) | Fellowship |
| 7 | `0x00000000_08000000` | `ID_ChatOption_TextFilter_General` (`0x0083E868`) | General |
| 8 | `0x00000000_10000000` | `ID_ChatOption_TextFilter_Trade` (`0x0083E870`) | Trade |
| 9 | `0x00000000_20000000` | `ID_ChatOption_TextFilter_LFG` (`0x0083E878`) | LFG |
| 10 | `0x00000000_40000000` | `ID_ChatOption_TextFilter_Roleplay` (`0x0083E880`) | Roleplay |
| 11 | `0x00000001_00000000` | `ID_ChatOption_TextFilter_Society` (`0x0083E888`) | Society |
| 12 | `0x00000000_04000000` | `ID_ChatOption_TextFilter_Error` (`0x0083E890`) | Error |

Every row's tooltip is the matching `…_Desc` global at label+4.

**Row 0 ("Gameplay") is present on windows 2/3/4/5 and ABSENT on window 8 (main).** Verified
two ways: the inline main-window block at `0x0049FDF6`–`0x0049FF1C` emits exactly 12
`AddChild` calls starting at Combat, while the inline window-5 block at `0x004A002D`–
`0x004A016F` emits 13 starting at Gameplay; and in the helper, `case 8` breaks past the
Gameplay `AddChild` at `0x0049EE6C` while cases 2/3/4/5 fall through the shared
`label_49EE4F` into it. **Retail does not let you switch gameplay text off in the main chat
window.**

So the Chat tab is: **2 sliders + 5 blocks × (12 or 13) checkboxes = 2 + 12 + 13×4 = 66
interactive controls**, in 6 sections.

---

## 6. The **Gameplay Options** tab — complete map (`LayoutDesc 0x2100002A`)

Seven buttons, all base `0x21000040/0x10000618`, all 240×32 at x = 26, no LEDs, no
Apply/Reset/Defaults. Handler: `gmGameplayOptionsUI::ListenToElementMessage @0x0049E110`
(only reacts to `idMessage == 1`).

| y | Element | Label (table `0x23000001`) | What retail does |
|---|---|---|---|
| 20 | `0x10000203` | `0x071D9AC4` **Exit to Character Selection** | `CM_UI::SendNotice_EndCharacterSession(1)` @ `0x0049E1D0` |
| 60 | `0x10000617` | `0x0BB75264` **Exit Game** | `BroadcastGlobalMessage(inst, 1, 0x10000027)` @ `0x0049E298`–`0x0049E2AB` — fires input action `0x10000027` |
| 110 | `0x10000204` | `0x0694E944` **Configure Keyboard** | *not handled in C++*; authored `P0x12 = enum 0x1000001F` → the button self-fires action `0x1000001F` |
| 150 | `0x100005CC` | `0x0A35EE57` **Use Mouse Turning Settings** | `BroadcastGlobalMessage(inst, 0x0C, 0)` @ `0x0049E2A1`–`0x0049E2AB` → `gmConfigUI::SetMouseTurningDefaults` |
| 190 | `0x10000205` | `0x0BB03250` **In-Game Help Files** | *not handled in C++*; authored `P0x12 = enum 123 (0x7B)` = the `ToggleHelp` action (F1 in `keymap-default.txt:132`) |
| 240 | `0x10000206` | `0x0145FCA5` **Urgent Assistance** | `ShellExecuteA(nullptr,"open", "http://support.turbine.com/ics/s…", …)` @ `0x0049E154`–`0x0049E16B`; on failure `MessageBoxA(…, "Asheron's Call Error", MB_OK)` |
| 280 | `0x10000207` | `0x02F2FD45` **Report Abuse** | same `ShellExecuteA` shape @ `0x0049E1F0`–`0x0049E207`, different URL |

The button-branch dispatch is byte-verified (`0x0049E28C`: `sub eax,0x100005CC; jz →
push 0 / push 0x0C; sub eax,0x4B; jnz → fall through; push 0x10000027 / push 1` —
`0x100005CC + 0x4B == 0x10000617` ✓).

**Neither "Urgent Assistance" nor "Report Abuse" sends a game message.** Both are external
browser launches. The two URLs are `support.turbine.com` support-ticket links (both truncated
at BN's ~33-char preview; the full strings were not extracted because they are dead links
today and acdream will not open them — **flagged for the planner as a deliberate divergence
candidate**).

**UNKNOWN / UNVERIFIED:**
- Action `0x10000027` ("Exit Game") — no default keybind, and I did not identify its
  consumer. That it means "quit" rests on the button's authored label only.
- Action `0x1000001F` ("Configure Keyboard") — no default keybind. Strongly corroborated:
  the Configure Keyboard screen's own **OK** (`0x1000002C`) and **Cancel** (`0x1000002D`)
  buttons *also* carry `P0x12 = 0x1000001F`, which is exactly the toggle-window pattern.

---

## 7. The **Character** tab — structural inventory (full option map is Lane B / Q2)

`gmCharacterSettingsUI::InitOptions @0x004A02F0` — **6 headers, 5 interior separators + 1
trailing, 49 toggle rows, no sliders, no menus.** Every row is
`SetToggleLabel(this, AddToggleOption(this, <PlayerOption>), ID_PlayerOption_X,
ID_PlayerOption_X_Help)` (the `enum PlayerOption` overload, `0x004F2A00`), so the tab is
homogeneous.

| Header global (VA) | StringId | Literal | Rows |
|---|---|---|---|
| `ID_CharacterOption_UIBehavior_Section` (`0x0083EA5C`) | `0x06489B6E` | User Interface Behavior | **3** |
| `ID_CharacterOption_UIDisplay_Section` (`0x0083EA60`) | `0x0A9BC99E` | User Interface Display | **15** |
| `ID_CharacterOption_Grouping_Section` (`0x0083EA64`) | `0x0CBAAFAE` | Grouping | **6** |
| `ID_CharacterOption_OtherPlayers_Section` (`0x0083EA68`) | `0x0872DFFE` | Other Players | **11** |
| `ID_CharacterOption_CharacterBehavior_Section` (`0x0083EA6C`) | `0x08674D5E` | Character Behavior | **7** |
| `ID_CharacterOption_Chat_Section` (`0x0083EA70`) | `0x0987FE8E` | Chat | **7** |

All six header globals byte-verified from their `mov eax,[0x0083EA5C+4n]; push eax` operands
at `0x004A02EA`, `0x004A0431`, `0x004A0ABF`, `0x004A0D63`, `0x004A122A`, `0x004A154B`, and all
six hashes verified name→`compute_str_hash`→string-table entry.

Rows in authored order (the `PlayerOption` enumerator names, for Lane B to bind):

1. `ViewCombatTarget`, `SalvageMultiple`, `MainPackPreferred`
2. `VividTargetingIndicator`, `ShowTooltips`, `CoordinatesOnRadar`, `SideBySideVitals`,
   `SpellDuration`, `DisableMostWeatherEffects`, `DisableDistanceFog`, `PersistentAtDay`,
   `DisableHouseRestrictionEffects`, `UseCraftSuccessDialog`, `ConfirmVolatileRareUse`,
   `DisplayTimeStamps`, `FilterLanguage`, `ShowHelm`, `ShowCloak`
3. `IgnoreAllegianceRequests`, `IgnoreFellowshipRequests`,
   `DisplayAllegianceLogonNotifications`, `FellowshipShareXP`, `FellowshipShareLoot`,
   `FellowshipAutoAcceptRequests`
4. `AcceptLootPermits`, `UseDeception`, `AllowGive`, `IgnoreTradeRequests`,
   `DragItemOnPlayerOpensSecureTrade`, `DisplayDateOfBirth`, `DisplayAge`, `DisplayChessRank`,
   `DisplayFishingSkill`, `DisplayNumberDeaths`, `DisplayNumberCharacterTitles`
5. `ToggleRun`, `AdvancedCombatUI`, `AutoTarget`, `AutoRepeatAttack`, `UseChargeAttack`,
   `LeadMissileTargets`, `UseFastMissiles`
6. `StayInChatMode`, `HearAllegianceChat`, `HearGeneralChat`, `HearTradeChat`, `HearLFGChat`,
   `HearRoleplayChat`, `HearSocietyChat`

This is a **1:1 match with the user's transcribed screenshots — with exactly one exception.**

> ### ⚠ Build-version divergence: "Listen to PK death messages"
> The user transcribed an 8th row in the Chat group. The **2013 EoR build's
> `gmCharacterSettingsUI::InitOptions` has only 7** — it ends at `HearSocietyChat` and then
> `AddSeperator`. However, StringTable `0x23000003` **does** contain
> `0x0D16E9A3 = "Listen to PK death messages."`, and
> `compute_str_hash("ID_PlayerOption_HearPKDeaths") == 0x0D16E9A3` exactly. There is **no**
> `HearPKDeath*` reference anywhere in the 2013 pseudo-C.
>
> **Conclusion:** the row was added after the Sept 2013 build; the user's screenshot is from a
> later client. The installed DATs carry the string, so acdream can render it, and ACE
> exposes the matching option. **Lane B must decide whether acdream ships 49 or 50 rows** —
> this is a real fork, not a transcription error.

Note also `ID_PlayerOption_ShowHelm` resolves differently in the two tables (`0x23000003`:
"Show Your Helm or Head Gear" = the label; `0x23000005`: "Your helmet or head gear is
visible." = a status line). The options UI uses table enum `0x10000003` → `0x23000003`.

**No `SetDefaultValue` call appears anywhere in `gmCharacterSettingsUI::InitOptions`** — so
every Character-tab checkbox's `m_default` stays at whatever `UIOption_Checkbox`'s constructor
leaves it. That means the **Defaults** button on the Character tab does *not* restore ACE's
`CharacterOptions1.Default = 0x50C4A54A`; its behaviour is UNVERIFIED and must be established
before implementing (read `UIOption_Checkbox`'s ctor, or `UIOption::InqDefaultGameplayOptionProperty
@ symbols.json`). **This is the single biggest open unknown in the Apply/Reset/Defaults
story.**

---

## 8. Configure Keyboard (pre-work for handoff Q5)

`LayoutDesc 0x21000009` — a **full-screen 800×600** layout (root `0x1000001F`, `T=3`),
frame `0x10000451` (600×476 @ 100,62, base `0x21000042/0x100002B0`), containing
`0x10000020` `T=0x1000000E` = `gmKeyboardUI`, 590×462 @ (5,7).

| Element | Geometry | Content |
|---|---|---|
| `0x1000049B` | 586×388, `T=8` (TabControl) | 6 tabs: **Movement** `0x05330A42`, **Camera** `0x0F5EE5E2`, **Combat** `0x0F1E0AC2`, **UI** `0x06FF16E2`, **Emotes** `0x0A3A04A2`, **CharacterSettings** `0x03765382` |
| `0x100004A7` | 586×363 | the binding grid: column headers **Command** `0x0FDD849C`, **Mapping 1** `0x0D11C1CC`, **Mapping 2** `0x0D41C1CC`, **Mapping 3** `0x0D31C1CC`; ListBox `0x10000025` (570×345, `T=5`) + scrollbar `0x10000026` |
| `0x1000002F` | 570×40, `T=0x10000034` | the `UIOption_ActionKeyMap` row template |
| `0x10000027` | (50,390) 100×32 | **Load File…** `0x06E9046E` |
| `0x10000028` | (150,390) 290×32 | current keymap filename label |
| `0x10000029` | (440,390) 100×32 | **Save As…** `0x048840AE` |
| `0x1000002A` | (0,430) 100×32 | **Defaults** `0x039D522E` |
| `0x1000002B` | (100,430) 100×32 | **Revert** `0x077FC0AE` |
| `0x1000002C` | (390,430) 100×32 | **OK** `0x0055D40E`, `P0x12 = 0x1000001F` |
| `0x1000002D` | (490,430) 100×32 | **Cancel** `0x08653BBE`, `P0x12 = 0x1000001F` |

Supporting decomp: `gmKeyboardUI::AddActionKeyMap 0x004DB2F0`, `GetKeymapDirectory 0x004DA8E0`,
`GetStringInfoFromInputMapID 0x004DA980`, `SaveKeymap 0x004DCF90` (appends `.keymap` when the
extension is missing), `MakeLoadKeymapDialog 0x004DC0B0`, `MakeSaveKeymapDialog 0x004DC5B0`,
`MakeOverwriteKeymapDialog 0x004DCA20`, `MakeCantOverwriteReadOnlyKeymapDialog 0x004DC7B0`,
`RestoreDefaultValues 0x004DA850`, `UpdateKeymapFilenameLabel 0x004DB290`, and the
`UIOption_ActionKeyMap` family (`InitiateBinding`, `SetBinding`, `EraseBinding`,
`ClearAllBindings`, `KeyHitHandler`, `OpenOverwriteBindingDialog`, `OpenMapWarnDialog`,
`SetMouseTurningDefaults`). Storage is the on-disk `.keymap` file named by
`[Input] KeymapFile` in `UserPreferences.ini` — **nothing keyboard-related goes over the
wire**. The user's own DAT dir currently holds `acclient.keymap` and `test.keymap`.

**Note the retail keyboard screen is NOT one of the four Options tabs** — it is a separate
800×600 modal screen reached by the "Configure Keyboard" button.

---

## 9. Binary-Ninja artifacts encountered (add to the DO-NOT-RETRY class list)

1. **`AddHeader(this, 0)` is never literally 0.** BN prints the argument as `0` because it is
   `mov eax, [<global>]; push eax`. The real values are the twelve
   `ID_*_Section` string-hash globals at `0x0083E750`+, `0x0083E810`+, `0x0083EA5C`+.
   Every header in this document was recovered from the raw operand bytes.
2. **`AddChild(..., 0, 0)` likewise drops the label/tooltip operands.** They too are
   `mov <reg>,[<global>]; push <reg>` pairs. All 13 Chat-filter labels came from a
   push-operand decode, not from the pseudo-C.
3. **`(((eax - eax) & 3) + 3)`** in `AddSliderOption` is the `neg`/`sbb` zero-idiom class
   already in the chat digest. Real result: `arg3 ? 6 : 3`.
4. **Identical-COMDAT folding aliases symbols.** `gmCharacterSettingsUI::ListenToElementMessage`,
   `gmChatOptionsUI::ListenToElementMessage`, and `gmConfigUI::ListenToElementMessage` all
   resolve to `0x0049E3A0`; `gmGameplayOptionsUI::ListenToGlobalMessage` and
   `gmKeyboardUI::ListenToGlobalMessage` both to `0x004F5860`; `gmGameplayOptionsUI::PostInit`
   is listed at `0x004BFA00`, which the pseudo-C prints as `gmCGProfessionPage::PostInit`.
   **A shared address does not mean the class actually implements that behaviour** — verify
   the body is generic before attributing it.
5. **BN field-name mush.** `CPlayerModule::OnChanged` writes what BN calls
   `this->m_TimeStampFormat.m_buffer`; the byte-level truth is `mov byte [esi+0x1A8], 1` —
   the `m_bDirty` flag that `UseTime` reads. Trust the offsets, not the names.
6. **`m_playerOption == ~AutoRepeatAttack_PlayerOption`** in `UIOption_Checkbox::Apply` is a
   rendering of a `not`/`cmp` pair. The branch body is unambiguous (the UIPreferences path);
   the predicate is not.

---

## 10. For the planner

### 10.1 Structural inventory in one place

| Thing | Value |
|---|---|
| Options panel LayoutDesc | **`0x2100002B`** (`client_local_English.dat`) |
| Tab-control root element | `0x10000208`, `Type 8`, authored 300 × 600 |
| Tab table property | `0x2E` = array of Structs `{0x30 = button id, 0x31 = page id, 0x32 = isDefault}` |
| Tab buttons (L→R) | `0x1000020D` Gameplay(default) · `0x1000020E` Character · `0x1000050B` Chat · `0x1000020F` Config |
| Close button | `0x10000210`, fires action `0x1000001A` |
| Page slots | `0x10000212` · `0x10000211` · `0x1000050C` · `0x10000213`, all (2,25) 298×575 |
| Page layouts | `0x2100002A` · `0x21000028` · `0x2100005C` · `0x21000029` |
| Page classes | `0x10000029` · `0x10000027` · `0x10000042` · `0x10000028` |
| Option ListBoxes | `—` · `0x100001FA` · `0x1000050D` · `0x10000200` (all 276 × 560, `T=5`) |
| Scrollbars | `—` · `0x100001FB` · `0x10000201` · `0x10000201` (16 × 560; ListBox `P0x72` names it) |
| Row template list | ListBox property `0x64`, entries `{0x63 = layout DID, 0x62 = element id}` |
| Row templates (all in `0x2100002B`) | header `0x10000216` · separator `0x10000217` · toggle `0x10000218` · slider `0x1000021A`/`0x1000021D` · menu `0x10000222` · toggle+slider `0x10000220`/`0x10000221` · bitfield64 `0x10000520` |
| Apply / Reset / Defaults | `0x100001FC` / `0x100001FD` / `0x100001FE`, 80×32 at y 564 |
| Host windows | `0x21000017` (`gmPanelUI`, docked) and `0x2100006E` (`gmFloatyPanelUI`, floating + resizable), slot `0x1000018D`, stack key `P0x10000029 = 10` |
| Open action | `0x1000001A` `ToggleOptionsPanel`, default **F11**; toolbar button `0x1000019B` in `0x21000016` |
| Row counts | Gameplay **7 buttons** · Character **6 headers / 49 toggles** · Chat **6 headers / 2 sliders / 5 bitfield blocks (12+13+13+13+13 = 64 checkboxes)** · Config **6 headers / 27 rows** |
| String tables | tab/button labels → `0x23000001`; option labels + tooltips + section headers → `0x23000003` (table enum `0x10000003`) |

### 10.2 What acdream can reuse from CH6 as-is

- **`LayoutImporter`** already handles the exact mechanisms this panel needs:
  `BaseLayoutId`/`BaseElement` cross-layout inheritance (every page mounts that way), the
  `ElementDesc::Incorporate` child merge, `ShouldMountBaseChildren` + the ZLevel correction
  for pure-container sub-window mounts (the four page slots are exactly that shape), and the
  parent-resize policy that scales a 300×600 page into a 300×362 slot.
- **`RetailWindowManager` / `UiRoot` / the floating-window shell** — the Options panel's real
  host `0x2100006E` (`gmFloatyPanelUI`) is the same 8-border-strip + resize-grip frame CH6
  already imports for the chat windows. Opacity, all-corner resize and drag come free.
- **`RetailLayoutFixtureGenerator`** — add `0x2100002B`, `0x21000028`, `0x21000029`,
  `0x2100002A`, `0x2100005C` and pin them, exactly as CH6 pinned `0x2100006F`/`0x2100005B`.
- **`DatWidgetFactory` already maps `0x10000035` → `BuildCheckbox`** — the LED option row's
  leaf widget class exists today.
- **`DatStringResolver.ComputeHash`** is already the exact `compute_str_hash`, so every
  `ID_PlayerOption_*` / `ID_ChatOption_*` / `ID_*_Section` label in this doc resolves at
  runtime by name with no hard-coded ids.
- **CH6's window-identity model** (main = 8, floaties = 2–5) is *confirmed* by the Chat tab's
  `SetUserData` arguments — no rework needed there.
- **`RuntimeCharacterOptionsState` + the `0x0005` codec** (CH3) is the right seam for the
  Character tab; the `0x1000008C` per-window blob (CH6) is the right seam for the Chat tab's
  filter blocks.

### 10.3 What acdream does NOT have yet

- **Element `Type 8` — the tab control.** `DatWidgetFactory` has no case for it (falls to the
  generic `UiDatElement`), and no reader for property `0x2E`'s struct array. This is the one
  genuinely new widget the campaign needs. It is also needed by the Configure Keyboard screen.
- **Element `Type 5` — `UIElement_ListBox` with an authored template list** (property `0x64`)
  and `AddItemFromTemplateList`. Also absent; also the mechanism that makes the whole options
  page work.
- `UIOption_Slider` (`0x10000037`), `UIOption_Menu` (`0x10000038`),
  `UIOption_CheckboxSlider` (`0x10000036`), `UIOption_CheckboxBitfield64` (`0x10000044`) —
  none mapped in `DatWidgetFactory`.
- The `OptionPage` / `PlayerOptionPage` **model**: a per-page registered-option array with
  `m_current` / `m_saved` / `m_default` triples and the four verbs. This is small and
  self-contained; it is what makes Apply/Reset/Defaults correct rather than approximated.
- A `UserPreferences.ini`-shaped preference store for the Config tab (acdream's settings live
  in `%LOCALAPPDATA%\acdream\`; the Config tab's 27 rows are all `Section_Key` preferences,
  not wire options). **This is where the "retail options vs acdream client settings" design
  call lands** — see §10.5.

### 10.4 Behaviours that MUST be ported, not improved

1. **Clicking an LED applies immediately** (`SetCurrentValue → Apply(1)`). Apply/Reset/Defaults
   operate on an undo baseline, not on a staging buffer.
2. **Apply is per-tab.** Each page owns its own option array.
3. **Defaults is never disabled**; Apply and Reset are disabled whenever nothing changed.
4. **Hiding a page reverts uncommitted edits** (`OnVisibilityChanged(false) →
   RestoreSavedValues`). Switching tabs or closing the window discards.
5. **Showing a page applies + commits** (`OnVisibilityChanged(true) → SaveCurrentValues`,
   which also flushes the blob).
6. **The main chat window has no "Gameplay" filter checkbox** (12 rows), the four floaties do
   (13 rows).
7. **The default tab is Gameplay Options**, not Character (`0x32 = true` on entry 0).
8. Retail's spelling in the UI-facing strings: "Allegiance" in the string table but
   `Allegience` in the symbol name — use the *string table* value for anything user-visible.

### 10.5 Open unknowns for the planner to close or accept

| # | Unknown | Where to look / suggested disposition |
|---|---|---|
| U1 | **What `m_default` is for the Character tab's 49 checkboxes.** `InitOptions` never calls `SetDefaultValue`, so "Defaults" behaviour on the biggest tab is unestablished. | Read `UIOption_Checkbox`'s ctor and `UIOption::InqDefaultGameplayOptionProperty` / `InqGameplayOptionNameAndTooltip`. **Blocking for the Defaults button.** |
| U2 | **Which options are "auto-save"** (immediate `0x0005`) vs batched into the `0x01A1` blob. | `CPlayerModule::IsAutoSaveOption` — enumerate it. This is exactly handoff Q4's discriminator. |
| U3 | Whether acdream ships the **50th Character row** ("Listen to PK death messages", `ID_PlayerOption_HearPKDeaths`, string `0x0D16E9A3` present in the DAT, absent from the 2013 code). | Design call. The string and ACE support exist; only the 2013 wiring is missing. |
| U4 | ~~The exact **`SetSliderLabel` operand pairs** for the Config tab's six labelled sliders.~~ **CLOSED 2026-08-11 (OP6 review + rework).** An intermediate OP6 claim that retail ships ZERO captions was the SAME BN zero-fold artifact as `AddHeader` (the review byte-decoded the `mov ecx/edx,[disp32]` string-id loads at `0x0049E4C6` etc.; the rework independently re-read 2 of 6 sites + the PDB global sequence `0x0083E768`–`0x0083E794`). The six pairs, in declaration order: Stiffness `Soft/Hard`, Adjustment Speed `Slow/Fast`, FOV `Narrow/Wide`, Screen Brightness `Dark/Bright`, Graphics Performance `Speed/Detail`, Degrade Distance `Close/Far`. Implemented in the OP6 rework (`472525b9`). | Evidence: `docs/research/2026-08-11-op6-review.md` M1; the rework commit's own byte log. |
| U5 | Semantics of layout property **`0x57`** (page/window registration) and **`0x58`** (`enum 1` on every options root). | Find the `GetAttribute_Enum(this, 0x57 …)` read. Not blocking — the toggle action can be driven from `0x12` on the buttons. |
| U6 | Consumer of input actions **`0x10000027`** ("Exit Game") and **`0x1000001F`** ("Configure Keyboard"). | Neither has a default keybind. `0x1000001F` is well corroborated by the keyboard screen's OK/Cancel; `0x10000027` rests on the label alone. |
| U7 | The two **`support.turbine.com` URLs** behind Urgent Assistance / Report Abuse. | Dead endpoints. Recommend a **register row**: acdream shows a "not available" notice rather than launching a browser at a dead Turbine host. Extract the exact strings only if the register row needs to quote them. |
| U8 | `gmConfigUI::SetMouseTurningDefaults`'s **full clamp set** (only the `Camera_Stiffness → 0.95f` clamp was read). | `0x0049E8F0`. Needed only if "Use Mouse Turning Settings" ships. |
| U9 | Whether the **Config tab's 27 preference rows** map onto acdream's existing quality/audio settings or need a new retail-shaped preference store. | Design call — see §10.3. The `UserPreferences.ini` key names are all established above, so a faithful store is cheap. |
| U10 | Which `0x2100002B` template `0x10000521` serves (present in the layout, in no template array). | Probably a later-build or unused row style. Non-blocking. |

### 10.6 A suggested slice shape (non-binding)

The natural seams fall out of the structure: (a) the two missing widget primitives —
`Type 8` tab control + `Type 5` ListBox-with-template-list — are a shared prerequisite for
every tab *and* for Configure Keyboard; (b) the `OptionPage`/`PlayerOptionPage` model with its
four verbs is one small, testable unit with no DAT dependency; (c) each tab is then a thin
`InitOptions` transcription against a binding table. The Gameplay tab is the smallest
end-to-end vertical (7 buttons, no option model at all) and would prove the tab host, the
mounting, and the open path in one slice before any option plumbing exists.

---

## Appendix — reproduction notes

- Byte reads: a throwaway `peread.py` in the session scratchpad maps VA → file offset through
  the PE section table of `C:\Users\erikn\Downloads\acclient.exe` (image base from the
  optional header) and dumps raw bytes. `decode_addchild.py` walks a VA range decoding
  `a1 imm32` / `8b 0d|15|1d|35|3d imm32` global loads, `50..57` register pushes,
  `6a xx` / `68 imm32` immediate pushes and `e8 rel32` calls, then prints the last four
  pushed arguments per call — that is how all 25 `AddChild` rows and all 18 `AddHeader`
  operands were recovered.
- DAT reads: a throwaway `OptProbe` console (`net8.0`, `Chorizite.DatReaderWriter` 2.1.7)
  with modes `find` (hunt element ids / types across every `0x21xxxxxx` LayoutDesc),
  `hosts` (find layouts referencing a given `BaseLayoutId`), `dump` (full recursive element +
  property dump), `str` (resolve a name or hash across every `0x23xxxxxx` StringTable) and
  `dumpstr`. **It must construct a `DatCollection`, not a bare `PortalDatabase`/
  `LocalDatabase`** — `LayoutDesc.Unpack` needs the collection to resolve master properties.
- Nothing in the repo was modified except this document.