chore: FFXIV Patch 5.5 "Trail to the Heavens" + LuminaLookup + status-resolver fixes + StatusNameEnglish

[logicallysynced]

Summary

Patch-day support for FFXIV 5.5 "Trail to the Heavens" plus a batch of API additions and resolver bug fixes that surfaced during the cross-language audit work.

Patch-day dependency bumps

Dep	From	To
FFXIVClientStructs	4ad7d0d72	6ea6cd2d1 (~50 commits — Update structs, Update UIModule, Update UIState, Update PlayerState, Update signatures, AddonLookingForGroup rename, CastInfo bitfield migration, Update EventFramework, etc.)
Lumina	7.3.0	7.4.0
Lumina.Excel	7.4.3	7.4.3 (latest published; per-sheet hash-mismatch tolerated by Reader.GameState.EnsureLuminaSheets)

Layout shifts auto-tracked at runtime; only test pins needed bumping

• UIModule.RaptureLogModule 0x19E0 → 0x1AC0
• UIModule.RaptureHotbarModule 0x57B80 → 0x57C60
• PlayerState size 0x908 → 0x920 (harness pin)
• Vector3 size 0xC → 0x10 (FCS gave it SIMD alignment; field offsets X/Y/Z @ 0/4/8 unchanged)

CastInfo bitfield migration absorbed

FCS migrated CastInfo.IsCasting and CastInfo.Interruptible from standalone byte fields to [BitField<bool>] accessors over a single Flags byte, AND made the struct non-marshalable. ActorItemMapper switched from Marshal.OffsetOf<CastInfo> to FieldOffsetReader.OffsetOf; IsCasting1 / IsCasting2 schema offsets now point at Flags; ActorItemResolver does the bit-0 mask. Downstream entry.IsCasting1 semantic preserved.

New public API: Sharlayan.LuminaLookup

Name → universal row id helpers across 10 sheets — inverse of Reader.Lumina's id-to-name helpers.

Method	Resource	Field
WeatherIdFromName	Weather	Name
ActionIdFromName	Action	Name
StatusIdFromName	Status	Name
PlaceNameIdFromName	Zone / field	Name
ContentFinderConditionIdFromName	Duty / instance	Name
ItemIdFromName	Item	Name
BNpcNameIdFromName	Battle NPC	Singular
ENpcResidentIdFromName	Friendly NPC	Singular
MountIdFromName	Mount	Singular
CompanionIdFromName	Minion	Singular
FindRowId<T>(config, name, selector)	Generic escape hatch	caller-provided

One process-wide Dictionary<string, uint> per sheet type, lazy-built across all 4 client languages and unioned with OrdinalIgnoreCase. Pass "Moon Dust", "快晴", or "Mondstaub" and get the same row id back. Per-language failures (hash mismatch during patch-day) silently degrade.

Cross-language consumer safety: StatusNameEnglish

New StatusItem.StatusNameEnglish property — always English regardless of Configuration.GameLanguage. Existing StatusName remains the localized display value. Consumers comparing against hardcoded English literals (statuses.Find(s => s.StatusNameEnglish == "Iron Will")) now stay correct on JP/DE/FR clients.

Audit confirmed StatusName was the only resolver field switching on GameLanguage. Actor names / target names / action names / chat are either locale-neutral (live memory) or display-only with no English-comparison use case.

The duplicated 5-case language switch in both resolvers became a single LocalizationHelper.SelectLocalized call.

Resolver bug fixes

DefaultStatusEffectOffset was reading garbage

ActorItemMapper left DefaultStatusEffectOffset at the default 0, so the resolver's BlockCopy was reading status entries from the start of the Character struct — pure garbage IDs and stale slots. Same bug in PartyMemberMapper (pointed at the StatusManager struct base instead of _status[0], off by 8 bytes for the Owner pointer prefix). Both now resolve StatusManager._status via FieldOffsetReader. Pinned via new integrity test.

Stacks gating

FCS Status.Param documents itself as "stack count for debuffs; food/potion id otherwise; meaningless for ordinary buffs". The mapper read it as Stacks for every status, surfacing arbitrary Param bytes as fake stack counts (e.g. Reduced Rates Stacks=30). Both resolvers now zero Stacks when statusInfo.MaxStacks <= 1, sourced from a new MaxStacks property on Models.XIVDatabase.StatusItem populated from Lumina's Status sheet.

Resilience

• Reader.GameState.EnsureLuminaSheets resolves Weather / BGM / BGMFadeType / BGMFade in independent try/catches — a hash mismatch on one sheet no longer voids the others.
• Harness [4] block probes each typed sheet independently and prints ✓ <RowCount> or ✗ <ExceptionType>: <Message> per sheet so the exact sheet(s) blocked by a schema-version gap are visible.

Test plan

• dotnet test — 179/179 passing (~+43 new tests vs main)
• Debug build + deploy to Chromatics Build Dependencies
• Live verify against patched FFXIV client — 22 scanner keys resolve; per-scene BGM, status names (English + localized), and per-status Stacks all correct
• LuminaLookup smoke test (harness [5]) — Weather / Action / Status / PlaceName / ContentFinderCondition / Item / BNpcName / ENpcResident / Mount / Companion lookups working with English + Japanese inputs

🤖 Generated with Claude Code