Games

🧠 MindNim

A sleek, strategic math-based game built with Python and Tkinter. Challenge a “smart” AI in a battle of logic, binary sums, and subtraction.

🎮 How to Play

Nim is a mathematical game of strategy.

  1. The Setup: The game starts with 3 piles of coins, randomly generated.
  2. The Turn: On your turn, you must remove 1, 2, or 3 coins from any single pile.
  3. The Goal: The player who takes the very last coin from the screen wins!

AI Intelligence: The bot uses a “Nim-Sum” mathematical strategy. While it may make mistakes early on, it becomes increasingly perfect as the coin count drops. Can you beat the math?

🚀 Installation & Running

⬇️ For Regular Users (Windows)

  1. Go to the Releases section on the right side of this page.
  2. Download the latest game.exe.
  3. Double-click the file to play! (Note: You may need to click “Run Anyway” if Windows Defender flags it as an unrecognized app.)

🛠️ For Developers (Run from Source)

If you want to modify the code or run it manually:

  1. Clone the repository: ```bash git clone https://github.com/YOUR_USERNAME/YOUR_REPO_NAME.git cd YOUR_REPO_NAME
  2. Run the game: python main.py

Here is the full, formatted text for your README.md. I have included a section for a screenshot (place a file named screenshot.png in your folder to make it appear) and clear instructions for your users.

Markdown

🧠 MindNim

A sleek, strategic math-based game built with Python and Tkinter. Challenge a “smart” AI in a battle of logic, binary sums, and subtraction.

🎮 How to Play

Nim is a mathematical game of strategy.

  1. The Setup: The game starts with 3 piles of coins, randomly generated.
  2. The Turn: On your turn, you must remove 1, 2, or 3 coins from any single pile.
  3. The Goal: The player who takes the very last coin from the screen wins!

AI Intelligence: The bot uses a “Nim-Sum” mathematical strategy. While it may make mistakes early on, it becomes increasingly perfect as the coin count drops. Can you beat the math?

🚀 Installation & Running

⬇️ For Regular Users (Windows)

  1. Go to the Releases section on the right side of this page.
  2. Download the latest MindNim.exe.
  3. Double-click the file to play! (Note: You may need to click “Run Anyway” if Windows Defender flags it as an unrecognized app.)

🛠️ For Developers (Run from Source)

If you want to modify the code or run it manually:

  1. Clone the repository: ```bash git clone https://github.com/YOUR_USERNAME/YOUR_REPO_NAME.git cd YOUR_REPO_NAME Run the game: python main.py

✨ Features Dynamic Animations: Smooth cubic-easing animations when coins are removed.

Smart AI: A bot that balances random play with mathematical “Nim-Sum” strategy.

Modern UI: A dark-themed, responsive interface using Tkinter’s Canvas.

Zero Dependencies: Runs on standard Python without needing external libraries like PyGame or Kivy.

Built With Language: Python 3.x

GUI Library: Tkinter

Packaging: PyInstaller

Project Structure main.py - The full game source code.

requirements.txt - Required for building the executable.

.gitignore - Prevents temporary build files from cluttering the repo.