# bytecoded1337/deobfuscators-and-dumpers architecture

> Architecture diagram of the GitHub repository bytecoded1337/deobfuscators-and-dumpers, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bytecoded1337/deobfuscators-and-dumpers
- Repository: https://github.com/bytecoded1337/deobfuscators-and-dumpers

## Overview

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: [`IronBrew1 (2)/ironbrew1_deobf/cli.py`](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/cli.py) (Command CLI), [`IronBrew1 (2)/ironbrew1_deobf/pipeline.py`](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/pipeline.py) (Analysis Pipeline), [`IronBrew1 (1)/engine.js`](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(1)/engine.js) (JS Deobfuscator), [`IronBrew1 (2)/ironbrew1_deobf/decoder.py`](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/decoder.py) (Payload Decoder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ib1py["IronBrew1 Python"]
  node_cli["Command CLI<br/>[cli.py]"]
  node_pipeline["Analysis Pipeline<br/>[pipeline.py]"]
  node_decoder["Payload Decoder<br/>[decoder.py]"]
  node_format["Serialized Parser<br/>[format.py]"]
  node_dump["Analysis Dumps<br/>[dump.py]"]
  node_recover["Lua Recovery<br/>[recover.py]"]
  node_compare["String Comparison<br/>[compare.py]"]
  node_rename["Semantic Renamer<br/>[rename.py]"]
  node_decompiler["External Decompiler<br/>[decompiler.py]"]
end

subgraph group_ib1js["IronBrew1 JavaScript"]
  node_enginejs["JS Deobfuscator<br/>[engine.js]"]
  node_jsio["Chunk Extraction<br/>[io.js]"]
  node_jsout["Program Reconstruction<br/>[out.js]"]
  node_jsvm["VM Utilities<br/>[vm.js]"]
end

subgraph group_ib0["IronBrew0"]
  node_ib0current["IronBrew0 Deobfuscator<br/>[IronBrew0.py]"]
  node_ib0legacy["IronBrew0 v1.x Deobfuscator<br/>[IronBrew0.py]"]
end

subgraph group_other["Other Deobfuscators"]
  node_boronide["Boronide Dumper<br/>[dump.py]"]
  node_ib2["IronBrew2 Decompiler"]
end

node_user(("Analyst"))

node_user -.->|"invokes"| node_cli
node_cli -->|"runs analysis"| node_pipeline
node_pipeline -->|"decodes payload"| node_decoder
node_pipeline -->|"parses bytes"| node_format
node_pipeline -->|"writes dumps"| node_dump
node_pipeline -->|"writes Lua"| node_recover
node_pipeline -->|"compares strings"| node_compare
node_cli -->|"unpacks payload"| node_decoder
node_cli -->|"parses serialized"| node_format
node_cli -->|"requests dumps"| node_dump
node_cli -->|"requests recovery"| node_recover
node_cli -->|"requests comparison"| node_compare
node_cli -->|"renames source"| node_rename
node_cli -->|"runs decompiler"| node_decompiler
node_enginejs -->|"extracts chunk"| node_jsio
node_enginejs -->|"reconstructs code"| node_jsout

click node_cli "https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/cli.py"
click node_pipeline "https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/pipeline.py"
click node_decoder "https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/decoder.py"
click node_format "https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/format.py"
click node_dump "https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/dump.py"
click node_recover "https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/recover.py"
click node_compare "https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/compare.py"
click node_rename "https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/rename.py"
click node_decompiler "https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/decompiler.py"
click node_enginejs "https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(1)/engine.js"
click node_jsio "https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(1)/Utils/io.js"
click node_jsout "https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(1)/Utils/out.js"
click node_jsvm "https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(1)/Utils/vm.js"
click node_ib0current "https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew0%20(2)/IronBrew0.py"
click node_ib0legacy "https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew0%20v1.x%20(1)/IronBrew0.py"
click node_boronide "https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/Boronide/dump.py"
click node_ib2 "https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew2/DecompileIronBrew2.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_pipeline,node_decoder,node_format,node_dump,node_recover,node_compare,node_rename,node_decompiler toneBlue
class node_enginejs,node_jsio,node_jsout,node_jsvm toneAmber
class node_ib0current,node_ib0legacy toneMint
class node_boronide,node_ib2 toneRose
class node_user toneIndigo
```

## Components

### IronBrew1 Python

- [Command CLI](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/cli.py): `IronBrew1 (2)/ironbrew1_deobf/cli.py`
- [Analysis Pipeline](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/pipeline.py): `IronBrew1 (2)/ironbrew1_deobf/pipeline.py`
- [Payload Decoder](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/decoder.py): `IronBrew1 (2)/ironbrew1_deobf/decoder.py`
- [Serialized Parser](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/format.py): `IronBrew1 (2)/ironbrew1_deobf/format.py`
- [Analysis Dumps](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/dump.py): `IronBrew1 (2)/ironbrew1_deobf/dump.py`
- [Lua Recovery](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/recover.py): `IronBrew1 (2)/ironbrew1_deobf/recover.py`
- [String Comparison](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/compare.py): `IronBrew1 (2)/ironbrew1_deobf/compare.py`
- [Semantic Renamer](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/rename.py): `IronBrew1 (2)/ironbrew1_deobf/rename.py`
- [External Decompiler](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(2)/ironbrew1_deobf/decompiler.py): `IronBrew1 (2)/ironbrew1_deobf/decompiler.py`

### IronBrew1 JavaScript

- [JS Deobfuscator](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(1)/engine.js): `IronBrew1 (1)/engine.js`
- [Chunk Extraction](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(1)/Utils/io.js): `IronBrew1 (1)/Utils/io.js`
- [Program Reconstruction](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(1)/Utils/out.js): `IronBrew1 (1)/Utils/out.js`
- [VM Utilities](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew1%20(1)/Utils/vm.js): `IronBrew1 (1)/Utils/vm.js`

### IronBrew0

- [IronBrew0 Deobfuscator](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew0%20(2)/IronBrew0.py): `IronBrew0 (2)/IronBrew0.py`
- [IronBrew0 v1.x Deobfuscator](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew0%20v1.x%20(1)/IronBrew0.py): `IronBrew0 v1.x (1)/IronBrew0.py`

### Other Deobfuscators

- [Boronide Dumper](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/Boronide/dump.py): `Boronide/dump.py`
- [IronBrew2 Decompiler](https://github.com/bytecoded1337/deobfuscators-and-dumpers/blob/main/IronBrew2/DecompileIronBrew2.py): `IronBrew2/DecompileIronBrew2.py`

### Other components

- **Analyst**

## Connections

- Analyst → Command CLI: invokes
- Command CLI → Analysis Pipeline: runs analysis (evidence: `IronBrew1 (2)/ironbrew1_deobf/cli.py`)
- Analysis Pipeline → Payload Decoder: decodes payload (evidence: `IronBrew1 (2)/ironbrew1_deobf/pipeline.py`)
- Analysis Pipeline → Serialized Parser: parses bytes (evidence: `IronBrew1 (2)/ironbrew1_deobf/pipeline.py`)
- Analysis Pipeline → Analysis Dumps: writes dumps (evidence: `IronBrew1 (2)/ironbrew1_deobf/pipeline.py`)
- Analysis Pipeline → Lua Recovery: writes Lua (evidence: `IronBrew1 (2)/ironbrew1_deobf/pipeline.py`)
- Analysis Pipeline → String Comparison: compares strings (evidence: `IronBrew1 (2)/ironbrew1_deobf/pipeline.py`)
- Command CLI → Payload Decoder: unpacks payload (evidence: `IronBrew1 (2)/ironbrew1_deobf/cli.py`)
- Command CLI → Serialized Parser: parses serialized (evidence: `IronBrew1 (2)/ironbrew1_deobf/cli.py`)
- Command CLI → Analysis Dumps: requests dumps (evidence: `IronBrew1 (2)/ironbrew1_deobf/cli.py`)
- Command CLI → Lua Recovery: requests recovery (evidence: `IronBrew1 (2)/ironbrew1_deobf/cli.py`)
- Command CLI → String Comparison: requests comparison (evidence: `IronBrew1 (2)/ironbrew1_deobf/cli.py`)
- Command CLI → Semantic Renamer: renames source (evidence: `IronBrew1 (2)/ironbrew1_deobf/cli.py`)
- Command CLI → External Decompiler: runs decompiler (evidence: `IronBrew1 (2)/ironbrew1_deobf/cli.py`)
- JS Deobfuscator → Chunk Extraction: extracts chunk (evidence: `IronBrew1 (1)/engine.js`)
- JS Deobfuscator → Program Reconstruction: reconstructs code (evidence: `IronBrew1 (1)/engine.js`)
