{"id":21470917,"url":"https://github.com/saadarazzaq/farkle-game","last_synced_at":"2025-07-31T17:33:24.425Z","repository":{"id":244666995,"uuid":"815912362","full_name":"SaadARazzaq/Farkle-Game","owner":"SaadARazzaq","description":"Dice Based strategic game built with python and tkinter 🎲","archived":false,"fork":false,"pushed_at":"2024-06-16T21:05:29.000Z","size":223,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-17T06:48:02.029Z","etag":null,"topics":["documentation","farkle","gui","python","tkinter"],"latest_commit_sha":null,"homepage":"https://www.youtube.com/watch?v=n6OAQRhohm4","language":"Python","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/SaadARazzaq.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":"2024-06-16T14:04:41.000Z","updated_at":"2024-06-16T21:05:31.000Z","dependencies_parsed_at":"2024-06-16T15:41:50.830Z","dependency_job_id":"643767e6-505d-43eb-bb93-a835e267424f","html_url":"https://github.com/SaadARazzaq/Farkle-Game","commit_stats":null,"previous_names":["saadarazzaq/farkle-game"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/SaadARazzaq/Farkle-Game","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SaadARazzaq%2FFarkle-Game","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SaadARazzaq%2FFarkle-Game/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SaadARazzaq%2FFarkle-Game/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SaadARazzaq%2FFarkle-Game/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SaadARazzaq","download_url":"https://codeload.github.com/SaadARazzaq/Farkle-Game/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SaadARazzaq%2FFarkle-Game/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268078824,"owners_count":24192373,"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-31T02:00:08.723Z","response_time":66,"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":["documentation","farkle","gui","python","tkinter"],"created_at":"2024-11-23T09:29:44.433Z","updated_at":"2025-07-31T17:33:24.403Z","avatar_url":"https://github.com/SaadARazzaq.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Farkle Game\n\n## Overview\nFarkle is a popular dice game where players take turns rolling six dice to score points. The objective is to be the first player to reach 10,000 points. This Python-based version of Farkle features a graphical user interface (GUI) created with the Tkinter library. The game allows multiple human and AI players to compete.\n\n![image](https://github.com/SaadARazzaq/Farkle-Game/assets/123338307/3808b02e-1b36-4c84-8f13-1a836cb10156)\n\n## Features\n- GUI-based gameplay using Tkinter\n- Supports multiple human and AI players\n- Dynamic status updates and score tracking\n- Handles scoring combinations and game logic\n- End-of-game winner announcement\n\n## Requirements\n- Python 3.x\n- `tkinter` library (usually included with Python)\n\n## Installation\n1. Ensure you have Python 3.x installed on your system.\n2. Clone this repository or download the game script.\n3. Navigate to the directory where the script is located.\n\n## How to Play\n1. Open your terminal or command prompt.\n2. Run the script using Python:\n    ```sh\n    python farkle.py\n    ```\n3. Follow the on-screen prompts to start the game.\n\n## Game Instructions\n### Starting the Game\n- When the game starts, you will be prompted to enter the number of human players and AI players.\n- Enter the names for human players.\n\n### Gameplay\n- Each player takes turns rolling six dice.\n- After rolling, the player can choose scoring combinations from the list.\n- Points are awarded based on the chosen combinations.\n- The player can continue rolling the remaining dice or end their turn to bank the current score.\n- If a player rolls and cannot make any scoring combinations, they \"Farkle\" and lose the points accumulated in that turn.\n\n### Scoring Combinations\n- `111` = 1000 points\n- `666` = 600 points\n- `555` = 500 points\n- `444` = 400 points\n- `333` = 300 points\n- `222` = 200 points\n- `1` = 100 points\n- `5` = 50 points\n\n### Ending the Turn\n- Click \"End Turn\" to bank your current score and pass the turn to the next player.\n- The game proceeds until a player reaches the target score of 10,000 points.\n- The last round starts when a player reaches or exceeds 10,000 points.\n\n### Winning the Game\n- The game ends when all players have completed the last round.\n- The player with the highest score at the end of the game is declared the winner.\n\n### Game Outputs\n\n![image](https://github.com/SaadARazzaq/Farkle-Game/assets/123338307/3b59ea35-2999-41ee-aae4-72781f2c189f)\n![image](https://github.com/SaadARazzaq/Farkle-Game/assets/123338307/b46b96de-0ada-4500-a9a4-bee1ada40e4a)\n![image](https://github.com/SaadARazzaq/Farkle-Game/assets/123338307/b8988bb2-b7a0-4998-bf35-26f3395a0d09)\n\n## Test Cases\n\n![image](https://github.com/SaadARazzaq/Farkle-Game/assets/123338307/11e98e9b-ebd1-48af-9bb5-f185ff5b9a63)\n![image](https://github.com/SaadARazzaq/Farkle-Game/assets/123338307/22e462b1-2bea-4a03-ad81-38faf5ff3d40)\n\n## Developer Notes\n- The game uses the Tkinter library to create the GUI.\n- The game logic handles dice rolls, scoring, turn management, and end-of-game conditions.\n- The `POINTS` dictionary defines the scoring combinations and their respective points.\n\n## Future Enhancements\n- Add more sophisticated AI player logic.\n- Improve the user interface for better user experience.\n- Add options for customizing game rules and target score.\n\n---\n\nEnjoy playing Farkle! If you encounter any issues or have suggestions for improvements, feel free to open an issue or submit a pull request. Happy gaming!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaadarazzaq%2Ffarkle-game","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsaadarazzaq%2Ffarkle-game","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaadarazzaq%2Ffarkle-game/lists"}