docs(readme): the event system, protocol 7, and module-uo v1.2.2 #6

wtclaude · 2026-09-10T03:06:28Z

wtclaude commented

2026-09-10 03:06:28 +00:00

Events Phase 16c, the landing page's half.

This page is updated when the shape of the project changes, not on ordinary work. A subsystem that
lets staff schedule an unattended change to a live game world is one.

What moves

A new bullet in "How they fit together", beside the engagement one it sits next to. What matters
on a front page is the posture rather than the feature list, so it says the four things that make
this safe to point at strangers:

everything an event may do arrives switched off;
caps are enforced in the database rather than in a role check;
cleanup is generated from a ledger rather than authored, and runs on completion, cancellation
and abort alike;
an event does not edit the world — it holds a lease the game restores on its own deadline,
even if the site never speaks to it again.

Plus the game's own switch, which is separate from the staff write plane and off out of the box.

Two stale numbers, both of which cost a reader real time:

Protocol 5 → 7 in the four values the installer prints. That block is what somebody copies into
Admin → Shard, and a wrong protocol number there is a pairing failure with no obvious cause.
module-uo v1.1.0 → v1.2.2, in the manifest URL and in the MODULES=uo@… line beneath it.

And docs/website/EVENTS.md in "Where to go next".

Checked rather than assumed

The protocol number is PROTOCOL_VERSION in link/sidecar/src/main.rs and protocol in
servuo-plugins/overlay.toml, both on main, both 7.
Module-uo releases/latest is v1.2.2, and its own release notes name
module-uo-1.2.2.json as the manifest to paste — which is the file the URL in this README points
at.
docs main now carries website/EVENTS.md as built, after RunicGateway/docs#232.

AI-assisted contribution. Drafted with Claude Code (Opus 5).

🤖 Generated with Claude Code

https://claude.ai/code/session_016wDDVXWMDz82WqE1i969r4

**Events Phase 16c**, the landing page's half. This page is updated when the *shape* of the project changes, not on ordinary work. A subsystem that lets staff schedule an unattended change to a live game world is one. ## What moves **A new bullet in "How they fit together"**, beside the engagement one it sits next to. What matters on a front page is the posture rather than the feature list, so it says the four things that make this safe to point at strangers: - everything an event may do arrives **switched off**; - caps are enforced in the database rather than in a role check; - cleanup is **generated from a ledger rather than authored**, and runs on completion, cancellation and abort alike; - an event does not edit the world — it holds a **lease** the game restores on its own deadline, even if the site never speaks to it again. Plus the game's own switch, which is separate from the staff write plane and off out of the box. **Two stale numbers**, both of which cost a reader real time: - **Protocol 5 → 7** in the four values the installer prints. That block is what somebody copies into Admin → Shard, and a wrong protocol number there is a pairing failure with no obvious cause. - **module-uo v1.1.0 → v1.2.2**, in the manifest URL and in the `MODULES=uo@…` line beneath it. And `docs/website/EVENTS.md` in "Where to go next". ## Checked rather than assumed - The protocol number is `PROTOCOL_VERSION` in `link/sidecar/src/main.rs` and `protocol` in `servuo-plugins/overlay.toml`, both on `main`, both **7**. - `Module-uo` `releases/latest` is **v1.2.2**, and its own release notes name `module-uo-1.2.2.json` as the manifest to paste — which is the file the URL in this README points at. - `docs` `main` now carries `website/EVENTS.md` as built, after RunicGateway/docs#232. --- **AI-assisted contribution.** Drafted with Claude Code (Opus 5). 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_016wDDVXWMDz82WqE1i969r4

wtclaude added 1 commit 2026-09-10 03:06:31 +00:00

docs(readme): the event system, protocol 7, and module-uo v1.2.2 0a7d138daa

Phase 16c of the events plan. The landing page is updated when the shape of the
project changes, and a subsystem that lets staff schedule an unattended change to
a live game world is one.

* **A new bullet in "How they fit together"**, beside the engagement one it sits
  next to: an event is written once as phases and steps, published as an
  immutable version and executed unattended. What matters on a front page is the
  posture rather than the feature list — everything arrives switched off, caps are
  enforced in the database rather than in a role check, cleanup is generated from
  a ledger rather than authored, and an event does not edit the world but holds a
  **lease** the game restores on its own deadline even if the site never speaks to
  it again. The game keeps its own switch, separate from the staff write plane.
* **Protocol 5 → 7** in the four values the installer prints. That block is what a
  reader copies into Admin → Shard, so a stale number there is the one that costs
  somebody an afternoon.
* **module-uo v1.1.0 → v1.2.2** in the manifest URL and the `MODULES=` line.
* `docs/website/EVENTS.md` added to "Where to go next".

Verified against the platform rather than assumed: the protocol number is
`link/sidecar/src/main.rs` and `servuo-plugins/overlay.toml` on `main`, and
v1.2.2 is the current Module-uo release, whose own notes name
`module-uo-1.2.2.json` as the manifest to paste.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016wDDVXWMDz82WqE1i969r4

whitlocktech merged commit 5deaf74049 into main

2026-09-10 04:28:41 +00:00

whitlocktech referenced this issue from a commit

2026-09-10 04:28:44 +00:00

Merge pull request 'docs(readme): the event system, protocol 7, and module-uo v1.2.2' (#6) from docs/events-system into main

whitlocktech deleted branch docs/events-system

2026-09-10 04:28:44 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: RunicGateway/.profile#6