From Moondust Wiki
Jump to navigation Jump to search
Smbx64 standard.png

SMBX64 (Super Mario Bros. X Standard version 64) is the name of the technical standard used by Super Mario Bros. X version 1.3. This standard contains the file formats, references, item lists, and game-wide default values. The specifics of this standard were researched by Wohlstand in early 2014. This standard is very strictly defined. Each item and behavior algorithm are linked directly to a specific ID value.

The SMBX 1.3 Compatible configuration package for Moondust Project is a full implementation of SMBX64 Itemset: blocks, BGO's, NPC's, Music list map, Sound list map, Tiles, Paths, Level entrances, effects. This configuration package completely provides a compatibility layer with SMBX-made levels, world maps, and episodes.


Why SMBX version 64?

The Standard name is the name of the game SMBX and the last internal version number which you can read in the first line of any .lvl file with notepad (it is 64).

Standard history

This is a partial history researched from available builds of SMBX. This history doesn't contain any unpublished alpha-builds (numbers of those versions you will find in the SMBX64-LVL file format specification). A more detailed history of every public build of SMBX Engine has own article.

SMBX1 - The first version of the standard came with Super Mario Bros. X 1.0, written by Andrew 'Redigit' Spinks. Blocks can hold 1-99 coins or one of the following NPCs: goomba, flower, leaf, shoe, or mushroom.

SMBX2 - Added support for custom music

SMBX8 - Added support for inter-level warps, added "stars-needed" lock for warps, added "Door" warp type

SMBX10 - Added support for layers and events in levels. Para-Koopas, Para-Goombas, and Cheep-Cheeps were given multiple behavior algorithms. Added NPC Generators. Added talk messages, "friendly" flag, and "not movable" flag for NPCs. Boss NPCs no longer all use the same algorithm, so the flag "Legacy Boss" was added to re-enable those algorithms. Added intro levels of episodes. Added "restart level on death" support. Added "hub-style" system for episodes, togglable in the world map. Added credits field for a world map. Added support for entering to the specified warp ID of a level from the world map.

SMBX17 - Added star count field into level file.

SMBX18 - Blocks can contain any available NPC by its ID. Added play sound event.

SMBX20 - Added "Number of stars" field for world maps.

SMBX28 - Added "Locked", "No Yoshi" and "Allow NPC" flags for warps. Added support for event triggers. Added support for forcing the player's control key events. Added "Always visible" flag for levels on a world map. Added support of background image under the level icon. Added "Game start" flag for level: allows for using any level location as the episode start point. Added support for warping between two locations on the world map.

SMBX32 - Added support for "Water" physical environment zones. Added auto-start ability of events, added layer motion events.

SMBX49 - Added auto-scrolling support.

SMBX55 - Added support to disable specified characters in the episodes.

SMBX62 - Added "level title" field. Added slippery block support.

SMBX63 - Allowed layers to be attached to an NPC, which will move layers with NPC's motion. Added "Quicksand" physical environment zone type.

SMBX64 - The latest and final version of the SMBX standard which was created in 2011 with "Super Mario Bros. X 1.3". After this version, "Super Mario Bros. X" development was permanently ended.

SMBX65 - A possible continuation of a standard in the possible SMBX 1.3.1, found in a published source code. There are was plans to add the support for variables and "saved events", which was never completed due to a sudden SMBX's end of life.

SMBX65-38A - The unofficial continuation of SMBX64 Standard used in Chinese SMBX-38A. The new standard has much more features and introduces new LVL/WLD file formats which going with the incompatible file format syntax

SMBX64-X2 - The another unofficial continuation of SMBX64 Standard used in SMBX2 project. The new standard also has much more features but is different from the SMBX64-38A.

File formats

SMBX64 standard uses a text format with unmarked values.

SMBX1...64 Standard specifications:

.LVL - level file format.
Download specification: ODT, PDF

.WLD - world file format.
Download specification: ODT, PDF

.SAV - game save file format.
Download specification: ODT, PDF

SMBX-38A Standard specifications:

Documentation is available in the Moondust Project repository.


