{"id":28384090,"url":"https://github.com/onnesok/asian_chicken","last_synced_at":"2026-05-18T00:04:34.106Z","repository":{"id":294178117,"uuid":"986158767","full_name":"Onnesok/asian_chicken","owner":"Onnesok","description":"Asian Chicken is a 2D endless runner game built with Flutter and the Flame game engine. Guide your chicken (and other characters) through a side-scrolling world, avoid obstacles, and compete for the highest score!","archived":false,"fork":false,"pushed_at":"2025-05-24T16:48:53.000Z","size":13545,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-30T15:57:31.050Z","etag":null,"topics":["2d","flame","flame-engine","flutter","game-development"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Onnesok.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-05-19T07:41:59.000Z","updated_at":"2025-07-11T07:26:23.000Z","dependencies_parsed_at":"2025-06-25T22:41:08.793Z","dependency_job_id":null,"html_url":"https://github.com/Onnesok/asian_chicken","commit_stats":null,"previous_names":["onnesok/bracu_chicken","onnesok/asian_chicken"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Onnesok/asian_chicken","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Onnesok%2Fasian_chicken","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Onnesok%2Fasian_chicken/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Onnesok%2Fasian_chicken/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Onnesok%2Fasian_chicken/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Onnesok","download_url":"https://codeload.github.com/Onnesok/asian_chicken/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Onnesok%2Fasian_chicken/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33160167,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T22:39:12.733Z","status":"ssl_error","status_checked_at":"2026-05-17T22:39:10.741Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["2d","flame","flame-engine","flutter","game-development"],"created_at":"2025-05-30T07:38:48.672Z","updated_at":"2026-05-18T00:04:29.928Z","avatar_url":"https://github.com/Onnesok.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Asian Chicken\n\nAsian Chicken is a 2D endless runner game built with Flutter and the Flame game engine. Guide your chicken (and other characters) through a side-scrolling world, avoid obstacles, and compete for the highest score!\n\n## Features\n- Multiple playable characters\n- Several enemy types (cat girl, witch, bat, etc.)\n- Parallax scrolling backgrounds (Pine Forest, Forest 1, Classic)\n- Sound effects and background music\n- Pause, settings, and level selection menus\n- High score tracking\n- Responsive controls (swipe and tap)\n- Customizable Control Buttons:\n  - Drag and drop the Jump, Down, Left, and Right buttons to any position on the screen using the in-game Button Settings UI.\n  - Button positions are saved and persist across app restarts.\n  - Default layout prevents button overlap and is optimized for landscape play.\n\n## Screenshots\n\nGame screenshots can be found in the [assets/Asian chicken directory on GitHub](https://github.com/Onnesok/asian_chicken/tree/main/assets/Asian%20chicken).\n\nBelow are some example screenshots from the game:\n\n| ![1](https://github.com/Onnesok/asian_chicken/raw/main/assets/Asian%20chicken/1.jpg) | ![2](https://github.com/Onnesok/asian_chicken/raw/main/assets/Asian%20chicken/2.jpg) | ![3](https://github.com/Onnesok/asian_chicken/raw/main/assets/Asian%20chicken/3.jpg) | ![4](https://github.com/Onnesok/asian_chicken/raw/main/assets/Asian%20chicken/4.jpg) |\n|---|---|---|---|\n| ![5](https://github.com/Onnesok/asian_chicken/raw/main/assets/Asian%20chicken/5.jpg) | ![6](https://github.com/Onnesok/asian_chicken/raw/main/assets/Asian%20chicken/6.jpg) | ![7](https://github.com/Onnesok/asian_chicken/raw/main/assets/Asian%20chicken/7.jpg) | ![8](https://github.com/Onnesok/asian_chicken/raw/main/assets/Asian%20chicken/8.jpg) |\n\n\u003e For more screenshots, see the [assets/Asian chicken folder](https://github.com/Onnesok/asian_chicken/tree/main/assets/Asian%20chicken) in the repository.\n\n## Getting Started\n\n### Prerequisites\n- [Flutter SDK](https://flutter.dev/docs/get-started/install) (3.5.0 or higher recommended)\n- Dart SDK (comes with Flutter)\n\n### Installation\n1. **Clone the repository:**\n   ```sh\n   git clone https://github.com/Onnesok/asian_chicken.git\n   cd asian_chicken\n   ```\n2. **Get dependencies:**\n   ```sh\n   flutter pub get\n   ```\n3. **Run the game:**\n   ```sh\n   flutter run\n   ```\n   \u003e The game is optimized for landscape mode.\n\n## Project Structure\n\n```\nasian_chicken/\n│\n├── lib/\n│   ├── main.dart                # App entry point, sets up providers and launches the game\n│   │\n│   ├── game/                    # Core game logic and components\n│   │   ├── asian_chicken_game.dart   # Main game class, handles game loop, parallax, and state\n│   │   ├── enemy_manager.dart        # Spawns and manages enemies\n│   │   ├── enemy.dart                # Enemy component and behavior\n│   │   └── chicken.dart              # Player character logic and animation\n│   │\n│   ├── screens/                 # UI/game screens\n│   │   ├── welcome_screen.dart         # Main menu and welcome screen\n│   │   ├── game_over_screen.dart       # Game over UI\n│   │   ├── level_screen.dart           # Level/difficulty selection\n│   │   └── character_selection_screen.dart # Character selection UI\n│   │\n│   ├── widgets/                 # Reusable UI widgets and overlays\n│   │   ├── pause_button.dart            # Pause button widget\n│   │   ├── pause_menu_bracu.dart        # Pause menu overlay\n│   │   ├── settings_menu_bracu.dart     # Settings menu overlay\n│   │   └── loading_overlay.dart         # Loading overlay widget\n│   │\n│   ├── models/                  # Data models\n│   │   └── enemy_data.dart              # Enemy data structure\n│   │\n│   └── providers/               # State management (using Provider)\n│       ├── score_provider.dart          # Score and high score logic\n│       ├── music_provider.dart          # Music and sound settings\n│       ├── level_provider.dart          # Level/difficulty state\n│       └── background_provider.dart     # Background selection state\n│\n├── assets/\n│   ├── images/                  # All game images and sprites\n│   │   ├── cat_girl/                    # Cat girl enemy sprites\n│   │   ├── witch/                       # Witch enemy sprites\n│   │   ├── Bat/, Rino/, AngryPig/       # Other enemy sprites\n│   │   ├── ChickBoy/, chicken/          # Player character sprites\n│   │   └── parallax/                    # Parallax backgrounds\n│   │       ├── PineForestParallax/      # Pine forest background layers\n│   │       └── forest1/                 # Forest 1 background layers\n│   │       └── plx-*.png                # Classic background layers\n│   │\n│   ├── audio/                   # Sound effects and background music\n│   │   ├── 8BitPlatformerLoop.wav       # Main background music\n│   │   ├── jump14.wav, hurt7.wav        # Sound effects\n│   │   └── readme.md                    # Audio credits and licenses\n│   └── Icon/                    # App icons for mobile/desktop\n│\n├── test/\n│   └── widget_test.dart         # Example widget test\n│\n├── pubspec.yaml                 # Project configuration, dependencies, and asset registration\n└── README.md                    # Project documentation (this file)\n```\n\n---\n\n### Directory Highlights\n\n- **lib/game/**: All core game logic, including the main game loop, player, and enemy logic.\n- **lib/screens/**: All major UI screens, such as menus and overlays.\n- **lib/widgets/**: Reusable UI components and overlays for pause, settings, and loading.\n- **lib/providers/**: State management for score, music, level, and background.\n- **assets/images/parallax/**: Contains all parallax background layers, organized by theme.\n- **assets/audio/**: Contains all music and sound effects, with credits in `readme.md`.\n\n---\n\n## Assets\n- **Images:**\n  - Sprites for chicken, cat girl, witch, bat, and more\n  - Parallax backgrounds: PineForestParallax, forest1, classic\n- **Audio:**\n  - Background music: 8BitPlatformerLoop.wav ([Tim Beek](https://timbeek.itch.io/royalty-free-music-pack))\n  - SFX: jump14.wav, hurt7.wav ([mikiz](https://mikiz.itch.io/mega-music-pack-v2-over-160-sounds))\n  - See `assets/audio/readme.md` for full credits\n\n## Dependencies\n- [Flame](https://pub.dev/packages/flame)\n- [Provider](https://pub.dev/packages/provider)\n- [Shared Preferences](https://pub.dev/packages/shared_preferences)\n- [Flame Audio](https://pub.dev/packages/flame_audio)\n- [Hive](https://pub.dev/packages/hive)\n- [Flutter Launcher Icons](https://pub.dev/packages/flutter_launcher_icons)\n\n## Customization\n- **Backgrounds:** Change in settings or via `BackgroundProvider`\n- **Characters:** Select from the character selection screen\n- **Levels:** Choose difficulty/level from the level selection screen\n- **Control Buttons:** Customize button positions and layout\n- **Persistent Button Settings:** Save button positions across app restarts\n\n## Setup Instructions\n\n1. **Assets:**\n   - Place your background image at `assets/images/background.png`.\n   - Ensure all other required images (chicken sprites, parallax layers, etc.) are in the correct `assets/images/` subfolders.\n   - Update your `pubspec.yaml` to include all asset paths.\n\n2. **Dependencies:**\n   - This project uses [Flame](https://pub.dev/packages/flame), [Provider](https://pub.dev/packages/provider), and [shared_preferences](https://pub.dev/packages/shared_preferences).\n   - Make sure to run `flutter pub get` after cloning or updating dependencies.\n\n3. **Persistent Button Settings:**\n   - Button positions are stored using `SharedPreferences`.\n   - No extra setup is needed; settings are saved automatically when you tap Save or Reset in the Button Settings screen.\n\n4. **Running the Game:**\n   - Run with `flutter run` on your preferred device or emulator.\n   - Use the in-game settings to adjust controls and other preferences.\n\n## Testing\n- Basic widget test included in `test/widget_test.dart`\n\n## Contributing\nPull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.\n\n## License\n*[See license here.](https://github.com/Onnesok/asian_chicken?tab=Apache-2.0-1-ov-file)*\n\n## Acknowledgements\n- [Flame Engine](https://flame-engine.org/)\n- [Flutter](https://flutter.dev/)\n- Audio and some assets from [Tim Beek](https://timbeek.itch.io/),  [mikiz](https://mikiz.itch.io/) and [Arks](https://arks.itch.io/)\n\n## Support\n\nFor issues or feature requests, please open an issue on the repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonnesok%2Fasian_chicken","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fonnesok%2Fasian_chicken","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonnesok%2Fasian_chicken/lists"}