Galaxy Eggbert Documentation
A faithful 3D remake of Speedy Blupi — C++ · Urho3D · CMake
What is Galaxy Eggbert?
Galaxy Eggbert is a 3D remake of Speedy Blupi, originally a Windows Phone XNA platformer game from 2013. The project takes the original game's levels, audio, sprite sheets, and gameplay rules and renders them in a 3D voxel environment using the Urho3D engine API.
The original 2D tile grid becomes a 100×100×100 voxel world. Blupi — the player character — is rendered as a billboard sprite. Enemies and collectibles patrol and bounce through the 3D space. The save format is binary-compatible with the mobile-eggbert C++ reference port.
Quick Navigation
🚀 Getting Started
Prerequisites, submodule setup, and first build steps.
🔧 Build Guide
CMake configuration for Linux, Windows, and Web targets.
🏛 Architecture
High-level design, subsystem map, and data flow.
🎮 Gameplay
Core loop, player mechanics, enemies, and progression.
🌎 Levels & Worlds
World file formats, loading pipeline, and tile types.
📄 Class Reference
Documented public classes, structs, and enums.
📖 Tutorials
Step-by-step guides for common development tasks.
🚧 Known Issues
TODO items, limitations, and incomplete features.
Technology Stack
| Component | Technology |
|---|---|
| Language | C++23 |
| Engine (primary) | Urho3D API via U3D community fork |
| Engine (future) | Nova3D (Robert Vokac's Urho3D fork) |
| Build system | CMake ≥ 3.21 |
| Testing | GoogleTest (54 unit tests) |
| Documentation | Doxygen (auto-generated) + this site |
| Linux graphics | EasyGL (OpenGL) or SDL Renderer |
| Windows graphics | SDL Renderer |
| Audio | Urho3D built-in (SDL_mixer backend) |
Current Status (Phase 27)
| Feature | Status |
|---|---|
| Voxel world model (World/Chunk/Block) | Done |
| World loading (.vwr and .txt formats) | Done |
| Terrain rendering (UV-mapped block faces) | Done |
| Blupi billboard sprite + animation | Done |
| Physics: gravity, jump, AABB collision | Done |
| Enemies and collectibles (partial) | Done |
| HUD: lives, treasures, keys, shield | Done |
| Audio: 93 WAV channels | Done |
| Save system (640-byte binary) | Done |
| 5 worlds with progression | Done |
| Linux + Windows builds | Done |
| Vehicles (helicopter, jeep, skateboard) | Planned |
| Animated 3D Blupi model | Planned |
| Web (Emscripten) build | Planned |
| Android build | Planned |
How to Open This Documentation
This is a static website — no server required. Open src/index.html directly in any modern browser.
All links use relative paths, so the site works from any local directory or when hosted on GitHub Pages.