Skip to content

MUME help file sync 2024 to 2026#28

Merged
nschimme merged 12 commits into
MUME:mainfrom
nschimme:mume-wiki-sync-2024-2026-2193321384464819504
May 27, 2026
Merged

MUME help file sync 2024 to 2026#28
nschimme merged 12 commits into
MUME:mainfrom
nschimme:mume-wiki-sync-2024-2026-2193321384464819504

Conversation

@nschimme

@nschimme nschimme commented May 27, 2026

Copy link
Copy Markdown
Contributor

This PR synchronizes the MUME Wiki with official game updates from 2024 through early 2026.

Key changes include:

  1. Istar Quest Overhaul: Reflects the removal of the metamorph command and the new experience progression system based on leading groups of lower-level players.
  2. Combat & Mechanics: Documents the weighting of damage sources in death logic, shared PK experience, and the new "Second Wind" ability for the Endurance skill.
  3. Spell Updates: Updates Portal, Magic Blast, and Dispel Magic with new syntax and protection mechanics.
  4. Race & Skill Adjustments: Adds Half-Elf disease immunity and Eärendil bonuses, as well as essence damage for missile weapons and fell beast calling for Rangers.
  5. Refactoring: Merges Whet.md into Whetstone.md and establishes a new Morgul_blade.md reference page.
  6. UI & Commands: Documents the new hiding status in the prompt, multi-command aliases, and the account import doors synchronization command.

All changes have been verified against the official MUME help files and game news, and the documentation build has been validated locally.

Summary by Sourcery

Update MUME help documentation to reflect 2024–2026 gameplay changes, including Istar quest rework, mechanics clarifications, and new spell and skill behaviours.

New Features:

  • Document new Istar experience system based on leading groups instead of metamorph levels.
  • Add explanations for new or expanded mechanics such as movement-state prompt indicators and hunger/thirst display in the score command.
  • Introduce dedicated Morgul blade reference page detailing its role in summoning fell beasts.

Enhancements:

  • Revise Istari and Metamorph help to remove obsolete metamorph progression and align with current quest design and timing rules.
  • Clarify death type determination, PK experience sharing, and missile weapon essence damage in core mechanics docs.
  • Expand spell and skill descriptions (Portal, Magic Blast, Black Breath, Dispel Magic, Darkness, Endurance, Shield, Herblore, Dark Oath, Backstab, Breath of Briskness, Embed) with updated effects, protections, and interactions.
  • Improve object and combat feedback docs by detailing Consider messaging tiers and movement-point status labels.
  • Update justice rules and town-crime description for same-side PK, and refine Half-Elf racial notes.
  • Consolidate whetstone documentation by folding Whet into Whetstone and correcting equipment reference links.

Documentation:

  • Add or update cross-links between related help pages (e.g., Morgul blade, Dark Oath, Black Breath, Call, Fell Beast, Movement Points, Weapon, Belt, Hold).
  • Remove the obsolete Whet command page and redirect users to the updated Whetstone help.

nschimme and others added 8 commits May 26, 2026 21:19
- Updated combat mechanics: damage source weighting for death, room-wide PK XP sharing, and Endurance "Second Wind".
- Updated spell documentation: Portal (syntax/hidden exits), Magic Blast (self-dispel reduction), Dispel Magic (enchant protection), and Black Breath/Breath of Briskness interactions.
- Overhauled Istar Quest: removed metamorph command, added new XP system for leading low-level groups.
- Updated races and skills: Half-Elf (disease immunity/Eärendil bonus), Dúnedain (Natural Teacher restrictions), Missile Weapons (essence damage), and Dark Oath (fell beast calling).
- Updated UI and commands: Prompt (hiding status), Look (auto-look on reconnect), Alias (multi-command support), and account command abbreviations.
- Consolidated Whetstone documentation and created Morgul Blade page.
- Updated location data for Greenway, Lothlórien, Fornost, and Tharbad.
- Resolved various dead links and validated the documentation build.
Co-authored-by: sourcery-ai[bot] <58596630+sourcery-ai[bot]@users.noreply.github.com>
Co-authored-by: sourcery-ai[bot] <58596630+sourcery-ai[bot]@users.noreply.github.com>
Co-authored-by: sourcery-ai[bot] <58596630+sourcery-ai[bot]@users.noreply.github.com>
Removed redundant information about backstabbing in combat.
Removed specific bonuses and immunity details for Half-elves.
Removed the line explaining the herblore 'Stock' ability.
Co-authored-by: sourcery-ai[bot] <58596630+sourcery-ai[bot]@users.noreply.github.com>
@sourcery-ai

sourcery-ai Bot commented May 27, 2026

