mini_games_python

A collection of simple, fun mini-games built using Python. This repository aims to provide easy-to-understand game implementations for both playing and learning. Everyone is welcome to contribute!

Getting Started

You can play these games by simply cloning the repository and running the individual Python scripts.

Prerequisites

• Python 3.x: Make sure you have Python 3 installed on your system. You can download it from python.org.

Cloning the Repository

Open your terminal or command prompt and run:

git clone https://github.com/eberjohns/mini_games_python.git

Current Games

• TicTacToe: A classic two-player game where players take turns marking spaces in a 3x3 grid with their symbol ('X' or 'O'), trying to get three in a row.
  • Play Tic Tac Toe
• Rock, Paper, Scissors: A classic hand game where players say "rock," "paper," or "scissors" and simultaneously form one of three shapes with an outstretched hand.
  • Play Rock, Paper, Scissors

Contributing

We warmly welcome contributions of all kinds! Whether you're interested in:

• Adding new mini-games: Have a simple game idea? Feel free to implement it!
• Improving existing games: Found a bug? See a way to enhance the gameplay or code? Send us a pull request!
• Suggesting new features: Have an idea for a cool addition to an existing game or the repository structure? Open an issue to discuss it.
• Improving documentation: Help us make the project even more accessible with better explanations and instructions.

How to Contribute

1. Fork the repository: Click the "Fork" button at the top right of the repository page on GitHub.
2. Clone your fork:

   git clone https://github.com/eberjohns/mini_games_python.git

3. Create a new branch: Choose a descriptive name for your branch (e.g., feature/new_game, fix/bug_in_tictactoe).

   git checkout -b main

4. Make your changes: Implement your new game, feature, or bug fix. Please ensure your code is well-commented and easy to understand.
5. Test your changes: Make sure your additions or modifications work as expected.
6. Commit your changes: Write clear and concise commit messages explaining what you've done.

   git add .
   git commit -m "Add a new awesome feature"

7. Push to your fork:

   git push origin your-branch-name

8. Create a Pull Request: Go to the original repository on GitHub and click the "Compare & pull request" button. Provide a clear title and description of your changes.

Contribution Guidelines

• Keep it simple: The focus is on small, understandable games.
• Clear code: Write clean, well-documented Python code.
• Follow existing style: Try to adhere to the coding style used in the existing games.
• Single purpose per pull request: Focus each pull request on a specific game, feature, or bug fix.

Learning Resources

This repository can be a great resource for learning about:

• Basic Python programming concepts: Variables, loops, conditional statements, functions.
• Game development fundamentals: Game loops, user input, basic AI (for some games).
• Version control with Git: Contributing through pull requests exposes you to a collaborative development workflow.

Stay Connected

We encourage you to:

• Star this repository if you find it interesting or useful!
• Open issues to report bugs, suggest new games or features, or ask questions.

Let the games begin! 🚀