Page 1 of 7

Meet TheXTech: a full working cross-platform port of SMBX engine [1.3.6]

Posted: 14 Mar 2020, 16:18
by Wohlstand
Hello everybody!


Did you see that I have done little work in my public repositories during February and at the start of March 2020? So, I did a lot of work which I am going to present for you all: it's a full C++ port of the original SMBX engine which now works on multiple platforms (tested on Linux, Windows, macOS, Haiku, and Android), and it does accurately represent original gameplay with the rest of features and bugs!

Some screenshots










How I made it?
Since February 2, SMBX's original source code is now open. This fact gave me a lot of helpful material which will help me to make the Moondust Engine better and faster! However, dealing with the VB6 environment is not convenient, and at the same time, it's not stable on Linux (because of the graphical engine and risk of VB6 IDE's crash due to using external DLL libraries). So, to get it to work easier, I remembered my very old idea to port the whole SMBX code to C++. So, after a week of initial research, I began working. After a week and a half, I got a fully working (but buggy in some places) thing. Then, I spent time debugging it and making it usable by everyone. It's the full replica of SMBX 1.3 with the rest of its logical bugs (with some exceptions: I did fix several crash bugs that were a big annoyance while playing a game). It works on multiple platforms: it works on Windows both 32 and 64 bits, on Linux, on macOS, (also may work on Haiku and xBSD). Since version 1.3.5 has Android support!

Frequently Asking Questions
This paragraph contains a list of several questions you would to ask me, I'll give answers to most of them.
Frequently Asking Questions
What is this?
It's a port of an old VB6 engine, purely written in C++. It reproduces an old engine completely (except an Editor), includes lots of its logical bugs (crashy bugs where they were found and then fixed).

Why did you make it?
Why? I have several purposes for why I made it:
  • It's a very convenient life model for research I want to use in PGE Engine development.
  • To make it work without it being necessary to use Wine on non-Windows platforms and allow it to run on any other than x86 platforms.
  • To be able to optimize it to make it use fewer hardware resources than the original VB6-based build of a game.

You have PGE Engine, why you have spent over one month crafting this thing?
I need it for PGE Engine development directly, it's much easier to hack and inspect rather than deal with the old and inconvenient VB6 environment.

What's the future of Moondust Engine as TheXTech now exists?
I'll continue the development of the Moondust Engine as I still have to pass the second goal of the Moondust Project.
Since the foundation, Moondust Project had two goals: 1) save SMBX; 2) give a flexible toolkit for new platform games. Opening of SMBX sources and introducing TheXTech has solved the first goal: SMBX has been saved and now it's free and open-source cross-platform software. Moondust Engine will be used to pass the second goal - giving a toolkit for new games. Unlike TheXTech, Moondust Engine gives full flexibility that allows anyone to build something new from scratch without inheriting an old game base. However, TheXTech is needed for Moondust Engine as a working research model to develop a new engine. It will be similar to GZDoom and Chocolate Doom ports of the Doom game: GZDoom is a powerful and functional engine, the best choice of modders; a Chocolate Doom is an accurate port of the original game to a modern platform with a purpose to represent an original game including even bugs. The Moondust Engine intends to be like a GZDoom while TheXTech is an analog of Chocolate Doom to represent an original game on modern platforms.

Can LunaLua work on this?
No, LunaLua won't work: this project is binary-incompatible with LunaLua. This also means that SMBX2 content is incompatible.

How to use this?
Here are many ways to play games with it:
- there are some ready-for-use packages, just take and use as you did it with SMBX.
- [macOS users, skip this]: use by the same way as an original game: put an executable file into the game root folder with a "thextech.ini" that contains the next text:

Code: Select all

force-portable = true

, music.ini, sounds.ini and additional "graphics/ui" folder. An important note: all default graphics must be converted into PNG, use the GIFs2PNG tool from PGE Project over your "graphics" folder with a "-d" switch. Don't use the "-r" switch to keep original GIFs together with new-made PNGs if you plan to continue the use of the original VB6-written SMBX.
- use it for debug mode: in your home directory, create the ".PGE_Project/thextech" folder (on macOS the "~/Library/Application Support/PGE Project/thextech") where you should put a full set of game resources and worlds stuff, this folder will work as a game root in the original game. This mode allows you to run an executable file from any folder location of your computer and use the same location of resources for all builds (except these are marked as portable by an INI file).

