Integrate audio feedback across the game by adding new SFX assets and loading them in `BootScene`. Key changes include:
- Added 12 new sound effect files (attacks, abilities, UI) and a main menu music track.
- Implemented SFX playback in `BattleScene` for actions like attacks, counters, mortar/strike/siege/pierce fires, buffs (rally), shields (protect), damage, destructions, and legendary card plays.
- Stopped main menu music during battles to avoid audio overlap and resumed it upon returning to `MainMenuScene`.
- Added hover and select sounds for UI buttons in `MainMenuScene`.
- Fixed deck composition in `DeckManager` by removing one 'imp_trooper_1' from the starter deck.
Refactor combat flow to separate preBattle (buffs/siege/protect) and attack phases. Introduce `preAttack` and `postAttack` events to handle temporary armor modifications (pierce) and restores.
Key changes:
- **Data Updates**: Updated `cards.json` and `skills.json` to reflect new triggers (`preBattle`, `preAttack`) for skills like Pierce, Protect, Siege, and Counter. Adjusted stats for Imperial Assault card.
- **Combat Logic**: Modified `CombatEngine.js` to process preBattle buffs sequentially (rally, siege, protect) and handle pierce armor reduction/restoration logic.
- **Skill Processor**: Updated `SkillProcessor.js` to implement positional logic for Protect (self + neighbors), direct armor reduction for Pierce, and counter damage calculation.
- **Animations**: Added new animation methods in `CardObject.js` (`animateArmorLoss`, `animateArmorGain`) and `BattleScene.js` to visualize:
- **Pierce**: Projectile flying to target with armor drop animation, restored after attack.
- **Protect**: Shields rising on source and flying to neighbors with armor gain animation.
- **Siege**: Launcher overlay, missile arc trajectory, and explosion impact.
- **Counter**: Spike projectile fired at impact during the attack hold phase.
- **Deck Builder**: Overhauled `DeckBuilderScene.js` with a scrollable card grid, faction/rarity filters, and improved deck management UI (owned/used counts).
- **Combat Logic**: Changed `siege` skill trigger from `on_attack` to `preBattle`.
- **Engine Updates**: Modified `_collectPreBattleBuffs` (renamed to `_collectPreBattleFires`) in `CombatEngine.js` to capture and log siege damage events separately from buffs.
- **Skill Processor**: Updated `SkillProcessor.js` to record `siegeTarget` and `siegeDamage` in the context for event logging.
- **Data Updates**: Adjusted descriptions and triggers in `cards.json` and `skills.json`.
- **UI**: Added a "Toggle Fullscreen" button to the Main Menu with state-aware labeling.
Implements a `CardTooltip` component that displays detailed card information (name, type, stats, skills with triggers/values, and flavor text) when hovering over a card in the BattleScene.
Changes include:
- Created `CardTooltip.js` to render dynamic tooltips based on card data and skill definitions.
- Updated `CardObject.js` to handle pointer events (`pointerover`, `pointermove`, `pointerout`) for showing/hiding the tooltip with a 500ms delay.
- Refactored interaction logic in `BattleScene.js` to use the `CardObject`'s native interactive area instead of a separate invisible rectangle, consolidating hover and click handlers.
- Updated `cards.json` and `skills.json` to define `preBattle` (Rally) and `preAttack` (Strike, Mortar) triggers with new descriptions.
- Added `_preBattlePhase` in `CombatEngine.js` to process Rally skills before combat, tracking temporary buffs on cards.
- Added `_postBattlePhase` to remove temporary buffs after combat resolves, ensuring stat changes are cleared for the next turn.
- Modified `SkillProcessor.js` to handle `Strike`, `Mortar`, and `Rally` logic with context data for animation targets and damage values.
- Implemented `_onPreAttackStep` in `BattleScene.js` to sequence animations before the main attack:
- `_animateMortarFire`: Flies a mortar shell in an arc, explodes on impact, and handles HP loss/death.
- `_animateStrikeFire`: Launches a missile at the opposing lane/commander with similar impact effects.
- `_animateRallyBuff`: Animates a flag flying between cards to visualize ATK gains.
- Updated `CardObject.js` `animateHPLoss` to accept explicit `fromHP`/`toHP` arguments, ensuring correct display values during multi-step damage sequences.
- Added `_playSkillExplosion` for consistent impact visual effects during skill resolution.
- Adjusted attack flow to pause for pre-attack animations before the standard card clash sequence.
- Adjusted `CardObject.js` to align "ATK", "ARM", "HP", and "DLY" labels horizontally next to their values instead of vertically below, improving visual clarity.
- Added `_animateInitiativeHandoff` in `BattleScene.js` to smoothly tween the initiative indicator icon between the player and opponent sides at the end of each turn.
- Updated `_updateInitiativeIndicator` to increase the icon size (110px) and adjust its X position for better visibility.
- Extracted `_playCardDeath` in `BattleScene.js` to handle the explosion sprite and fade-out sequence for defeated cards, preventing code duplication.
- Updated `_refreshCardAfterAttack` to use the new helper method, serving as a fallback for cards killed by counter or rupture effects without an HP loss animation.
- Modified `animateHPLoss` completion handler in `_animateAttack` to trigger `_playCardDeath` immediately after the HP animation finishes, ensuring the death sequence only plays once and respects the animation timing.
- Added guard logic to prevent double-destruction if a card is already removed from `cardObjects` before the refresh step.
- Added `playerGoesFirst` state to `CombatEngine` to alternate turn order each round.
- Updated `beginTurn` and `beginCommit` to handle AI deployment based on the current initiative (opponent deploys first if they have initiative, otherwise after the player).
- Modified `_buildPendingAttacks` to respect the alternating attack order.
- Added `animateHPLoss` to `CardObject.js` for a visual HP reduction animation similar to the Berserk gain effect.
- Enhanced `_animateAttack` in `BattleScene.js`:
- Integrated sprite animations for attacks (gun turret) and explosions using new spritesheets.
- Synchronized HP loss and Berserk gain animations with the attack sprite completion.
- Added an "Attacks First" indicator icon next to the commander of the side with initiative.
- Updated `BootScene.js` to load the new `attacksFirst` UI image and `attacks` spritesheet.
- Updated `cards.json` and `skills.json` to trigger Berserk on damage dealt (`on_attack`) instead of on kill, adjusting descriptions accordingly.
- Modified `CombatEngine.js` to emit a `berserk` event after successful attacks and removed the previous kill-based logic.
- Enhanced `SkillProcessor.js` to apply Berserk attack power gains only when damage is dealt during an attack.
- Added `animateBerserkGain` in `CardObject.js` to visually display the ATK increase with scaling, a "+N" label, and smooth transitions.
- Overhauled `_animateAttack` in `BattleScene.js`:
- Cards now slide to the center and scale up during attacks, then return to their original positions.
- Added a "VS" image that appears between cards during the clash.
- Synchronized particle bursts, shakes, and damage numbers with the new centered animation timing.
- Integrated Berserk gain animation into the attack flow, rewinding ATK text before animating the increase.
- Added `vs.png` asset loading in `BootScene.js`.
- Update `game.js` configuration to 1920x1080 with `Phaser.Scale.FIT` for responsive window resizing.
- Scale all UI elements across scenes (MainMenu, Battle, DeckBuilder, Collection, Store, Fusion) to match the new resolution:
- Increase font sizes by ~35-50% for better readability.
- Enlarge buttons and interactive areas to accommodate the larger viewport.
- Expand card display dimensions in battle and deck management screens.
- Adjust layout coordinates in `BattleScene` to center the 4-lane arena properly on the wider screen.
- Update `BootScene` loading text to center dynamically based on scale dimensions.
- Add project documentation (`CLAUDE.md`) outlining architecture, scene flow, and data models for future contributors.
- Significantly increase HP values across all Imperial and Raider cards to extend combat duration and emphasize defense mechanics.
- Adjust armor values on select units (e.g., Raider Berserker, Marauder) to better match their roles.
- Reformat `cards.json` skills into expanded multi-line objects for improved readability and maintainability.
- Update the default starter deck in `DeckManager` to a more focused composition: 4x Trooper, 3x Gunner, 3x Guardian.
- Reduce starting gold in `SaveManager` from 1500 to 400 to better align with the new economic balance.
- Add PNG artwork assets for Imperial and Raider faction cards (commanders and units).
- Update `BootScene` to dynamically load card images based on `artKey` entries in `cards.json`.
- Refactor `CardObject` to render the loaded image over a faction-colored backing, falling back gracefully if the texture is missing.
- Replace the previous solid background rectangle with a transparent red overlay (`.bg`) for the attack flash animation, ensuring art remains visible during impacts.
- Completely rewrite `CardObject` to use a structured layout: top banner (ATK/ARM), 16:9 image area, content section (name/skills), and bottom banner (HP/DLY).
- Remove the `HealthBar` class dependency; HP is now displayed as text within the card's bottom banner.
- Update `BattleScene` to use `CardObject` for Commander displays, ensuring visual consistency with lane cards and simplifying state updates via `.refresh()`.
- Refactor the card picker UI to instantiate actual `CardObjects` instead of manual rectangles/text, adding hover scale effects for better interactivity.
- Split `commitPlayerDeploy` into `beginCommit`, `processNextAttack`, and `finalizeCommit` to enable per-attack animation control.
- Introduce `_pendingAttacks` queue in CombatEngine to sequence attacks one by one, allowing the UI to react to intermediate damage (e.g., counter-kills).
- Refactor BattleScene commander rendering into persistent Containers (`commanderObjects`) that support live `refresh()` for HP/stats updates during combat.
- Update `_animateAttack` to handle commander targets and skip scale-back animations for dead cards, deferring cleanup to `_refreshCardAfterAttack`.
- Implement recursive attack loop in `_processNextAttackStep` that drives the battle forward, updating visuals immediately after each hit before proceeding.
- Split CombatEngine.stepTurn() into beginTurn() (draw + AI deploy) and commitPlayerDeploy() (player choice + combat resolution).
- Add a card picker UI in BattleScene for player deployment, with pass option.
- Implement phased animations: deploy scale-in, sequential attack sequences with enlarged cards, particle bursts, shake/flash on defender, and floating damage numbers.
- Update CardObject to scale fonts/layout with card size and show ATK/HP/ARM/DLY stats plus skills text.
- Adjust battlefield layout constants (lane positions/commander column) and UI button placements for the new flow.
Brian Fertig