# Planetary Multiplier
Version 0.1
`Planetary Multiplier` is a game for **Break the Universe: A Mini Space Simulation**.
You launch planets into a chaotic orbital system, stack score multipliers, manage wall-hit lives, and try to beat your best score.
## Requirements
- Python 3.10+
- `pyglet`
Install:
```bash
pip install pyglet
```
Run:
```bash
python gravity_waves.py
```
## Gameplay
- Central sun gravity and orbital motion
- Drag-and-release launcher
- Water droplet splash system that can form mini planets
- Goldilocks ring that slowly increases multiplier when planets stay inside
- Boundary system (`BOUNCE` / unlockable `WRAP`)
- High score + progression saved locally
## Controls
- `1` = Start Normal mode (3 lives)
- `2` = Start EZ mode (10 lives)
- `R` = Reset run
- `L` = Change boundary mode before a run starts
- `M` = Toggle BGM (only appears after BGM unlock and if audio support is available)
- Mouse drag opposite direction, release to launch a planet
## Progression
- Beating your own best score 3 times unlocks `WRAP` mode.
- Beating your own best score 5 times unlocks optional BGM.
## Optional BGM (assets/Track 01.ogg ... Track 41.ogg)
BGM is optional and auto-detected at runtime.
- If your setup can decode/play `.ogg` through pyglet, BGM appears in the UI when unlocked.
- If audio backend/codec support is missing, BGM options are hidden automatically.
If `.ogg` playback is missing on your machine, install FFmpeg and make sure it is available on your system `PATH`, then restart the game.
## Save Files
- `planetary_multiplier_highscore.txt` stores score/unlock progress.
- Legacy `planet_multiplier_highscore.txt` and `gravity_waves_highscore.txt` are still read for migration if present.
## Third-party Asset
Optional unlockable background music (BGM): track(s) from "Free Chiptune Collection [ For Game Usage] (OC)" by CallRoll
Source: Internet Archive item "free-chiptune-collection-for-game-usage"
License/usage note: Public Domain Mark 1.0; uploader states "use this as you please" and "No credit needed."
Used as: optional unlockable background music only; not part of the core gameplay, visuals, or main original content of the entry