# ACPlugin event coverage — 2026-05-27

**ACPlugin PR-1 deliverable** (per
[`chorizite-reading-guide-summary-2026-05-27.md`](chorizite-reading-guide-summary-2026-05-27.md)
row §1 #1 + `external/chorizite/ACPlugin/READING_GUIDE.md` §9 last
bullet). Catalogues every `_net.S2C.On*` handler in
`external/chorizite/ACPlugin/API/World.cs` ctor (lines 88-133) and
`external/chorizite/ACPlugin/API/WorldObjects/Character.cs` ctor (lines
182-222) and matches each against our existing wasm `poll_events()` /
`plugins/api.js` bus surface.

**Status legend:**

| | Meaning |
|---|---|
| `Y` | Surfaced as a distinct kind (or bus event) with equivalent payload |
| `Partial` | We surface something adjacent (coalesced kind, missing fields, or different shape) |
| `N` | Not surfaced anywhere; PR-2 / Wave E gap |

**Source:** the 40 World handlers + 40 Character handlers + 2
`Game.cs` state machine handlers + 7 `PatchProgress.cs` connectivity
handlers (= **89 dispatch surfaces** total, larger than the "40+"
estimate). For symmetry with the original audit in `plugins/api.js`
header, this doc treats the 18 user-facing event SURFACES (the
`event EventHandler<TArgs>` declarations) as the primary axis and
breaks the underlying handler dispatch down per-event.

This IS the input list for PR 2 (`World.cs` S2C dispatch port) and
Wave E (wire-format gaps); each `N` row is a candidate.

---

## A. World.cs S2C handlers (40 entries — `World.cs:88-133`)

Each row is one `_net.S2C.OnXxx += OnXxx` line in the `World()` ctor.

