Skip to content

update subraces for MUME IX#29

Merged
nschimme merged 3 commits into
MUME:mainfrom
nschimme:race-updates-mume-ix-3715129401515869755
May 27, 2026
Merged

update subraces for MUME IX#29
nschimme merged 3 commits into
MUME:mainfrom
nschimme:race-updates-mume-ix-3715129401515869755

Conversation

@nschimme

@nschimme nschimme commented May 27, 2026

Copy link
Copy Markdown
Contributor

Description

Related Issue

Checklist

  • Wiki Rules: I have followed the Content Rules (mortal knowledge only) and Spoiler Rules (using ::: details Spoiler) as defined in the Contributing Guide.
  • Content Accuracy: I have verified the information added/changed is accurate to the game.
  • Visual Check: I have verified that the page renders correctly (no broken tables, lists, or styling).
  • Local Build: (For coders) Ran docker compose up --build wiki (or npm run docs:build) and verified changes locally.
  • Index Pages: Updated top-level index pages (e.g., docs/guides.md, docs/classes.md) if a major new page was added.

Summary by Sourcery

Document updated racial and sub-racial mechanics across MUME and restructure race-related references.

New Features:

  • Add detailed sub-race sections and mechanical bonuses for Trolls, Men, Hobbits, Dwarves, Elves, Orc tribes, and Half-Elves.
  • Introduce the Morruhk orc tribe and clarify the three-sided war with Zaugurz as an independent faction.

Enhancements:

  • Rewrite and consolidate Beorning bear-form description and racial stat modifiers into clearer, table-driven documentation.
  • Restructure the races index page to highlight sub-races, racial statistics, and key race guides, and to separate Zaugurz into their own faction section.
  • Refine lore and class documentation to better explain how race choice, aging, and terrain interact with character mechanics.
  • Improve clarity and consistency of terminology (e.g., sub-races vs subraces) and racial link targets by routing references through the central races overview.

Documentation:

  • Replace the old Race page with an updated races overview, updating all internal links accordingly.

nschimme added 3 commits May 27, 2026 16:46
- Updated Racial Statistics table in `docs/pages/Statistic.md` with accurate modifiers and age multipliers from mume.org.
- Consolidated high-level race documentation into `docs/races.md` and added a redirect for the legacy `docs/pages/Race.md`.
- Enhanced individual race pages (`Man.md`, `Elf.md`, `Half-Elf.md`, `Dwarf.md`, `Hobbit.md`, `Orc.md`, `Troll.md`, `Black_Númenórean.md`, `Beorning.md`) with detailed sub-race/tribe/strain bonuses and features.
- Improved UX and navigation flow between the Character Building (Classes) guide and the Playable Races documentation.
- Ensured all data is synchronized with the latest official MUME help files.
- Deleted legacy `docs/pages/Race.md` and updated all internal links to the consolidated `docs/races.md`.
- Completely rebuilt the Racial Statistics table in `docs/pages/Statistic.md` for accuracy and readability.
- Enhanced all individual race pages with detailed sub-race/tribe/strain information.
- Standardized sub-race bonuses into a consistent bulleted format with descriptive labels.
- Fixed typos and consolidated redundant information in `Beorning.md`.
- Improved cross-linking between classes and races for better UX.
- Deleted legacy `docs/pages/Race.md` and updated all internal links to `docs/races.md`.
- Completely rebuilt the Racial Statistics table in `docs/pages/Statistic.md` for accuracy.
- Enhanced all individual race pages with detailed sub-race bonuses and features from official help files.
- Refactored all racial bonuses into a consistent bulleted format with descriptive labels.
- Specifically updated `Half-Elf.md` with Disease Resistance, Star of Eärendil, and Versatility bonuses.
- Fixed typos and consolidated information in `Beorning.md`.
- Improved navigation and cross-linking across the wiki.
@sourcery-ai

sourcery-ai Bot commented May 27, 2026

Copy link
Copy Markdown
Contributor

Reviewer's Guide

