bglga/TODO.md

71 lines
3.9 KiB
Markdown

# TODO
**1. Core Gameplay Loop & State Management**
* [x] **GAL-1: Player Lives**
* [x] GAL-2: Add a `PlayerLives` resource.
* [x] GAL-3: Decrement lives on collision.
* [x] GAL-4: Implement player destruction and respawn with temporary invincibility.
* [x] **GAL-5: Game Over State**
* [x] GAL-6: Use Bevy's `States` (`Playing`, `GameOver`).
* [x] GAL-7: Transition to `GameOver` when lives reach zero.
* [x] GAL-8: Display a "Game Over" message.
* [x] **GAL-9: Scoring**
* [x] GAL-10: Add a `Score` resource.
* [x] GAL-11: Increment score when an enemy is hit.
* [x] **GAL-12: Levels/Stages**
* [x] GAL-13: Add `CurrentStage` and `StageConfigurations` resources.
* [x] GAL-14: Define criteria for clearing a stage.
* [x] GAL-15: Advance to the next stage with increasing difficulty.
**2. Enemy Behavior - Formations & Attack Patterns**
* [x] **GAL-16: Enemy Formations**
* [x] GAL-17: Define target positions for formations (`FormationLayout`).
* [x] GAL-18: Enemies have an `Entering` state to fly to their position.
* [x] GAL-19: Enemies have an `InFormation` state.
* [x] **GAL-20: Enemy Attack Dives**
* [x] GAL-21: Enemies have an `Attacking` state with different `AttackPattern`s (Swoop, Direct, Kamikaze).
* [x] GAL-22: Periodically trigger random enemies to start an attack dive.
* [x] GAL-23: Enemies fire bullets during their dives.
* [x] GAL-24: Enemies are despawned when they fly off-screen after an attack.
* [x] **GAL-25: Enemy Variety**
* [x] GAL-26: `EnemyType` enum (`Grunt`, `Boss`).
* [x] GAL-27: Different behaviors, points, and colors based on type.
**3. Advanced Galaga Mechanics**
* [ ] **GAL-28: Boss Galaga & Capture Beam**
* [x] GAL-29: Create a "Boss" enemy type.
* [x] GAL-30: Implement the tractor beam attack logic (`boss_capture_attack` system).
* [x] GAL-31: Player has a `Captured` component when hit by the beam.
* [x] GAL-32: Boss has a `ReturningWithCaptive` state to go back to the formation.
* [x] GAL-33: Improve the tractor beam visual effect (currently a simple rectangle).
* Completed on branch gal-33-improve-tractor-beam-visual, commit 52b0919 — 2-layer glow beam with pulse animation, 8 unit tests
* [ ] **GAL-34: Dual Fighter (Rescuing Captured Ship)**
* [ ] GAL-35: Allow the player to shoot a Boss that is holding a captured ship.
* [ ] GAL-36: Implement the logic to free the captured ship upon shooting the Boss.
* [ ] GAL-37: Implement the dual fighter mode (controlling two ships, firing two bullets).
* [ ] **GAL-38: Challenging Stages**
* [ ] GAL-39: Implement a special stage type (e.g., every 3-4 levels).
* [ ] GAL-40: Design and implement intricate flight patterns for enemies that do not shoot.
* [ ] GAL-41: Award bonus points for destroying all enemies in the stage.
**4. Polish and User Interface**
* [ ] **GAL-42: Visuals**
* [ ] GAL-43: Replace placeholder geometric shapes with actual sprites.
* [x] GAL-44: Add explosion animations/effects.
* **Branch:** `gal-44-add-explosion-effects`
* **Comment:** 2026-05-06 — Implementation complete with commit `2ff561e`
* [x] GAL-45: Implement a scrolling starfield background.
* [ ] **GAL-46: Audio**
* [ ] GAL-47: Integrate `bevy_audio`.
* [ ] GAL-48: Add sound effects (shooting, explosions, player death, tractor beam, etc.).
* [ ] GAL-49: Add background music.
* [ ] **GAL-50: UI**
* [x] GAL-51: Display Score, Lives, and Stage in the window title.
* [ ] GAL-52: Display Score, Lives, and Stage on the screen using `bevy_ui`.
* [ ] GAL-53: Implement a High Score system (saving/loading).
* [x] GAL-54: Create a Start Menu state with a "Start Game" button.
* [ ] GAL-55: Add a "Press R to Restart" message to the `GameOver` screen and implement restart logic.