| # | Handler (S2C event) | Opcode (est.) | Our kind / bus | Status | Notes |
|---|---|---|---|---|---|
| 1 | `OnItem_CreateObject` | 0x00F745 (GameEvent inner Item_CreateObject) | `kind=1` EntityUpdate (SPAWN) + `kind=11` InventoryUpdated + `objectCreated` bus | Y | **PR-2 (2026-05-27):** `plugins/world-state.js::dispatchItemCreateObject` now fires `objectCreated` with the typed WorldObject instance. Routes through PR 1's setters (`updateObjDesc`/`updatePhysicsDesc`/`updateWeenieDesc`). |
| 2 | `OnItem_DeleteObject` | 0x00F747 | `kind=2` REMOVE + `objectReleased` bus | Y | **PR-2 (2026-05-27):** `plugins/world-state.js::dispatchItemDeleteObject` fires `objectReleased` + recursively releases container children (matches `World.cs:734-770`). |
| 3 | `OnItem_ObjDescEvent` | 0x00F74C | `kind=8` `playerStatsUpdated` (coalesced) + `objDescChanged` bus | Partial | **PR-2 added the bus event** via `dispatchObjDescUpdate` — but the WIRE-level coalesce into kind=8 means remote-player ObjDesc swaps still ride the stats-refresh signal. Stays Partial until a dedicated kind splits clothing/jewelry/armor visual swaps from stats. Renderer impact: high. |
| 4 | `OnItem_ParentEvent` | 0x00F751 | `kind=8` (coalesced via re-snapshot) + `itemParentChanged` bus | Y | **PR-2 (2026-05-27):** `dispatchItemParent` sets `PropertyInstanceId.Wielder` via PR 1's `setInstanceValue` (with same-value short-circuit) and fires the bus event. Equip/wield consumers can subscribe directly. |
| 5 | `OnItem_ServerSaysContainId` | 0x00F75A | `kind=11` InventoryUpdated + `itemContainerChanged` bus | Y | **PR-2 (2026-05-27):** `dispatchServerSaysContainId` routes through `setInstanceValue(PROP_INSTANCE_CONTAINER, ...)` + fires per-item bus event. Per-item move toast can now subscribe — no more polling. |
| 6 | `OnItem_ServerSaysMoveItem` | 0x00F75B | `kind=11` (coalesced) | Partial | See row 5 — wasm-side wire still coalesces (no dedicated kind), but PR-2's WorldState surfaces it through the same `itemContainerChanged` channel when the host forwards. |
| 7 | `OnItem_ServerSaysRemove` | 0x00F73C | `kind=2` REMOVE + `objectReleased` bus | Y | Same path as DeleteObject (PR-2 unified). |
| 8 | `OnInventory_PickupEvent` | 0x00F74A | `kind=11` (coalesced via InventoryUpdated) | Partial | Currently only logged via `_log.LogError` in upstream Chorizite (`World.cs:303`). Could surface as `itemPickedUp` if useful. |
| 9 | `OnItem_OnViewContents` | 0x00F750 (assumed; opcode confirm-pending) | `kind=12` vendorOpened + `kind=21` containerOpened | Y | **PR-2 (2026-05-27) fixed the load-bearing race** — `plugins/world-state.js::dispatchContainerOpened` now implements the child-wait gate per `World.cs:212-249`. Pre-PR-2 the JS side fired `containerOpened` immediately; now it defers until every listed child's `objectCreated` has arrived. Confirmed race was real (the handoff §3 first quote was correct; not a hypothetical). |
| 10 | `OnItem_StopViewingObjectContents` | 0x00F752 | `kind=31` ContainerClosed (NEW) + `containerClosed` bus | Y | **PR-2 (2026-05-27):** new wasm kind=31 emitted on `WorldEvent::ContainerClosed`. JS drain forwards to `containerClosed` bus event; `WorldState::dispatchContainerClosed` clears `openContainer` + fires the typed event. Open/close lifecycle now symmetric. |
| 11 | `OnLogin_PlayerDescription` | 0x00F745 (Login_PlayerDescription inner) | `kind=8` playerStatsUpdated + `kind=11` InventoryUpdated | Partial | First-arrival inventory profile decoded; the World handler in ACPlugin also seeds `Character.Containers` for child packs — our handler should mirror. PR-4 / Character.cs port. |
| 12 | `OnItem_SetAppraiseInfo` | 0x00C9 | `kind=32` ObjectAppraised (NEW) + `objectAppraised` bus | Y | **PR-2 (2026-05-27) — HIGH renderer impact closed.** New wasm kind=32 emitted on every `WorldEvent::EntityIdentified` (previously only portals emitted kind=3 META_REFRESH). `WorldState::dispatchSetAppraiseInfo` folds the bool/int/int64/float/string/dataId/spellBook properties through PR 1's `setIntValue`/`setStringValue`/etc. setters. /assess UI, vendor tooltips, examine popovers unblocked. |
| 13 | `OnItem_SetState` | 0x00F76A | `kind=15` DoorStateChanged + `kind=17` EntityVisibilityChanged + `itemStateChanged` bus | Y | **PR-2 (2026-05-27):** `dispatchSetState` routes through PR 1's `setIntValue(PROP_INT_PHYSICS_STATE, newState)` + fires `itemStateChanged` with `{previousState, newState}` deltas. Door + visibility wires continue to fire kind=15/17 in parallel. |
| 14 | `OnItem_UpdateObject` | 0x00F748 | `kind=1` EntityUpdate (re-spawn) + `dispatchObjectUpdate` | Partial | **PR-2 added in-place property refresh** via `dispatchObjectUpdate` (folds all 3 desc blobs through PR 1 setters without spawn churn). Wire still routes through the re-spawn path for renderer entity-store consistency; status stays Partial until the wasm side splits the wire arms. |
| 15 | `OnItem_UpdateStackSize` | 0x00F74B | `kind=11` InventoryUpdated + `stackSizeChanged` bus | Y | **PR-2 (2026-05-27):** `dispatchUpdateStackSize` routes through both `setIntValue(PROP_INT_STACK_SIZE, ...)` AND `setIntValue(PROP_INT_VALUE, ...)` per `World.cs:358-366`. Stack badges + value-display can subscribe directly. |
| 16 | `OnItem_WearItem` | 0x00F73E | `kind=8` + `kind=11` (coalesced) | Partial | Wielding mechanically works (server says equipped). Visual swap on local + remote players covered via ObjDesc (row 3). |
| 17 | `OnItem_QueryItemManaResponse` | 0x00C8 | — | N | Item mana query response not surfaced. Low priority (used by item-info HUD only). |
| 18 | `OnQualities_RemoveBoolEvent` | 0x01D1 | — | N | Quality-removal events not surfaced (Wave E §5.1: "Qualities_*Remove*Event family 0x01D1–0x01DE + 0x02B8/0x02B9 — biggest batch"). Low impact unless server explicitly clears flags. |
| 19 | `OnQualities_RemoveDataIdEvent` | 0x01D2 | — | N | Same batch as 18. |
| 20 | `OnQualities_RemoveFloatEvent` | 0x01D3 | — | N | Same batch as 18. |
| 21 | `OnQualities_RemoveInstanceIdEvent` | 0x01D4 | — | N | Same batch as 18. |
| 22 | `OnQualities_RemoveInt64Event` | 0x01D5 | — | N | Same batch as 18. |
| 23 | `OnQualities_RemoveIntEvent` | 0x01D6 | — | N | Same batch as 18. |
| 24 | `OnQualities_RemovePositionEvent` | 0x01D7 | — | N | Same batch as 18. |
| 25 | `OnQualities_RemoveStringEvent` | 0x01D8 | — | N | Same batch as 18. |
| 26 | `OnQualities_UpdateAttribute2ndLevel` | 0x01EC | `kind=8` playerStatsUpdated | Partial | Coalesced; no per-vital delta (`api.js:94-95` TODO). PR-4 should split. |
| 27 | `OnQualities_UpdateAttribute2nd` | 0x01EB | `kind=8` (coalesced) | Partial | Same as 26. |
| 28 | `OnQualities_UpdateAttributeLevel` | 0x01EA | `kind=8` (coalesced) | Partial | |
| 29 | `OnQualities_UpdateAttribute` | 0x01E9 | `kind=8` (coalesced) | Partial | |
| 30 | `OnQualities_UpdateBool` | 0x01D9 | `kind=8` (coalesced) | Partial | |
| 31 | `OnQualities_UpdateDataId` | 0x01DC | `kind=8` (coalesced) | Partial | |
| 32 | `OnQualities_UpdateFloat` | 0x01DA | `kind=8` (coalesced) | Partial | |
| 33 | `OnQualities_UpdateInstanceId` | 0x01DE | `kind=8` (coalesced) | Partial | |
| 34 | `OnQualities_UpdateInt64` | 0x01DD | `kind=8` (coalesced) | Partial | |
| 35 | `OnQualities_UpdateInt` | 0x01DB | `kind=8` (coalesced) | Partial | |
| 36 | `OnQualities_UpdatePosition` | 0x01E0 | `kind=8` (coalesced) | Partial | |
| 37 | `OnQualities_UpdateSkillAC` | 0x01EE | `kind=8` (coalesced) | Partial | |
| 38 | `OnQualities_UpdateSkillLevel` | 0x01ED | `kind=8` (coalesced) | Partial | |
| 39 | `OnQualities_UpdateSkill` | 0x01EF | `kind=8` (coalesced) | Partial | |
| 40 | `OnQualities_UpdateString` | 0x01DF | `kind=8` (coalesced) | Partial | |

