248 lines
15 KiB
Markdown
248 lines
15 KiB
Markdown
# Changelog - hbm-rpg-v3
|
||
|
||
All notable changes to the **HbM RPG v3** Foundry VTT system.
|
||
|
||
The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
|
||
this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||
|
||
## [1.5.2] - 2026-10-26
|
||
|
||
### Fixed
|
||
- A character with the discipline Magia Sakralna - Egzorcyzmy (`sacredExorcism`) is now treated as a Sacred Magic caster in the spell discipline gate. Before, it only matched its own id, so exorcists failed the requirement for Sacred spells. The match is one-way: a plain Sacred mage is not an exorcist.
|
||
- The "new round" chat message and README no longer claim that Mana is reset. Mana is a daily pool in the vault and has not been reset per round since 1.3.x; the message now says which counters really reset.
|
||
|
||
### Added
|
||
- Spell cast dialog has a **Modyfikator liczby kości** (dice modifier, +/-). It changes the number of dice in the casting test for every casting mode (standard, sacred, witch, blood, prayer); the pool never drops below 0. The over-limit Nadczarowanie test uses the same modified pool. API: `CastOptions.diceModifier`, `applyDiceModifier()` in `rules.ts`.
|
||
|
||
### Changed
|
||
- English text "Cannot be unraveled" is now "Cannot be dispelled" on the spell cast card.
|
||
|
||
## [1.5.1] - 2026-10-22
|
||
|
||
### Added
|
||
- Weapons have wound kinds (`system.weapon.woundKinds`: `slashing` sieczne / `piercing` kłute / `blunt` obuchowe, several allowed, empty = unspecified), editable on the gear sheet as a multi-select. Matches Foundry Sync Brief §18.
|
||
- Gear parser reads `wound` (string, comma list or YAML list; Polish or English words) from vault weapon notes. Unknown values are dropped; nothing is guessed.
|
||
- Packs rebuilt from the current vault: Sztylet piercing+slashing, Bicz slashing, Laska blunt, bows and Włócznia piercing; generic one-/two-handed entries list all three (pick the real type per weapon).
|
||
|
||
### Changed
|
||
- `applyDamage` takes `woundKinds` (array) instead of a single kind; passive Krew applies when any is slashing or piercing. Blunt (and unarmed) never gives Krew.
|
||
- Vault sync of 2026-10-22 needs no further logic changes: runic armour wording, Zakazana Osłona retaliation, Rozerwanie Run artifact destruction and free Immediate Action for Kradzież Życia / Złożenie w Ofierze were already covered in 1.5.0 (spell, talent and discipline text arrives through the rebuilt packs).
|
||
|
||
### Notes
|
||
- Callers of `applyDamage` still need to pass the equipped weapon's `woundKinds`.
|
||
- Kości Losu use is now an Immediate Action that counts toward the limit (vault `Zużywanie Ładunków`); the system has no Fate-dice action code yet.
|
||
|
||
## [1.5.0] - 2026-10-20
|
||
|
||
Vault answers (Foundry Sync Brief §17): blood magic and Runiczny Pancerz.
|
||
|
||
### Changed
|
||
- **Runiczny Pancerz:** one hit of more than 5 damage (after the Runiczny Pancerz step) disables 1 point; hits no longer accumulate (`runicCounter` is unused). Disabled points return at the end of the fight (`deleteCombat`), on Długi Odpoczynek, or when restored (Akcja Natychmiastowa; Amulet Osłony 2 Many per point). `destroyRunicPoints` (Rozerwanie Run) lowers the maximum permanently.
|
||
- **Shield-breaking spells** (Przebicie Eteru, Boska Włócznia, Fala Energii, Tajemniczy Strumień, Strzała Pożądania, Ostatni Sąd): every 2 damage disable a point and damage counts ×2 against Magiczna Osłona. Szkarłatny Pocisk ignores Runiczny Pancerz and Magiczna Osłona but not Pancerz; Prawdziwa Dezintegracja ignores Pancerz and destroys shields / disables all Runiczny Pancerz (`SPELL_DAMAGE_PROFILES`, chat-card `data-profile`).
|
||
- **Blood magic rewritten to the vault:** Samookaleczenie (Test Magia (Walka Wręcz) T=2, lose HP = Sukcesy, 1 Krew per HP, once per round; Większe: 2 Krew per HP), Kradzież Życia / Większa (1 Zapał, arms the next attack, Krew per HP actually lost), Złożenie w Ofierze, Wielka Ofiara (once per day), Wchłanianie Krwi (min. 1 Krew, once per round). Removed the invented ×3 self-harm penalty and `floor(damage/4)` life steal.
|
||
- Passive Krew: Szacunek do Życia 1 per 4 HP, Krwisty Pojedynkowicz 1 per 2 HP (cutting/piercing, either side; callers pass `woundKind`/`sourceActor` to `applyDamage`); Rytualista Krwi starts a fight with 4 Krew; leftover Krew heals 2 HP each at the end of the fight.
|
||
|
||
### Added
|
||
- Actor attributes `bloodUsed.*` (per round) and `greatSacrificeUsed` (per day).
|
||
|
||
## [1.4.1] - 2026-10-20
|
||
|
||
### Added
|
||
- Runiczny Pancerz can be restored with Mana: `game.hbm.runicArmor.rechargeRunicArmor(actor, points, { partial })` – 2 Many per point, capped at the armor's maximum (Amulet Osłony, Akcja). Degradation (every 5 absorbed damage) is unchanged.
|
||
|
||
### Changed
|
||
- Money converter: NBP rates come from `src/logic/nbp.ts` – one range request per currency (first table from 1 June of the campaign year), latest published rate for future years or when no table is found, 4 s timeout, offline fallback EUR = `TRADE.eurRate` (4.36), USD = 4.00.
|
||
|
||
## [1.4.0] - 2026-10-20
|
||
|
||
Vault sync ("Foundry Sync Brief 2026-10-20").
|
||
|
||
### Changed
|
||
- Magic power levels III/IV: daily mana swapped to 24 / 21.
|
||
- Wyczerpanie Many: casting beyond the daily pool is allowed; the shortfall is borrowed (cumulative counter `manaBorrowed`, reset by Długi Odpoczynek) and a N d6 tier roll is posted.
|
||
- Over-limit overcast failure now rolls Kara za Nieudolność (N d6, tier 5-8 drains the pool by the base cost).
|
||
- Odetchnięcie limited to twice between Długie Odpoczynki (`breathersTaken`); Długi Odpoczynek resets counters.
|
||
- Oszołomiony applied automatically when one hit costs ≥ ½ max Żywotność; Koncentracja test 4:⌈⅓ lost⌉ reported; Oszołomiony/Przerażony expire at the end of the character's next turn.
|
||
- Przewrócony and Przerażony condition definitions rewritten; Magiczny Pocisk deals at least 1 after Pancerz.
|
||
- Armor-condition damage reduction rounds up.
|
||
- "Reakcja" relabelled "Akcja Natychmiastowa" (per-round counter `immediateActionsUsed` reset each round).
|
||
- Spell data recompiled from the vault (new costs, Aegis of Zeus slug `aegis-zeus`); spell `difficulty.successes` max raised to 30 (superspells); new `thaumaturgy` school.
|
||
|
||
### Added
|
||
- `src/logic/rules.ts`: pure helpers for the new rules (+ tests), `absorbBlood`, `drinkManaElixir`, trade constants.
|
||
- Migration 1.4.0.
|
||
|
||
## [Unreleased]
|
||
|
||
### Changed
|
||
- **Foundry v14 compatibility:** Migrated from deprecated `template.json` to `documentTypes` in `system.json`. The system now declares Actor and Item types directly in the manifest as required by Foundry v14+. `template.json` has been removed.
|
||
- Updated `compatibility.verified` to `"14"` to support Foundry VTT v14 build 363.
|
||
|
||
## [1.2.0] - 2026-04-30
|
||
|
||
Major mechanics + infrastructure release. Adds optional-rules sub-packs,
|
||
ActiveEffects integration, automated tests, full localization for the new
|
||
features, and a v1.2.0 world migration.
|
||
|
||
### Added
|
||
- **Talent sub-packs** for optional rules:
|
||
- `talents-blood` - 5 talents from *Arcanum Sanguinis*
|
||
- `talents-abyss` - 4 talents from *Klątwa Otchłani*
|
||
- Each parsed talent is stamped with `flags['hbm-rpg-v3'].sourceModule`
|
||
so future module-aware UIs can filter or annotate them. *Note:* Foundry
|
||
has no native gating of compendium content by external modules; the flag
|
||
is informational only. *Chwała Szkarłatnemu Kultowi* has no talent
|
||
chapter and is therefore intentionally not split.
|
||
- **Macro pack `hbm-macros`** (7 macros, Polish labels):
|
||
Rzut Puli d6, Test Atrybutu, Nałóż Przypadłość, Krótki/Długi Odpoczynek,
|
||
Pomocnik Rzucania Grupowego, Doładuj Zapał.
|
||
- **ActiveEffects integration on Talent and Gear sheets.** Both item types
|
||
now render an Effects fieldset with Add/Edit/Toggle/Delete actions backed
|
||
by Foundry's built-in ActiveEffect document; `transfer:true` effects are
|
||
auto-applied to actors when the item is granted.
|
||
- **Initiative override.** `CONFIG.Combat.initiative.formula = '2d6 + @attributes.initiative'`
|
||
is registered in the `init` hook; characters use their derived initiative
|
||
attribute, NPCs default to `2d6 + 0`.
|
||
- **Per-turn Zeal regeneration is configurable.** The combat-turn handler
|
||
now reads `flags['hbm-rpg-v3'].zealRegenBonus` (default `0`) added to the
|
||
base `+1` regen - talents can grant additional regen via an ActiveEffect
|
||
with `mode: ADD` targeting that flag.
|
||
- **Long-rest cleanup.** `rest(actor, 'long')` now also deletes temporary
|
||
ActiveEffects on the actor (those with finite duration or with the
|
||
`flags['hbm-rpg-v3'].untilLongRest` marker), preserving transferred passives.
|
||
- **Migration `1.2.0`.** Backfills NPC `mana/zeal/blood` resources, sets
|
||
default `zealRegenBonus = 0` on character actors, and best-effort attaches
|
||
a `+1 zealRegenBonus` ActiveEffect to existing talents whose description
|
||
mentions "+1 Zapał" or "regeneracja Zapału".
|
||
- **Localization.** Added `HBM.{rest, initiative, talentCategory, macro,
|
||
activeEffect}` namespaces to both `lang/pl.json` and `lang/en.json`.
|
||
- **Vitest test harness** (`vitest.config.ts`, `tests/setup.ts`). 5 test
|
||
files covering damage layers, rest mechanics, zeal-regen helper, talent
|
||
parser, and the v1.2.0 migration - 18 tests, all passing.
|
||
|
||
### Notes on skipped items
|
||
- **Spell preparation** is intentionally not implemented - every spellcaster
|
||
can cast any known spell directly (per design).
|
||
- **Module gating of sub-pack talents** is not enforced because Foundry does
|
||
not provide a hook to hide compendium documents based on external module
|
||
presence. The `sourceModule` flag is preserved for future opt-in filtering.
|
||
|
||
## [1.1.2] - 2026-04-30
|
||
|
||
Mechanics polish release. No content changes; focuses on the spell-cast UX, the
|
||
NPC sheet, and the cast dialog.
|
||
|
||
### Added
|
||
- **Rich spell-cast chat card** (`templates/chat/spell-cast.hbs`) with header
|
||
badges (mode / school / circle / success or failure), a costs ledger, damage
|
||
block, status-effect chips, save line, registered triggers, and a collapsible
|
||
description.
|
||
- **Apply-status / apply-damage chat buttons.** Click handlers in
|
||
`src/logic/chat-cards.ts` toggle status effects on selected/targeted tokens
|
||
and pipe damage through `applyDamage()` with the correct `ignoreMagical*` /
|
||
`ignorePhysicalArmor` flags pulled from the spell metadata.
|
||
- **NPC sheet can cast spells.** `actor/npc.hbs` now lists embedded spell items
|
||
with a `✦ Rzuć` button; the sheet supports drag-drop of items from
|
||
compendiums or other actors. NPC schema gained `mana`, `zeal`, `blood`
|
||
resources (mirroring characters) so the cast pipeline runs unchanged.
|
||
- **Variable-success picker** in the cast dialog. When a spell defines
|
||
`system.variableSuccesses[]` (e.g. *Przywołanie Istoty z Otchłani*), the
|
||
dialog renders radio options and sets `opts.requiredOverride` from the
|
||
selected variant.
|
||
- **Canvas-based group-cast UI.** When `system.requiresGroupCast` is set, the
|
||
cast dialog now renders a checkbox list of canvas tokens (instead of the
|
||
free-text actor-id field), so group casters can be picked visually.
|
||
|
||
### Changed
|
||
- `src/logic/spell-cast.ts` no longer posts separate damage / status messages -
|
||
everything is consolidated into the new chat card via `renderTemplate`.
|
||
- `lang/{pl,en}.json` - added `HBM.spellCast.*` keys for the new card and
|
||
dialog widgets.
|
||
- `styles/hbm.css` - styling for the spell-cast card and the new dialog
|
||
widgets (caster checkbox list, variant radio list).
|
||
|
||
## [1.0.0] - 2026-04-29
|
||
|
||
First production release. Adds the full magic and resource model from books I–VIII
|
||
plus a build pipeline that generates compendium content from the source markdown
|
||
in `_books/`.
|
||
|
||
### Added
|
||
|
||
- **Spell schema**: full coverage of the spell-reference (`deity`, `bloodCost`,
|
||
`components.symbols`, `requirements.{race,talent,discipline}`, `isSuperspell`,
|
||
`requiresGroupCast`, `minCasters`, `nonCombatOnly`, `areaOfEffect.{shape,x,y,unit}`,
|
||
`damageBase`, `damageType`, `ignoresArmor`, `statusEffects`, `saveAttribute`,
|
||
`saveSkill`, `overcastOptions`, `triggers`, `sourceBook`, `castingTimeRounds`,
|
||
`castingTimeMinutes`, `variableSuccesses`).
|
||
- **Compendium content** (152 docs / 11 packs):
|
||
- `spells-general`, `spells-elements`, `spells-sacred`, `spells-academic`,
|
||
`spells-superspells`, `spells-crimson` (93 spells total, blood/abyss packs
|
||
reserved for AS / KO content).
|
||
- `talents`, `talents-npc` (34 talents).
|
||
- `races` (5 races), `disciplines`, `disciplines-forbidden` (20 disciplines).
|
||
- **Cast pipeline**: `validateCast()` gates resources/race/talent/discipline/deity
|
||
/group/inCombat/superspell/witch-symbol; `castSpell()` dispatches
|
||
standard / sacred / witch / blood / Hekate hybrid; `rollSpellDamage()` parses
|
||
formula tokens; reactive triggers (`killWithWeapon`, `targetCastsSpell`,
|
||
`damageTaken`, `turnStart`).
|
||
- **Cast dialog** with mana/zeal/blood inputs, group-caster picker, GM bypass
|
||
checkboxes, validation feedback inline.
|
||
- **New mechanics modules**: `blood-magic`, `abyss-magic`, `brewing`, `rest`,
|
||
`trade` - all exposed under `game.hbm.*`.
|
||
- **Actor schema**: `attributes.blood`, `attributes.elixirTolerance`,
|
||
`attributes.insanity` with derived clamps and resource cards on the sheet.
|
||
- **Mental conditions**: paranoia, fobia, depresja, mania, schizofrenia
|
||
(Klątwa Otchłani VIII).
|
||
- **Character sheet**: short-rest / long-rest header buttons; spells tab grouped
|
||
by school with badges (`★ super`, `⛧ group`, `☮ noncombat`, `🔒 race-lock`)
|
||
and source-book pip.
|
||
- **Compendium browser metadata**: per-pack `flags.hbm-rpg-v3.{category,sourceBook,
|
||
forbidden}` and `packFolders` (Zaklęcia / Talenty / Rasy i Dziedziny).
|
||
- **Localization**: Polish (canonical) and English mirrors for all new
|
||
namespaces (`spell`, `spellSchool`, `deity`, `sourceBook`, `aoeShape`,
|
||
`damageType`, `triggerEvent`, `spellCast`, `bloodMagic`, `mentalCondition`).
|
||
- **Migration runner** for v0.2.0 worlds (`complexityLevel` →
|
||
`components.symbols.length`, `targets` regex → `areaOfEffect`, `overcasting`
|
||
text → `overcastOptions[0].description`).
|
||
- **Build pipeline**: `scripts/parsers/*` (book-walker, spell/talent/discipline/
|
||
race parsers) + Zod validation + `scripts/build-packs.ts` (LevelDB via
|
||
`@foundryvtt/foundryvtt-cli`). `bun run package` runs build → packs → zip.
|
||
|
||
### Deferred
|
||
|
||
- `gear-*`, `actors-*`, `roll-tables-*` packs - source books lack stat-block data.
|
||
- Adventures package (`hbm-rpg-v3-adventures`).
|
||
- Macro packs.
|
||
- Compendium browser premium-module integration.
|
||
|
||
## [0.6.1] - 2026-04-29
|
||
|
||
- Localization parity (`en.json` mirrors all `pl.json` namespaces).
|
||
- CSS polish: badges, source pip, blood-pool tint, school details groups,
|
||
fieldset and array-row layouts.
|
||
- Compendium browser metadata + `packFolders`.
|
||
|
||
## [0.6.0] - 2026-04-29
|
||
|
||
- Spell item-sheet rewrite (8 fieldsets, conditional rendering).
|
||
- Cast dialog (`askCastOptions`) with mana/zeal/blood/Hekate/group/bypass.
|
||
- Character header: short-rest / long-rest buttons.
|
||
- Resources: blood pool, elixir tolerance, insanity (conditional).
|
||
- Spells tab grouped by school with badges.
|
||
|
||
## [0.5.0] - 2026-04-29
|
||
|
||
- New mechanics modules under `game.hbm.*`: blood-magic, abyss-magic, brewing,
|
||
rest, trade. Actor schema gains `elixirTolerance`, `insanity`.
|
||
|
||
## [0.4.0] - 2026-04-29
|
||
|
||
- Phase 0 foundation: extended `constants`, `SpellData`, `CharacterData.attributes.blood`,
|
||
migration runner, mental conditions.
|
||
|
||
## [0.3.x]
|
||
|
||
- Pre-1.0 baseline: data models, sheets, dice, conditions, basic cast
|
||
(standard / sacred / witch), 4-layer damage model, race/class linking.
|