Octoturge
181 lines
9.3 KiB
Markdown
181 lines
9.3 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).
|
||
|
||
## [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.
|