How katalash/dsluadecompiler works
DSLuaDecompiler converts Lua 5.0, HavokScript, and early Lua 5.3 bytecode into decompiled source, primarily for FromSoft game modding. The documented workflow parses bytecode, translates opcodes into a shared IR, applies reusable analyses and transformation passes to recover expressions and control flow, then prints source. The graph preserves the documented frontends and core recovery stages; the README describes their overall flow, while sampled source excerpts do not show every runtime call, so uncertain orchestration links are dashed.
Main entry points: Function.cs Shared function IR · LuaFile.cs Bytecode parser · Program.cs CLI · LuaDecompiler.cs Decompilation coordinator
Components 17
Entry and parsing
- CLI
DSLuaDecompiler/Program.cs - Bytecode parser
LuaDecompilerCore/LuaFile.cs - Decompilation coordinator
LuaDecompilerCore/LuaDecompiler.cs
Bytecode frontends
- Lua 5.0 frontend
LuaDecompilerCore/LanguageDecompilers/Lua50Decompiler.cs - HavokScript frontend
LuaDecompilerCore/LanguageDecompilers/HksDecompiler.cs - Lua 5.3 frontend
LuaDecompilerCore/LanguageDecompilers/Lua53Decompiler.cs
IR recovery
- Shared function IR
LuaDecompilerCore/IR/Function.cs - Expression IR
LuaDecompilerCore/IR/Expression.cs - Instruction IR
LuaDecompilerCore/IR/Instruction.cs - Control-flow graph
LuaDecompilerCore/CFG/BasicBlock.cs - Pass manager
LuaDecompilerCore/PassManager.cs - IR transformation passes
LuaDecompilerCore/Passes - Recovery analyses
LuaDecompilerCore/Analyzers - AST structuring
LuaDecompilerCore/Passes/AstTransformPass.cs
Source output
- Source printer
LuaDecompilerCore/FunctionPrinter.cs - Decompiled Lua source
LuaDecompilerCore/FunctionPrinter.cs
Other components
- Decompiler user
Connections 20
- Decompiler user → CLI: runs
DSLuaDecompiler/Program.cs - CLI → Decompilation coordinator: invokes
DSLuaDecompiler/Program.cs - CLI → Bytecode parser: loads bytecode
DSLuaDecompiler/Program.cs - Bytecode parser → Lua 5.0 frontend: supplies bytecode
LuaDecompilerCore/LanguageDecompilers/Lua50Decompiler.cs - Bytecode parser → HavokScript frontend: supplies bytecode
LuaDecompilerCore/LanguageDecompilers/HksDecompiler.cs - Bytecode parser → Lua 5.3 frontend: supplies bytecode
- Lua 5.0 frontend → Shared function IR: translates opcodes
LuaDecompilerCore/LanguageDecompilers/Lua50Decompiler.cs - HavokScript frontend → Shared function IR: translates opcodes
LuaDecompilerCore/LanguageDecompilers/HksDecompiler.cs - Lua 5.3 frontend → Shared function IR: translates opcodes
- Shared function IR → Instruction IR: represents code
- Shared function IR → Expression IR: represents expressions
LuaDecompilerCore/IR/Expression.cs - Pass manager → IR transformation passes: runs passes
LuaDecompilerCore/PassManager.cs - Pass manager → Recovery analyses: runs analyses
LuaDecompilerCore/PassManager.cs - IR transformation passes → Control-flow graph: builds and transforms
LuaDecompilerCore/Passes/AstTransformPass.cs - IR transformation passes → AST structuring: structures control flow
LuaDecompilerCore/Passes/AstTransformPass.cs - Recovery analyses → Shared function IR: analyze variables
LuaDecompilerCore/Analyzers/LocalVariablesAnalyzer.cs - AST structuring → Source printer: provides AST
- Source printer → Decompiled Lua source: prints source
LuaDecompilerCore/FunctionPrinter.cs - Decompilation coordinator → Pass manager: coordinates recovery
LuaDecompilerCore/LuaDecompiler.cs - Decompilation coordinator → Source printer: requests output