acdream/docs/research/2026-08-12-campaign-fa-test-script.md

Campaign FA connected-gate test script

Status: FA3 owes its connected gate. Launch with ACDREAM_LIVE=1 against the local ACE server (testaccount / +Acdream). Anything marked INERT is authored and clickable but deliberately does nothing yet — that is the correct, contracted behavior for this slice (D1), not a bug.

FA3 is the panel SHELL only: mount, F3/F4 open paths, tab switching, all four pages' empty states, and Friends/Squelch read-only lists. Fellowship roster rows, the create-fellowship dialog, live vitals, and every Allegiance swear/break/kick action are FA4/FA5 scope — do not report their absence here.

---

FA3 — the social panel shell

Opening the panel — F3/F4, keyboard only

1. Press F3. The social panel opens on its Allegiance tab (the authored default tab — Allegiance is ALSO the left-most tab drawn on the tab strip, at x=0; the default tab and the left-most tab are the SAME tab, verified by re-deriving the authored tab table directly from the fixture, the live-mount probe, and each page's own P0x57 action-map id — see SocialPanelController's class doc for the full citation. [FA3 fix-round correction, mechanism MF-1] an earlier draft of this script claimed Friends was drawn left-most; that was wrong). No toolbar button opens this panel — retail authors none (lane A §6.1) — so there is nothing to click for this step besides the keybind itself.
2. Press F3 again while the panel is open and already on the Allegiance tab. The panel closes — same toggle-closes-on-repeat-press shape as every other Toggle*Panel action (e.g. F11/Options, Spellbook).
3. Press F4. The social panel opens directly on its Fellowship tab (F4 switches AND opens in one press, even if the panel was closed).
4. With the panel open on Fellowship, press F3. The panel does NOT close — it switches to the Allegiance tab (F3 is scoped to its own tab, not a blanket close). Symmetrically, pressing F4 while open on Allegiance switches to Fellowship rather than closing.
5. Click the panel's own close (X) button, top-right of the window chrome. The panel closes — same action as a repeat F3/F4 press on the already-active tab.
6. Drag the window by its border/chrome; resize it from the BOTTOM edge only. Same shared gmPanelUI geometry policy as every sibling main panel (Options, Character, Inventory, Spellbook, the indicator-detail panels): draggable, resizable from the bottom edge only, remembers its height across a close/reopen within the session.

Exclusivity vs sibling panels

7. Open Character Info (or Inventory, or Options), then press F3. The other panel closes and the social panel opens on Allegiance — the SAME retail gmPanelUI one-active-panel-at-a-time behavior every sibling panel already has (RetailPanelUiController.RegisterMainPanel shares one geometry rectangle across all ten registered main panels).
8. With the social panel open, open Character Info. The social panel closes. Confirms the exclusivity is bidirectional, not just "opening the social panel closes others."

Tab switching

