Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jonaskromer/blackjack
Blackjack implemented using scala providing a tui and gui
https://github.com/jonaskromer/blackjack
blackjack card-game design-patterns functional-programming game-development scala scala3
Last synced: about 13 hours ago
JSON representation
Blackjack implemented using scala providing a tui and gui
- Host: GitHub
- URL: https://github.com/jonaskromer/blackjack
- Owner: jonaskromer
- License: mit
- Created: 2024-10-04T08:08:19.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-11-15T07:45:09.000Z (3 months ago)
- Last Synced: 2024-12-03T10:08:09.984Z (about 2 months ago)
- Topics: blackjack, card-game, design-patterns, functional-programming, game-development, scala, scala3
- Language: Scala
- Homepage:
- Size: 669 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://coveralls.io/github/jonaskromer/scala_blackjack?branch=main)
[](https://app.codacy.com/gh/jonaskromer/blackjack/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
---
# Blackjack
Blackjack is a text-based Blackjack game built with Scala. This game provides a command-line interface (TUI) where users can interactively play Blackjack by entering commands.
---
## Features
* **Add Players**: Add multiple players to the game before starting.
* **Game Actions**: Hit, Stand, Restart, and Start a new game.
* **Console Colorization**: Outputs are colorized for better readability.
* **Exit Option**: Exits the game safely.
---
## Getting Started
### Prerequisites
* Scala installed
### Running the Game
1. Clone the repository.
2. Compile the code with `scalac`.
3. Run the application with `scala`.
### Using the TUI
Once the game is running, you can control the flow using the following commands:
* **help**: Displays a help message with available commands (TODO).
* **add [name]**: Adds a new player to the game with the specified name.
* **start**: Starts a new game round.
* **hit**: Draws another card for the current player.
* **stand**: Ends the current player's turn.
* **restart**: Restarts the game with the current players.
* **printHands**: Displays each player’s hand and total score.
* **exit**: Exits the game.
### Command Examples
* `add Alice` - Adds a player named Alice.
* `start` - Begins the Blackjack game with all added players.
* `hit` - The current player draws a card.
* `stand` - The current player ends their turn.
* `printHands` - Shows each player’s hand.
* `exit` - Exits the game.
---
## Game Overview
Blackjack is a card game where players try to reach a total score of 21 without going over. The player can choose to draw cards ("hit") or stop drawing ("stand"). The player closest to 21 at the end of the round wins, unless the dealer has a better score.
---
## Code Structure
* **view.Tui**: Manages the user interface and input processing.
* **model.Game**: Represents the game state and handles logic for player actions and game rules.
* **model.GameState**: Enum for game states, including EXIT.
* **view.ConsoleColors**: Provides colorization for text output.
---
## Future Work
* **Help Command**: Expand the `help` command to show detailed command usage.
* **Game Rules**: Implement more Blackjack rules, such as splitting and doubling down.
---
## License
This project is licensed under the MIT License.