The open-source
level editor
for Mario hacks.

Everything Lunar Magic edits, plus custom sprites and patches, in one window. Opens ROMs you already edited in LM. Share a project, not a ROM.

Download for Windows Read the source (MIT) → Also available: Linux x64 · In development
The Level editor: level $105 on Layer 1 with a sky background of clouds and
                blue hills, and the FG tile picker down the left side. The Map16 editor: the 16x16 tile map for level $105 with the 8x8 graphics
                picker down the left side. The Graphics editor: GFX014 zoomed to 1500% with pixel tools along the top
                and the loaded FG, BG and sprite files listed on the left. The Animations editor: a global 32x8 slot with four frames and a live preview.

Download Pipe Dream

Windows installer Linux executable

No packaged macOS build yet.

One tool instead of six.

A SMW hack today stitches together a level editor, a block inserter, a sprite inserter, a music patcher, an ASM runner and an assembler, each with its own folders and its own way to break your ROM at 2am. Pipe Dream is the one program that does all of it: same window, same project, same undo history.

Lunar Magic

opens as is● live

Asar

patches● live

PIXI

custom sprites● live

GPS

custom blocks● live

AddmusicK

custom music● live

UberASM

custom code● live

ROMs already edited in Lunar Magic open, edit and save without conversion, and without breaking when you go back to LM afterwards. It edits the ROM the way the game reads it: real pointer tables, level headers, object streams and Map16 pages. Not a wrapper, not a patch format.

project.pdpno ROM data
  "SchemaVersion": 1,  "BaseRom": { "Sha256": "78fa978f…", "Title": "SUPER MARIOWORLD" },  "Map16": {    "Slots": {-      "0D8A68": "0410041004100410"+      "0D8A68": "0910091009100910"    }  }
● reviewable in a pull request

Share the project, not the ROM.

Your work saves to a .pdp project file: plain JSON describing every edit relative to a pinned base ROM. No ROM data at all.

  • Hand a collaborator the file; with the same base they see exactly what you see
  • It's text: commit it, branch it, diff it like any other file
  • The base ROM is read, never written; a bad session costs a rebuild
  • Builds are outputs, and ship as BPS patches

Easier to get started.

Most people who want to make a Mario level give up somewhere between the fifth download and the first hex offset. Pipe Dream is built so you never hit that point.

Nothing to assemble first

One install, one window. No tool chain to wire up before you can place a block.

Guided first run

It walks you through pointing at your base ROM and making a project, and recovers on its own when a base goes missing.

Plain language, not raw bytes

Level settings, exits and tile properties are named fields. You shouldn't need a hex table to change the music.

Undo everywhere

Real edit history, so poking at something you don't understand yet is how you learn instead of how you lose an afternoon.

What works today.

Everything Lunar Magic edits, edited here, plus the jobs you used to hand to separate tools.

Level editing

Objects and sprites on a live canvas: place, drag, rubber-band select, undo. Rendered through the real object engine, so what you see is what loads.

Map16 & graphics

Map16 pages with tile properties (acts-like, palette, priority, flips), ExGFX import, a GFX browser, palette grids, background picker.

Overworld

Areas, level tiles, events and transitions, with Lunar Magic's own overworld palettes so every colour edits.

Exits & entrances

Main entrance, secondary entrances, vanilla and LM secondary exits, listed and edited instead of hand-poked in hex.

Custom sprites

Import PIXI sprites, slot them, edit their config and place them like vanilla ones. Up to 255 sprites a level, with our own MIT driver.

Patches & BPS

A project keeps its Asar patches, applied in order at build, and the build ships as a BPS patch the way the community expects. Asar comes bundled.

Cross-platform

One codebase, no platform-specific editor code. Windows and Linux builds come out of CI on every commit; macOS builds from the same source.

Scriptable

The same executable runs headless for batch jobs and CI: render, diff, self-check, and creating or building projects.

Roadmap.

Most of these replace a tool you currently download and run by hand. A ✓ means it's live in the editor today. No timelines, and these land one at a time.

✓
Sprite managerInstall custom sprites and place them like vanilla ones. Their config, table entries and per-level assignment are handled for you.
instead of PIXI
✓
Updates that install themselvesPipe Dream checks for a new release, downloads it, and replaces itself. Your projects and config stay put.
instead of re-downloading
✓
Feature parity with Lunar MagicEverything LM edits, edited here, overworld included. You no longer need LM open beside it.
instead of keeping LM open
✓
Block managerInstall a custom block and get all of it: the code, its Map16 entry, its acts-like setting.
instead of GPS
✓
UberASM managerAttach custom ASM to a level, a gamemode, or the whole game, from the level you're looking at.
instead of UberASMTool
✓
Music managerInstall songs and pick a level's music by name instead of by number. See sample group space before you run out of it.
instead of AddmusicK
✓
SA-1 supportOpen, edit and build SA-1 ROMs. Sprites, blocks and patches assemble against the SA-1 memory map for you.
instead of SA-1 Pack by hand
Background managerInstall a background and get its ExGFX, palette and Map16 pages set up together.
instead of the ExGFX shuffle
Shareable custom base ROMsPackage a prepared base (patches, ASM, resources) for someone else to build against. A .pdp already pins its base; this shares it.
instead of passing ROMs around

If one of them is what you're waiting on, say so on the issue tracker.

OPEN SOURCE

If you don't like something, fork it.

bash
$ git clone https://github.com/john-sparwasser/pipe-dream
$ cd pipe-dream
$ dotnet run --project src/PipeDream.csproj
  • Change the UI
  • Add a tool
  • Ship your own build

MIT licensed

Install.

No toolchain, no compiling. Windows gets a per-user installer needing no admin rights, and CI proves it works by installing it, running a self-check from the installed binary and uninstalling again. Linux gets a single self-contained executable: chmod +x and run. Either way it carries its own .NET runtime, so there's nothing to install alongside it, and the editor can update itself from then on.

Take the file for your platform from the latest release: the PipeDream-Setup installer for Windows, or PipeDream-linux-x64 for Linux.

Every commit also gets built and tested on both platforms, so if you want something newer than the last release, the build workflow has one, though those artifacts need a GitHub login and expire after 90 days, which is why the release above is the better link.

You supply your own copy of Super Mario World. Pipe Dream ships no game data.

Status.

Pipe Dream is pre-release and under active development. It now covers everything Lunar Magic edits; the latest release is v0.8.0. Try it on a copy of a hack rather than the hack, keep backups of any ROM you point it at, and file what breaks. What's next is on the roadmap.

It's MIT licensed and the whole thing is on GitHub. Bug reports from people who got stuck in the first ten minutes are the most useful kind. Come say hi and ask questions on the Discord.

Resources.

Stop juggling six tools.

Free, open source, and one install. Bring your own copy of Super Mario World.