No description
Find a file
Harald Hoyer a0863b290c feat(gameplay): add scripted flight paths for special stage enemies
Add Lissajous and cubic Bezier path types for enemies on special stages
(every 3rd level). Path-following enemies spawn with ScriptedPath marker
and FollowingPath state, move along parametric curves, and despawn when
their path ends off-screen.

Key changes:
- New flight_paths module with pure path evaluation (Lissajous + Bezier)
- ScriptedPath marker component and FollowingPath EnemyState variant
- flight_patterns field on StageConfigurations for composable path data
- Special stage spawn branch in spawn_enemies() with stagger delays
- Path-following movement in move_enemies() with delay gating and despawn
- Formation complete early return for special stages
- Without<ScriptedPath> filter on attacking_query to prevent double-processing
- 13 new unit tests for path evaluation and data contracts

Refs: GAL-40
2026-05-07 19:54:18 +02:00
.roo iii 2025-04-11 10:43:48 +02:00
.vscode feat: add cratedocs server configuration to mcp.json 2025-04-15 12:05:18 +02:00
src feat(gameplay): add scripted flight paths for special stage enemies 2026-05-07 19:54:18 +02:00
tests feat(gameplay): add scripted flight paths for special stage enemies 2026-05-07 19:54:18 +02:00
TODO chore(todo): add acceptance criteria and test hints to open issues 2026-05-07 09:53:09 +02:00
.envrc feat: initial commit 2025-03-29 10:58:19 +01:00
.gitignore chore: .gitignore 2026-05-07 14:57:22 +02:00
.mcp.json add .mcp.json 2026-05-06 21:09:21 +02:00
AGENTS.md docs: add line for testing 2026-05-07 14:53:17 +02:00
Cargo.lock chore(deps): upgrade Bevy 0.13 → 0.18 2026-05-06 21:26:48 +02:00
Cargo.toml chore(deps): upgrade Bevy 0.13 → 0.18 2026-05-06 21:26:48 +02:00
flake.lock refactor: replace nixify with flake-utils and rust-overlay in flake.nix 2026-05-04 22:15:27 +02:00
flake.nix chore(deps): upgrade Bevy 0.13 → 0.18 2026-05-06 21:26:48 +02:00
opencode.json chore: add opencode config, replace AGENT.md with AGENTS.md 2026-05-04 22:15:32 +02:00
README.md docs: add line for testing 2026-05-07 14:53:17 +02:00

bglga

This project is a simple Galaga-like space shooter game built using the Bevy engine.

Current State

The game features:

  • A player ship at the bottom of the screen that can move left and right.
  • Shooting bullets upward using the spacebar or up arrow key.
  • Enemy ships that spawn at the top and move downward.
  • Collision detection between bullets and enemies.
  • Collision detection between the player and enemies.
  • A player lives system (starting with 3 lives).
  • Player destruction upon collision.
  • Player respawn after a short delay with temporary invincibility.
  • Remaining lives displayed in the window title.

Controls

  • Move Left: A key or Left Arrow
  • Move Right: D key or Right Arrow
  • Shoot: Spacebar or Up Arrow

How to Compile

nix develop --command cargo build

How to Test

nix develop --command cargo test 

How to Run

  1. Make sure you have Rust and Nix installed.
  2. Clone the repository.
  3. Navigate to the project directory.
  4. Run the game using the command: nix develop --command cargo run

Headless Screenshots

The flake exposes a take-screenshots app that launches a binary inside an Xvfb display backed by lavapipe (software Vulkan), waits, and captures one or more PNG screenshots. Useful for smoke-testing rendering without a real GPU.

nix run .#take-screenshots -- EXE NUM DELAY_START PAUSE_INBETWEEN [OUTPUT_DIR]
  • EXE — path to the executable to launch
  • NUM — number of screenshots to take
  • DELAY_START — seconds to wait after launch before the first shot
  • PAUSE_INBETWEEN — seconds between consecutive shots
  • OUTPUT_DIR — where to write shot-NNN.png files (default: current directory)

Example, capturing three frames of the game one second apart after a six-second warm-up (Bevy + software Vulkan needs roughly that long to render its first frame):

nix develop --command cargo build
nix run .#take-screenshots -- ./target/debug/bglga 3 6 1 ./shots