docs(runicnpc): plan RunicNPC, our own Rust NPC plugin (D214–D220) #298

wtclaude · 2026-09-30T01:32:12Z

wtclaude commented

2026-09-30 01:32:12 +00:00

What

The plan for RunicNPC, Runic Gateway's own NPC plugin for Rust (Oxide and Carbon), in the new repository runicnpc-rust. It replaces PLAN_REDESIGNS §6's two-route spike. The rest of the Rust redesigns wait for it, and module-rust requires it once it releases (D220).

runicnpc/PLAN.md (new):
- §1: what the 2026-09-30 spike found on the Oxide rig.
  - Route A kept its kit and fought with it, but cannot be named.
  - HumanNPC counted its NPCs as players: the sidecar recorded a player.death and a player.tally for fake players. Its persistence also leaks.
  - NpcSpawn worked, at the cost of a boot hitch, a phone-home, self-unloading without its images, and no licence.
- Two corrections to the old plan (§1.4).
- The org lead's decisions D214–D220.
- The features: borrowed ideas are credited by source; the rest are our own.
- The API, the /rnpc chat commands, behaviour roles, loot, and navigation.
- Stages 0–10, each with how it is tested on both rigs.
- An honest maintenance table.
- Eight questions (§11).
modules/rust/PLAN_REDESIGNS.md:
- status line and table row;
- §6 marked superseded, with a pointer; the original text is kept;
- §9 item 5 now builds RunicNPC before items 6 and 7;
- §10 gains D214–D220.
README.md: lists runicnpc/.

Not in this PR

No code: the repository is still empty.
The rigs still carry spike leftovers, listed in the session report.

Checklist

AI-assisted: written with Claude Code (Claude Opus 5.5)

🤖 Generated with Claude Code

https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

## What The plan for **RunicNPC**, Runic Gateway's own NPC plugin for Rust (Oxide and Carbon), in the new repository `runicnpc-rust`. It replaces PLAN_REDESIGNS §6's two-route spike. The rest of the Rust redesigns wait for it, and `module-rust` requires it once it releases (D220). - **`runicnpc/PLAN.md`** (new): - §1: what the 2026-09-30 spike found on the Oxide rig. - Route A kept its kit and fought with it, but cannot be named. - HumanNPC counted its NPCs as **players**: the sidecar recorded a `player.death` and a `player.tally` for fake players. Its persistence also leaks. - NpcSpawn worked, at the cost of a boot hitch, a phone-home, self-unloading without its images, and no licence. - Two corrections to the old plan (§1.4). - The org lead's decisions **D214–D220**. - The features: borrowed ideas are credited by source; the rest are our own. - The API, the `/rnpc` chat commands, behaviour roles, loot, and navigation. - **Stages 0–10**, each with how it is tested on both rigs. - An honest maintenance table. - Eight questions (§11). - **`modules/rust/PLAN_REDESIGNS.md`**: - status line and table row; - §6 marked superseded, with a pointer; the original text is kept; - §9 item 5 now builds RunicNPC before items 6 and 7; - §10 gains D214–D220. - **`README.md`**: lists `runicnpc/`. ## Not in this PR - No code: the repository is still empty. - The rigs still carry spike leftovers, listed in the session report. ## Checklist - [x] AI-assisted: written with Claude Code (Claude Opus 5.5) 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

wtclaude added 1 commit 2026-09-30 01:32:14 +00:00

docs(runicnpc): plan RunicNPC, our own Rust NPC plugin (D214-D220) 97be4fb5ab

The PLAN_REDESIGNS §6 spike ran on the Oxide rig on 2026-09-30. Route A
kept its kit and fought with it but cannot be named; HumanNPC counted its
NPCs as players in the killfeed and tallies; NpcSpawn worked but costs a
boot hitch, a phone-home and an unbundleable dependency. The org lead
chose to write our own API-style plugin in runicnpc-rust.

runicnpc/PLAN.md records the spike, the decisions, the features, the API,
the chat commands, and stages 0-10 with how each is tested, plus eight
questions. PLAN_REDESIGNS §6, §9 and §10 point at it; the index lists it.

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

wtclaude added 1 commit 2026-09-30 01:38:35 +00:00

docs(runicnpc): record the org lead's answers, D221-D228 aec01342d5

Standalone use too (D221), placements live on the server (D222), our own
scientist subclass and brain (D223), installer and egg ship it plus a
Gitea release and possibly other download sites (D224), per-profile
kills public and in titles (D225), edge to main (D226), no default caps
but a measured cost warning wherever NPCs are added (D227), and the
names RunicNPC, /rnpc, runicnpc.* (D228). The sections they change are
updated: standalone profiles, the console profile verb, cost warnings,
stage 1's measurements, and publishing.

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

whitlocktech merged commit 216bbf9c54 into main

2026-09-30 01:47:51 +00:00

whitlocktech deleted branch docs/runicnpc-plan

2026-09-30 01:47:52 +00:00

whitlocktech referenced this issue from a commit

2026-09-30 01:47:52 +00:00

Merge pull request 'docs(runicnpc): plan RunicNPC, our own Rust NPC plugin (D214–D220)' (#298) from docs/runicnpc-plan into main

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: RunicGateway/docs#298