docs(rust): plan fixes — D173 quests, D174 title rules, D175 admin-owned titles #284

Merged
whitlocktech merged 2 commits from docs/rust-plan-fixes-quests into main 2026-09-26 21:36:14 +00:00
Member

What & why

Stacked on #283. This branch contains #283's commit plus two more. Merge #283 first and this diff shrinks to its own commits; merging this one alone takes all three.

It records the org lead's latest answers to modules/rust/PLAN_FIXES.md (2026-09-26):

  • D173 — "Quests completed" (Wayfarer) counts Rust's own missions, the ones the game's NPCs already hand out on the map. No quest plugin. uMod's hook catalogue names no mission hook, and CARBON.md lists none among Carbon's own. So §4.6 opens the detailed plan with a spike on the rig, keeping the first approach that works on both frameworks:
    1. a framework hook, if one exists by build time;
    2. otherwise, read the player's own mission list at each tally flush;
    3. otherwise, a D168 helper that patches mission completion.
    • Pass condition: a player finishes a mission and Wayfarer moves by exactly one. It must not move for an abandoned or failed mission.
  • D174 — the title rules §4.6 recommended are adopted:
    • the two kill-distance titles are "best" columns, not totals;
    • a weapon-class kill counts every kill the player is credited with (players, NPCs, animals);
    • the APC and the helicopter credit the killing blow;
    • healing counts only other players.
  • D175 — the 23 title names are defaults, not fixed names. The title text resolves in three layers, and the first one set wins:
    1. A rule's own text.
    2. An admin's title for the category, set once for the site. It supersedes the default on every server, and clearing it brings the default back.
    3. The module's shipped default.
    • It builds on phase 17's rust_title_rules, where stat grows from kills / npckills / playtime to the 23 categories.
    • The same 24-character limit and markup stripping apply to an admin's title as to a rule's.
    • Titles are still computed at each push (D135), so a rename is never stale.
  • §9 and the decision range in PLAN.md §35 / the status line / the rust README are updated to D159–D175.

How it was tested

Docs only. I searched modules/rust/HOOKS.md and CARBON.md for any mission hook and found none. I read the rust_title_rules schema from Module-Rust's server/db/schema.sql.

Checklist

  • I have read CONTRIBUTING.md.
  • The change builds and existing tests/checks pass locally. (No CI in this repo.)
  • I have added or updated tests/docs where it makes sense.
  • My commits are reasonably scoped with clear messages.

AI-assisted contributions (required)

  • No AI tools were used to produce this contribution.
  • AI tools were used. Tool(s): Claude Code (Claude Opus 5.5). I have reviewed and understand every change, and take responsibility for it. AI-authored commits are marked with a Co-Authored-By / Assisted-By trailer.

License

  • I agree that my contribution is licensed under this project's license (GNU GPL v3.0 or later), and I have the right to contribute it.

🤖 Generated with Claude Code

https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

## What & why **Stacked on #283.** This branch contains #283's commit plus two more. Merge #283 first and this diff shrinks to its own commits; merging this one alone takes all three. It records the org lead's latest answers to `modules/rust/PLAN_FIXES.md` (2026-09-26): - **D173 — "Quests completed" (Wayfarer) counts Rust's own missions**, the ones the game's NPCs already hand out on the map. No quest plugin. uMod's hook catalogue names no mission hook, and `CARBON.md` lists none among Carbon's own. So §4.6 opens the detailed plan with a **spike on the rig**, keeping the first approach that works on both frameworks: 1. a framework hook, if one exists by build time; 2. otherwise, read the player's own mission list at each tally flush; 3. otherwise, a D168 helper that patches mission completion. - **Pass condition:** a player finishes a mission and Wayfarer moves by exactly one. It must not move for an abandoned or failed mission. - **D174 — the title rules §4.6 recommended are adopted:** - the two kill-distance titles are "best" columns, not totals; - a weapon-class kill counts every kill the player is credited with (players, NPCs, animals); - the APC and the helicopter credit the killing blow; - healing counts only other players. - **D175 — the 23 title names are defaults, not fixed names.** The title text resolves in three layers, and the first one set wins: 1. **A rule's own text.** 2. **An admin's title for the category**, set once for the site. It supersedes the default on every server, and clearing it brings the default back. 3. **The module's shipped default.** - It builds on phase 17's `rust_title_rules`, where `stat` grows from `kills` / `npckills` / `playtime` to the 23 categories. - The same 24-character limit and markup stripping apply to an admin's title as to a rule's. - Titles are still computed at each push (D135), so a rename is never stale. - §9 and the decision range in PLAN.md §35 / the status line / the rust README are updated to D159–D175. ## How it was tested Docs only. I searched `modules/rust/HOOKS.md` and `CARBON.md` for any mission hook and found none. I read the `rust_title_rules` schema from Module-Rust's `server/db/schema.sql`. ## Checklist - [x] I have read [CONTRIBUTING.md](CONTRIBUTING.md). - [x] The change builds and existing tests/checks pass locally. (No CI in this repo.) - [x] I have added or updated tests/docs where it makes sense. - [x] My commits are reasonably scoped with clear messages. ## AI-assisted contributions (required) - [ ] No AI tools were used to produce this contribution. - [x] AI tools were used. Tool(s): `Claude Code (Claude Opus 5.5)`. I have reviewed and understand every change, and take responsibility for it. AI-authored commits are marked with a `Co-Authored-By` / `Assisted-By` trailer. ## License - [x] I agree that my contribution is licensed under this project's license (**GNU GPL v3.0 or later**), and I have the right to contribute it. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY
wtclaude added 2 commits 2026-09-26 21:33:04 +00:00
D169 every fix and redesign lands before Module-Rust's cutover. D170 an
expired zone is marked expired on the site (F14 moves from "by design"
to a fix, amending D96). D171 Steam sign-in moves to the website's own
plan as part of the base website. D172 chat titles use all twenty-three
listed conditions under new names: §4.6 is now a table of condition,
title and the hook that feeds it, plus what the detailed plan must
settle (best-value columns, weapon classes, vehicle-kill credit, heals
of others, quests). PLAN.md §35 and the rust README follow.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY
D173: "Quests completed" (Wayfarer) counts the missions Rust's NPCs
already hand out; no quest plugin. uMod's catalogue names no mission
hook and CARBON.md lists none, so the detailed plan starts with a rig
spike: a framework hook if one exists at build time, else reading the
player's mission list at each tally flush, else a D168 helper patch.
D174 adopts §4.6's recommended title rules (best columns for kill
distance, weapon-class kills count every credited kill, killing-blow
credit for APC/heli, heals of others only).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY
wtclaude added 1 commit 2026-09-26 21:35:04 +00:00
The twenty-three title names in §4.6 are the module's defaults. An admin
can set their own title per category, once for the site, and it
supersedes the default on every server; clearing it restores the
default. A rule's own text still wins over both. §4.6 describes the
three layers on top of phase 17's rust_title_rules (stat grows from
three values to the twenty-three categories).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY
wtclaude changed title from docs(rust): plan fixes — D173 quests are Rust's own missions, D174 title rules to docs(rust): plan fixes — D173 quests, D174 title rules, D175 admin-owned titles 2026-09-26 21:35:19 +00:00
whitlocktech merged commit f015772425 into main 2026-09-26 21:36:14 +00:00
whitlocktech deleted branch docs/rust-plan-fixes-quests 2026-09-26 21:36:14 +00:00
Sign in to join this conversation.
No description provided.