[RELEASE] DeAMX 0.3: .amx -> .pwn decompiler

[trc_]

DeAMX v0.3

Lost your gamemode source code and don't want to rewrite all of it? Want to take a look at how other gamemodes implement those interesting features? Now you can!

New release
0.3 is out now. Main new feature is propagation of argument types of functions: if DeAMX found out that one of the arguments of a function is a float, and another function passes one of its local variables to it, it will mark that local variable as a float also. The calling function may also pass one of its own arguments, so that we in turn know more about other functions calling this function.

Also, return types of functions are recognized now.

Features

• Takes any .amx file that was generated by the Pawn compiler and turns it back into a .pwn file
  
• Recognizes functions, if, if/else, for, while, and switch/case constructs, and ternary operators.
• Uses public function names if available.
• Recognizes type of most local and global variables. Finds array dimensions.
• Contains signatures for all SA-MP native functions and callbacks.
• Finds out the types of arguments and return values of script defined functions.
• Recognizes what arguments of script-defined functions are used for (e.g. player id, object id) and gives them sensible names.

Notes

• This is an early release. It may not correctly decompile all scripts.
• Known issue: prototypes of script-defined functions are not applied to calls of those functions before the function definition. This means that e.g. a constant float argument will be interpreted as an int.
  

Usage
DeAMX is a Lua script: you need Lua to run it. For detailed usage instructions and the licence, see readme.txt in the .zip.


>> Download v0.3 here! <<
(Download link updated as Filefront will be going down soon)

Disclaimer
The author is in no way responsible for what you do with this decompiler. You are not allowed to decompile someone else's script and re-release it as your own script, unless explicitely approved by the script's author.

[Scott[LT]]

if it works then this will be cool i tried to decompile but dont works for me something i do wrong

[trc_]

If you get an error message from deamx ("error in deamx_blah.lua line blah") there's not much you can do. Tell me where I can get the .amx file you're trying to decompile and I'll take a look at it for the next version. Same goes for any other files that people have errors with btw.

If you got a different error message (one that doesn't state a .lua file where the error occured), you may be doing something wrong. If your error doesn't name a .lua file please explain what you did exactly.

[DragSta]

Wow this is great! I didnt think this was possible from what soem people have said Great work!

[Luxeon]

wow ,you rock ! 

[Jashugan]

Very nice!!

[TheMaTrIx4057]

Awesome Thx!

[Antironix]

There goes the .amx security xD But good job!

[John.]

Please can someone upload it somewhere else cause i have probs with filefront  , thnx in advance...

[trc_]

File size is not a problem, it has decompiled a 5000+ line script without problems (TaXi FR). I'll take a look at it.

[Packie ]

Excellent.   

[Killerkid.]

Can you upload to a new host.
i cant download.

[Killerkid.]

It makes a blank gamemode have 5 errors (new.pwn)

Code:

error 025: function heading differs from prototype
error 025: function heading differs from prototype
error 025: function heading differs from prototype
error 035: argument type mismatch (argument 2)
error 025: function heading differs from prototype

Anyway nice 

[trc_]

Also, I compiled and decompiled the original LVDM.  This:

PAWN Code:

static
g_sModelUse[(611 - 400) + 1];

Became:

PAWN Code:

new glob8[212][1];

611 - 400 + 1 = 212. The [1] means g_sModelUse[value][0] is used somewhere.

And:

PAWN Code:

public SendPlayerFormattedText(playerid, const str[], define)

Became:

PAWN Code:

public SendPlayerFormattedText(playerid, arg1[], arg2[])

There's no way to determine if an argument is "const" from the amx file. And function prototypes aren't perfect yet.

Both of which meant the script didn't compile.

It's not the goal of this decompiler to create perfectly compileable pwn files. The goal is to be able to look at the code and eventually recover parts of it.

And it doesn't forward custom public functions.

I can add that in a later release I guess.


Edit: your YSI crash is because of a ternary operator btw. Totally forgot about those, heh.

[Felle]

I must say this looks very nice!
Good job and good luck with it in the future!