Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/saadarazzaq/connect4-game
A CLI Based Connect four strategic game build in python 🔗4️⃣
https://github.com/saadarazzaq/connect4-game
cli connectfour-game documentation python
Last synced: about 2 months ago
JSON representation
A CLI Based Connect four strategic game build in python 🔗4️⃣
- Host: GitHub
- URL: https://github.com/saadarazzaq/connect4-game
- Owner: SaadARazzaq
- Created: 2024-06-16T13:41:53.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-06-16T21:07:20.000Z (7 months ago)
- Last Synced: 2024-06-17T14:53:59.961Z (7 months ago)
- Topics: cli, connectfour-game, documentation, python
- Language: Python
- Homepage: https://www.youtube.com/watch?v=utXzIFEVPjA
- Size: 3.8 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Connect 4 CLI Game Overview
Welcome to Connect 4, a classic two-player game now available in a Command Line Interface (CLI) version! In this game, you can choose to play against another player or challenge the computer. The objective is to connect four of your tokens in a row, either horizontally, vertically, or diagonally.
## Features
- Two-player mode
- Player vs. Computer mode
- Simple and intuitive CLI interface
- Dynamic game board display
## Requirements
- Python 3.x
- art library (for the welcome message)
## Installation
- Ensure you have Python 3.x installed on your system.
- Install the art library using pip:
```bash
pip install art
```
## How to Play
1. Clone this repository or download the game script.
2. Open your terminal or command prompt.
3. Navigate to the directory where the script is located.
4. Run the script using Python:
```bash
python Connect_4.py
```
5. Follow the on-screen instructions to start the game.
## Game Instructions
### Main Menu
When you start the game, you will be presented with the main menu. You have the following options:
1. Play a 2 player game
2. Play a game against CPU (Computer)
3. Exit
### Playing the Game
- Two Player Game: Each player takes turns to place their token on the board. Player 1 uses the "🔵" token and Player 2 uses the "🔴" token.
- Player vs. CPU: You will play against the computer. You use the "🔵" token, and the computer uses the "🔴" token.
### Making a Move
- The game board is displayed with columns labeled A to G and rows numbered 0 to 5.
- To make a move, input the column letter followed by the row number (e.g., A0).
- The token will drop to the lowest available space in the selected column, adhering to gravity rules.
### Winning the Game
- The game ends when a player connects four of their tokens in a row, either horizontally, vertically, or diagonally.
- The winner is announced, and the game board is displayed one final time.
## Example Game Play
1. Start the game and choose to play against the computer.
2. Enter your player name.
3. The game board is displayed, and the player's turn is indicated.
4. Enter your move (e.g., "A0").
5. The computer makes its move.
6. The game continues until there is a winner or the board is full.
## Game Screenshots:
## Test Cases:
## Developer Notes
- The game uses a 6x7 grid to represent the Connect 4 board.
- The art library is used to print the welcome message in a stylized font.
- Functions are modular and handle specific tasks like printing the board, checking for a winner, and managing turns.
## Future Enhancements
- Add difficulty levels for the computer opponent.
- Implement a graphical user interface (GUI) for a more interactive experience.
- Allow players to undo moves.
---
Enjoy the game and have fun connecting four! 💖