skribisto / goker

Poker in Go

Goker - A Poker Game in Go

Project Overview

Goker is a poker game implemented in Go. This project was created so I can learn the Go programming language. Goker is a fully playable poker game featuring rudimentary CPU intelligence and multiplayer capabilities. The game runs in a Docker container.

Features

• Playable Poker Game: Enjoy a Texas Hold'em game of poker with friends or against CPU opponents. (hard-coded 1 player vs 2 CPUs for now)
• Rudimentary CPU Intelligence: Test your skills against basic AI opponents.
• Multiplayer Support: Play with multiple human players in the same game with minor tweak.
• Dockerized: Run the game effortlessly using Docker.
• CI/CD: Very basic CI/CD that automatically builds a docker image and pushes it on Docker Hub for each release.

Installation Instructions

To start playing Goker, you need Docker installed on your machine. Once Docker is set up, you can run the game with the following command:

docker run -it skribisto/goker:latest

This command pulls the latest Goker image from Docker Hub and starts the game in an interactive terminal session.

Usage

Goker is primarily intended for my own learning experience on Go language. It showcases (very) basic game logic, CPU decision-making, and multiplayer interaction within a Dockerized environment.

Future Improvements

Planned future improvements include:

• Web Application: Adding a web interface for an enhanced user experience.
• Performance Enhancements: Optimizing the game for better performance.
• Code Refactoring: Refactoring the codebase to comply with Go standards and best practices.

No commitments are made to code those improvements under any timeline.

License

Goker is released under the GNU General Public License v3.0. You are free to use, modify, and distribute this software under the terms of the GPLv3. For more details, refer to the LICENSE file.

Contributing

If you have ideas for new features, improvements, or bug fixes, please feel free to open an issue. Comments on my code, style, choices are very welcome.

Contact

For any inquiries, suggestions, or feedback, you can reach out via GitHub issues or directly contact me.

---

This project is a work in progress

goker's Issues

feat (doc): write a cool README

fix (scores): correctly print in-progress ScoreCards

we print :
PANIC=String method: runtime error: index out of range [0] with length 0)

On pre-flop pair, because we expect all 5 cards. In short we only print correctly for end-of-game scoreCards

feat (play): very dumb cpu start

Far from calling it "AI"

fix (plays): Manage all-in and almost empty stacks

When stack of a player is almost empty :
2024/05/14 11:56:54 log.go:78: goker > [CRIT] %!w(*errors.errorString=&{not enough money to bet that})

We also don't allow yet all-in bets

feat (game): run in a container