planetoids-game 0.5.0

A retro-style space shooter game built with Pygame.

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

Key	Action
Arrow Keys	Rotate & Thrust
Space	Fire
P	Pause
Enter	Select Menu Items

---

🔧 Configuration & Settings

You can modify settings via the Options Menu:

Available Settings

Setting	Description
crt_enabled	Enable CRT retro effect
glitch_intensity	"minimum", "medium", or "maximum"
pixelation	"minimum", "medium", or "maximum"

---

👨‍💻 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:
  • [e-mail]
• Twitter:
  • @ChrisGreening
• LinkedIn
  • Chris Greening
• Personal Website
  • www.christophergreening.com