Mice!

Mice! is a strategic game where players must kill rats with bombs before they reproduce and become too numerous. The game is a clone of the classic game Rats! for Windows 95.

Compatibility

It's developed in Python 3.11, please use it

Features

• Maze Generation: Randomly generated mazes using Depth First Search (DFS) algorithm.
• Units: Different types of units such as rats, bombs, and points with specific behaviors.
• Graphics: Custom graphics for maze tiles, units, and effects.
• Sound Effects: Audio feedback for various game events.
• Scoring: Points system to track player progress.

Technical Details

• Language: Python 3
• Libraries:
  • sdl2 for graphics and window management
  • Pillow for image processing
  • uuid for unique unit identification
  • subprocess for playing sound effects
  • tkinter for maze generation visualization
• Game Loop: The game uses a main loop to handle events, update game state, and render graphics.
• Collision Detection: Each unit checks for collisions with other units and walls.
• Sound Management: Sound effects are managed using the subprocess module to play audio files.
• Environment Variables:
  • SDL_VIDEODRIVER to set the video driver
  • RESOLUTION to set the screen resolution
• Engine: The game engine is built using SDL2, providing efficient rendering and handling of game events. The engine supports:
  • Image Loading: Using Pillow to load and process images.
  • Text Rendering: Custom fonts and text rendering using SDL2's text capabilities.
  • Sound Playback: Integration with SDL2's audio features for sound effects.
  • Joystick Support: Handling joystick input for game controls.
  • Window Management: Fullscreen and windowed modes, with adjustable resolution.

Installation

1. Clone the repository: bash git clone https://github.com/yourusername/mice-maze-game.git cd mice-maze-game
2. Create a virtual environment: bash python3 -m venv venv source venv/bin/activate
3. Install the dependencies: bash pip install -r requirements.txt
4. Run the game: bash python rats.py

Project Files

• maze.py: Contains the MazeGenerator class for generating and visualizing the maze.
• rats.py: Main game file that initializes the game and handles game logic.
• engine/controls.py: Contains the KeyBindings class for handling keyboard input.
• engine/maze.py: Contains the Map class for loading and managing the maze structure.
• engine/sdl2.py: Contains the GameWindow class for SDL2 window management and rendering.
• units/bomb.py: Contains the Bomb and Explosion classes for bomb units.
• units/rat.py: Contains the Rat, Male, and Female classes for rat units.
• units/points.py: Contains the Point class for point units.
• assets/: Directory containing game assets such as images and fonts.
• sound/: Directory containing sound effects.
• README.md: This file, containing information about the project.
• requirements.txt: Lists the Python dependencies for the project.
• .env: Environment variables for the project.
• .gitignore: Specifies files and directories to be ignored by Git.
• scores.txt: File for storing high scores.