Refactors and expands race and sub-race documentation for MUME IX, adding detailed mechanical descriptions for each sub-race/tribe, restructuring racial stats into a proper table, and standardizing internal links from the old Race page to the new top-level races index.

File-Level Changes

Change Details Files
Rewrite Troll sub-race section into concise, structured per-sub-race descriptions.
  • Rename Troll subraces heading to 'Sub-races' and replace legacy bullet lists with three separate subsections for Hill, Cave, and Mountain trolls.
  • Condense and modernize the description of each troll sub-race into a short feature list, emphasizing their unique combat and utility bonuses.
docs/pages/Troll.md
Expand Men page to describe each human sub-race with its unique mechanics and bonuses.
  • Introduce a dedicated 'Sub-races' section for Men instead of a flat link list.
  • Add narrative plus bullet-point mechanical features for Eriadoran, Rohirrim, Dúnedain, Beorning, and Black Númenórean, highlighting starting perks, skill bonuses, and penalties.
docs/pages/Man.md
Rework Hobbit sub-race documentation into clearer, feature-focused subsections and fix race link.
  • Fix Hobbit race link to point to the new races index.
  • Replace old Stoor/Fallohid mechanic bullets with three explicit sub-race subsections (Harfoot, Stoor, Fallohide), each with thematic description and summarized bonuses.
docs/pages/Hobbit.md
Clarify Beorning racial mechanics, especially wilderness bonus and bear form details.
  • Fix race link to use the shared races index and clarify that the wilderness skill bonus does not reduce training effectiveness.
  • Refactor bear form description into a 'Bear Form Features' subsection with a formatted stat table and concise bullet points on combat behavior, forage, group OB bonuses, and form restrictions.
docs/pages/Beorning.md
Replace basic Orc tribe blurb with a full three-tribe sub-race breakdown including Morruhk.
  • Update the introductory text to mention three playable Orc tribes (Tarkhnarb, Morruhk, Zaugurz) and their factional alignment.
  • Add a 'Tribes (Sub-races)' section with separate subsections detailing each tribe’s combat, tracking, herblore, terrain, and bloodlust features.
  • Introduce a brief 'Other Tribes' section before the list of non-playable tribes.
docs/pages/Orc.md
Expand Elf sub-race descriptions with flavor plus mechanical summaries.
  • Replace terse bullet lists for Silvan and Sinda with short narrative descriptions followed by consolidated bullet points for archery, wilderness, crafting, leadership, and aging traits.
  • Augment Noldo description with Detect Magic, focus-gem quest, and aging details.
docs/pages/Elf.md
Modernize and tabularize racial stat modifiers, including new sub-races and race links.
  • Replace the old inline racial stats table with a proper markdown table listing STR/INT/WIS/DEX/CON/WIL/PER/Age per race, including Bear, Orc, Troll, and Black Númenórean.
  • Update explanatory text and footnote to cover all three Orc tribes and move Race links to the shared races index.
docs/pages/Statistic.md
Introduce Dwarf clans (sub-races) and describe their distinct bonuses.
  • Fix Dwarf race link to use the races index and keep existing starting-location text intact.
  • Add a 'Sub-races' section describing Longbeard, Firebeard, and Broadbeam clans with short flavor blurbs and their resilience, crafting, bravery, parry, and exit-bash bonuses.
docs/pages/Dwarf.md
Promote races to a first-class index page with sub-race guidance and Zaugurz faction separation.
  • Add an image, tip-style callout about sub-races, and a note about the three-sided war, calling out Zaugurz as a separate faction.
  • Clarify that Shadow races (Tarkhnarb/Morruhk) are at war with both Free Peoples and Zaugurz.
  • Introduce a dedicated Zaugurz section and move/reshape links to point to the Zaugurz Orc guide and to new core race mechanics pages (Racial Statistics, Classes & Roles).
docs/races.md
Document Half-Elf mechanics including disease resistance, celestial buffs, and stat changes.
  • Clarify that Half-elves are not disease-immune like Elves.
  • Add a 'Features' section listing mechanical traits: disease duration reduction, Star of Eärendil effects, versatility bonuses tied to mood, aging rate, and WIS/STR stat modifiers.
