docs: the front door is a platform, not a UO bridge #2

wtclaude · 2026-08-12T19:29:43Z

wtclaude commented

2026-08-12 19:29:43 +00:00

Phase 5 slice 3 (MODULE_SYSTEM.md §2.11.1). Independent of the other three PRs in the slice — merge whenever.

The landing page still opened with "A website + game bridge for private Ultima Online (ServUO) shards" and listed six repositories. The module system made the first untrue; Phase 5 made the second wrong by two.

What changed

Reframed rather than patched. Runic Gateway is a website platform for game communities that knows nothing about any particular game; everything game-specific arrives as an installable module, and Ultima Online is the first one.

The repo table splits in two — the platform (website, Android-app, docs, Integration-kit) and Ultima Online support (Module-uo, link, servuo-plugins, installer). Eight repos, and a visitor can now tell which half they need.
"How they fit together" leads with the three layers any game needs — game plugin → sidecar → website module — before the UO specifics, including the rule that the website process never opens a connection to a game server, and the sidecar-persists-before-it-forwards reason a page shows the last thing the game said instead of going blank.
Quick start gains step 2: install a module. Paste a release's install-manifest URL into Admin → Modules, or declare MODULES=<id>@<version>=<url> on a compose-managed host. Both were checked against server/.env.example rather than written from memory — the example URL is module-uo v0.3.0's real manifest.
A pointer to Integration-kit for anyone whose game is not Ultima Online, and a "where to go next" row for the module contract.

The honest bit

One blockquote says the module system lives on the website's edge branch and reaches main at the cutover, so nobody clones main looking for a Modules screen that is not there yet. That paragraph comes out with decision 11.

AI-assisted: written with Claude Code (Claude Opus 5); commits carry a Co-Authored-By trailer.

Phase 5 slice 3 (`MODULE_SYSTEM.md` §2.11.1). Independent of the other three PRs in the slice — merge whenever. The landing page still opened with *"A website + game bridge for private Ultima Online (ServUO) shards"* and listed **six** repositories. The module system made the first untrue; Phase 5 made the second wrong by two. ## What changed **Reframed rather than patched.** Runic Gateway is a website platform for game communities that knows nothing about any particular game; everything game-specific arrives as an installable module, and Ultima Online is the first one. - **The repo table splits in two** — the platform (`website`, `Android-app`, `docs`, `Integration-kit`) and Ultima Online support (`Module-uo`, `link`, `servuo-plugins`, `installer`). Eight repos, and a visitor can now tell which half they need. - **"How they fit together" leads with the three layers any game needs** — game plugin → sidecar → website module — before the UO specifics, including the rule that the website process never opens a connection to a game server, and the sidecar-persists-before-it-forwards reason a page shows the last thing the game said instead of going blank. - **Quick start gains step 2: install a module.** Paste a release's install-manifest URL into Admin → Modules, or declare `MODULES=<id>@<version>=<url>` on a compose-managed host. Both were checked against `server/.env.example` rather than written from memory — the example URL is `module-uo` v0.3.0's real manifest. - A pointer to `Integration-kit` for anyone whose game is not Ultima Online, and a "where to go next" row for the module contract. ## The honest bit One blockquote says the module system lives on the website's **`edge`** branch and reaches `main` at the cutover, so nobody clones `main` looking for a Modules screen that is not there yet. That paragraph comes out with decision 11. --- - [x] AI-assisted: written with Claude Code (Claude Opus 5); commits carry a `Co-Authored-By` trailer.

wtclaude added 1 commit 2026-08-12 19:29:45 +00:00

docs: the front door is a platform, not a UO bridge aa2245b315

The org landing page still opened with "A website + game bridge for private
Ultima Online (ServUO) shards" and listed six repositories. The module system
made the first untrue and Phase 5 made the second wrong by two: Module-uo and
Integration-kit.

Reframed rather than patched. Runic Gateway is a website platform for game
communities that knows nothing about any particular game; everything
game-specific arrives as an installable module, and Ultima Online is the first
one. The repo table splits accordingly — the platform (website, Android-app,
docs, Integration-kit) and UO support (Module-uo, link, servuo-plugins,
installer) — and "How they fit together" now leads with the three layers any
game needs (plugin, sidecar, module) before the UO specifics, including the rule
that the website process never opens a connection to a game server.

Quick start gains step 2: install a module. Paste a release's install-manifest
URL into Admin -> Modules, or declare MODULES=<id>@<version>=<url> on a
compose-managed host. Both were checked against server/.env.example rather than
written from memory.

One honest blockquote says the module system lives on the website's `edge`
branch until the cutover, so nobody clones `main` looking for a Modules screen
that is not there yet.

Co-Authored-By: Claude <noreply@anthropic.com>

whitlocktech merged commit 19f6ba018a into main

2026-08-12 19:33:39 +00:00

whitlocktech referenced this issue from a commit

2026-08-12 19:33:40 +00:00

Merge pull request 'docs: the front door is a platform, not a UO bridge' (#2) from docs/module-system-reframe into main

whitlocktech deleted branch docs/module-system-reframe

2026-08-12 19:33:40 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: RunicGateway/.profile#2