How to add custom episodes for the macOS version?
If you have a bundled build of TheXTech, all default resources are inside your .app: "Content/Resources/assets/". You can modify the content, but it's not recommended! Instead, after the first run of a game, in your home directory will appear the next directory:

Code: Select all

~/TheXTech Episodes

In this directory, you will find an empty "battle" and "worlds" folder to put your custom stuff. At the "~/Library/Application Support/PGE Project/thextech" path logs, settings, and game saves will be stored.
If you want to replace default assets with your own, you can modify the content of the app bundle or compile a new build by giving the necessary CMake arguments needed to pack your custom assets root and icon into the new bundle or make the assets-less build (if you give no arguments, the assets-less build will result). Therefore, you need to put the full content of the game root into the "~/Library/Application Support/PGE Project/thextech" folder, include default assets (graphics, music, sounds, intro and outro levels, default battle, and worlds folders).

How to develop episodes targeted to TheXTech?
This engine has full compatibility with almost all old episodes developed for SMBX 1.3 with some minor exceptions (if the certain level or episode do rely on the bug of the old game, you can add the "compat.ini" file at your level or episode to re-enable certain bugs which are required for level or episode to work normally).

You can use the same tools as you used to develop episodes for the original SMBX 1.3 (include the classic built-in editor of the old game). The engine doesn't include its own editor anymore, instead, you have two options to get the editor for this engine: do use the vanilla Editor and have all limits as SMBX 1.3, or do development in the modern Moondust Editor that will allow you to use brand-new features of the engine were inaccessible from the old editor.

You need to simply download the standalone Moondust (PGE Project) toolchain and take the latest "SMBX 1.3 Compatible" configuration package. Once you will start the PGE Editor, to get the direct level testing work, you should open (or create a new) any level file, open the Test->TheXTech menu, and choose the "Change path to TheXTech..." menu item. You should specify (or browse) the full path to the actual executable of the game, and press the Ok button. Once you set this properly, you can press the F5 key to start the level testing now.

You can save your level and world maps in LVLX and WLDX format, they are natively supported by TheXTech include the numerous unique features that came from Moondust and SMBX-38A standards, for example, the full ability to use the Z-Layer and Z-Offset, the warp enter the event, the custom "stars needed" message text, two-way warps, portal warps, vertical section wrap, support for more than 21 section, etc. On world maps, there are more than 5 credit lines available and the ability to set up the custom music file provided. The engine does the full support for PNG graphics and a lot of music and sound formats, customizable player hitbox calibration files (the same as for PGE Engine and SMBX2 being used).

What is different with this thing in comparison to the original VB6 build?
  • First off, it's written in C++ while original (as we already know) is written in VB6.
  • Doesn't have an Editor. Instead, in nearest future, it will have deep integration with PGE Editor that will allow to use it with the same functionality as in the original editor (the "magic hand" functionality was kept to allow real-time editing of the level while testing, it's needed to use IPC communication with PGE Editor to get the ability to use it better).
  • Full support of UTF-8 in filename paths and internal text data (original game had only 8bit ANSI support).
  • For graphics and controlling, it uses an SDL2 library while the original game has used WinAPI calls and GDI library.
  • It uses PGE-FL that has better file format support.
  • A support for WLDX world maps is allowing unlimited credits lines and custom music without it being necessary to use a music.ini for music replacements.
  • Some LVLX exclusive features now working: vertical section wrap, two-way warps, custom "star needed" message, warp enter the event, ability to disable stars printing in HUB episodes for specific doors, ability to disable interscene showing when going to another level through a warp.
  • Built-in support for the episode and level wide music.ini and sounds.ini to override default music and sound assets.
  • World maps now support a custom directory to store any specific resources like custom tiles/scenes/paths/levels and not spam the episode root folder with world map resources anymore.
  • Default config format is INI, old config.dat format is no longer supported, mainly because of incompatible key code values (SDL_Scancode versus VirtualKeys enum of Windows API).
  • Game saves now using the SAVX format instead of a classic SAV. However, if you already have an old game save, you still can resume your game by using a new engine now (the next gamesave attempt will result in a SAVX file, an old gamesave in SAV format will be kept untouched).
  • Built-in PNG support for custom and default graphics. Masked GIFs are still supported for backward compatibility, however, without making an unexpected auto-conversion as SMBX-38A does.
  • Checkpoints now have multi-points! You can use them in your levels multiple times without limits!
  • It does use a lazy-decompress algorithm to speed up the loading of a game and reduce memory usage.
  • For music and SFX, the MixerX library is used to give support for a wide amount of sound and music formats!
  • It doesn't embed any graphics: there are NO truly hardcoded graphics, everything is now represented by external graphics!
  • Some internal limits have been expanded.
  • Built-in GIF recorder by F11 key (F10 on macOS, F11 is reserved by system UI for a "show desktop" action)

