{"id":20146287,"url":"https://github.com/mohammadrezaamani/candycrush-gui","last_synced_at":"2026-03-14T05:31:20.833Z","repository":{"id":151987257,"uuid":"457759798","full_name":"MohammadrezaAmani/CandyCrush-GUI","owner":"MohammadrezaAmani","description":"Candy Crush game developed with Java Swing","archived":false,"fork":false,"pushed_at":"2025-05-15T08:29:51.000Z","size":11828,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-15T09:31:59.116Z","etag":null,"topics":["candycrush","gui","java","swing"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MohammadrezaAmani.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2022-02-10T11:53:42.000Z","updated_at":"2025-05-15T08:28:26.000Z","dependencies_parsed_at":"2023-09-11T16:45:26.577Z","dependency_job_id":null,"html_url":"https://github.com/MohammadrezaAmani/CandyCrush-GUI","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/MohammadrezaAmani/CandyCrush-GUI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohammadrezaAmani%2FCandyCrush-GUI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohammadrezaAmani%2FCandyCrush-GUI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohammadrezaAmani%2FCandyCrush-GUI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohammadrezaAmani%2FCandyCrush-GUI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MohammadrezaAmani","download_url":"https://codeload.github.com/MohammadrezaAmani/CandyCrush-GUI/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MohammadrezaAmani%2FCandyCrush-GUI/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267127268,"owners_count":24040006,"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-07-26T02:00:08.937Z","response_time":62,"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":["candycrush","gui","java","swing"],"created_at":"2024-11-13T22:20:57.880Z","updated_at":"2026-03-14T05:31:15.807Z","avatar_url":"https://github.com/MohammadrezaAmani.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Candy Crush GUI\n\n![Candy Crush](./assets/game-layout.png)\n\nA modern, enhanced implementation of the classic Candy Crush game built with Java Swing. This project features a clean, modular architecture, smooth animations, advanced AI capabilities, multiple game modes, and more.\n\n## Features\n\n- **Multiple Game Modes**\n  - Classic Mode: Match candies to reach target score with limited moves\n  - Timed Mode: Score as much as possible in a limited time\n  - Puzzle Mode: Complete specific objectives and challenges\n  - Multiplayer Mode: Compete against a friend (local play)\n\n- **Advanced AI Features**\n  - Smart hint system to suggest optimal moves\n  - Auto-play functionality with adjustable difficulty levels\n  - Deep analysis of potential matches and cascades\n\n- **Modern UI/UX**\n  - Sleek, responsive interface with glassmorphism effects\n  - Smooth animations and transitions\n  - Customizable themes (Light, Dark, Candy)\n  - Sound effects and background music\n\n- **Gameplay Enhancements**\n  - Special candies with unique abilities\n  - Score tracking and high score system\n  - Customizable difficulty settings\n  - Save/load game functionality\n\n## Requirements\n\n- Java JDK 11 or higher\n- Minimum resolution: 1024x768\n- 256MB RAM\n\n## Installation and Setup\n\n1. Clone the repository:\n   ```\n   git clone https://github.com/MohammadrezaAmani/CandyCrush-GUI.git\n   ```\n\n2. Navigate to the project directory:\n   ```\n   cd CandyCrush-GUI\n   ```\n\n3. Compile the project:\n   ```\n   javac -d bin src/main/java/candycrush/Main.java\n   ```\n\n4. Run the game:\n   ```\n   java -cp bin candycrush.Main\n   ```\n\n## How to Play\n\n1. **Start a Game**: Choose a game mode from the main menu\n2. **Match Candies**: Click on a candy, then click on an adjacent candy to swap them\n3. **Create Special Candies**:\n   - Match 4 in a row: Creates a striped candy\n   - Match 5 in a row: Creates a wrapped candy\n4. **Use Hints**: If you're stuck, click the Hint button or press 'H'\n5. **Keyboard Controls**:\n   - H: Show hint\n   - P or ESC: Pause game\n   - R: Reset game\n   - F: Toggle fullscreen\n\n## Project Structure\n\n```\nsrc/main/java/candycrush/\n├── Main.java                  # Application entry point\n├── ai/                        # AI and hint system\n├── audio/                     # Audio management\n├── model/                     # Game logic and data models\n├── util/                      # Utility classes\n└── view/                      # UI components\n    ├── components/            # Reusable UI elements\n    ├── dialogs/               # Dialog windows\n    ├── game/                  # Game screen and board\n    └── screens/               # Main application screens\n```\n\n## Architecture\n\nThis application follows a Model-View-Controller (MVC) architecture:\n- **Model**: Game state and logic (GameBoard, Candy)\n- **View**: UI components and screens\n- **Controller**: User input handling and game flow\n\nAdditional design patterns used:\n- Observer pattern for model-view communication\n- Singleton pattern for resource managers\n- Strategy pattern for AI behavior\n\n## Configuration\n\nSettings can be modified in `src/main/resources/config.properties`.\n\nKey settings:\n- `ui.theme`: LIGHT, DARK, or CANDY\n- `game.default.difficulty`: EASY, MEDIUM, or HARD\n- `ui.sound.enabled`: true or false\n- `ui.music.enabled`: true or false\n\n## Credits\n\n- Original game by: Mohammadreza Amani\n- Refactored and enhanced version: [Your Name]\n- Sound effects from: [Source]\n- Music from: [Source]\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Future Enhancements\n\n- Online multiplayer mode\n- Additional special candies and power-ups\n- Level editor for custom puzzles\n- Mobile/touch screen support\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohammadrezaamani%2Fcandycrush-gui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmohammadrezaamani%2Fcandycrush-gui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohammadrezaamani%2Fcandycrush-gui/lists"}