Skip to content

Prashant-Jonny/ljd

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LuaJIT raw-bytecode decompiler (LJD)

The original name was ljwthgnd as in LuaJIT 'What The Hell is Going On' Decompiler named under the LuaJIT C sources variable naming convention.

WARNING! This code is nor finished, nor tested yet! There is no even slightest warranty that resulting code is even near to the original. Use it at your own risk of the wasted time.

SECOND WARNING! And, BTW, this all is a one huge prototype. Because the "release" version should be written into lua itself. Because it's cool to decompile the decompiler - a great test too!

How to use it

There is no argument parsing right now, so comment out things in the main.py script and launch it as in main.py path/to/file.luac

TODO

There is a lot of work to do, in the order of priority

  1. AST Mutations:

    1. Use the line information (or common sense if there is no line information) to squash similar expressions into a single expression.
  2. Formatting improvements

    1. Use the line information (or common sense) to preserve empty lines and break long statements like in the original code.

      This is mostly done, but only in the "common sense" part.

    2. Use method-style calls and definitions for tables.

  3. Features not supported:

    1. GOTO statement (from lua 5.2). All the required functionality is now in place, but that's rather a low-priority task right now.

    2. Local sub-blocks:

    do
    	...
    end
    These subblocks are not reflected anyhow directly in the bytecode.
    The only way to guess them is to watch local variable scopes, which
    is simple enough in case of non-stripped bytecode and a bit
    harder otherwise.
    
    P.S. After a bit more research - it could be hard after all and
    I don't see much profit.,, An ultra-low priority
    

About

LuaJIT raw-bytecode decompiler

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 84.1%
  • Lua 15.9%