How to build it?
You can read a guide on how to build this project from a source code which you can find here:

To build it, you need to have the next things:
  • CMake
  • Ninja optionally (to speeds-up the build process)
  • Compatible C/C++ compiler (GCC, Clang, MSVC haven't been tested yet)
  • Git (required to pull submodules and clone source of dependent libraries to build them in place)
  • Mercurial (required to clone an official SDL2 repository to build it in place here)
  • Optionally: system-wide installed dependencies: SDL2, libFreeImageLite (a modded implementation of the FreeImage), MixerX sound library, AudioCodecs collection of libraries. Having them be installed in a system gives a major build speed up. However, it's possible to build all these dependencies in place here with the cost of extra build time being added.

The official TheXTech documentation
Here you'll find a lot of guides and explanations for most of the TheXTech.

Feel free to try it out in action now:
There are ready for use packages, equipped with original SMBX 1.3 assets and "The Invasion 2" episode.

Needed more episodes?
If you are looking for more episodes, please visit the archive of preserved SMBX episodes (You can browse these directories where episodes will be compatible: SMBX 1.3, SMBX 1.0 - 1.2, and TheXTech. All other directories will contain incompatible episodes that will not properly work, see details here).

Also, you can find some episodes at SMBX Episodes section of WohlSoft Forum, or browse the episodes sub-section at SMBX forum where you still can find any compatible episodes (which was originally targeted to SMBX 1.3).

Changes for 1.3.6
  • Added an ability to toggle drawing of the HUD and other on-screen metadata using the F1 key (@Wohlstand)
  • Added an ability to type cheats on the touchscreen using a special new cheats key (@Wohlstand, @ds-sloth)
  • Added native support for LunaDLL Autocode script language (@Wohlstand)
  • Added fail-counter feature (keeps counting deaths per game save) (@Wohlstand)
  • Reworked controller support (@ds-sloth)
  • Touchscreen support for non-Android platforms (@ds-sloth)
  • Added the ability to save multiple keyboard profiles (@ds-sloth)
  • New multiplayer start screen (@ds-sloth with design input from @0lhi)
  • Added controller disconnect recovery screen (@ds-sloth)
  • Ground pound by alt run is now a per-controller setting (@ds-sloth)
  • Added an ability to add/drop the second player from the pause menu (@ds-sloth)
  • Added the support for real-time audio effects such as reverb and SPC echo. Sounds.ini can configure them for each level section (@Wohlstand)
  • Performance improvements for showing, hiding and moving layers (@ds-sloth)
  • Reduced game object memory footprint (@ds-sloth)
  • Performance improvements when run on slow filesystems (@ds-sloth)
  • Fixed unexpected music that got started after the level got entered too quick from the world map (@Wohlstand)
  • Fixed the vanilla bug: a Player can get stuck in the pipe when entering it being a fairy (@Wohlstand)
  • Added an option to enable fast walking on the world map (@ds-sloth, @Wohlstand)
  • Added an ability to customize UI/common assets from the episode and level sides (@Wohlstand)
  • Added a blink effect at speedrun timer on level/episode completion (@Wohlstand)
  • Added an in-game editor based on the original game's editor code (requires EditorIcons.png asset) (@ds-sloth)
  • Added config option to show the current episode's title onscreen (@ds-sloth)
  • Fixed the clipped render of the Roto-Disk's effect (@Wohlstand)
  • Fixed the lock/star sign behaviour at locked two-way warps: now they work correctly at the opposite side (@Wohlstand)
  • Added an ability to set a different path for the user directory by command line argument (@Wohlstand)
  • Blocked an ability to start the game with no episodes or battle levels available in the list and prevented several issues with this (@Wohlstand)
  • Added option to disable or always perform 2x texture scale down optimization (@ds-sloth)
  • Added the ability to have multiple intro levels per assets pack (if the introset directory exists and it contains at least one level file, they will be selected randomly every time when the main menu opens) (@Wohlstand)
  • Added game selection menu into Android launcher: every browsed assets directory will be remembered and can be accessed quickly using the new menu (@Wohlstand)
  • Added the individual sound for Ludwig von Koopa's death (@Wohlstand)
  • Added the individual sound for Larry Koopa's death and shell spinning after stomp (@Wohlstand)
  • Fixed an improper new (when specific compatibility option is not disabled) behaviour of the Skull Raft when the head segment impacts a wall but loses a floor at the same time, causing the following segments to suspend forever (@Wohlstand)
  • Fixed the issue of a possible fall through the floor if walking point-blank to a block that had an extracted bonus and another solid block placed under it (does not happen if the "fix-player-downward-clip" option was disabled) ( (@Wohlstand)
  • Removed the "require-ground-to-enter-warps" compat.ini option as redundant: there is the native option of LVLX and 38A-LVL level formats to enable this behaviour. (@Wohlstand)
  • Some options of the compat.ini have been renamed (for backward compatibility, there are aliases kept for now) (@Wohlstand)
  • Added the individual sound for Link's iceball shoot (@Wohlstand)

For Windows (XP/Vista/7/8/8.1/10+):
Downloads for Windows
- Download for 64-bit (modern platforms)
- Download for 32-bit (old platforms and 32-bit operating system installs)
- Download for ARM64 (for Windows-based tablets that use an ARM processor, or other compatible devices)
Note: To unpack 7z archives you need to use the 7-zip tool (it's free!). For ARM devices try this version of 7-zip.

For macOS (10.11 is minimal, if not works even on 10.11, report me please. The AppleSilicon version requires the macOS 11.0):
Downloads for macOS
- Download DMG image, universal for both Intel and Apple Silicon
Note: because of macOS specifics, using the game here is different than other systems: after install, running a game,
and then, to add your custom episodes, look into your home directory and find the "TheXTech Episodes" folder, the "worlds" and "battle" inside is for your own stuff!
To replace default media, look inside the bundle and find the "Content/Resources/assets" folder!
Caution 1: bundle is unsigned, make sure you know how to deal with a Gatekeeper to make able to use this! On Catalina it may not start the first time after Gatekeeper's question, try to run the game again!
Caution 2: On Apple Silicon (M1) devices, you will need to run the xattr -rd "Super Mario Bros." from your terminal at the applications directory to get the game work.

For Linux distros (x86_64 and i386):
Downloads for Linux
Portable archives
There are static portable builds that should work almost everywhere. If you run a different Linux distro than Ubuntu, you may use the Ubuntu 16.04 version for the game. The confirmed work on the Debian 10, on the OpenSUSE, on the Fedora, on the CentOS. Also, the game could work on ArchLinux and Monjaro. If all builds won't work on your distro, feel free to report to me and try to compile the game from the sources to get it to work on your side. Right now there are x86_64 and 32-bit x86 builds that were made, ARM wasn't built by the CI yet (probably I'll try to set up the CI to produce such builds).

Debian and Ubuntu-compatible packages
The game will be installed at system, default assets will appear at

Code: Select all

, and user directory for game saves, custom worlds, logs, screenshots will appear at

Code: Select all

directory on the first launch.

AUR packages
There is an AUR package, maintained by YidaozhanYa. The game will be installed at system, default assets will appear at /usr/share/games/thextech-smbx, and user directory for game saves, custom worlds, logs, screenshots will appear at ~/.thextech-smbx directory.

Code: Select all

yay -Sua --batchinstall thextech-supermariobrosx

For Android:
Downloads for Android
- Download for Android (Minimum version is 4.1)
Note: this is the plain runtime package that doesn't include any game assets. You should download the SMBX assets pack archive and unpack it into any convenient place. On the first run (or at the Settings), you should select the directory that contains your unpacked assets. That directory will serve the same as the SMBX game directory on the desktop versions. You can easily add more episodes to it by unpacking archives into the "worlds" directory in the same way as on desktop versions. At the Settings, you can switch between different game asset directories that allow you to play different games (such as "Adventures of Demo") by the same engine.

WebAssembly (Play game in the browser):
Web version
- Play SMBX in the browser NOW! (Note, the game may work slow from some places like China, please ask people for any local mirrors, or get the self-hosted version below).
- Download the Self-hosted version of the game if you want to upload the game copy on your WEB-server and make the game get better availability.
Note: Adding custom episodes and replacing default music/sounds/graphics require you to build the game from the sources with giving of your assets directory. You can find the detailed manual on how to build the web version of the game here.

Plain desktop runtimes
There are packages that contain the runtime engine binary only. Use this to update your existing game without re-downloading game assets. Especially if you did your own remix of the assets and you don't want to re-remix them again.

Plain runtime downloads


This is the "Game template", the app bundle that contains no assets. You need to put the game assets into the "" directory inside of the bundle, and then, edit "Content/Info.plist", and specify the value for the "CFBundeName" field to make it not be "Not named application" in the task manager.)

The full C++ source code repository:

If you have any questions, problem reports, or suggestions, feel free to write to me!

Posted: 15 Mar 2020, 23:07
by Wohlstand
A small update: I did added into the main post a link to Emscripten build which can be played in a browser now!

Emscripten (Play in browser now)
- Play game in your browser now!

Posted: 22 Mar 2020, 3:36
by +KZ
this is great! Finally, smbx is for several platforms :D, although I would like an Android version to be released, since it is what I have at hand.

Posted: 28 Mar 2020, 18:18
by Anuja16
It would be nice if you can convert the character actions and enemies actions from your reprogramming into the PGE Engine.

Posted: 8 Apr 2020, 22:15
by Olhi
Oh my gawd, this is beautiful :cry:

SMBX being a webgame now will make it so much easier to get people to play it in the future!

But I am even more happy about the GNU/Linux version. This is a decade old dream coming true.

I came across an issue: For both, my wired Xinput and wireless X360 Controller, the D-Pad doesn't work, only the Analog Stick. This is true for the Linux version, and the Windows version when ran via Wine.

And a suggestion/request: Would it be possible to have the Purple Yoshi's ground pound be triggered by "Alt Run" instead of "Down"? As he is now, he is a walking death trap, which is a shame, since he could easily be one of the best Yoshis.

Posted: 8 Apr 2020, 22:36
by Wohlstand
Olhi wrote:I came across an issue: For both, my wired Xinput and wireless X360 Controller, the D-Pad doesn't work, only the Analog Stick. This is true for the Linux version, and the Windows version when ran via Wine.
That I guess because of no support for arrows controls setup, I can add that support easily ;-)
You can try how PGE Engine will work with your controller to verify how arrows will work (they can be set up here). If will work fine, I'll just backport some code, otherwise I will need to use SDL_Controller API for some things.

Olhi wrote:And a suggestion/request: Would it be possible to have the Purple Yoshi's ground pound be triggered by "Alt Run" instead of "Down"? As he is now, he is a walking death trap, which is a shame, since he could easily be one of the best Yoshis.
Good idea, and there are not only purple: yellow also, and every Yosho who ate a yellow shell will also have a ground pound.

Posted: 8 Apr 2020, 22:55
by Olhi
Wohlstand wrote:You can try how PGE Engine will work with your controller to verify how arrows will work (they can be set up here).

Works perfectly fine!

Posted: 8 Apr 2020, 22:57
by Wohlstand
Perfect! :good:
So, I'll just backport PGE Engine's joystick module and I'll allow to set up arrow keys also.

Posted: 12 Apr 2020, 11:58
by Olhi
Another request: When the game window loses focus, the game freezes until the focus is back. This causes 2 disadvantages:

1. During grindy moments, such as doing a 1Up-Trick, it forces me to keep my eyes on the screen when I could rather use the time to check my E-Mails or social media.

2. For Twitch Streams, when the player has to briefly stop to do something else, the music is muted, which makes the wait bothersome for viewers. This is especially problematic for Streamers without mic who have to switch between Chat Window and Game, as they interrupt the music frequently.

I recognize that this has advantages, so a good solution would be to have the game only freeze when focus is lost while on the pause menu. Maybe a hotkey to disable in-game audio would work, too.

If that's not possible, I would appreciate an option to disable the freeze entirely.

Posted: 12 Apr 2020, 12:44
by Wohlstand
You want to make game never freeze when unfocused? I already have a solution:
Run game from a command line with a next argument:

Code: Select all

thextech --never-pause

(Or make a shortcut that adds this argument into the command)
And game will always run and never watch for a focused state. ;-)

Posted: 12 Apr 2020, 12:53
by Olhi
Wohlstand wrote:And game will always run and never watch for a focused state. ;-)

