Who owns SMBX?

Currently, SMBX is owned and managed by the SMBX Forums leaders. We simply develop new technology for it – we call this “SMBX2.”

What is “SMBX2” exactly?

SMBX2 is a collaborative, open-source effort to improve and expand upon the original SMBX.  Among other things, SMBX2 features:

  • new playable characters
  • a robust new Editor
  • more NPCs, BGOs and Blocks
  • a scripting extension using the Lua language
  • Countless other features listed at the bottom of the download page

Is SMBX2 related to SMBX 38A (A.K.A. SMBX 1.4.x)?

The two are completely separate. Both projects intend to serve as successors to version 1.3 of SMBX, but 38A is its own software developed from the ground up whereas SMBX2 is being built around Redigit’s original code. As a result, compatibility with older episodes tends to be much higher in SMBX2 than in 38A.

The SMBX Source Code has been released. Are you going to make use of it?

We can’t, no. Not without completely rewriting the entirety of SMBX2 from scratch, at the very least. SMBX2 relies on the used compiled build of SMBX 1.3 to stay as-is in order for LunaLua to function. Upgrading to a different compiled build would make LunaLua, and thus the entirety of SMBX2, unusable. As such, we will ignore the SMBX source code completely.

How far is SMBX2 into development?

As of writing this, we’re releasing new builds working towards a full, stable SMBX2 2.0.0 release. We frequently post previews and updates on this site’s dev blog, and if you want to follow development more closely you can join us in the codehaus discord server.

Can you add [NPC/Block/BGO] from [game]?

Assets are done on the basis of “is someone willing to make it” and “what will it add to the game”. Check the resource claims sheet; if the thing you want is on there, it means it’s already planned or being worked on.

With the release of Beta 4, our focus on adding entities has mostly shifted towards polishing other aspects of the game. Outside of the elements included by default, people in the community publish their own custom packs, which might include something you’re looking for.

The program isn’t starting/I can’t test levels/I don’t see any custom graphics!

If you’re experiencing issues like this, there are several things you can try.

1. Make sure your antivirus software is not preventing SMBX2 from executing properly.

2. Make sure SMBX2 is installed in a location which doesn’t require admin privileges for writing files.

3. The “No Custom Graphics” error in particular has shown to correct itself after a reinstallation. Sorry for the inconvenience.

I found a bug! How do I report it?

We currently don’t have a formal bug tracker, so please contact us directly on the Codehaus Discord server using the link at the top of the page.


Who is Uncle Broadsword?

He’s a character from a game that (as of writing this) is currently being developed by the talkhaus community, a forum that many of the SMBX2 devs are members of.  All you really need to know about Broadsword is that he’s a treasure-hunting alien with a magic sword and that one of his brothers is a toaster.

Who is Megan?

Megan is Megan.

Please remove Megan


Who is [other character]?

Aside from Broadsword, Megan, and a few other NPCs (like Blerts and Grafs), all of the new playable characters and NPCs come from existing video games. Many of them are taken from the original games that SMBX 1.3 pulled from as well as their many spinoff series.

Can you add [character]?

We’re currently focusing on other aspects of the game and the current roster will see no major additions until we’re ready to go out of beta. Afterwards, anything can happen! Sonic and Kirby are fan-favourites and frequently requested, but they’re both difficult to make and considering we’re optimizing and changing systems throughout the betas, it would be a waste to work on them now. In the meantime, though you might see community-made episodes or levels that feature their own custom player characters, so keep an eye out for those!


How do I playtest levels in the new editor?

Press F5 or go to Test > Test Level.

Why was the level editor from SMBX 1.3 replaced?

The old editor was buggy and lacked many basic quality-of-life features of modern software. It lacked the ability to do simple tasks such as undo/redo – or even have multiple levels open at once! Like the rest of SMBX, it was closed-source, so it would have been extremely difficult to develop from it in any meaningful way.

What are some of the improvements and new features that come with the new editor?

In addition to those previously-mentioned QoL features, the new editor boasts: a sleeker and more customizable interface, more block and NPC placement tools, a variable-size snapping grid, and so much more.


What sort of things can you do with LunaLua?

LunaLua can be used for simple, mundane things like powerup and character filters, but it can also be used to add interesting and impressive bosses, cutscenes, gameplay systems, and visual effects to episodes and levels.

Do I need to be an expert programmer to make use of Lua scripting?

If you have done any programming before, it will certainly help. However, this is by no means necessary to do cool stuff with LunaLua. By loading even a single Library or adding just a few lines of code, you can profoundly change how your level or episode plays!

Is Lua/LunaLua difficult to learn?

Compared to other programming languages, Lua is less complex and is much more relaxed with the rules governing its syntax. In other words, the language has much more forgiving grammar. As such, it is a very appropriate language to start learning programming in. It’s worth noting that many members of the SMBX2 dev team actually had no prior coding experience and learned how to program through using LunaLua!

What are helper libraries?

Helper libraries (sometimes erroneously referred to as “APIs”) are self-contained scripts and packages of LunaLua code that provide simplified and streamlined building blocks for more complex systems.  One such package, for example, allows you to create visually impressive secret areas in your levels.  You can find community-made helper libraries on the forums.

How and where can I learn how to code in LunaLua?

There are many ways to go about it. Some learn best through dissecting and analyzing code written by other level creators. Others, meanwhile, learn by starting with a simple task: for example a powerup filter or a small tweak to the player’s physics. Starting small like this allows one to easily work one’s way up to more ambitious challenges.

We’re constantly updating and expanding the LunaLua documentation and a series of tutorials that cover the basics of Lua and the LunaLua API are in the works.  Also, in addition to being the main hub of SMBX 2’s development, the codehaus discord server is a great place to learn about LunaLua by asking questions and getting feedback on your work.


How do you add new content in SMBX2?

While the project is open-source, we don’t actually have access to SMBX’s source code;  instead we’re using assembly hacks to inject hooks into various areas of the game’s compiled code.  These hooks allow us to remove hard-coded limits, alter the game’s memory, override processes like the rendering and sound systems, and fix bugs like the infamous mushroom-in-lava crash.  Inserting the hooks is a lengthy process, however, so for now we still need to work around some of the limits of the original code.

Will you add [feature] from 38A’s SMBX (SMBX 1.4)?

We eventually plan to have some degree of support for 38A levels, but due to differences in the way the two engines are built we’ll likely never have full compatibility.


Are you officially affiliated with any video game companies?

SMBX2 is simply a hobby project that mashes together various video games. In no shape or form do we claim to be affiliated or endorsed by any companies or individuals. We do, however, encourage people to support your favorite video game companies by buying the official games and consoles. If you would like to support the company that made all of this possible, you can show your support to Nintendo by buying a Nintendo Switch!

Can a company like Nintendo ask you to take this down?

Currently, we consider this project to be a derivative work covered under Fair Use. However, we are not lawyers and, in the event that a company like Nintendo disagrees with our assessment, we’ll oblige immediately and without question to any and all of their requests, including the removal of content.

Afterwards, if it is amenable to the company in question, we will aim to replace any removed content with something completely original.