bin-go

README

bin-go

bin-go is a command-line game implemented using Golang. It is a simple game that generates a 5x5 grid of random numbers and players take turns crossing off numbers until one player has crossed off 5 rows or column combined.

Getting Started

1. Clone the repository
2. Navigate to the root directory of the project.
3. Start the game server by running go run cmd/server/server.go.
4. Players can connect to the server by running go run cmd/client/client.go -i [server_ip] -u "[Username]". Replace [server_ip] with the IP address of the machine running the server.
5. Once all the players have connected, the game can be started by typing s and pressing enter in the terminal where the server process is running.

How To Play

1. Each player will be assigned a 5x5 grid of random numbers ranging from 1 to 25.
2. Players take turns providing a number from their grid that they wish to cross off, the same number will be crosesed from other players board.
3. The first player to cross off 5 rows or column combined wins the game.

Screenshot

Contributing

As this project was created for learning purposes, it may have room for improvement. If you would like to contribute to this project, feel free to fork the repository and make changes. If you find any issues with the code, you can open an issue on the repository.

License

This project is released under the MIT License. Feel free to use and modify the code as per the terms of this license.(see LICENSE).