Many thanks! :hi:

Posted: 14 Apr 2020, 0:13
by Olhi
I found a bug on the Linux version that occurs when starting the Classics Collection version of The Great Empire 3:

Posted: 14 Apr 2020, 0:19
by Wohlstand
Damn it won't work without Proxy, but good that I have a proxy.

I need to test this thing on my latest build to see what's wrong, however, my guess is that here is a possible case-sensitive FS path problem :wacko: (on EXT4 Meow.txt and mEoW.txt are different files while on HFS+ and FAT/NTFS a same). I have some idea for a workaround to allow case insensitive path beingn recognized correctly.

Posted: 14 Apr 2020, 0:28
by Olhi
Wohlstand wrote:Damn it won't work without Proxy, but good that I have a proxy.

Oh, I see. Can you recommend any convenient sites that are good for you? I like Streamable because it doesn't require an account.

Posted: 14 Apr 2020, 2:26
by Wohlstand
You can upload short examples even here by a built-in forum's file uploader ;-)

Added after 12 hours 9 minutes:
Okay, I had to search and I found that it's really banned, and reason is absorduous:
25 апреля Роскомназдор внёс в реестр запрещённых сайтов сервис коротких видео "Streamable", согласно решению Мосгорсуда.

Иск к "Streamable" и еще одному сервису подала компания-учередитель "Матч-ТВ" (российский федеральный телеканал, сфокусированный на спорте). Основанием для подачи иска явился тот факт, что на сайте "Streamable" показывались матчи, лицензия на которые была у телеканала "Матч! Футбол 1".

