https://github.com/mchlnix/smb3-foundry
SMB3 Level Editor in Python
https://github.com/mchlnix/smb3-foundry
rom smb3 smb3-foundry smb3-workshop
Last synced: about 2 months ago
JSON representation
SMB3 Level Editor in Python
- Host: GitHub
- URL: https://github.com/mchlnix/smb3-foundry
- Owner: mchlnix
- License: gpl-3.0
- Created: 2019-03-15T11:03:23.000Z (about 7 years ago)
- Default Branch: dev
- Last Pushed: 2026-03-30T08:31:58.000Z (2 months ago)
- Last Synced: 2026-04-02T02:34:30.363Z (2 months ago)
- Topics: rom, smb3, smb3-foundry, smb3-workshop
- Language: Python
- Homepage:
- Size: 49.8 MB
- Stars: 100
- Watchers: 10
- Forks: 15
- Open Issues: 106
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# A modern Super Mario Bros. 3 Level Editor
[](https://youtu.be/7_22cAffMmE)
YouTube Video of 1.0 Beta Version
## Downloads
SMB3 Foundry Level Editor: Linux, Windows, OSX
SMB3 Scribe Overworld Editor: Linux, Windows, OSX
Manuals: SMB3 Foundry, SMB3 Scribe
## Features right now
- Level selection
- Level view
- Block Viewer
- Object-Viewer
- Loading/Saving of levels
- Zooming
- Select, Move and Remove multiple Objects
- Copy/Cut/Paste Objects
- Supports editing Vertical Levels
- Undo/Redo System
- Change Palettes, Music and Jumps to other Levels
- Play any level directly, without having to overwrite your ROM
- Make screenshots of your Level
## To come
- Better interface concerning level size
## Not planned right now
- Support of other versions, other than the US release
## Contact
Come to the [SMB3 Romhacking Discord](https://discord.gg/pm87gm7) and message Michael.
## How to run
### The Easy Way
You can use the executables in the [Releases](https://github.com/mchlnix/SMB3-Foundry/releases) tab on Github under **Assets**. Those should work out of the box.
Alternatively you can try the methods below.
### Windows
1. You need to have at least Python 3.10 (3.11 recommended) installed. To do that, go to
https://www.python.org/downloads. Make sure to tick the box "Add Python to
Path"!
2. You need to install the Qt for Python GUI framework. To do that, open a command
prompt (search cmd in Windows) and type in `pip install -r requirements.txt`. This should work automatically.
3. Click on smb3-foundry.py and the level editor should open up, asking you to
select the ROM you want to load. Preferably the US version of SMB3 or a Hack
based on it.
### Linux
1. The `python3` package should already be installed on your system. If not then do it using your distributions package manager.
2. Install `python3-pip` using the package manager as well.
3. Install the dependencies, using `pip3 install -r requirements.txt`.
4. You can start the level editor using `python3 smb3-foundry.py` using the terminal.