This folder contains beginner-friendly Python mini games. Each game is self-contained in its own subfolder and can be run directly from the terminal.

• 2048-Game
• Dots-Boxes-AI
• Emoji-Memory-Game
• FLAMES-Game
• Flipping-Toss
• Hangman-Game
• Number-Guessing-Game
• Number-Sliding-Puzzle
• Password-Forge
• Reverse-Hangman-Game
• Rock-Paper-Scissor
• Rolling-Dice
• Simon-Says
• Snake-Game
• Tic-Tac-Toe
• Whack-a-Mole
• Word-Scramble-Game

Follow these steps to run any project in the games folder. These instructions are designed for beginners and assume no prior experience with Python projects.

You need Python 3.10 or higher. Download it from the official website: https://www.python.org/downloads/

After installing, check your version:

python --version
# or
python3 --version

If you see a version number like Python 3.10.0 or higher, you are ready.

On Windows: Press Win + R, type cmd, and press Enter. On Mac: Open the Terminal app from Applications > Utilities. On Linux: Open your preferred terminal emulator.

Use the cd command to change directories. For example, to go to the Number-Guessing-Game project:

cd path/to/your/python-mini-project/games/Number-Guessing-Game

Replace path/to/your/python-mini-project with the actual path where you downloaded or cloned the repository.

Most game projects use only the Python standard library and do not require extra packages. If a project folder contains a requirements.txt file, install dependencies with:

pip install -r requirements.txt
# or
pip3 install -r requirements.txt

If you get a 'pip not found' error, try python -m pip install -r requirements.txt instead.

Start the project by running its main Python file. For example:

python Number-Guessing-Game.py
# or
python3 Number-Guessing-Game.py

If you get an error about 'python' not being found, try 'python3'.

Some projects may include a README file or comments at the top of the code. Always check for these files in the project folder for details on how to play the game, what input it expects, and what output it produces.

• If you see an error about missing modules, double-check step 4.
• If you see a 'Permission denied' error, make sure you have permission to access the folder and files.
• If you are stuck, open an issue on the repository or ask for help in the project's discussion area.

• Keep each game in its own folder.
• Follow naming style: Category/Project-Name/Project-Name.py.
• Keep code simple, procedural (no classes), and beginner-friendly.
• Use clear prompts and feedback for user interaction.
• Add comments for clarity and to explain non-obvious code sections.
• Avoid adding unnecessary dependencies. If dependencies are required, always include a requirements.txt file and update instructions.
• Use clear, descriptive variable and file names.
• Test your project on Windows, Mac, and Linux if possible.

Credit: Project by steam-bell-92 and contributors