Copy link
Copy Markdown
Contributor

Reviewer's Guide

Synchronizes multiple MUME wiki help pages with 2024–2026 game changes, notably removing metamorph from the Istar quest, updating combat/experience, spells, skills, prompt UI, and refactoring whetstone/morgul blade documentation.

Flow diagram for updated Istar Quest experience progression

flowchart TD
  A[Istar character gains experience] --> B[Is character leading a group?]
  B -->|No| Z[No experience gained]
  B -->|Yes| C[Are they in non_Minion lands?]
  C -->|No| Z
  C -->|Yes| D[Evaluate group members]
  D --> E[Count novices_and_champions]
  D --> F[Count heroes]
  D --> G[Count legends]
  E --> H[High experience per kill]
  F --> I[Moderate experience per kill]
  G --> J[Very low experience per kill]
  H --> K[Total experience for Istar]
  I --> K
  J --> K
  K --> L[Apply experience only in good_or_neutral_zones]
  L --> M[Update Istar level progression]
Loading

Flow diagram for updated PK death classification using damage weighting

flowchart TD
  A[Character dies] --> B[Collect recent damage_sources]
  B --> C[Compute damage_from_enemies]
  B --> D[Compute damage_from_mobs_and_environment]
  C --> E[Check recent_enemy_encounters]
  E --> F{Enemy_damage significant
vs mob_damage?}
  F -->|Yes| G[Classify as pk_death]
  F -->|No| H[Classify as mobdeath_or_other]
  D --> F
  G --> I[Apply pk_death rules]
  H --> J[Apply non_pk death rules]
Loading

Flow diagram for fell beast calling via Morgul blade or Dark Oath ranger

flowchart TD
  A[Player attempts Call_fell_beast] --> B{Is player a Dark_Oath Ranger?}
  B -->|No| C{Has Morgul_blade?}
  C -->|Yes| D[Use Morgul_blade to Call fell_beast]
  C -->|No| E[Call fails]
  B -->|Yes| F{Ranger skill high_enough?}
  F -->|No| C
  F -->|Yes| G[Call fell_beast without Morgul_blade]
  D --> H[Fell_beast summoned as mount]
  G --> H
  E --> I[No fell_beast summoned]
Loading

File-Level Changes

Change Details Files
Reworked Istar Quest and Metamorph documentation to match new quest flow and removal of metamorph leveling.
  • Lowered Istar Quest entry level requirement from 21 to 20 and simplified post-quest progression description.
  • Replaced meta-level XP rules with new leadership-based XP mechanics tied to leading groups in non-Minion lands, with emphasis on novices and reduced gains from higher-level followers.
  • Changed quest time limit wording to 90 real-life days and expanded list of Istar perks (no food/water, cheaper spells, all-town citizenship, language mastery).
  • Removed obsolete metamorph quest mechanics and repositioned Metamorph.md as a historical note plus Beorning-only mechanic.
docs/pages/Istari.md
docs/pages/Metamorph.md
Updated combat/death and experience rules plus movement and skill-related effects.
  • Clarified PK death determination to be based on weighted damage sources and recent encounters rather than just immediate presence of enemies.
  • Documented PK experience sharing among all enemies present when a player is defeated.
  • Extended movement status ladder with Unwearied/Steadfast and kept mapping to movement points, tying into Second Wind endurance behaviour.
  • Explained Second Wind as a temporary movement point boost when exhausted.
  • Documented backstab preventing dying cries at high skill levels.
  • Noted Black Númenórean bonus when using herblore to create antidotes.
docs/pages/Death.md
docs/pages/Experience.md
docs/pages/Movement_points.md
docs/pages/Endurance.md
docs/pages/Backstab.md
docs/pages/Herblore.md
Expanded and clarified spell behaviour for travel, offensive, debuff, and utility spells.
  • Simplified Portal syntax to use only a magical key target, removed direction parameter, and documented that portals reveal hidden exits.
  • Added full behavioural description for Magic Blast including room-wide damage, dispel chance, Sanctuary self-protection scaling, and immunity for charmed followers.
  • Described Black Breath’s debuff effects and its direct cancellation of Breath of Briskness.
  • Clarified Dispel Magic as meta-magic, and guaranteed that self-cast will not strip item enchantments.
  • Documented that Darkness affects sky visibility and room lighting.
  • Linked Breath of Briskness as being cancelled by Black Breath.
  • Clarified Shield effectiveness scaling with dexterity and Dodge skill.