**World.cs subtotal:** 10 Y / 21 Partial / 9 N (out of 40). *PR-2 (2026-05-27): +9 Y promotions (rows 1, 2, 4, 5, 9 reaffirmed, 10, 12, 13, 15 newly Y).*

The big partial cluster is the 14 `Update*` quality-updates (rows
26-40, except 36 which uses position). All collapse into `kind=8
playerStatsUpdated` — Wave C.2 already added 13 wasm exports that
let JS callers re-read derived attributes/vitals/skills on demand,
so the "missing per-vital delta" gap is reducible to "coalesced
notification + on-demand recompute" rather than "data missing."

---

## B. Character.cs S2C+C2S handlers (40 entries — `Character.cs:182-222`)

| # | Handler (S2C/C2S event) | Opcode (est.) | Our kind / bus | Status | Notes |
|---|---|---|---|---|---|
| 1 | `OnLogin_SendEnterWorld` (C2S echo for `Id`) | 0xF657 | `kind=4` GameStarted / `kind=5` CharacterSelect | Y | Character.id captured from session handle. |
| 2 | `OnLogin_PlayerDescription` | 0x00F745 (Login inner) | `kind=8` + `kind=11` + Character.applyLoginPlayerDescription | Y | **PR-4 (2026-05-27):** `Character.applyLoginPlayerDescription` folds the full Base+Qualities cascade (options + 8 PropertyXxx maps + attributes + vitals + skills + enchantments). World.cs entry covers inventory; Character.cs entry covers stats. Wave C.2 wasm exports power the derived values. |
| 3 | `OnLogin_LogOffCharacter` | 0xF7CB | `kind=6` LoggingOut | Y | |
| 4 | `OnEffects_PlayerTeleport` | 0xF748 (Effects_PlayerTeleport assumed) | `kind=33` PortalSpaceEntered (NEW) + `portalSpaceEntered` bus + Character.applyEffectsPlayerTeleport | Y | **PR-4 (2026-05-27):** new wasm kind=33 emitted from the recv-loop `PlayerTeleport` arm (alongside the existing LoginComplete dispatch). JS drain forwards into Character via `world.dispatchEffectsPlayerTeleport` + emits `portalSpaceEntered` bus. Loading-screen overlay can now subscribe directly. |
| 5 | `OnItem_SetState` (Character variant — checks PhysicsState.Hidden for self only) | 0x00F76A | `kind=7` ENTERED_WORLD + `kind=17` EntityVisibilityChanged + Character.applyItemSetState | Y | **PR-4 (2026-05-27):** Character checks `objectId == self && !(newState & Hidden)` per `Character.cs:461-466`. Fires `portalSpaceExited` on the Character bus; combined with kind=33 (entered), portal-space edges are now symmetric. |
| 6 | `OnCombat_HandlePlayerDeathEvent` | 0xF6C8 | `kind=29` death + Character.applyCombatHandlePlayerDeath | Y | Q1a (2026-05-26) shipped. PR-4 forwards into typed Character (self-filter via `victimId == self`). |
| 7-20 | `OnQualities_PrivateRemove/Update {Bool,Int,Int64,Float,String,InstanceId,DataId} (14 handlers)` | 0x0259-0x0269 (Private quality family — `Character.cs:191-204`) | Character.private{Update,Remove}{Int,Int64,Float,Bool,String,Instance,Data} + WorldState.dispatchCharacterPrivateQuality | Y | **PR-4 (2026-05-27):** the Character class now exposes the 14 `private*` setters routing through the inherited WorldObject typed-dict setters. WorldState exposes `dispatchCharacterPrivateQuality(kind, op, key, value)` so the host can route private-only quality updates here instead of into the shared WorldObject store. Per handoff §3 row 6 — the routing target is Character, NOT World; the inherited setters are the property store. Wire-side decoder still uses the public quality kind (no wasm-side private fan-out yet — Wave E if needed); for now the dispatch is API-complete for any caller that knows the update is private. |
| 21-28 | `OnQualities_PrivateUpdateAttribute*/SkillAC/SkillLevel/Skill (8 handlers)` | 0x0270-0x0278 (Private quality family — `Character.cs:205-211`) | Character.{updateAttribute, updateAttributePointsRaised, updateSkill, updateSkillTraining, updateSkillPointsRaised, updateVital, updateVitalCurrent, updateVitalPointsRaised} + WorldState dispatchers | Y | **PR-4 (2026-05-27):** all 8 typed-private handlers wired. The Character's typed `attributes/skills/vitals` Maps mirror the C# `Character.Attributes / Skills / Vitals` dicts byte-for-byte. WorldState forwards via `dispatchCharacterUpdate{Attribute, Skill, Vital, ...}` methods. **Load-bearing: UpdateVital even/odd parity** (`Character.cs:721` — handoff §3 row 5) ported exactly. Wave C.2 wasm exports (`computeAttributeCurrent`/`computeVitalMax`/`computeSkillCurrent`) consumed in Character.{currentAttribute, maxVital, currentSkill}. |
| 29-30 | `OnQualities_PrivateRemovePositionEvent / PrivateUpdatePosition (2 handlers)` | 0x0258 / 0x0257 | Character.{privateUpdatePosition, privateRemovePosition} | Y | **PR-4 (2026-05-27):** trivial passthrough to the inherited `setPositionValue` / `removePositionValue`. The position-quality slots arrive on the wire as PropertyPosition updates; the routing target is the Character per `Character.cs:212-213` (private), distinct from the World public path. |
| 31 | `OnMagic_DispelEnchantment` | 0x02C5 | Character.removeEnchantment + WorldState.dispatchCharacterRemoveEnchantment | Partial | **PR-4 (2026-05-27):** the Character now exposes `removeEnchantment(layeredId)` and WorldState exposes `dispatchCharacterRemoveEnchantment`. Wire-side: the dispel still flows through the existing `PlayerEnchantmentsUpdated` snapshot-diff (PR-2 path) which detects removals via set-difference. Stays Partial because the wire-level wrapper events (target_guid + sequence for remote-creature dispels) aren't surfaced — only local player. |
| 32 | `OnMagic_DispelMultipleEnchantments` | 0x02C6 | Character.applyMagicRemoveMultipleEnchantments + WorldState.dispatchCharacterRemoveMultipleEnchantments | Partial | Same coverage as row 31 — bulk variant. |
| 33 | `OnMagic_PurgeBadEnchantments` | 0x0312 | Character.applyMagicPurgeBadEnchantments + WorldState.dispatchCharacterPurgeEnchantments(/*badOnly=*/true) | Partial | **PR-4 (2026-05-27):** `Character.cs:593-600` ported — wipes `duration>0 && statValue<0` entries. Wire-side trigger needs Wave E for the explicit purge packet; the snapshot-diff covers the resulting state in the meantime. |
| 34 | `OnMagic_PurgeEnchantments` | 0x02C8 | Character.applyMagicPurgeEnchantments + WorldState.dispatchCharacterPurgeEnchantments | Partial | **PR-4 (2026-05-27):** `Character.cs:584-591` ported — wipes all `duration>0` entries. Same Wave E wire-trigger gap as row 33. |
| 35 | `OnMagic_RemoveEnchantment` | 0x02C4 | Character.removeEnchantment | Partial | Same coverage as row 31 — the C# handler dispatches the same `RemoveEnchantment` path. |
| 36 | `OnMagic_RemoveMultipleEnchantments` | 0x02C7 | Character.applyMagicRemoveMultipleEnchantments | Partial | Bulk variant of row 35. |
| 37 | `OnMagic_UpdateEnchantment` | 0x02C2 | `kind=8` + `enchantmentAdded` / `enchantmentRemoved` / `enchantmentsChanged` bus + Character.allEnchantments | Y | **PR-4 (2026-05-27):** completes the snapshot→Character bridge. `WorldState.dispatchEnchantmentSnapshot` now folds the snapshot into `world.character.allEnchantments` AND fires per-enchantment Added/Removed deltas. The Character's load-bearing tiebreak (`Character.cs:232-239` — handoff §3 row 7) resolves which entry wins per `(spell_category, layer)`. Cooldown discriminator (`Character.cs:619`) routes COOLDOWN-flagged entries to `sharedCooldowns` instead. Wire-level wrapper events (target_guid + sequence) for remote-creature buffs remain a Wave E item; self-buff add/remove is fully covered. |
| 38 | `OnMagic_UpdateMultipleEnchantments` | 0x02C3 | `kind=8` + delta bus + Character.applyMagicUpdateMultipleEnchantments | Y | Same coverage as row 37. Bulk variant; per-entry routing identical. |

