blobworld 1.4.0

A blob-eat-blob survival game, written in pygame

Blob World

Description

A pygame blob survival game written in Python 3. Guide your blue blob through 10 levels of increasing difficulty.

File System

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)

Desktop entry

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.

Dependencies

Package	Purpose
pygame >= 2.1	Game engine — display, input, audio
numpy	Collision distance calculations

---

Installation

From PyPI (recommended)

pipx install blobworld 

or 

pip install blobworld

From source

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

---

How to Run

blobworld

Or if running from source without installing:

python -m blobworld.main