🎮 Console Mini Games

A collection of retro arcade-style games for the terminal, built with Python.

---

🕹️ Games Collection

Game	Description	Status
Tetris	Classic block-stacking puzzle	✅ Ready
Snake	Classic snake game	🔜 Coming Soon
Pong	Two-player paddle game	🔜 Coming Soon
Breakout	Brick-breaking arcade	🔜 Coming Soon
Space Invaders	Alien shooter	🔜 Coming Soon

---

🧱 Tetris

A retro arcade-style Tetris game with colorful ASCII graphics.

✨ Features

• 🎨 Colorful ASCII Graphics - Beautiful retro visuals with colored blocks
• 🎲 Random Spawns & Rotations - Pieces spawn at random positions and rotations for extra challenge
• ⚡ Key Acceleration - Hold arrow keys to move faster
• 🔥 Combo System - Get bonus points for clearing multiple lines (Double, Triple, Tetris!)
• 👻 Ghost Piece - See where your piece will land
• 🕹️ Retro Intro - Classic 3-2-1-GO! countdown with ASCII art

📸 Screenshots

Gameplay

Combo System

🎮 Controls

Key	Action
← → or A/D	Move left/right
↓ or S	Soft drop
↑ or W	Rotate
Space	Hard drop
P	Pause
Q	Quit
R	Restart (after game over)

🚀 Installation

Option 1: Run the EXE (Windows)

Download ConsoleTetris.exe from the Releases page and run it directly. No Python required!

Option 2: Run from Source

# Clone the repository
git clone https://github.com/tntvlad/console-mini-games.git
cd console-mini-games

# Run Tetris
python console_tetris.py

Requirements: Python 3.6+

🏗️ Build from Source

To build the executable yourself:

pip install pyinstaller
python -m PyInstaller --onefile --console --name "ConsoleTetris" console_tetris.py

The executable will be in the dist folder.

🎯 Scoring

Lines Cleared	Points	Bonus
1 (Single)	40 × Level	-
2 (Double)	100 × Level	+25%
3 (Triple)	300 × Level	+50%
4 (Tetris)	1200 × Level	+75%

• Soft drop: +1 point per cell
• Hard drop: +2 points per cell dropped

📝 License

MIT License - feel free to use, modify, and distribute!

---

🚧 Roadmap

• Tetris
• Snake
• Pong
• Breakout
• Space Invaders
• More games...

🤝 Contributing

Want to add a game to the collection? Feel free to open a PR!

🙏 Acknowledgments

Built with ❤️ for retro gaming enthusiasts.

---

Enjoy the game! 🎮✨