9. Click each of the four tabs (left-to-right authored order: Allegiance, Fellowship, Friends, Squelch — only ONE tab is highlighted "open" at a time. [FA3 fix-round correction, mechanism MF-1] an earlier draft of this script had the order as Friends/Allegiance/Fellowship/Squelch; that was wrong — re-derived directly from the fixture's authored 0x2E tab table). Each switches the visible page; exactly one page is visible at a time. No crash, no stuck state, switching back and forth repeatedly is safe.
10. Note the tab captions read correctly, in this left-to-right order — "Allegiance", "Fellowship", "Friends", "Squelch" — not blank. A blank caption on any tab button would be the #375 missing-string- resolver class of bug; report it immediately if seen.

Fellowship page — empty state

11. On a character with NO fellowship (the default state), open the Fellowship tab. Expect: an editable fellowship-name text field, a Create Fellowship button, and FOUR checkboxes (Ignore Fellowship Requests / Auto-Accept Requests / Share XP / Share Loot — [FA3 fix-round correction, mechanism SF-4] an earlier draft hedged this as "three... a fourth may also be present"; the fixture and the decomp both settle it at four). No member list, no leader/quit/open/recruit/dismiss/disband buttons visible — those belong to the OTHER (in-fellowship) frame, which is hidden. INERT: the Create Fellowship button, the name field, and all four checkboxes do nothing yet on click/edit (FA4 wires the create flow and the checkboxes already have Options-tab live consumers — this page's OWN copies are not yet cross-bound).
12. If the test character IS currently in a fellowship (uncommon for +Acdream's default state, but possible if a prior session left one active), open the Fellowship tab instead expecting: a fellowship name display, a member roster ListBox (empty rows — FA4 populates them), and six buttons (Leader/Quit/Open/Recruit/Dismiss/Disband). All six buttons are INERT for FA3.

Allegiance page — empty state

13. On a character with NO allegiance profile ever received this session (the default state — nothing has queried allegiance data yet), open the Allegiance tab. Expect: the monarch block and patron block BOTH HIDDEN (no visible "Monarch:" / "Patron:" labels or name lines), while your own character line (name/followers/rank) and the vassal list area remain visible per their authored layout. The Swear/Break/Kick buttons and the "Ignore Allegiance Requests" checkbox are present and INERT.
14. This state does NOT change for the rest of this gate — that is the correct, contracted FA3 behavior, not a bug. [FA3 fix-round correction, mechanism MF-2] an earlier draft of this script sent you to @allegiance info expecting it to make the blocks visible, and told you to report it if that didn't happen. That trigger CANNOT fire and the instruction was wrong: FA3 never sends the 0x001F AllegianceUpdateRequest subscription (FA5 scope, per the plan's corrected D6/CF-1 note), and 0x0020 AllegianceUpdate — the ONLY inbound message that can populate this panel's data — is never provoked by anything FA3 does. Running @allegiance info in chat still works exactly as before FA3 (it is an independent, already- shipped command) and WILL print your monarch/patron/vassal data as chat TEXT — but its response (0x027C) stopped seeding this panel's profile back in FA2 (4272ad0e), so it has zero effect on this page. The correct, expected combination for this entire gate is: @allegiance info prints real data to the chat window (if you have an allegiance), AND the Allegiance page's monarch/patron blocks stay hidden throughout — report NEITHER half as a bug. The panel blocks becoming visible at any point during this gate (see "What to report" below) is the actual anomaly to watch for.

Friends page — read-only list

15. Open the Friends tab. If the test account has any friends server-side, their NAMES appear as rows in the list (no online/ offline styling, no icons — names only, this slice's explicit scope). If the account has none, the list is empty (no placeholder text is invented).
16. The three action-shaped buttons and the "Appear Offline"-shaped checkbox are INERT — clicking/toggling them does nothing (register row AD-79). This is CONTRACTED for FA3; do not report it.

Squelch page — read-only list

17. Open the Squelch tab. If the test account has any squelched characters or accounts, their names appear as rows (characters and account-level squelches both listed, names only). Empty otherwise.
18. The three action-shaped buttons are INERT (register row AD-79, same as Friends). CONTRACTED, do not report.

Scrolling a long roster

[FA3 fix-round addition, blast N-8/MF-1] the two ListBoxes' own scrollbars were unwired until this fix round — completely unreachable past the visible extent, not merely awkward to use. This step exercises the fix directly.

19. If the test account's Friends or Squelch roster is longer than fits in the panel's visible area (the Friends box is 270×400 but the panel itself is only ~300×362, so as few as a dozen or so entries can already overflow — check either tab), drag the scrollbar thumb (or click the track/arrows) and confirm the rows scroll and every name remains reachable, all the way to the last row. This is a soft check if the test account's roster is genuinely too short to overflow — do not manufacture a long roster just to exercise this step, but if the roster IS long enough, a scrollbar that does not move the list, or a list that will not scroll at all, IS a bug — report it.

Live update while the panel is closed

20. This is a soft check, not required to pass/fail the gate: if Friends/Squelch state changes server-side while the social panel is CLOSED (e.g. via @friend chat commands, if any are wired), then reopening the panel afterward should show the up-to-date list immediately (the read-only binding polls every frame WHILE THE PANEL IS VISIBLE — [FA3 fix-round correction, blast SF-2] an earlier draft of this script said the poll runs "regardless of which tab or window is visible"; that changed in the fix round — the rebuild is now gated on the social panel's own visibility so it does no DAT work while closed, but it still catches up in full the moment the panel is shown again, so the user-visible outcome described here is unchanged. See SocialFriendsPageController/ SocialSquelchPageController's own doc comments). Report if the list is stale on reopen.

Window restore-open behavior across relaunch

[FA3 fix-round addition, blast N-8] stated honestly rather than left untested: the social panel is NOT in acdream's short list of windows whose OPEN/CLOSED state is force-reset every session (stateManagedVisibilityWindows — Combat/JumpPowerbar/ ExternalContainer/Vendor). This is a deliberate, documented choice (the FA seams doc), and it matches the EXACT SAME convention every sibling main panel already uses — Options, Spellbook, Character, Inventory, and Vitae all restore their own last open/closed state too.

21. Open the social panel (F3 or F4), then close the client and relaunch (or simply log out and back in without closing the window). The EXPECTED, non-bug behavior is that the social panel reopens automatically in whatever tab/open state it was left in — the SAME restore-open behavior every other main panel already has. This is not something to report; it is only listed here so the behavior is understood in advance rather than surprising anyone mid-gate.

---

What to report

• Any tab caption that renders blank instead of its retail name.
• The panel opening on the wrong DEFAULT tab (should be Allegiance, and Allegiance is also the left-most tab) on a fresh F3 press with the panel previously closed.
• F3/F4 failing to switch tabs while the panel is already open, or closing the panel when it should only switch tabs.
• The panel NOT closing/opening exclusively with sibling gmPanelUI panels (Character/Inventory/Options/etc.).
• The Fellowship page showing the WRONG frame for the character's actual fellowship state (e.g. showing the roster/six-button frame while +Acdream has no fellowship).
• The Allegiance page's monarch/patron blocks becoming VISIBLE at ANY point during this gate — there is no code path in FA3 that can make that happen (see step 14); if it happens, that is a real bug (an accidental wire connection), not the false-defect trigger an earlier draft of this script pointed at.
• Any INERT button/checkbox producing a VISIBLE effect (a Create Fellowship, Swear, Friends, or Squelch action that unexpectedly does something) — this would mean either an accidental wire connection or a stale INERT claim in this script.
• A Friends/Squelch row showing anything other than a plain name (an exception, a blank row, garbled text).
• A Friends/Squelch scrollbar that does not move the list, or a longer-than-visible roster with no way to reach its later rows (step 19) — only when the test account's roster is actually long enough to overflow.
• Any crash, hang, or exception in the log while opening/closing/ switching tabs repeatedly.

Explicitly NOT in scope for this gate

• Fellowship roster population, vitals, the create-fellowship dialog, recruit/dismiss/leader/open/disband wire sends, and the option-row un-dims (FA4).
• Allegiance monarch/patron/vassal LIVE population, swear/break/kick wire sends, and their confirmation dialogs (FA5).
• Friends/Squelch add/remove/appear-offline/clear wire sends (D1 — out of campaign scope entirely, register row AD-79).
• The bot-vs-ACE two-session fellowship gate (FA6).