Obfuscation Guide
How to obfuscate Lua and Luau code using the Obscurau engine.
This guide explains how to secure scripts using the dashboard.
Dashboard Workflow
Use the dashboard to obfuscate scripts manually.
- Go to the Obfuscation tab in the sidebar.
- Upload a
.luaor.luaufile. - Select the Target Platform that matches your environment (e.g., Luau, Roblox, Lua 5.1).
- Choose an Optimization Level.
- Click Obfuscate.
- Click the download button to save the output file.
Target Platforms
The engine selects one of two compiler backends based on the target you select.
- Luau VM Backend: The engine uses this backend for
LuauandRobloxtargets. It provides structural protections specific to the Luau VM. - Portable Lua Backend: The engine uses this backend for
Lua 5.1-5.5,LuaJIT,FiveM,Warcraft 3,World of Warcraft, andGarry's Mod. It parses modern Lua syntax but emits Lua 5.1-compatible source code to maximize compatibility across older runtimes.
Protection Levels
The engine provides three optimization levels.
- Safe (Level 1): The default profile. It prioritizes runtime compatibility and execution speed.
- Aggressive (Level 2): Increases mutation intensity. It automatically enables the
Intense VM Structuresetting for supported backends. - Maximized (Level 3): The maximum protection profile. It maximizes internal compiler optimization at the cost of execution speed.
Automation
To integrate the obfuscator into a build system or deployment pipeline, use the REST API. See the API Reference for endpoint definitions and authentication parameters.