super-mango-editor
C11 + raylib platformer, visual level editor, and hands-on game-development school — playable in the browser via WebAssembly.
Play → | Learn → | Builder Manual → | Releases →
About
Super Mango is a C11/raylib platformer and a place to learn C by taking a real
game apart: play it, freeze and step the running simulation, edit its TOML
worlds, and read the code that connects them. The campaign is Creator's
Playground → Volcanic Depths 1 → Volcanic Depths 2. Six small mechanics levels
in levels/labs/ go with an eight-lab learning track. The standalone editor
saves the same TOML files the game loads. Native builds run on macOS, Linux and
Windows; Emscripten builds the browser version.
Start learning: Sandbox School · Debugging C · C in This Codebase · Mechanics Museum · Entity Walkthrough
The source is part of the lesson. Explicit update/draw steps, simple loops and
comments about units, ownership and library calls are intentional. We favour
code a learner can trace over a shorter version that hides a step.
Tech Stack
| Technology | Version | Purpose |
|---|
| C | C11 | Language standard (clang -std=c11) |
| raylib | 6.2, pinned source/checksum | Window, graphics, input, PNG loading, built-in text font and audio; bundled GLFW on desktop |
| CMake | Available platform version | Out-of-source raylib dependency build; Make remains the application entry point |
| tomlc17 | R260821 + project patches | TOML v1.1 parser; upstream provenance and patch inventory |
| Emscripten | 6.0.13 in CI | WebAssembly compilation for browser play |
What is in it
- A side-scrolling platformer with multi-screen TOML worlds, 33 render layers and fixed 1/60 s physics steps (
make timing-lab shows why)
- Six enemy types, seven hazard types, coins (score and bonus lives), health stars and an end-of-level star
- Vines, ladders, ropes, three bouncepad sizes, crumbling bridges and float platforms
- Authored
[[checkpoints]], or automatic screen-boundary respawns for levels without them
- Pause, game-over and completion overlays: Up/Down or D-pad selects, Enter/Space/Start confirms (A also confirms), Esc/Back exits (B also exits)
- Keyboard, hot-plug gamepad and browser touch controls; F1 settings with remapping, audio, dead zone, window scale, high contrast and reduced motion
- A debug inspector to freeze, step, slow down and tune the simulation, and to record and replay experiments
- A standalone level editor with undo/redo, copy/paste, validation that blocks bad saves, autosave and one-key playtesting
The manual covers each of these in detail.
Getting Started
Prerequisites
A C11 compiler (clang or gcc), make, CMake, Python 3 (3.12+
recommended) and Node.js 22.12+ (CI uses Node 26.9.0), which make test needs for
its six JavaScript host-contract tests. The first build downloads and verifies
the pinned raylib 6.2 source; no system raylib is needed. See dependency provenance.
macOS:
brew install cmake python node
xcode-select --install # provides clang and make
Linux (Debian/Ubuntu):
sudo apt update
sudo apt install build-essential clang cmake python3 libgl1-mesa-dev libx11-dev \
libxrandr-dev libxinerama-dev libxcursor-dev libxi-dev zenity
# Node.js 22.12+: distribution packages are often older; see https://nodejs.org/
Windows (MSYS2 UCRT64):
pacman -S make mingw-w64-ucrt-x86_64-clang mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-python \
mingw-w64-ucrt-x86_64-cmake mingw-w64-ucrt-x86_64-make
# plus Node.js 22.12+ from https://nodejs.org/ on PATH
WebAssembly: install the Emscripten SDK at 6.0.13 with emcc and emcmake on PATH. GitHub CI is the authoritative WASM release verification; report local toolchain failures separately from application failures.
make doctor reports which of these are missing before the first build.
The docs tools need Python 3.11+; the docs site also needs Bun
(see website maintenance). On a machine without a display or
sound card, make test OUTDIR=out/headless RAYLIB_PLATFORM=memory runs the
tests on raylib's in-memory backend.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
