Planetoids: A Retro-Inspired Space Shooter

What is it?

Planetoids is a fast-paced, retro-inspired arcade space shooter built in Python with Pygame.
Dodge asteroids and experience a vintage arcade feel with CRT effects, glitch animations, and pixel-perfect scaling.

🪐 Key Features

• Fast-paced asteroid destruction
• Smooth FPS-independent physics
• Retro CRT visual effects & glitch animations
• Classic arcade gameplay mechanics
• Power-ups and increasing difficulty
• Pixel-perfect scaling for all screen sizes

💾 Installation

🔹 Install from PyPI (Recommended)

The easiest way to install Planetoids is through pip:

pip install planetoids-game

Once installed, launch the game by running:

planetoids

🔹 Install from Source

If you want the latest development version, you can install directly from GitHub:

git clone https://github.com/chris-greening/planetoids-game.git
cd planetoids-game
pip install -e .

Then, start the game with:

planetoids

🚀 Running the Game

Once installed, you can start Planetoids in one of the following ways:

🔹 Run from Source

If you cloned the repository, navigate to the project folder and run:

python3 -m planetoids

This ensures that Python finds the package correctly.

🔹 Run as an Installed Package

If you installed Planetoids via pip, simply run:

planetoids

This will launch the game without needing to reference the Python interpreter directly.

🎮 Controls

🔧 Configuration & Settings

You can modify settings via the Options Menu:

Available Settings

👨‍💻 Contributing

All contributions, bug reports, and suggestions are welcome!

• Open an Issue
• Start a Discussion
• Pull Requests are always appreciated!

📜 License

This project operates under the MIT license. See LICENSE for details.

📩 Support

Feel free to reach out if you have any questions or feedback!

• Email:
  • chris@christophergreening.com
• Twitter:
  • @ChrisGreening
• LinkedIn
  • Chris Greening
• Personal Website
  • www.christophergreening.com