How bytecoded1337/deobfuscators-and-dumpers works
Bytecode1337 is a collection of Lua/Luau bytecode deobfuscators and dumpers, not one integrated application. The clearest end-to-end workflow is IronBrew1 (2): a user invokes the CLI, which extracts and decodes a payload, parses its serialized structure, then emits analysis dumps, conservative recovered Lua, and string comparisons. The repository also includes separate Boronide, IronBrew0, IronBrew1 JavaScript, and IronBrew2 tools. Their standalone internals are not connected here where source evidence was unavailable.
Main entry points: cli.py Command CLI · pipeline.py Analysis Pipeline · engine.js JS Deobfuscator · decoder.py Payload Decoder
Components 18
IronBrew1 Python
- Command CLI
IronBrew1 (2)/ironbrew1_deobf/cli.py - Analysis Pipeline
IronBrew1 (2)/ironbrew1_deobf/pipeline.py - Payload Decoder
IronBrew1 (2)/ironbrew1_deobf/decoder.py - Serialized Parser
IronBrew1 (2)/ironbrew1_deobf/format.py - Analysis Dumps
IronBrew1 (2)/ironbrew1_deobf/dump.py - Lua Recovery
IronBrew1 (2)/ironbrew1_deobf/recover.py - String Comparison
IronBrew1 (2)/ironbrew1_deobf/compare.py - Semantic Renamer
IronBrew1 (2)/ironbrew1_deobf/rename.py - External Decompiler
IronBrew1 (2)/ironbrew1_deobf/decompiler.py
IronBrew1 JavaScript
- JS Deobfuscator
IronBrew1 (1)/engine.js - Chunk Extraction
IronBrew1 (1)/Utils/io.js - Program Reconstruction
IronBrew1 (1)/Utils/out.js - VM Utilities
IronBrew1 (1)/Utils/vm.js
IronBrew0
- IronBrew0 Deobfuscator
IronBrew0 (2)/IronBrew0.py - IronBrew0 v1.x Deobfuscator
IronBrew0 v1.x (1)/IronBrew0.py
Other Deobfuscators
- Boronide Dumper
Boronide/dump.py - IronBrew2 Decompiler
IronBrew2/DecompileIronBrew2.py
Other components
- Analyst
Connections 16
- Analyst → Command CLI: invokes
- Command CLI → Analysis Pipeline: runs analysis
IronBrew1 (2)/ironbrew1_deobf/cli.py - Analysis Pipeline → Payload Decoder: decodes payload
IronBrew1 (2)/ironbrew1_deobf/pipeline.py - Analysis Pipeline → Serialized Parser: parses bytes
IronBrew1 (2)/ironbrew1_deobf/pipeline.py - Analysis Pipeline → Analysis Dumps: writes dumps
IronBrew1 (2)/ironbrew1_deobf/pipeline.py - Analysis Pipeline → Lua Recovery: writes Lua
IronBrew1 (2)/ironbrew1_deobf/pipeline.py - Analysis Pipeline → String Comparison: compares strings
IronBrew1 (2)/ironbrew1_deobf/pipeline.py - Command CLI → Payload Decoder: unpacks payload
IronBrew1 (2)/ironbrew1_deobf/cli.py - Command CLI → Serialized Parser: parses serialized
IronBrew1 (2)/ironbrew1_deobf/cli.py - Command CLI → Analysis Dumps: requests dumps
IronBrew1 (2)/ironbrew1_deobf/cli.py - Command CLI → Lua Recovery: requests recovery
IronBrew1 (2)/ironbrew1_deobf/cli.py - Command CLI → String Comparison: requests comparison
IronBrew1 (2)/ironbrew1_deobf/cli.py - Command CLI → Semantic Renamer: renames source
IronBrew1 (2)/ironbrew1_deobf/cli.py - Command CLI → External Decompiler: runs decompiler
IronBrew1 (2)/ironbrew1_deobf/cli.py - JS Deobfuscator → Chunk Extraction: extracts chunk
IronBrew1 (1)/engine.js - JS Deobfuscator → Program Reconstruction: reconstructs code
IronBrew1 (1)/engine.js