How quantumxternal/quantum-obfuscator-lua-luau works
Clyde is a Luau obfuscator whose main workflow accepts source through the CLI or web interface, tokenizes and parses it, applies configurable AST transformations, then emits direct Luau or a protected stack/register VM script. Its other major capability is syntax validation. The graph preserves both VM backends and the shared bytecode layer. Some subsystem links rely on README architecture statements and SOURCE INDEX references; unsampled implementation details are not inferred.
Main entry points: obfuscatePipeline.ts Obfuscation Pipeline · reg-vm-gen.ts Register VM Generator · LuauCompiler.ts Syntax Validator · Parser.ts Luau Parser
Components 26
Language Front End
- Lexer
src/lexer/Lexer.ts - Token Types
src/tokens.ts - Luau Parser
src/parser/Parser.ts - Type Parser
src/parser/TypeParser.ts - AST Types
src/ast/types.ts - Syntax Validator
src/compiler/LuauCompiler.ts
Obfuscation
- Obfuscation Pipeline
src/engine/obfuscatePipeline.ts - Protection Profiles
src/engine/profiles.ts - Identifier Renamer
src/obfuscator/Obfuscator.ts - String Encoder
src/obfuscator/StringEncoder.ts - Flow Scrambler
src/obfuscator/ControlFlowScrambler.ts - Luau Printer
src/obfuscator/Printer.ts
VM Backends
- Stack Compiler
src/vm/Compiler.ts - Register Compiler
src/vm/RegCompiler.ts - Bytecode Format
src/vm/bytecode.ts - Stack VM Generator
src/vm/vm-gen.ts - Register VM Generator
src/vm/reg-vm-gen.ts - VM Bootstrap
src/vm/bootstrap-template.ts - LZMA Compression
src/vm/lzma.ts - VM Runner
src/vm/vm-runner.ts - Register VM Runner
src/vm/reg-runner.ts
User Interfaces
- CLI Commands
src/cli/obfuscate.ts - Web UI
public/app.js - Web Server
src/server.ts
Other components
- User
- Obfuscated Luau
Connections 34
- User → CLI Commands: runs command
README.md - User → Web UI: uses interface
README.md - Web UI → Web Server: requests obfuscation
README.md - CLI Commands → Obfuscation Pipeline: invokes
src/cli/obfuscate.ts - Web Server → Obfuscation Pipeline: invokes
src/server.ts - Web Server → Syntax Validator: validates source
src/server.ts - Protection Profiles → Obfuscation Pipeline: configures
src/engine/profiles.ts - Obfuscation Pipeline → Lexer: tokenizes
README.md - Lexer → Token Types: produces tokens
src/lexer/Lexer.ts - Obfuscation Pipeline → Luau Parser: parses tokens
src/engine/obfuscatePipeline.ts - Luau Parser → Type Parser: delegates types
src/parser/Parser.ts - Luau Parser → AST Types: builds AST
README.md - Syntax Validator → Lexer: tokenizes
src/compiler/LuauCompiler.ts - Syntax Validator → Luau Parser: parses
src/compiler/LuauCompiler.ts - Syntax Validator → Luau Printer: prints AST
src/compiler/LuauCompiler.ts - Obfuscation Pipeline → Identifier Renamer: renames identifiers
src/engine/obfuscatePipeline.ts - Obfuscation Pipeline → String Encoder: encodes strings
src/engine/obfuscatePipeline.ts - Obfuscation Pipeline → Flow Scrambler: scrambles flow
src/engine/obfuscatePipeline.ts - Obfuscation Pipeline → Luau Printer: prints output
README.md - Obfuscation Pipeline → Stack Compiler: compiles stack VM
src/engine/obfuscatePipeline.ts - Obfuscation Pipeline → Register Compiler: compiles register VM
README.md - Stack Compiler → Bytecode Format: emits bytecode
src/vm/Compiler.ts - Register Compiler → Bytecode Format: emits bytecode
src/vm/RegCompiler.ts - Obfuscation Pipeline → Stack VM Generator: generates stack VM
README.md - Obfuscation Pipeline → Register VM Generator: generates register VM
src/engine/obfuscatePipeline.ts - Stack VM Generator → Bytecode Format: encodes bytecode
src/vm/vm-gen.ts - Register VM Generator → Bytecode Format: encodes bytecode
src/vm/reg-vm-gen.ts - Register VM Generator → VM Bootstrap: uses bootstrap
src/vm/reg-vm-gen.ts - Register VM Generator → LZMA Compression: compresses payload
src/vm/reg-vm-gen.ts - Stack VM Generator → Obfuscated Luau: emits script
README.md - Register VM Generator → Obfuscated Luau: emits script
README.md - Luau Printer → Obfuscated Luau: emits Luau
README.md - Stack Compiler → VM Runner: supports execution
- Register Compiler → Register VM Runner: supports execution