Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Random Level Generator and Level Script Compiler for Super Mario Bros. 1 on the NES

GitHub release Github all releases GPLv3 license

Download for Windows

About Level-Headed

Level-Headed is an application that is still under development. Ultimately, I am designing it to be a random level generator that will work across multiple platforming games. In its current state, Level-Headed can essentially create new Mario games based off of Super Mario Bros. 1 (SMB1) with a click of a button! Users can also create their own levels using the "SMB1_Compliance" scripting language. As of now, only SMB1 is supported, but in the future, support for more games will be added.

In order for Level-Headed to work properly, a base ROM must be supplied to Level-Headed. You can read more about which ROMs are supported here.

Check out the Level-Headed Wiki for more information and tutorials on how to use Level-Headed.

If you're a Windows user, you can download the Windows build under the releases tab. Linux and Mac users should compile the application and plugins via the Unix Build Script. Alternatively, Level-Headed can be compiled via Qt Creator.

If you have any questions about Level-Headed, feel free to contact me at


Q: What's going to be in the next update?

A: You can see what changes are going to be implemented by looking at the changelog.

Q: When are you going to add new patterns into the level generator? What about new level types?

A: Currently, levels still only have access to about 10 patterns per level type, which is why the levels can sometimes be a bit stale. The v0.4.x series of updates will address this by focusing on creating new patterns for existing levels as well as adding completely new level types all together. v0.4 is still a ways off though, as I intend to write a graphical pattern editor to easily make new patterns for the level generator. Development of this tool will need to be completed before development of v0.4 can start.

Q: How do I add my own graphics and music patches?

A: There's a tutorial on how to do that on the wiki here.

Q: There's no variety!

A: Bear in mind that Level-Headed is only v0.3, so it's only a fraction of what I have planned. Think of current releases as a preview of what's to come. With each update, this will become less and less of a problem.

Q: When will you support X game?

A: Level-Headed is being designed from the ground up with multi-game support in mind, but don't expect to see support for another game until after v1.0. That's a very, very long ways off.

Q: Is Level-Headed dead? You haven't updated it in months!

A: No, it is far from dead. I tend to work on Level-Headed off and on when I have spare time and when I have the interest. Consequently, development tends to be very slow and sporadic. However, I can't see myself ever dropping this project completely.