**Character.cs subtotal:** 30 Y / 6 Partial / 0 N (out of 40). *PR-4 (2026-05-27) promotions: rows 2, 4, 5, 7-30 (24 PrivateUpdate*), 37-38 → Y; rows 31-36 (6 Magic_Remove/Dispel/Purge) → Partial. Net delta: 3 Y / 4 Partial / 33 N → **30 Y / 6 Partial / 0 N**.*

**Remaining 6 Partials all share one cause:** the wire-level wrapper events for REMOTE-creature buff/cooldown tracking aren't surfaced — only the local-player active list rides the kind=8 snapshot. Wave E delivers the per-target packet wrappers needed for the full buff/debuff HUD against arbitrary entities; PR 4 closes the entire local-player Character API in the meantime.

---

## C. Game.cs state machine handlers (2 entries)

| # | Handler | Opcode | Our kind / bus | Status | Notes |
|---|---|---|---|---|---|
| 1 | `OnStateChanged` (synthesized from 4 wire events) | — | `kind={1,4,5,6,7}` split | Partial | We surface state TRANSITIONS as 5 different kinds but no single unified "stateChanged {old, new}" bus event (`api.js:92` TODO). PR-2 should add a unified channel + the `GameStateChanged` factory (already shipped in PR-1). |
| 2 | `OnCharactersChanged` (re-fire roster) | — | `kind=0` CharacterListRecv | Y | Wired; renderCharacterList drains every fire. |

