# Games
A collection of small interactive games (like Tic-Tac-Toe, Rock Paper Scissors, and Uno) built for fun, practice, and learning core programming concepts.
---
## Overview
This repository contains a set of terminal-based games implemented in Java and Python, organized into separate folders by game.
Each game focuses on improving logic , algorithms, and clean code structure through simple, playable examples.
---
## Games Included
| Game | Description | Status |
|-------------------|----------------------------------------------------|--------------------------------------------|
| Tic-Tac-Toe | Classic 3x3 grid game vs CPU. | Completed. |
| Rock Paper Scissors | Classic hand game vs CPU with planned stats. | Core game implemented; stats planned. |
| Battle Game | Custom battle system with attacks vs CPU. | Completed (Python implementation). |
| Uno | Terminal-based Uno card game. | Initial implementation added. |
| Uno Flip | Implementation of UNO Flip with light/dark sides.| Initial implementation added. |
---
## Project Structure
```text
/
├─ BattleGame/ # Battle game (Python)
├─ RockPaperScissors/ # Rock Paper Scissors (Java)
├─ TicTacToe/ # Tic-Tac-Toe (Java)
├─ Uno/ # Uno game
├─ UnoFlip/ # Uno Flip game
└─ README.md # Project documentationFolder names map directly to individual games so you can jump into any game’s code quickly.
- Java (JDK 8+) for Java-based games.
- Python 3 for BattleGame and any other Python-based games.
- Git (optional but recommended for cloning the repo).
git clone https://github.com/SaahibSingh/Games.git
cd GamesEach game is run individually from its own folder.
General behavior:
- Follow the on-screen prompts in the terminal.
- Input is usually:
- Row and column numbers for grid-based games (like Tic-Tac-Toe).
- Menu numbers or text options for choosing moves or actions.
- Games handle basic invalid input and reprompt when possible.
You can extend this section with game-specific instructions (for example, how special Uno/Uno Flip cards work).
- Navigate to the Tic-Tac-Toe folder:
cd TicTacToe - Compile:
javac TicTacToeRunner.java
- Run:
java TicTacToeRunner
- Create a new folder at the repo root (for example,
ConnectFour/). - Implement the game logic and a
mainentry point (Javapublic static void mainor a Pythonif __name__ == "__main__"block). - Make sure the game:
- Compiles or runs without errors.
- Handles invalid input gracefully.
- Prints clear instructions to the player.
Contributions are welcome:
- Fork this repository.
- Create a feature branch.
- Add or improve a game (code, tests, or documentation).
- Open a pull request with a clear description of your changes.
This project is currently unlicensed.
If you plan to reuse or extend the code publicly, consider adding an open-source license (for example, MIT or Apache 2.0).