Само судебное заседание прошло без присутствия обвиняемой стороны. С компании "Fastly" (владелец "Streamable") также взыскали 3 тыс. рублей госпошлины.
In a short words: because of a copyright violation: "Match-TV" have sued it because of match show publishing without license.

Posted: 14 Apr 2020, 19:53
by Olhi
I'll make attachments in the future then, in addition to sharing a Streamable link.

Posted: 14 Apr 2020, 20:27
by Wohlstand
Yes, it's a case sensitivity problem:
Снимок экрана от 2020-04-14 20-26-06.png
Снимок экрана от 2020-04-14 20-26-06.png (11.05 KiB) Viewed 73524 times

So, you have to manually rename or try to use PGE Maintainer's case fixer tool (be careful it's incomplete and may work incorrectly) until I'll provide a workaround.

Added after 27 minutes 54 seconds:
At least I had to test PGE Maintaner's case fixer, with an "All to lower" mode, and episode became playable.

Posted: 16 Apr 2020, 20:25
by [Deleted]
+KZ wrote:this is great! Finally, smbx is for several platforms :D, although I would like an Android version to be released, since it is what I have at hand.

umm pge for android is here and I think pge is smbx

Posted: 16 Apr 2020, 21:35
by +KZ
Chanceux2 wrote:
+KZ wrote:this is great! Finally, smbx is for several platforms :D, although I would like an Android version to be released, since it is what I have at hand.

umm pge for android is here and I think pge is smbx

but thextech is a complete engine, pge engine is on development and still dont have all the characteristics of smbx, anyway its editor is very advanced and i use it

by the way, i have 2 suggestions for thextech:

- enable a key that skip the episode credits

- port the online feature that originally are on vanilla editor

thanks :p

Posted: 16 Apr 2020, 21:38
by Wohlstand
+KZ wrote:- enable a key that skip the episode credits
Already can be done via ESC key, isn't that?

+KZ wrote:- port the online feature that originally are on vanilla editor
Networking for collaboration editing is planned but with a lower priority. Mainly because a base of PGE Engine is a most main goal right now. I desired to don't make anything huge on Editor side yet and pull a full effort on PGE Engine after I'll complete some preparation works I am doing now...