docs(rust): phase 13b plan of record (PLAN.md §29) #269

wtclaude · 2026-09-24T10:31:16Z

wtclaude commented

2026-09-24 10:31:16 +00:00

This is the plan of record for the second half of module-rust phase 13, the rewards. It is committed before any code, as §28 was for 13a.

PLAN.md §29 records:

D98–D105, the org lead's decisions of 2026-09-24:
- kill credit is chosen per step (players, NPCs or both) and goes to the last hit;
- a "both" score is minutes + killWeight × kills, with the weight as a step param;
- a tally counts only inside a zone this run opened;
- five recipient modes: everyone, top N, score ≥ X, random N, top X %;
- a grant applies only on the kit's server;
- each reward is also one extra use of the kit, held by the site as credits and spent last;
- the news announce leg is a per-server opt-in, off by default;
- rust.announce posts to one server or to every server.
The Kits 4.4.9 facts they rest on. The one that shaped D103: SetPlayerKitUses does nothing for a player with no usage record of that kit, so the credits have to live outside Kits and be spent from OnKitRedeemed.
The catalogue: four actions, two budgets and the kit source. Also what each of the three repos builds (protocol 10) and the eight-step walk. The walk needs Kits installed on both rigs and a real player.
§29.5, four readings nobody asked about, for review to overrule before code:
- NPCs include animals;
- a run holds one tally per server;
- two new plugin bounds, EventsMaxRecipients 100 and EventsMaxTallies 8;
- the news leg sends a post's title.

Code PRs follow on feat/phase-13b-rewards → edge in Rust-Plugins, Rust-Link and Module-Rust.

AI-assisted: Claude Code (Claude Opus 5.5)

🤖 Generated with Claude Code

https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

This is the plan of record for the second half of module-rust phase 13, the rewards. It is committed before any code, as §28 was for 13a. **PLAN.md §29** records: - **D98–D105**, the org lead's decisions of 2026-09-24: - kill credit is chosen per step (players, NPCs or both) and goes to the last hit; - a "both" score is minutes + `killWeight` × kills, with the weight as a step param; - a tally counts only inside a zone this run opened; - five recipient modes: everyone, top N, score ≥ X, random N, top X %; - a grant applies only on the kit's server; - each reward is also **one extra use** of the kit, held by the site as credits and spent last; - the news announce leg is a per-server opt-in, off by default; - `rust.announce` posts to one server or to every server. - **The Kits 4.4.9 facts they rest on.** The one that shaped D103: `SetPlayerKitUses` does nothing for a player with no usage record of that kit, so the credits have to live outside Kits and be spent from `OnKitRedeemed`. - **The catalogue**: four actions, two budgets and the kit source. Also what each of the three repos builds (protocol 10) and the eight-step walk. The walk needs Kits installed on both rigs and a real player. - **§29.5, four readings nobody asked about**, for review to overrule before code: - NPCs include animals; - a run holds one tally per server; - two new plugin bounds, `EventsMaxRecipients` 100 and `EventsMaxTallies` 8; - the news leg sends a post's title. Code PRs follow on `feat/phase-13b-rewards` → `edge` in Rust-Plugins, Rust-Link and Module-Rust. - [x] AI-assisted: 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-24 10:31:17 +00:00

docs(rust): phase 13b plan of record (PLAN.md §29) fb12b18efc

The rewards half of phase 13, written before its code: the participation
tally counted by the game, rust.kit.entitle through the site mirror's per-run
rows plus one extra kit use per reward, and rust.announce with the announce
leg. Records D98-D105 (org lead, 2026-09-24), the Kits 4.4.9 facts they rest
on, the catalogue, what each repo builds, the eight-step walk, and four
readings left open for review.

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

whitlocktech merged commit 5777e0757c into main

2026-09-24 11:33:17 +00:00

whitlocktech deleted branch docs/rust-phase-13b

2026-09-24 11:33:18 +00:00

whitlocktech referenced this issue from a commit

2026-09-24 11:33:19 +00:00

Merge pull request 'docs(rust): phase 13b plan of record (PLAN.md §29)' (#269) from docs/rust-phase-13b into main

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: RunicGateway/docs#269