Mark/flapguard
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
| Flapguard | Play at http://itchbox.tail018ac4.ts.net/game/flapguard | https://itchbox.tail018ac4.ts.net/game/flapguard
15 commits 1 branch 0 tags 130 MiB
Find a file
Exact
tasker-worker 90d0efed99
Some checks failed
Deploy to itchbox / deploy (push) Failing after 1m36s
Details
Run Godot Tests / test (push) Successful in 2m7s
Details
ci: drop sudo from Godot install step (runner has no sudo)
2026-09-12 00:04:36 -07:00
.forgejo/workflows ci: drop sudo from Godot install step (runner has no sudo) 2026-09-12 00:04:36 -07:00
.github/workflows ci: drop sudo from Godot install step (runner has no sudo) 2026-09-12 00:04:36 -07:00
docs Expand game systems and visual polish 2026-02-01 16:39:30 -08:00
generated_prompts Add Flapguard MVP skeleton 2026-01-19 18:24:37 -08:00
godot_project Expand game systems and visual polish 2026-02-01 16:39:30 -08:00
project_state Add builds directory to .gitignore and update project documentation 2026-01-27 14:54:12 -08:00
tools Add builds directory to .gitignore and update project documentation 2026-01-27 14:54:12 -08:00
.gitignore Add builds directory to .gitignore and update project documentation 2026-01-27 14:54:12 -08:00
.pre-commit-config.yaml Add basic pre-commit hooks config 2026-06-03 20:45:44 -07:00
README.md Expand game systems and visual polish 2026-02-01 16:39:30 -08:00
run_tests.sh Expand game systems and visual polish 2026-02-01 16:39:30 -08:00

README.md

Flapguard

Flapguard is a 2D arena and adventure demo built in Godot 4. Fly, clash, and dive through short combat encounters with dynamic movement mechanics and engaging combat systems.

Features

  • Three Game Modes: Arena battles with waves of enemies, guided Tutorial, and Adventure mode with chaptered progression
  • Dynamic Movement: Flap, glide, dive, climb, sprint, and slide mechanics
  • Combat System: Glide attacks, clash resolution, and strategic positioning
  • Multiple Biomes: Forest, cavern, and other themed arenas with environmental hazards
  • Progression System: Save/load persistence for adventure progress and settings
  • Accessibility Options: High-contrast UI mode and customizable controls
  • Narrative Elements: Multi-page story cards for intro and outro sequences

Quick Start

  • Open the project in Godot 4.5+.
  • Run res://scenes/system/GameManager.tscn.
  • Use the main menu to start Arena, Tutorial, or Adventure mode.

Controls (Default)

  • Move: A/D or Left/Right
  • Flap: Space
  • Glide/Attack: Shift
  • Dive: S or Down
  • Climb (glide pull-up): W or Up
  • Sprint: Double-tap move direction
  • Slide: Hold Down while sprinting
  • Pause: Esc

Project Structure

  • godot_project/ - Godot project root with scenes, scripts, resources, and assets
  • docs/ - User and developer documentation
  • project_state/ - Backlog and sprint tracking
  • tools/ - Development tools and QA scripts

Development Requirements

  • Godot 4.5+ (editor and CLI if running headless checks)
  • gdlint for script linting

Recent Highlights

  • Adventure now has chaptered progression with a world map and a boss finale
  • Added biome arenas (forest, cavern) and a dedicated boss arena
  • New enemy behaviors: diver and skirmisher variants
  • Wind gust hazard setpiece added to arenas and adventure segments
  • Gamepad-friendly menus with default focus and primary/secondary bindings

Build Notes

  • This repo includes placeholder assets and tuning values.
  • Use the Settings menu for audio levels, difficulty settings, screen shake toggle, and UI scale.

Known Issues

  • Multiplayer is placeholder-only; networking flow is not playable.
  • Adventure mode content is limited and still in flux.
  • Achievements are tracked but no in-game UI is exposed yet.
  • Some placeholder assets remain and will be replaced in future updates.

Development Tools

  • Lint: gdlint godot_project/scripts
  • Headless parse: godot4 --headless --check-only --quit (if installed)
  • Combined QA checks: tools/qa_checks.sh