{"id":29635363,"url":"https://github.com/dmytrozykov/flappybird","last_synced_at":"2026-05-17T17:33:26.645Z","repository":{"id":302062233,"uuid":"1011110836","full_name":"dmytrozykov/flappybird","owner":"dmytrozykov","description":"A fan recreation of the classic Flappy Bird","archived":false,"fork":false,"pushed_at":"2025-07-12T12:33:17.000Z","size":5405,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-21T17:05:10.380Z","etag":null,"topics":["flappybird","gamedev","love2d","lua"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dmytrozykov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-30T10:12:47.000Z","updated_at":"2025-07-12T12:33:20.000Z","dependencies_parsed_at":"2025-06-30T11:36:44.872Z","dependency_job_id":"4e9f7e25-70b1-41e2-8e4f-2440ecbbb63b","html_url":"https://github.com/dmytrozykov/flappybird","commit_stats":null,"previous_names":["dmytrozykov/flappybird"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dmytrozykov/flappybird","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmytrozykov%2Fflappybird","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmytrozykov%2Fflappybird/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmytrozykov%2Fflappybird/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmytrozykov%2Fflappybird/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dmytrozykov","download_url":"https://codeload.github.com/dmytrozykov/flappybird/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmytrozykov%2Fflappybird/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270734952,"owners_count":24636271,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-16T02:00:11.002Z","response_time":91,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flappybird","gamedev","love2d","lua"],"created_at":"2025-07-21T16:38:10.815Z","updated_at":"2026-05-17T17:33:16.628Z","avatar_url":"https://github.com/dmytrozykov.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🐤 Flappy Bird Clone (LÖVE2D)\n\nA fan recreation of the classic Flappy Bird, developed using [LÖVE2D](https://love2d.org/). Simple, frustrating, and endlessly replayable.\n\n## 📽️ Preview\n\n\u003cimg src=\"preview/gameplay.gif\" alt=\"Gameplay\" width=\"400\"/\u003e\n\n\u003cimg src=\"preview/main_menu_screenshot.png\" alt=\"Main menu screenshot\" width=\"400\"/\u003e\n\n---\n\n## 🎮 Game Design Overview\n\nBased on:  \n[Game Design Analysis of Flappy Bird and Swing Copters](https://medium.com/@thomaspalef/game-design-analysis-of-flappy-bird-and-swing-copters-5c6df9fc10f0)\n\n- **Player has 4 seconds to test controls** before gameplay begins.\n- **Physics is consistent**: jump/fall strength and timing are always the same.\n- **Challenge** comes from player skill and precision.\n\n---\n\n## 🧠 Core Mechanics\n\n### Player Control\n- **Input**: Tap / Click / Spacebar\n- **Action**: Bird flaps upward with fixed velocity\n- **Gravity**: Constant downward acceleration\n- **Constraints**: Cannot fly above screen or fall below ground\n\n### Movement System\n- **Bird**: Affected by gravity\n- **Pipes**: Move from right to left at constant speed\n\n### Obstacles\n- **Pipes**: Vertical pairs with a fixed gap\n- **Spacing**: Evenly spaced, with randomized vertical offset\n- **Spawn/Despawn**: Off-screen management for performance\n\n---\n\n## 💥 Collision Rules\n\n- **Pipes**: Any contact = game over\n- **Ground / Ceiling**: Out-of-bounds = game over\n- **Detection**: Axis-Aligned Bounding Box (AABB)\n\n## 🧰 Tech Stack\n\n- **Engine**: [LÖVE2D](https://love2d.org/)\n- **Language**: Lua\n- **Libraries**:\n  - [`rxi/json.lua`](https://github.com/rxi/json.lua) – lightweight JSON parser for Lua\n\n---\n\n## 🚀 Running the Game\n\n### Requirements\n- [LÖVE2D 11.x](https://love2d.org/) or newer\n\n### How to Play\n1. Download this repo.\n2. Run using:\n    ```bash\n    love .\n    ```\n3. Or zip the contents and run with LÖVE:\n    ```bash\n    love path/to/your-zip.zip\n    ```\n\n---\n\n## 📜 License\n\n[MIT License](LICENSE)\n\n---\n\n## 🙌 Acknowledgements\n\n- Original game by **Dong Nguyen**\n- [Design analysis](https://medium.com/@thomaspalef/game-design-analysis-of-flappy-bird-and-swing-copters-5c6df9fc10f0) by Thomas Palef\n\n---\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmytrozykov%2Fflappybird","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdmytrozykov%2Fflappybird","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmytrozykov%2Fflappybird/lists"}