Skip to content

Latest commit

 

History

History
116 lines (97 loc) · 3.21 KB

README.md

File metadata and controls

116 lines (97 loc) · 3.21 KB

🎮 Python Arcade Collection

A collection of classic arcade games implemented in Python using Pygame.

Games Included

🐍 Snake Game

  • Classic snake gameplay with modern visuals
  • Grid-based movement with wall crossing feature
  • Score tracking and game over screen
  • Smooth animations and visual effects
  • Controls: Arrow keys to move, ESC for menu

📚 Hangman

  • Multiple word categories with extensive vocabulary (100+ words each):
    • 🦁 Animals: From common pets to exotic wildlife
    • 💰 Crypto: Comprehensive blockchain and cryptocurrency terms
    • 🤖 AI: Artificial Intelligence concepts and terminology
    • 🧠 LLMs: Large Language Models and NLP terminology
  • Smart word selection system to avoid repetition
  • Detailed hints for educational value
  • Hint system (Ctrl+H to show hints)
  • Animated drawing of the hangman
  • Visual feedback for correct/incorrect guesses
  • Controls: Type letters to guess, ESC for menu

🏓 Pong

  • Single-player vs AI with three difficulty levels
  • Dynamic AI behavior with realistic paddle movement
  • Score limit of 10 points to win
  • Player and AI labels with score display
  • Controls: W/S keys to move, ESC for menu

🎯 Tetris

  • Classic Tetris gameplay with modern interface
  • Score system and level progression
  • Next piece preview and score display
  • Controls: Arrow keys to move/rotate, ESC for menu

✨ Features

Main Menu

  • Dynamic game previews with animations
  • Smooth transitions between games
  • Easy navigation with arrow keys
  • Visual feedback for selected games

Common Features

  • Consistent ESC key behavior across all games
  • Modern UI with clean visuals
  • Score tracking and high scores
  • Game over screens with restart options
  • Smooth animations and transitions

🛠️ Technical Details

Requirements

  • Python 3.x
  • Pygame library

Installation

  1. Clone the repository
  2. Install dependencies:
pip install pygame
  1. Run the game:
python main.py

🎮 Controls

  • Arrow Keys: Navigation in menus and games
  • ESC: Return to previous menu/quit
  • Game-specific controls are shown in each game

Development

Code Structure

  • main.py: Main game launcher
  • games/: Individual game modules
    • Snake game files
    • Hangman game files
    • Pong game files
    • Tetris game files
  • utils/: Shared utilities and effects
    • Animation and visual effects
    • Sound effects

Features Added

  • Dynamic game previews in main menu
  • Transition effects between screens
  • Unified control scheme
  • Score tracking system
  • Sound effects for games
  • Error handling and performance optimizations

📝 Updates and Changes

  • Added wall crossing feature to Snake game
  • Implemented AI difficulty levels in Pong
  • Enhanced Hangman with expanded vocabulary (400+ words total)
  • Added detailed hints and descriptions for all words
  • Added score limit and winner screen to Pong
  • Improved visual feedback across all games
  • Fixed various bugs and performance issues
  • Added preview animations for all games
  • Standardized menu navigation and controls

Contributing

Feel free to contribute to this project by:

  • Reporting bugs
  • Suggesting new features
  • Submitting pull requests

License

This project is open source and available under the MIT License.