https://github.com/saadarazzaq/farkle-game
Dice Based strategic game built with python and tkinter 🎲
https://github.com/saadarazzaq/farkle-game
documentation farkle gui python tkinter
Last synced: 11 months ago
JSON representation
Dice Based strategic game built with python and tkinter 🎲
- Host: GitHub
- URL: https://github.com/saadarazzaq/farkle-game
- Owner: SaadARazzaq
- Created: 2024-06-16T14:04:41.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-06-16T21:05:29.000Z (about 2 years ago)
- Last Synced: 2025-03-17T06:48:02.029Z (over 1 year ago)
- Topics: documentation, farkle, gui, python, tkinter
- Language: Python
- Homepage: https://www.youtube.com/watch?v=n6OAQRhohm4
- Size: 218 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Farkle Game
## Overview
Farkle 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.
## Features
- GUI-based gameplay using Tkinter
- Supports multiple human and AI players
- Dynamic status updates and score tracking
- Handles scoring combinations and game logic
- End-of-game winner announcement
## Requirements
- Python 3.x
- `tkinter` library (usually included with Python)
## Installation
1. Ensure you have Python 3.x installed on your system.
2. Clone this repository or download the game script.
3. Navigate to the directory where the script is located.
## How to Play
1. Open your terminal or command prompt.
2. Run the script using Python:
```sh
python farkle.py
```
3. Follow the on-screen prompts to start the game.
## Game Instructions
### Starting the Game
- When the game starts, you will be prompted to enter the number of human players and AI players.
- Enter the names for human players.
### Gameplay
- Each player takes turns rolling six dice.
- After rolling, the player can choose scoring combinations from the list.
- Points are awarded based on the chosen combinations.
- The player can continue rolling the remaining dice or end their turn to bank the current score.
- If a player rolls and cannot make any scoring combinations, they "Farkle" and lose the points accumulated in that turn.
### Scoring Combinations
- `111` = 1000 points
- `666` = 600 points
- `555` = 500 points
- `444` = 400 points
- `333` = 300 points
- `222` = 200 points
- `1` = 100 points
- `5` = 50 points
### Ending the Turn
- Click "End Turn" to bank your current score and pass the turn to the next player.
- The game proceeds until a player reaches the target score of 10,000 points.
- The last round starts when a player reaches or exceeds 10,000 points.
### Winning the Game
- The game ends when all players have completed the last round.
- The player with the highest score at the end of the game is declared the winner.
### Game Outputs
## Test Cases
## Developer Notes
- The game uses the Tkinter library to create the GUI.
- The game logic handles dice rolls, scoring, turn management, and end-of-game conditions.
- The `POINTS` dictionary defines the scoring combinations and their respective points.
## Future Enhancements
- Add more sophisticated AI player logic.
- Improve the user interface for better user experience.
- Add options for customizing game rules and target score.
---
Enjoy 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!