docs/pages/Half-Elf.md
Align Age documentation and links with the new races index and explicit aging multipliers.
  • Update race links from the old Race page to the new races index.
  • Clarify that aging rates depend on races and point to the races index instead of in-game help for details.
docs/pages/Age.md
Update lore and various help pages to reference the new races index instead of the old Race page.
  • Change links from ./pages/Race.md to ../races.md (or ./races.md) across lore and help documents such as Lore, Account, Advanced, Alignment, Black metal wristband, Death, Envenom, Forest green cloak, Movement points, Names, Pack horse, Pray, Ranger, Regeneration, Shire, Skills, Suggest_name, Terrain, Tower_Hills, Train, Waterways, Whois, and related pages.
  • Ensure references to race-based mechanics (movement, regeneration, PK rules, naming) now consistently target the shared races index.
docs/lore.md
docs/pages/Account.md
docs/pages/Advanced.md
docs/pages/Alignment.md
docs/pages/Black_metal_wristband.md
docs/pages/Death.md
docs/pages/Envenom.md
docs/pages/Forest_green_cloak.md
docs/pages/Movement_points.md
docs/pages/Names.md
docs/pages/Pack_horse.md
docs/pages/Pray.md
docs/pages/Ranger.md
docs/pages/Regeneration.md
docs/pages/Shire.md
docs/pages/Skills.md
docs/pages/Suggest_name.md
docs/pages/Terrain.md
docs/pages/Tower_Hills.md
docs/pages/Train.md
docs/pages/Waterways.md
docs/pages/Whois.md
Integrate races into class-building guidance and fix the main Skills/Class docs to point at the new index.
  • Update Skills index to link 'Race' to the shared races index instead of the old Race page.
  • Update classes overview to highlight 'Playable Races' as a prerequisite for understanding builds, and link to the new races index.
docs/pages/Skills.md
docs/classes.md

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey - I've left some high level feedback:

  • You removed pages/Race.md and updated many links to ../races.md, but there may still be remaining references or external/bookmarked URLs pointing to Race.md; consider adding an alias/redirect in the frontmatter of races.md (or a stub Race.md) to avoid broken links.
  • The new sub-race descriptions introduce detailed mechanical bonuses (e.g., bloodlust effects, Morruhk tracking, Half-elf Star of Eärendil); it would be good to double-check these against the in-game help text and align wording where possible to prevent divergence over time.
  • Across the updated race/sub‑race pages, the same concepts are sometimes bolded and sometimes linked (e.g., Wilderness vs [Wilderness](./Wilderness.md), OB vs [Offensive bonus](./Offensive_bonus.md)); standardizing on links where a dedicated help page exists would make navigation and maintenance easier.
Prompt for AI Agents
Please address the comments from this code review:

## Overall Comments
- You removed `pages/Race.md` and updated many links to `../races.md`, but there may still be remaining references or external/bookmarked URLs pointing to `Race.md`; consider adding an alias/redirect in the frontmatter of `races.md` (or a stub `Race.md`) to avoid broken links.
- The new sub-race descriptions introduce detailed mechanical bonuses (e.g., bloodlust effects, Morruhk tracking, Half-elf Star of Eärendil); it would be good to double-check these against the in-game `help` text and align wording where possible to prevent divergence over time.
- Across the updated race/sub‑race pages, the same concepts are sometimes bolded and sometimes linked (e.g., **Wilderness** vs `[Wilderness](./Wilderness.md)`, **OB** vs `[Offensive bonus](./Offensive_bonus.md)`); standardizing on links where a dedicated help page exists would make navigation and maintenance easier.

Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

@nschimme nschimme merged commit c91d5c2 into MUME:main May 27, 2026
3 checks passed
@nschimme nschimme deleted the race-updates-mume-ix-3715129401515869755 branch May 27, 2026 21:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant