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.
- 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
The easiest way to install Planetoids is through pip:
pip install planetoids-gameOnce installed, launch the game by running:
planetoidsIf 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:
planetoidsOnce installed, you can start Planetoids in one of the following ways:
If you cloned the repository, navigate to the project folder and run:
python3 -m planetoidsThis ensures that Python finds the package correctly.
If you installed Planetoids via pip, simply run:
planetoidsThis will launch the game without needing to reference the Python interpreter directly.
| Key | Action |
|---|---|
| Arrow Keys | Rotate & Thrust |
| Space | Fire |
| P | Pause |
| Enter | Select Menu Items |
You can modify settings via the Options Menu:
| Setting | Description |
|---|---|
| crt_enabled | Enable CRT retro effect |
| glitch_intensity | "minimum", "medium", or "maximum" |
| pixelation | "minimum", "medium", or "maximum" |
All contributions, bug reports, and suggestions are welcome!
- Open an Issue
- Start a Discussion
- Pull Requests are always appreciated!
This project operates under the MIT license. See LICENSE for details.
Feel free to reach out if you have any questions or feedback!
- Email:
- Twitter:
- Personal Website