A pygame blob survival game written in Python 3. Guide your blue blob through 10 levels of increasing difficulty.
| Path | Purpose |
|---|---|
~/.config/blobworld/config.ini |
User configuration file — created on first run with defaults. Edit to change screen resolution, player speed, volume, and more. Delete to restore defaults. |
~/.local/share/blobworld/scores.db |
SQLite highscore database — stores the top 10 scores with name, score, level reached, and time played. |
~/.local/share/icons/blobworld.png |
Desktop icon (installed via in-game DESKTOP menu) |
~/.local/share/applications/blobworld.desktop |
Desktop entry (installed via in-game DESKTOP menu) |
A desktop entry and icon can be installed from the DESKTOP option in the
main menu. This requires curl and a network connection to download the files
from GitHub. Once installed the game will appear in your application launcher.
| Package | Purpose |
|---|---|
| pygame >= 2.1 | Game engine — display, input, audio |
| numpy | Collision distance calculations |
pipx install blobworld
or
pip install blobworld
git clone https://github.com/gavinlyonsrepo/blobworld
cd blobworld
python -m venv .venv
source .venv/bin/activate
pip install -e .Note: On newer Linux distributions (Ubuntu 23.04+, Fedora 38+) the system Python is externally managed. Always install inside a virtual environment. Recommend pipx install
blobworldOr if running from source without installing:
python -m blobworld.main