SMBX64 Standard has some limits about placing elements on the level map and world map:


  • Player start points: 2
  • Blocks: 16384 (because max index size in VB6 is a half of the max value of two-byte signed integer value)
    • Sizable Blocks (these count as normal blocks too): 1000
  • NPCs: 5000
  • Background Objects: 8000
  • Warps: 200
  • Water/Quicksand areas (doesn't matter how big): 450
  • Events: 100
  • Layers: 100

World maps

  • Tiles: 20000
  • Paths: 2000
  • Music-Boxes: 1000
  • Scenery: 5000
  • Levels: 400

In Game

  • Max episodes in "worlds" folders: 100 (declared internally, but in fact is 126) (exceeding results into a crash or to a list of empty names with a blank world map)
  • Stars: 10000
  • Effects: 1000

Note: information about SMBX's limits here is NOT taken from the Debugger box of SMBX Editor, because it shows incorrect limits for some of the elements, and it doesn't have a debug box for world maps.

Standard item list

Here are lists of the total item settings which are defined by the SMBX64 standard


World map


Accessible properties

A full list of data properties which can be defined and changed with SMBX64-compatible editors and used in the SMBX based games.

Level Settings

  • Level title string
  • Max total number of sections: 21
  • Per section properties
    • Left-Top-Right-Bottom positions values
    • Background color (accessible from SMBX1 to SMBX2, later unused)
    • Level warp flag (Connect left and right sides)
    • Off-screen exit flag
    • No turn back(right direction walk only) flag
    • Underwater flag
    • Background-ID number
    • Music-ID number (Music-ID=24 is a reserved value which enables custom music playback)
    • Custom music file string

Level items

  • Blocks (Should be sorted by Y and grouped with sorting by X in array)
    • X-Y position
    • W-H Size of sizable block (Multiple 32 only, minimal size is 64x64 px)
    • Slippery flag
    • Invisible flag
    • Contents (Nothing 0, Coins 1...99, NPC-9 100, NPC-1 101, NPC-14 102, NPC-34 103, NPC-35 104, coins 105...999, NPCID+1000, 1001...1392)
    • Layer name string
    • "Destroyed" event slot string
    • "Hit" event slot string
    • "No more objects in the layer" event slot string
  • Background objects (Should be sorted by special sorting priority table)
    • X-Y position
    • Layer name string
  • NPC
    • X-Y position
    • Direction left-random-right
    • Friendly flag
    • No move flag
    • Legacy boss flag (accessible for three NPC's: Boom-boom, Birdo, Bowser III'rd)
    • Message text string
    • Generator flag
    • Generator direction left-up-right-down
    • Generator period delay
    • Generator type number
    • Layer name string
    • Attached layer name string
    • "Activated" event slot string
    • "Died" event slot string
    • "Talk" event slot string
    • "No more objects in layer" event slot string
  • Player's spawn point
    • X-Y Position
  • Warp points
    • X-Y of entrance point position
    • X-Y of exit point position
    • Layer name string
    • Warp type number
    • Entrance direction left-up-right-down
    • Exit direction right-down-left-up
    • No Yoshi (Deny vehicles) flag
    • Allow carried NPC's flag
    • Locked flag
    • Stars needed number
    • Level Entrance flag
    • Level Exit flag
    • Target Level filename string
    • Target warp Array-ID number
    • Target world map X-Y coordinates (-1 and -1 are reserved with "empty fields")
  • Water/Quicksand zone
    • X-Y Position
    • W-H Size (Multiple 32 only)
    • Is Quicksand flag
  • Layers
    • Layer name
    • "layer is hidden" flag
  • Events
    • Event title string
    • Pop-up Message box text string
    • 21 slots for layers of "hide" task (21'st must be empty!)
    • 21 slots for layers of "show" task (21'st must be empty!)
    • 21 slots for layers of "toggle visibility" task (21'st must be empty!)
    • "Disable smoke effect" flag
    • Task to switch background ID's of each 21 section
    • Task to switch music ID's of each 21 section
    • Task to change boundaries of each 21 section
    • Auto-triggerable flag
    • Trigger&hold player control key flags for UP-DOWN-LEFT-RIGHT-JUMP-ALTJUMP-RUN-ALTRUN-DROP-START
    • Set movement for layer name string
    • Set movement for layer X-Y speeds in pixels per frame
    • Set autoscrolling for section number
    • Set autoscrolling of section X-Y speeds in pixels per frame

World map settings

  • Episode title
  • Intro level file name string
  • 5 fields of "Episode credits"
  • "No world map" flag
  • "Restart on fail" flag
  • Total stars number
  • Episode without Mario flag
  • Episode without Luigi flag
  • Episode without Peach flag
  • Episode without Toad flag
  • Episode without Link flag

World map items

  • Terrain tiles
    • X-Y position
  • Scenery
    • X-Y position
  • Paths
    • X-Y position
  • Music Boxes
    • X-Y position
  • Level entrance tiles
    • X-Y position
    • "Background path" flag
    • "Big background path" flag
    • "Always visible" flag
    • "Game start point" flag
    • Target level file name string
    • Target WARP-ID number
    • Open path condition by exit type for left side
    • Open path condition by exit type for top side
    • Open path condition by exit type for right side
    • Open path condition by exit type for bottom side
    • Target teleportation X-Y world map coordinates

Measure units

Internal measure units and constants in the SMBX Engine

  • Size units: 1 block = 32 pixels.
  • Time unit: 1 frame = 1/65 second. (used in the animation frame delay, movement speeds, event timer and generator timer)
  • Speed unit: Pixels per frame.
  • Acceleration units: pixels-seconds per frames (add or subtract speed value per frame)
  • Common grid alignment size: 32 pixels

Content formats


SMBX's Graphics uses GIF format. SMBX Engine imitates transparency by using a bit masks: an image which drawing in the frame buffer with applying to each pixel value AND bitwise operation, and then drawing foreground image with applying OR bitwise operation with each pixel. This algorithm disallows having a semi-transparency images and in result a dirty colors.

Musics and sounds

SMBX uses MP3 file format. Custom music can use other formats, however, such as: WAV, WMA, MID and MP3.

Editor Tech Standard

Declaration of level and world map editors for SMBX64 standard.

Level Items


All item sizes are pre-defined for each item and can't be changed except to sizable blocks, water zones and NPC's with npc.txt files.

  • All blocks and most of background objects has a 32x32 px size or multiple 32 px size.
  • All sizable blocks uses 96x96 sprite which dividing to 9 pieces of sizable block.


All items has default grid size in 32 pixels where they are should be aligned. But some exceptions are presented.

  • Blocks
    • Aligning relative to left-top corner with 32 px or 16 px grid size
  • Background objects
    • Aligning relative to left-top corner with 32 px or 16 px grid size
  • NPC's
    • Has a special aligning rule:
      • bottom aligned to 32px or 16px grid size
      • Side aligning by formula: Target position = (Offset from grid cell left side: 32px/2)-((Width of NPC)/2) if NPC aligns to grid cell center or when NPC aligns by center to grid line, horizontal offset formula is '-((Width of NPC)/2)'.
      • Any "Generators" aligning with 16 px grid size.
  • Warps
    • Aligns with 16px grid size
  • Water/Quicksand zone
    • Aligns with 16px grid size
  • Player's spawn points
    • Aligning with 4 px vertical and 2 px horizontal aligning grid sizes.


Collisions prevents placement of items over each other by special rules:

  • Blocks
    • Colliding with any other blocks except sizable blocks.
    • Colliding with any NPC's except vines, red herb container, red door.
  • Background objects
    • Colliding with background object of same BGO-ID.
  • NPC's
    • Colliding with any blocks except sizable blocks.
    • Colliding with any NPC's except vides, red herb container, red door.
  • Water/Quicksand zone
    • Doesn't colliding with others.
  • Warps
    • Doesn't colliding with others.
  • Player's spawn point
    • Doesn't colliding with others.
  • Effects
    • Denied to placement in the editor.

Render Z-Order

Level graphical layaring

A full table of SMBX Engine internal rendering order priorities (Z-Layers)

Value Name Description
-100.0 SMBX Level Background The Level Background
-95.0 SMBX BGO SMBX BGOs which are rendered on the furtherst back of the scene.
-90.0 SMBX Sizeable Blocks All SMBX sizeable blocks
-85.0 SMBX BGO SMBX BGOs which are rendered on the back.
-80.0 SMBX Special BGO (i.e. locks) All special BGOs like locks.
-75.0 SMBX Background NPCs SMBX background NPCs like vines, piranah plants, diggable sand, mother brain, things in MB jars.
-70.0 SMBX Held NPCs SMBX NPCs which are held by the player.
-65.0 SMBX Normal Blocks All normal SMBX blocks.
-60.0 SMBX Effects Some effects, which are on the background: doors, pressed p-switches, some other stuff
-55.0 SMBX NPC Some SMBX NPCs like: coins, clown car, chompy, herb, wood rocket, koopaling fire
-50.0 SMBX NPC Some SMBX NPCs like ice blocks.
-45.0 SMBX NPC All common SMBX NPCs.
-40.0 SMBX Chat Icon The SMBX chat icon, which is displayed, when you can talk with an NPC.
-35.0 SMBX Player Mounts The player mounts: Yoshi, Clowncar, Shoe
-30.0 SMBX Player Mounts? Maybe is the same as -35.0
-25.0 SMBX Players All active players on screen.
-20.0 SMBX BGO All foreground BGOs.
-15.0 SMBX NPC All foreground NPCs.
-10.0 SMBX Block All foreground Blocks.
-5.0 SMBX Effect All foreground Effects.
5.0 SMBX HUD All elements of the SMBX HUD.

Definition of drawing order of items by types (old internal Moondust draft standard) of Z-Layers:

Lowerest: Background images
-160: Background-2: BGO's
-150: Sizable blocks
-100: Background-1: BGO's
-50: Warp - Derived BGOs (locks on doors and stuff)
-10: Background NPC's
-5: Held NPC's
1: Normal blocks
15: Furthest Back Effects (doors, pressed p-switches, some other stuff)
30: Normal NPC's
31: Normal NPC's (Ice block)
32: Player Vehicles / Mounts
35: Playable characters
50: Foreground-1: BGO's
100: Foreground NPC's
150: Foreground blocks
160: Foreground-2: BGO's
Highest: Foreground effects
Blocks array order

All blocks in the file are must be sorted by way [X-position] -> [Y-position] -> [ArrayID]. That required by SMBX's collision detection algorithm which uses binary ranges. If blocks are will not be ordered, NPCs are will always miss up collisions with any blocks.

Background objects array order

All BGOs are ordering by special order priority coefficient which groups specific BGO-ID's inside.

Background object Order Priority table
Value BGO ID list Comment
10 14, 75, 76, 77, 78 background-2 layer Backgrounds
20 11, 12, 60, 61 SMB3 Goal zone
25 66, 158, 159, 172 background-1 layer Waterfall
26 26, 65, 82, 83, 164, 165, 166, 167, 168, 169 Water
30 52, 79 Blk. dungeon block, Tree Trunk
75 2, 3, 4, 5, 6, 7, 8, 9, 10, 13, 15, 16, 17, 18, 19, 20, 21, 22, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 47, 53, 54, 55, 56, 57, 58, 59, 62, 63, 64, 67, 80, 81, 84, 85, 86, 89, 90, 91, 93, 94, 95, 96, 97, 98, 100, 101, 102, 103, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 132, 133, 134, 135, 136, 142, 144, 146, 147, 148, 149, 150, 151, 152, 153, 160, 161, 162, 163, 170, 171, 173, 174, 175, 176, 177, 178, 179, 180, 181, 182, 183, 184, 185, 186, 189, 190 Most of BGOs
76 129, 130, 131 Wooden fence
77 1 Small bush
80 48, 139, 140 Ghost house
90 70, 71, 72, 73, 74, 141 Rails, Rail lift buffer, Ghosthouse door
98 87, 88, 92, 104, 105, 107 Doors
99 99 Glass window fragment
125 23, 24, 25, 45, 46, 49, 50, 51, 68, 69, 106, 137, 138, 143, 145, 154, 155, 156, 157, 187, 188 Foreground-1 layer BGOs

How SMBX orders BGOs in a list: There's a mix of using a hardcoded conditions, but also some lookup from a table of Boolean values, where this table of boolean values is only written once and not changed. Used an Insertion sort algorithm. The algorithm is stable itself, but implementation inside SMBX is not stable, therefore every file save of same data, resulted file always has a different order of BGOs.

PGE File Library orders BGOs by this order priorities table and by order of placement which gives the same result on every file save. PGE File Library uses recursion-less Quick sort algorithm.

World map items


All world map items have 32 px tile size except level points which have different sizes of sprites, but the physical size still is 32 px.


All items aligns with 32 px grid size except 'sceneries' which aligns with 16 px grid size.

  • Terrain tiles, Paths, Music Boxes
    • Aligns with 32 px grid size
  • Sceneries
    • Aligns with 16 px grid size
  • Level entrance tiles
    • Has a special aligning rule:
      • bottom aligned to 32px or 16px grid size
      • Side aligning by formula: Target position = (Offset from grid cell left side: 32px/2)-((Width of NPC)/2) if NPC aligns to grid cell center or when NPC aligns by center to grid line, horizontal offset formula is '-((Width of NPC)/2)'.


Collisions prevent placement of items over each other by special rules:

  • Terrain tiles
    • Collides with any other tiles
  • Sceneries
    • Doesn't collide. (which a technical mistake of SMBX! To prevent it, they should collide with other sceneries with the same SCENERY-ID in 16x16 px cell of the left-top picture side)
  • Paths
    • Collides with any other paths and with level points
  • Level entrance tiles
    • Collides with any other level points and with paths
  • Music boxes
    • Collides with any other music boxes

Render Z-Order

Definition of drawing order of items by types

0: Terrain tiles
5: Sceneries
10: Paths
15: Level entrance tiles
20: Music boxes

Customization of contents

SMBX64 Standard supports customization.


Blocks do support custom graphics. You need to use an image in GIF format with the same size or the same number of animation frames as the original block had.

Notice Tip: if your block image size is bigger or smaller than the original block is, in Moondust Editor, you can place them with no problem, unlike in SMBX Editor. That way you can create custom blocks of any size, which will work in SMBX Engine.
OOjs UI icon notice-destructive.svg WARNING: Don't select custom blocks in the SMBX Editor or they will shrink to their original sizes!!
Notice Note: Custom-sized block is a type of SMBX64 Hack.

Background Objects (BGOs)

Background Objects do support custom graphics. You need to use an image in GIF format with the same size or the same number of animation frames as the original BGO had. If the image will be bigger than the original BGO's sizes, it will look cut, but if the image will be smaller than the original BGO, it will work in both SMBX and PGE.

Non-Playable Characters (NPCs)

NPCs are fully customizable, but you need to use a special npc.txt configuration file.


Backgrounds do support custom graphics and they can have any image sizes. The main condition: images should have the height at least 600 pixels. The "SMB2 Underground" and "SMB3 Pipes" background also must have the width at least 800 pixels. The "SMB3 Blocks", "SMB3 Hills", "SMB3 Snow Hills", "SMB3 Snow Trees", and "SMB3 Waterfall" (Lower part of splitted backgrounds) suggests the same height as original.

Playable Characters

Internal frame indeces of the playable character

Each playable character uses a sprite sheet with a size 1000x1000 pixels and contains 100 frames in each of them. The SMBX game uses special frame indexes system to split the sheet into two halves: the left half contains frames for the left direction and the right half for the right direction. Every frame has its special index that was made to easily "turn" playable characters between left and right directions by changing the sign.

To compute X pixels coordinate at the sprite from the frame index, this formula can be used:

[math]\displaystyle{ x = \left \lfloor \frac{fi + 49}{10} \right \rfloor \times 100 }[/math]

The similar formula for the Y pixels coordinate:

[math]\displaystyle{ y = ({(fi + 49) \bmod 10}) \times 100 }[/math]

Where [math]\displaystyle{ fi }[/math] - The frame index between -49 and +50. Where 0 is the neutral frame, positive are frames of the right direction, and negative are frames of the left direction. To retrieve the cell x and y coordinates, remove the [math]\displaystyle{ \times 100 }[/math] multiplication from the formula.

To get the frame index from [math]\displaystyle{ x \times y }[/math] cell coordinate (zero-based from 0 to 9 for each dimension), this formula can be used:

[math]\displaystyle{ fi = (y - 10 \times x) - 49 }[/math]

Terrain tiles

Terrain tiles do support custom graphics.


Sceneries do support custom graphics, but custom sceneries from 33 to 65 will crash SMBX while trying to save the file or switching to Level Editor. Moondust Editor doesn't have that problem.


Paths do support custom graphics..

Level entrance tiles

Level entrance tiles do support custom graphics.

Musics and sounds

You can use custom music in Level Mode, but you can't use custom music in World Map mode. You can't use custom sounds in both modes.

Tips for the Vanilla level Contests participation

Some people may host special contests where is required to follow the SMBX64 standard and these are require the full compatibility with the original SMBX Engine version 1.3 and don't use external frameworks or engines which are not the same as legacy SMBX Engine without any customizations, hacks, or extensions. Even modern engines such as Moondust Engine, SMBX-38A, X2, and TheXTech are not allowed. However, you are able to use Moondust Editor to create a compatible level that will don't cause a crash in the legacy editor and engine.

This is a list of tips you must follow to be granted for participation in those contests:

  • you shouldn't include into blocks or NPC Containers (such as herbs, eggs, Lakitu, and bubbles) impossible objects (elements are locked or not listed as available items for including into blocks or NPC Containers)
  • you shouldn't customize BGO order priority (keep the value of order priority be -1)
  • you shouldn't use any scripts or INI-files in the levels. Just have a level file, graphics, and music (or just level only without any custom stuff, dependent on the rules of a specific contest).
  • you should use music formats compatible with the vanilla engine (such as MP3 or WAV). While you converting music is suggested to always compress with a bitrate equal to 320 to have fewer quality damages.
  • you should use compatible graphics with vanilla engine formats (A pair of the GIF files ready for bitmask algorithm: front image with black background and mask - black shape on white background). You can use PNG to GIFs conversion utility to produce compatible graphics of any complexity easier.
  • you should save into SMBX-64 (or older) LVL format, no LVLX or SMBX-38A levels.
  • you shouldn't use decimal speed values in the npc.txt's because the legacy editor is crashing depending on the system locale.
  • you shouldn't use dummy elements (reserved element slots are not available for regular usage) because picking up them from a map will crash legacy SMBX Editor.
  • you shouldn't use "system" BGOs (door star and keyhole used for the warps) because picking up of them will crash legacy SMBX Editor.
  • sizable blocks are MUST NOT have a size smaller than 64x64, picking up this block will cause a crash.
  • sizable blocks are MUST HAVE size multiple 32 because the legacy engine will show holes between image segments and it can't smartly fill empty space between them like modern engines are doing.
  • firebars must not be longer than 32 cells: it's a limitation given by the legacy SMBX Editor.

And any other features which are impossible to make on the legacy editor are not allowed for use.

Known implementations of standard

Super Mario Bros. X

It's the original implementation from which the standard was developed. This game is used in its original form as a core for LunaLua-SMBX, and then, for the SMBX2 project.


A game engine and toolkit, developed by Russian developer Wohlstand. It doesn't implement the SMBX64 standard directly because of the config packs system that was developed with a purpose to make the game engine being more universal than the original SMBX game was. At the same time, Editor has built-in validators which noticing a possible SMBX64 violation when saving level or world files into SMBX64 format.

Super Mario Bros. X by 38A

An unofficial reconstruction of SMBX game, developed by Chinese developer 5438A38A. It has different physics and some logical behavior than the original game. Also, it automatically converts any opened levels, episodes, and resources into its own SMBX-38A format. Therefore, it's the partial implementation of the SMBX64 standard which does work for data import only. It can't be used to produce SMBX64-compatible levels and episodes.


A cross-platform port of SMBX game, developed by Russian developer Wohlstand. This game is a full and accurate implementation of the SMBX64 standard. At the same time, it has some small piece of additional functionality and limits expansion that wasn't available in the original SMBX game.

Extensions of SMBX64 standard

As time is going, there are new engines has introduced. Here is the table that shows the difference between various engines.

Notice Note: This list may be incomplete, some more features may be added into this table in the future.
Feature Moondust Engine SMBX-38A SMBX2 TheXTech
General Features
Mixer X sound library + +[xtra 1] +[xtra 2] +
PNG custom graphics + + + +
PGE-X Level File (LVLX) + - + +
PGE-X World File (WLDX) + - - +
Custom data for gamesaves +[xtra 3] *[xtra 4] +[xtra 5] +[xtra 6]
music.ini + - + +
sounds.ini + - + +
Player calibrations + - +[xtra 7] +[xtra 8]
Scripting Lua
(Moondust API)
TeaScript[xtra 9] Lua
(LunaLua API)
LunaScript[xtra 10]
in 1.3.6
NPC configs INI
(Moondust format)
Built-in at levels
and world settings files
(Legacy and X2 own format)
(Legacy only)
Block configs INI
(Moondust format)
Built-in at levels
and world settings files
(X2 own format)
BGO configs INI
(Moondust format)
Built-in at levels
and world settings files
(X2 own format)
Backgrounds configs INI
(Moondust format)
TeaScript-based INI and TXT
(X2 own format)
Texture atlasses (placing
multiple objects on the
same texture)
- +[xtra 11] *[xtra 12] -
Built-in DSP FX - - - SPC (SFC/SNES) Echo
and Reverb[xtra 13]
Multi-language support + - - +
Renderer SDL2 DirectX 9 OpenGL SDL2/OpenGL
Unique Game Asset Pack
(Not based on SMBX64)
+[xtra 14] - - *[xtra 15]
Scripting features
Graphics functions + + + *[xtra 16]
GLSL shaders - - + -
Audio functions + + + +
Custom AI for objects *[xtra 17] *[xtra 18] +[xtra 19] -
Text functions - +[xtra 20] + +
Level features
More than 21 section + - - + (Max: 201)
Vertical section wrap + + + +
Portal warps + + + +
Cannon pipes + + -[xtra 21] + (since
Two-way warps + + +[xtra 22] +
BGO Z-Layer/Offset + - Partially**[xtra 23] +
Warp on-enter event + + - +
Warp custom stars message + + - +
Multiple checkpoints + + +[xtra 24] +
World map features
Custom music for boxes + + - +
Custom directory for maps + - - +
Layers and events - + - -
Controllable camera - + +[xtra 25] -
3D view - - +[xtra 26] -
World map testing +[xtra 27] +[xtra 28] +[xtra 29] +[xtra 30] (since the


  1. The SMBX-38A uses a special version of the MixerX compiled as a monolithic DLL that includes statically linked SDL2 and codec libraries.
  2. The SMBX2 may use a very outdated version of MixerX, so, it may have limited functionality compared to other engines.
  3. Lua scripts for Moondust Engine can get/store any text data using global functions.
  4. States of pre-defined variables can be saved.
  5. Lua scripts for X2 can get/store any text data using global objects and functions with different access scopes.
  6. LunaScript scripts at TheXTech can save/load some text/numeric data using special commands.
  7. Player calibrations at SMBX2 require all frames to be stored at the INI file, and also require to have the deprecated "used=true" flag to be presented at every frame section, and doesn't support custom animations stored in the calibration file itself.
  8. Player calibrations at TheXTech don't support custom animations stored in the calibration file itself, nor changing grab position.
  9. TeaScript is the simplified VisualBasic-like scripting language used at SMBX-38A.
  10. LunaScript is the forward-compatible LunaDLL Autocode dialect used at TheXTech.
  11. The SMBX-38A allows making different variants of the same object placing them all on the same texture. This ability called internally "GFX Expansion".
  12. At X2, custom textures can be used with lua as atlases to drawn custom objects and animations using different areas of textures.
  13. World map doesn't support Sound FX yet. Sound FX is defined by 0-based section.
  14. Moondust Engine is in WIP Stage. Require other engines in order to play the game with full features.
  15. Due to feature limitation, it's impossible to create a unique game asset with full features.
  16. TheXTech has a limited set of graphics functions in the LunaScript inherited from the LunaDLL Autocode.
  17. Currently, Moondust Engine allows making custom NPC and playable characters only.
  18. TeaScript allows limited customisation of objects AI using complex combinations of different objects and triggers.
  19. X2 has a flexible API that allows making autonomous implementations of custom objects such as NPCs, blocks, playable characters (over existing), etc.
  20. Text Print function uses NPC as source in SMBX-38A.
  21. Cannon pipes at SMBX2 do work via special lua script and won't be configured via level file parameters yet.
  22. Internally, one two-way warp entry produces two warp entries that have inverted entrance and exit locations. So, one two-way warp entry at SMBX2 takes two warp array entries at once.
  23. Z-Layer doesn't work for SMBX2. Z-Offset declares the order of elements of the same Z-priority between each other.
  24. The NPC-192 checkpoint at SMBX2 doesn't support multi-points. The multipoint for SMBX2 requires the use of NPC-400 and NPC-430.
  25. Can be performed using the lua code.
  26. Fully implemented using lua, the lua code is required to activate it.
  27. On Moondust Engine, world map testing doesn't allows playing levels. Instead, you are required to type an exit code.
  28. On SMBX-38A, world map testing doesn't allows playing levels. Instead, you are required to select an exit code from the dialogue.
  29. On X2, the world map runs as an episode playing.
  30. On TheXTech, the world map runs as an episode playing.


  • Fun fact: Wohlstand had no idea about the "Sceneries 33-65 will crash SMBX while saving" bug, until h2643 told him that!
  • In the original SMBX World Map editor, there is a bug, which allows you to place sceneries multiple times on the SAME position with no limits. This causes appearing of junk scenery items while you place them with a mouse.
Super Mario Bros. X