docs/pages/Portal.md
docs/pages/Magic_Blast.md
docs/pages/Black_Breath.md
docs/pages/Dispel_Magic.md
docs/pages/Darkness.md
docs/pages/Breath_of_Briskness.md
docs/pages/Shield_Spell.md
Adjusted race/class mechanics and ranger dark oath interactions, including fell beast summoning and missile weapon essence damage.
  • Removed explicit statement that Half-Elves are not immune to disease, aligning with new race mechanics.
  • Stated that missile weapons deal additional essence damage versus opposing-side creatures.
  • Documented that Dark Oath now allows highly skilled Rangers to call a fell beast without a morgul blade, and that its resource drain on mana/moves is reduced.
  • Added Morgul_blade.md describing Morgul blade properties and its role in calling fell beasts, cross-linked from Dark Oath.
docs/pages/Half-Elf.md
docs/pages/Missile_weapons.md
docs/pages/Dark_oath.md
docs/pages/Morgul_blade.md
Updated command and UI help, including prompt indicators and score output.
  • Added H prompt flag to indicate hiding status alongside existing movement indicators.
  • Clarified that score shows hunger and thirst levels, not just health.
  • Extended Consider object output to also show material and expanded the con level table with new top tiers.
  • Clarified Justice that same-side PK is a crime in all towns.
docs/pages/Prompt.md
docs/pages/Score.md
docs/pages/Consider.md
docs/pages/Justice.md
Refactored whetstone documentation and fixed equipment reference link.
  • Merged Whet.md into Whetstone.md, added command classification, alias for Whet, and restructured usage bullets with cross-links to related concepts.
  • Updated equipment overview to reference Whetstone.md instead of removed Whet.md.
docs/pages/Whetstone.md
docs/equipment.md
docs/pages/Whet.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 found 1 issue, and left some high level feedback:

  • The Half-Elf update description mentions adding disease immunity, but the Half-Elf help file now only removes the "They are not immune to disease" line without stating the new immunity explicitly; consider clarifying their disease resistance/immunity status in this page (or linking to where it is documented).
  • In Experience.md, the new bullet "experience gained is shared among all your enemies in the room" is confusing: when you defeat an enemy player, it likely should mention allies/group members/side rather than "your enemies"; consider rewording to make the beneficiary side clear.
Prompt for AI Agents
Please address the comments from this code review:

## Overall Comments
- The Half-Elf update description mentions adding disease immunity, but the Half-Elf help file now only removes the "They are not immune to disease" line without stating the new immunity explicitly; consider clarifying their disease resistance/immunity status in this page (or linking to where it is documented).
- In Experience.md, the new bullet "experience gained is shared among all your enemies in the room" is confusing: when you defeat an enemy player, it likely should mention allies/group members/side rather than "your enemies"; consider rewording to make the beneficiary side clear.

## Individual Comments

### Comment 1
<location path="docs/pages/Dark_oath.md" line_range="12" />
<code_context>

 Through the use of a **Dark oath**, a servant of the [Dark Lord](./Sauron.md) may pledge themselves to his will and gain evil knowledge. Those that wrap themselves in the [Dark Lord's](./Sauron.md) power can move undetected among their foes over extended distances, [call](./Call.md) [fell beasts](./Fell_Beast.md), and possess enhanced [endurance](./Endurance.md), albeit at the expense of reduced concentration.

+Highly skilled [Rangers](./Ranger.md) can summon a [fell beast](./Fell_Beast.md) without the aid of a [morgul blade](./Morgul_blade.md). Furthermore, the concentration required for the oath now exerts a smaller drain on [mana](./Mana.md) and [movement](./Movement_points.md) regeneration.
+
 Example:
</code_context>
<issue_to_address>
**nitpick (typo):** Capitalize "Morgul blade" to match the item page and other references.

In Morgul_blade.md the item is capitalized and treated as a proper name. For consistency, consider changing "a [morgul blade]" here to "a [Morgul blade]".

```suggestion
Highly skilled [Rangers](./Ranger.md) can summon a [fell beast](./Fell_Beast.md) without the aid of a [Morgul blade](./Morgul_blade.md). Furthermore, the concentration required for the oath now exerts a smaller drain on [mana](./Mana.md) and [movement](./Movement_points.md) regeneration.
```
</issue_to_address>

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.

Comment thread docs/pages/Dark_oath.md Outdated
nschimme and others added 3 commits May 27, 2026 11:04
Added that half-elves are not immune to disease.
Co-authored-by: sourcery-ai[bot] <58596630+sourcery-ai[bot]@users.noreply.github.com>
Removed HTML entities from the spell description for clarity.
@nschimme nschimme merged commit ac28e2e into MUME:main May 27, 2026
2 checks passed
@nschimme nschimme deleted the mume-wiki-sync-2024-2026-2193321384464819504 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