- Robust Decompilation for Lua 5.2/5.3: This fork introduces robust decompilation support for Lua versions 5.2 and 5.3, specifically targeting bytecode with stripped debug information. Previous versions of the tool would crash under these conditions, but with this update, decompilation is stable and reliable.
LuaDec is a Lua decompiler for lua 5.1 , and experimental for lua 5.2 and 5.3.
It is based on Hisham Muhammad's luadec which targeted lua 5.0.x and LuaDec51 by Zsolt Sz. Sztupak.
LuaDec is free software and uses the same license as the original LuaDec.
git clone https://github.com/zhangjiequan/luadec
cd luadec
git submodule update --init lua-5.1
cd lua-5.1
make linux
cd ../luadec
make LUAVER=5.1
If you want to build it for lua 5.2 or 5.3 , just replace 5.1 above to 5.2 or 5.3. You can also compile using tools like mingw32-make. For example:
git clone https://github.com/zhangjiequan/luadec
cd luadec
git submodule update --init lua-5.3
cd lua-5.3
mingw32-make mingw
cd ../luadec
mingw32-make LUAVER=5.3
There are also project files for vc2008, tested for vc2008 , vc2013 and vc2022.
Before compiling, make sure there are correct sources in lua-5.1 , lua-5.2 or lua-5.3.
- decompile lua binary file:
luadec abc.luac - decompile lua source file for testing and comparing:
luadec abc.lua - disassemble lua source or binary
luadec -dis abc.lua - -se output strings using selected encoding, available encodings are ASCII GB2312 GBK GB18030 BIG5 UTF8 luadec -se UTF8 abc.luac
- -pn print nested functions structure, could be used by -fn
luadec -pn test.lua
0
0_0
0_0_0
0_1
- -f decompile only specific nested function
luadec -f 0_1 test.lua - -ns donot process sub functions
luadec -ns -f 0_1 test.lua - -fc perform a instruction-by-instruction compare for each function
luadec -fc test.lua
outputs:
-- function check pass 0
-- function check fail 0_0 : cannot compile
-- function check fail 0_1 : different code size; sizecode org: 66, decompiled: 67, same: 47;
There are some more options, usually for debug purposes, or for cases where the built in local guesser guesses wrong. Use -h to get a complete list of usable parameters
Original by Hisham Muhammad (http://luadec.luaforge.net)
Ongoing port to Lua 5.1 by Zsolt Sz. Sztupak (https://github.com/sztupy/luadec51/)
The internals of Lua5.1 was learned from Kein-Hong Man's A No-Frills Introduction to Lua 5.1 VM Instructions
No changes are currently planned.
LuaDec is licensed under the MIT license.
If you find this tool useful, please mention my name in your credits screen. Something like "LuaDec by viruscamp & zhangjiequan" or "Thanks to viruscamp & zhangjiequan" would be very much appreciated.
Feel free to fork the project and make modifications for yourself or to share by creating pull requests. Also, create issues for feature requests or bug reports if you want to help improving this tool, thanks!
Contact me at zhangjiequan@qq.com
LuaDec is a free and open-source software. If you like it and find it helpful, you can buy me a coffee!
