v0.3.0

0.3.0

Everything since v0.2.5 — the v0.2.6 tag was never published as a Release, so its one fix is included here too.

Added

• Shields are now narrated throughout combat, for you, your allies, and enemies alike: gaining shields, having them stripped, and blocking hits — "Wizard blocked 12 Fire from Fire Bolt, 2 shields left." Blocked hits report the damage that would have landed. Two new settings control whether non-wizard shield lines end with the unit's resulting shield count: enemy_shield_totals (on by default) and ally_shield_totals (off by default).
• Allegiance changes are announced: units that turn friendly (Dominate, conversions) or hostile (betrayals, Treachery).
• Cheating death is announced: when a hit would have killed you but you survive (Crisis Charm, Soulbound / Soul Jar), you hear "You would have died —" and your resulting health.
• Auto pickup (the game's A key) now reports one summary when the collection walk ends instead of announcing every item in stride: Memory Orbs with SP gained and the new total, Ruby Hearts with the max-HP gain and current HP, components by name. Canceling mid-walk summarizes what was gathered so far. Pressing A with nothing left to collect says "Nothing to pick up."
• Realm summary on level clear: turns taken, spell casts, top damage dealt and taken — the stats panel the game shows sighted players.
• Rift previews read each component's tags and distinguish boss tiers the game shows by color: "Boss:" for encounter bosses, "Elite:" for named threats.
• Components read their tags when cycled to or examined on the ground.
• Equipment reads its tags and its Attributes stat block (live values), matching the drawn panel.
• Spell pages mark already-purchased upgrades with "owned" and read "Attributes: None" where the game draws it.
• Vault portals read their real names ("Spiders Lair") instead of a generic "Rift" — before and after unlocking.
• Enemy ability lists include Quick Cast where present, use the game's "Spells:" header, and match the game's resist wording.

Fixed

• One unit is never spoken as several units: repeated hits now read as repetition ("Ally Sword of Light (5,10) blocked 2 hits, 5 Physical each from Pinch") instead of "3 Ally Dancing Blades at (3,8), (3,8), (3,8)" for one blade hit three times, and one-time facts (fades, buff applies, deaths) speak once. Covers every grouped speech path.
• Casts fully absorbed by an enemy's shield no longer read "No damage" — they read the blocked clause the game shows as the pips drop. Also fixes AoE casts where one blocked target was dropped from speech entirely.
• Enemy channels are no longer voiced as "attack": channel starts read "began channeling Pinch", continuations carry the real spell name and the game's own verb. Player channel continuations get their real spell names back too.
• Self-target buff casts and channel starts no longer append a false "No damage."
• A melee attack fully absorbed by a shield no longer speaks as a bare "X attacked." — the blocked line is the single voice for the hit.
• Clearing a realm no longer swallows the final action's narration: the winning cast's results speak first, then "Level complete," then the realm summary.
• Item pickups after a realm is cleared now speak — they were silently dropped, every level, all along.
• Spell upgrades whose whole effect is stat changes (e.g. Lightning Bolt's Blood Horizon) no longer go silent — every upgrade reads exactly what the game draws: stat gains, description, added tags, stack type. Upgrades that introduce new stats to their spell read those gain lines too.
• Ability descriptions speak their live numbers everywhere — no more bare placeholder words like "damage Lightning damage" (the Living Lightning Scroll bug). Same fix covers passives, on-death effects, clouds, and ground items.
• Locked rifts no longer reveal their contents: like the game, they read only the rift's name, the unlock hint, and (for vaults) the vault's description, until the level is cleared.
• Summon previews read max HP instead of "0 of 48 HP".
• Shields granted to a unit at the moment it is summoned are now announced; a unit returning via Reincarnation no longer produces a phantom "shields gained"; a grant past the 20-shield cap announces the true net gain once.
• Channeling, rituals, and other manual-only cast behavior work again with the mod loaded.
• How to Play always opens at the first page instead of resuming the last page viewed. (This was 0.2.6.)

Install

Unzip the screen_reader folder into your Rift Wizard 3 mods directory, replacing the existing one. Git users can git pull (main is at v0.3.0).