---

## D. PatchProgress.cs handlers (3 entries — out of scope)

`PatchProgress.OnProgressChanged / OnConnectProgress / OnPatchProgress`
(`PatchProgress.cs:12-132`) — N/A for browser. We ship pre-built DATs;
no patcher/connect-handshake events. Listed for completeness only.

---

## E. Aggregate scoring (excluding PatchProgress N/A)

| Source | Total | Y | Partial | N |
|---|---|---|---|---|
| World.cs S2C | 40 | 10 | 21 | 9 |
| Character.cs (S2C+C2S) | 40 | 30 | 6 | 0 |
| Game.cs | 2 | 1 | 1 | 0 |
| **Total (post-PR-4 2026-05-27)** | **82** | **41** | **28** | **9** |

| Source | Total | Y | Partial | N |
|---|---|---|---|---|
| Post-PR-2 baseline (for reference) | 82 | 14 | 26 | 42 |
| **Pre-PR-2 baseline (for reference)** | **82** | **5** | **32** | **45** |

PR-2 newly-Y promotions (10 total):
1. `OnItem_CreateObject` — added `objectCreated` bus event.
2. `OnItem_DeleteObject` — added `objectReleased` bus event + recursive child release.
3. `OnItem_ParentEvent` — dedicated `itemParentChanged` event with setInstanceValue routing.
4. `OnItem_ServerSaysContainId` — dedicated `itemContainerChanged` per-item event.
5. `OnItem_OnViewContents` — child-wait gate fix (was Y by name but race was unfixed).
6. `OnItem_StopViewingObjectContents` — NEW kind=31 wire + `containerClosed` bus event.
7. `OnItem_SetAppraiseInfo` — NEW kind=32 wire + property-folding via PR 1 setters.
8. `OnItem_SetState` — dedicated `itemStateChanged` with prev/next state.
9. `OnItem_UpdateStackSize` — dedicated `stackSizeChanged` event.
10. `OnItem_ServerSaysRemove` — unified through PR 1 setter path.

