# 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
