Welcome to the LunaLua!

This is an archived page since the LunaLua became as a part of SMBX2 project. Therefore, it's no longer receives standalone updates. We highly recommend downloading SMBX2 which already contains latest LunaLua.



LunaLua - is a free and open source extension for legacy SMBX Engine of version 1.3 which contains some patches, fixes, improvments, and also extends it, adding the Lua scripting language support!


  • Increasing overall performance
  • Fixes of some bugs
    • npc-*.txt with decimal numbers won't crash anymore SMBX with "runtime error 13"
    • fixes a random crash caused by the mushrooms contacting with lava blocks
  • OpenGL render support
  • SMBX's audio engine has been replaced with better and more flexible SDL Mixer X library which also provides SMBX with internal support of lots of additional sound formats
  • Added PGE's sounds.ini and music.ini support which gives ability to have custom musics (including the world map musics!) and custom sound effects per episode.

Comparison with LunaDLL

LunaLua is a continuation of LunaDLL which adds the Lua scripting language. The main problem with Autocode (the LunaDLL-language) is the lack of flexibility (f.e. custom functions, variables,.. etc). With LunaLua we don't need any hardcoded code for complex ideas anymore.

Screenshots and videos

LunaLua: CinematX preview thing
(Demo of CinematX lua library for LunaLua)
LunaLua with effects system
(Example of custom effect controlling)
LunaLua-SMBX: Jump Event Experiences
(All switches are triggering on jump)


NOTE: LunaLua no longer receives standalone updates. We highly recommend downloading SMBX 2.0 which already contains latest LunaLua.

How to download standalone LunaLua:

  • Select a version of LunaLua
  • If you already have LunaLua, just select "Update only" and then download a small update package
  • If you download LunaLua for the first time or you've got troubles after update, choose a "Full Installation"
    • Choice a base game ("SMBX 1.3" or "A2XT")
    • Choice "Include complete standalone game" if you wish to download a runnable package of SMBX Engine with pre-installed LunaLua. Download it if you have no SMBX installed or you wish to have LunaLua as separate assembly.

1. Please select the version of LunaLua:

...or download latest Nightly/Dev-Build

2. Please select the type of the installation:

Select target base Game:

Source code

(Requires Visual Studio 2015 for build)

Download sources (zip)

Our GitHub repository

Help, FAQ and Documentation

Full LunaLua API Documentation

Frequently Asked Questions about Lua Errors

Official Help and support on the PGE Forums

Official Help and support on the Talkhaus

Official Help and support on the SMBX Forums

This page has been requested 29733 times.

Copyright © 2014-2020 By PGE Team

Legal information and privacy policyAbout us