The 14 Y's: rows 1, 2, 4, 5, 7, 9, 10, 12, 13, 15 from World.cs + rows 1, 3, 6 from Character.cs + row 2 from Game.cs.

The 32 Partials are dominated by the quality-update family (40 entries
collapsed into `kind=8` playerStatsUpdated), and 10 World.cs "we
surface adjacent data but not this exact event" rows.

---

## F. Top 5 N's by renderer impact (updated post-PR-2 2026-05-27)

Ordered for PR-3 / PR-4 / Wave E execution priority. Items #2 and #3
from the original PR-2 brief shipped; #1 partially shipped via JS-side
diff (need wire-level wrapper for remote-creature buffs).

| Rank | Handler | Opcode | Renderer / UI impact | Wave / PR target |
|---|---|---|---|---|
| 1 | `OnMagic_DispelEnchantment` / `Dispel*Multiple` / `Purge*Enchantments` | 0x02C4 / 0x02C5 / 0x02C6 / 0x02C7 / 0x02C8 / 0x0312 | Remote-creature buff-bar tracking + explicit dispel-toast events. Self-buff add/remove now Partial via PR-2 JS-side diff; this is the next gap. | Wave E batch 1 (wire-level wrapper events with target_guid) |
| 2 | `OnEffects_PlayerTeleport` | 0xF748 | `portalSpaceEntered` not wired — loading-screen overlay edge missing. | PR-4 (Character.cs port) |
| 3 | 24 Private quality updates (`PrivateUpdate*` family) | 0x0257-0x0278 | Strict server-confirmed-only updates blocked (skill train confirmation, fellowship invites, etc.). Per handoff §3 second quote — don't merge with public family. | PR-4 (Character.cs port — different dispatch target) |
| 4 | 8 `Qualities_Remove*Event` family | 0x01D1-0x01D8 | Server-initiated quality clears not surfaced; rare in normal play but blocks ACE admin-toolkit + edge gameplay flows. | Wave E batch 2 |
| 5 | `OnInventory_PickupEvent` | 0x00F74A | Bus event `itemPickedUp` missing — useful for autoloot plugin authoring; low gameplay impact. | Wave E batch 2 |

The remaining N's (Item_QueryItemManaResponse + lifecycle tail) are
plugin-author convenience rather than user-facing renderer blockers.

---

## G. Out-of-band ClientEvent kinds (browser-only)

These have no Chorizite analogue and exist solely to drive browser-side
plumbing (no PR-2 / Wave E action needed). For completeness, mirrors
the comment at `api.js:38-47`:

- `kind=2` ChatReceived
- `kind=11` InventoryUpdated (coalesced)
- `kind=13` UseFailed (WeenieError; would be a Character.OnUseFailed event)
- `kind=14` UseDone (server-ack success)
- `kind=15` DoorStateChanged
- `kind=16` SoundTriggered
- `kind=17` EntityVisibilityChanged
- `kind=18` EntityAirborneChanged
- `kind=19` CombatEvent (5 sub-events: damageDealt / damageTaken / evadedTarget / evadedAttacker / attackDone)
- `kind=29` Death

---

## H. Method note

The opcode estimates in columns 3 are from cross-referencing
`Chorizite.ACProtocol/protocol.xml` against the C# handler names
(format: `<event name="OnXxx">` ⇒ handler `OnXxx`). They are NOT
re-confirmed against our wasm dispatcher; PR-2 + Wave E execution
should grep `external/holtburger/crates/holtburger-protocol/src/messages/`
to confirm exact opcode mapping before adding new ClientEvent kinds.

The Y / Partial / N tagging is BEST-EFFORT from reading
`plugins/api.js` (canonical post-Wave-D.1 surface) + our existing
`coverage table 18-row audit` at `api.js:18-65`. The original audit
covered 18 user-facing EventArgs; this expanded view covers all 82
S2C/C2S handler subscriptions for symmetry with PR-2 dispatch
scope. Numbers diverge from the original (3 Y / 6 Partial / 6 N / 3 N/A)
because:

1. **Granularity differs.** Original counted 18 user-facing events
   (1 per `event EventHandler<TArgs>` declaration in C#). This doc
   counts 82 underlying `_net.S2C.OnXxx += handler` subscriptions.
   Same wire — different axis.
2. **PartialCounts as overflow.** Where the 18-row audit said
   "PARTIAL" once for the whole enchantment family, this doc counts
   8 N's (one per `OnMagic_*` handler).
3. **Quality-update family.** Original audit didn't split the 14
   quality-update handlers; this doc lists each.

Cross-validate against the original `plugins/api.js:18-65` audit
before pulling into PR-2 commit messages.

---

## I. PR-2 shipped (2026-05-27) — what changed

**Files shipped:**
- `apps/holtburger-web/plugins/world-state.js` (NEW, 818 LOC) — `WorldState`
  class porting `World.cs:1-820`. Weenies Map + Get/Exists + container-open
  child-wait gate + 11 dispatcher methods + JS-side enchantment-snapshot
  diff engine. Bound onto `client.world` and integrated with the existing
  `client.events` bus via `bindWorldStateToClient`.
- `apps/holtburger-web/plugins/api.js` (EDIT, +75 LOC) — exposes `WorldState`,
  adds `client.player.enchantments()`, replaces `client.world` (renderer
  scene queries grafted on for back-compat as `client.scene`).
- `apps/holtburger-web/src/lib.rs` (EDIT, +66 LOC) — 2 new
  `CLIENT_EVENT_KIND_*` constants (31 ContainerClosed, 32 ObjectAppraised)
  + dispatch arms in the recv-loop's `WorldEvent` match (split
  ContainerClosed out of the OR + augmented EntityIdentified).
- `apps/holtburger-web/index.html` (EDIT, +37 LOC) — drainEvents loop forwards
  kind=31/32 onto `client.events.emit('containerClosed' | 'objectAppraised', …)`.
- `apps/holtburger-web/tests/world-state.test.cjs` (NEW, 423 LOC) — 38 assertions
  across 10 phases. All PASS.
- `external/holtburger/docs/acplugin-event-coverage-2026-05-27.md` (this doc).

**Validation runs:**
- `node tests/world-state.test.cjs`: 38/38 PASS.
- `node tests/world_object.test.cjs`: 80/80 PASS (regression).
- `node tests/inventory_paperdoll_helpers.test.cjs`: 36/36 PASS (regression).
- `node tests/world_object_property_dict.test.cjs`: 24/24 PASS (regression).
- `cargo test -p holtburger-web --lib`: 57/57 PASS.
- `cargo test -p holtburger-protocol --lib`: 286/286 PASS.
- `cargo check --target wasm32-unknown-unknown --lib`: PASS.
- `node validate_wire_conformance.cjs`: 31/31 PASS (no fixtures added — wire
  for kind=31/32 piggybacks existing CloseGroundContainer + IdentifyObjectResponse).

**Matrix delta:** 5 Y / 32 Partial / 45 N → **14 Y / 26 Partial / 42 N**.

**Out-of-scope deferred:**
- PR 3 — typed-subclass hierarchy refinements (`Container.items` /
  `Container.containers` read-through getters, `SetWielded` helper).
- PR 4 — `Character.cs` private-quality dispatch (24 PrivateUpdate*
  handlers) + portalSpaceEntered/Exited.
- Wave E — `Magic_DispelEnchantment` / `Purge*` wire-level wrappers
  for REMOTE-creature buff tracking (self-buff add/remove already
  covered via PR-2 JS diff).
- Bus event `itemPickedUp`, `worldInfo`, `stateChanged` unified.

---

## J. PR-4 shipped (2026-05-27) — what changed

**Files shipped:**
- `apps/holtburger-web/plugins/world-objects/character.js` (EDIT, 15 LOC stub
  → ~800 LOC) — full `Character.cs` port extending Container. Owns
  `skills`/`attributes`/`vitals` typed dicts + `allEnchantments`/
  `sharedCooldowns` + `vitae` setter (1.0=none semantics) + 7-event bus
  (vitaeChanged, vitalChanged, enchantmentChanged, sharedCooldownChanged,
  portalSpaceEntered/Exited, death). Wave C.2 wasm exports
  (`computeAttributeCurrent`/`computeVitalMax`/`computeSkillCurrent`) drive
  `currentAttribute`/`maxVital`/`currentSkill` derived getters with
  defensive fallback when wasm is unavailable.
- `apps/holtburger-web/plugins/world-state.js` (EDIT, +~150 LOC) — adds
  `setLocalPlayerGuid(guid)` + retro-upgrade path; `dispatchItemCreateObject`
  branch spawns `Character` when guid matches the local player; 13 new
  Character forwarding dispatchers (login/death/portalspace/itemstate +
  attribute/skill/vital updates + enchantment apply/remove/purge + 14-way
  private quality router); enchantment snapshot diff now also folds into
  `world.character.allEnchantments`.
