hbm-foundry-system/CHANGELOG.md

Changelog - hbm-rpg-v3

All notable changes to the HbM RPG v3 Foundry VTT system.

The format follows Keep a Changelog and this project adheres to Semantic Versioning.

[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.