# gary60182007/diu9u-obfuscator architecture

> Architecture diagram of the GitHub repository gary60182007/diu9u-obfuscator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gary60182007/diu9u-obfuscator
- Repository: https://github.com/gary60182007/diu9u-obfuscator

## Overview

This repository is a public showcase for a Luau obfuscator, not the obfuscation engine itself. Its CLI reads a Lua source file and calls the unavailable `bytecode_vm` module; when that module is absent, it exits with an error. The README documents the engine’s parse, compile, protect, and VM-generation stages, while `obfuscated/` contains showcase outputs. Those engine capabilities are documented rather than implemented in the available source, so their internal links rely on the README.

Main entry points: [`obfuscate_scripts.py`](https://github.com/gary60182007/diu9u-obfuscator/blob/master/obfuscate_scripts.py) (CLI Stub), [`README.md`](https://github.com/gary60182007/diu9u-obfuscator/blob/master/README.md) (Bytecode Compiler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI"]
  node_cli["CLI Stub"]
end

subgraph group_engine["Documented Engine"]
  node_engine["Closed Core"]
  node_parser["AST Parser<br/>[README.md]"]
  node_compiler["Bytecode Compiler<br/>[README.md]"]
  node_protection["Bytecode Protection<br/>[README.md]"]
  node_vm["VM Generator<br/>[README.md]"]
  node_output["Generated Output"]
end

subgraph group_showcase["Showcase Outputs"]
  node_samples["Obfuscated Samples"]
end

node_user(("User"))

node_user -->|"runs with input"| node_cli
node_cli -->|"calls compile"| node_engine
node_engine -->|"writes result"| node_output
node_parser -->|"produces AST"| node_compiler
node_compiler -->|"serializes bytecode"| node_protection
node_protection -->|"wraps payload"| node_vm

click node_cli "https://github.com/gary60182007/diu9u-obfuscator/blob/master/obfuscate_scripts.py"
click node_parser "https://github.com/gary60182007/diu9u-obfuscator/blob/master/README.md"
click node_compiler "https://github.com/gary60182007/diu9u-obfuscator/blob/master/README.md"
click node_protection "https://github.com/gary60182007/diu9u-obfuscator/blob/master/README.md"
click node_vm "https://github.com/gary60182007/diu9u-obfuscator/blob/master/README.md"
click node_samples "https://github.com/gary60182007/diu9u-obfuscator/tree/master/obfuscated"

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_user toneBlue
class node_engine,node_parser,node_compiler,node_protection,node_vm,node_output toneAmber
class node_samples toneMint
```

## Components

### CLI

- [CLI Stub](https://github.com/gary60182007/diu9u-obfuscator/blob/master/obfuscate_scripts.py): `obfuscate_scripts.py`

### Documented Engine

- **Closed Core**
- [AST Parser](https://github.com/gary60182007/diu9u-obfuscator/blob/master/README.md): `README.md`
- [Bytecode Compiler](https://github.com/gary60182007/diu9u-obfuscator/blob/master/README.md): `README.md`
- [Bytecode Protection](https://github.com/gary60182007/diu9u-obfuscator/blob/master/README.md): `README.md`
- [VM Generator](https://github.com/gary60182007/diu9u-obfuscator/blob/master/README.md): `README.md`
- **Generated Output**

### Showcase Outputs

- [Obfuscated Samples](https://github.com/gary60182007/diu9u-obfuscator/tree/master/obfuscated): `obfuscated`

### Other components

- **User**

## Connections

- User → CLI Stub: runs with input (evidence: `README.md`)
- CLI Stub → Closed Core: calls compile (evidence: `obfuscate_scripts.py`)
- Closed Core → Generated Output: writes result
- AST Parser → Bytecode Compiler: produces AST (evidence: `README.md`)
- Bytecode Compiler → Bytecode Protection: serializes bytecode (evidence: `README.md`)
- Bytecode Protection → VM Generator: wraps payload (evidence: `README.md`)