- `apps/holtburger-web/plugins/api.js` (EDIT, +12 LOC) — `client.character`
  getter exposes `world.character` for plugins.
- `apps/holtburger-web/src/lib.rs` (EDIT, +30 LOC) — new
  `CLIENT_EVENT_KIND_PORTAL_SPACE_ENTERED = 33` emitted from the recv-loop
  `PlayerTeleport` arm alongside the existing LoginComplete dispatch.
- `apps/holtburger-web/index.html` (EDIT, +35 LOC) — `setLocalPlayerGuid`
  forwards to `world.setLocalPlayerGuid`; kind=33 drain → typed Character
  + `portalSpaceEntered` bus event; kind=29 death also forwarded to
  `dispatchCombatHandlePlayerDeath` for self-filter routing.
- `apps/holtburger-web/tests/character.test.cjs` (NEW, ~520 LOC) — 56
  assertions across 15 sections + 3 bonus tests for Wave C.2 fallback.
  All PASS.
- `external/holtburger/docs/acplugin-event-coverage-2026-05-27.md` (this
  doc, EDIT — Character.cs subtotal section + aggregate scoring updated).

**Critical semantics confirmed correct in the port:**
1. **Vitae 1.0 = no vitae, 0.95 = 5% vitae** (handoff §3 row 4) — setter
   preserves the multiplier; SkillInfo.cs:138-140 logic on the Wave C side
   already multiplies by it.
2. **UpdateVital even/odd parity** (handoff §3 row 5) — `(vitalKey % 2) === 0`
   gate per `Character.cs:721`; event payload dispatches with the ODD
   canonical type id; vitals dict is keyed by ODD id.
3. **Enchantment tiebreak** (handoff §3 row 7) — segregation port per Wave
   C.2 §7: set-spells beat non-set; within set sort by SpellId desc;
   within non-set sort by StartTime desc; Power desc primary +
   Level8AuraSelfSpells secondary.
4. **Cooldown discriminator** (handoff §3 row 5) — `(type & 0x1000000) !== 0`
   routes to `sharedCooldowns` not `allEnchantments`. One wire packet
   carries both; the bit decides.
5. **PrivateUpdate* routing** (handoff §3 row 6) — distinct from World's
   public Update*. PR 4 wires the Character path via `dispatchCharacter*`
   methods; the World public path stays unchanged.
6. **SharedCooldown sign-extend** (handoff §3 row 6) — `(layeredId << 20) >> 20`
   ported as `Character.signExtendLow12`; JS bitwise ops are signed
   32-bit by definition so the literal port works.

**Validation runs:**
- `node tests/character.test.cjs`: 56/56 PASS.
- `node tests/world-state.test.cjs`: 38/38 PASS (regression).
- `node tests/world_object.test.cjs`: 80/80 PASS (regression).
- `node tests/world_object_property_dict.test.cjs`: 24/24 PASS (regression).
- `node tests/inventory_paperdoll_helpers.test.cjs`: 36/36 PASS (regression).
- `cargo check --target wasm32-unknown-unknown --lib -p holtburger-web`: PASS.
- `cargo test -p holtburger-web --lib`: 57/57 PASS.
- `cargo test -p holtburger-core --lib`: 248/248 PASS (Wave C baseline).
- `node validate_wire_conformance.cjs`: 31/31 PASS (no new fixtures — kind=33
  piggybacks the existing PlayerTeleport parser).

**Matrix delta:** 14 Y / 26 Partial / 42 N → **41 Y / 28 Partial / 9 N**
(net: +27 Y, +2 Partial, −33 N). Character.cs subtotal flipped 3 Y / 4
Partial / 33 N → **30 Y / 6 Partial / 0 N**.

**Out-of-scope deferred:**
- Wave E — wire-level wrapper events with `target_guid + sequence` for
  REMOTE-creature buff tracking (rows 31-36 stay Partial because only
  local-player buffs flow through the kind=8 snapshot diff today).
  Once Wave E lands the wire-side fan-out the JS-side
  `dispatchCharacterRemoveEnchantment` / `dispatchCharacterPurgeEnchantments`
  surfaces are already in place.
- Wave E — `OnInventory_PickupEvent` 0x00F74A bus surface
  (`itemPickedUp`). Low priority.
- 9 N's remaining: 8 `Qualities_Remove*Event` family (rows 18-25 of
  World.cs) + 1 `OnItem_QueryItemManaResponse`. All World.cs side.