|
1 | 1 | # 🛡️ Pobfus v1.0 | The Monolith |
2 | | -### *Advanced Lua Virtualization & Control-Flow Flattening* |
| 2 | +### *High-Density Lua Virtualization & Control-Flow Flattening* |
3 | 3 |
|
4 | | -> [!CAUTION] |
5 | | -> **STATUS: ⚠️ MAINTENANCE YELLOW** |
6 | | -> The engine is currently undergoing "Hell-Mode" optimization. Logic stability is 98%. |
7 | | -> Current Version: 1.0-RC1 (Release Candidate) |
| 4 | + |
| 5 | + |
| 6 | + |
| 7 | + |
8 | 8 |
|
9 | | -**Pobfus** is a portable, single-file obfuscation engine designed to transform readable Lua source into a **Fat Hex-Table Brick Wall**. Using the **CamBuscate 0.1.1** core, it maps bytecode to localized variable constants, making static analysis a nightmare for decompilers. |
| 9 | +> [!IMPORTANT] |
| 10 | +> **DEVELOPMENT START:** March 4, 2026 |
| 11 | +> **OFFICIAL RELEASE:** March 5, 2026 (v1.0 Stable) |
| 12 | +> **AUTHOR:** tenringsofdoom1x |
| 13 | +
|
| 14 | +**Pobfus** is a 24-hour sprint project designed to kill the "API-Dependency" era. It transforms readable Lua into a **Fat Hex-Table Brick Wall** using the **CamBuscate 0.1.1** core. No APIs, no keys, just pure client-side virtualization. |
10 | 15 |
|
11 | 16 | --- |
12 | 17 |
|
13 | | -## 🚀 "Hell-Mode" Features |
14 | | -* **The Fat Header:** Maps 40+ global functions (`Eb`, `ob`, `La`, etc.) to hide internal Lua calls. |
15 | | -* **Junk-Bit Injection:** Every byte is wrapped in random alphanumeric "noise" that is stripped at runtime by the internal VM. |
16 | | -* **Integrity Anchor:** The decryption key is mathematically tied to the ASCII logo length. Edit the logo = break the script. |
17 | | -* **Encrypted Roast Trap:** Logic-locked insults are buried within the hex-table, triggered only during tamper attempts. |
| 18 | +## 🏗️ Build Your Own "Pobfus-Type" Engine |
| 19 | +Pobfus isn't just a tool; it's a **Framework**. You can modify the Monolith to create your own branded protector in minutes. |
18 | 20 |
|
19 | | ---- |
| 21 | +### 1. Customizing the "Fat" Header |
| 22 | +Open `index.html` and locate the `Eb, ob, La...` variable string. Replace these with your own localized constants (e.g., `_v1, _v2, _v3`) to change the visual "weight" of the output. |
| 23 | + |
| 24 | +### 2. Injecting Custom "Hell-Mode" Roasts |
| 25 | +Locate the `_roasts` array. Any text added here is automatically bit-XORed. If a skid tampers with your code, the VM will decrypt and print your custom roast before freezing the thread. |
| 26 | + |
| 27 | +### 3. Adjusting Junk-Bit Entropy |
| 28 | +Find the `Math.random().toString(36)` logic. Changing the substring length (e.g., `(2, 8)` instead of `(2, 5)`) makes the "Brick Wall" wider and more chaotic. |
20 | 29 |
|
21 | | -## 🧱 The "Pobfus-Type" Logic |
22 | | -To build a Pobfus-Type engine, the logic follows a specific three-stage transformation: |
23 | 30 |
|
24 | | -### 1. Bitwise XOR Mapping |
25 | | -Every character $c$ in the source is processed through a XOR gate using a dynamic key $k$: |
26 | | -$$c_{enc} = c \oplus k$$ |
27 | 31 |
|
28 | | -### 2. Chunky Hex Conversion |
29 | | -The resulting byte is converted to Hex and appended with random junk. |
30 | | -* **Original:** `p` |
31 | | -* **Pobfus Output:** `0x70abc` (Where `70` is the hex and `abc` is the junk noise) |
| 32 | +--- |
| 33 | + |
| 34 | +## 📊 Feature Comparison (v1.0 Release) |
32 | 35 |
|
33 | | -### 3. Control-Flow Flattening |
34 | | -Instead of a linear execution, the Lua VM uses a `repeat...until` state machine. This prevents step-through debugging by hiding the execution order inside a "Dispatcher." |
| 36 | +| Feature | Standard APIs | Old-Gen Obf | **Pobfus v1.0** | |
| 37 | +| :--- | :---: | :---: | :---: | |
| 38 | +| **Hosting Cost** | $$$ / Monthly | $ / Server | **$0 (GitHub Pages)** | |
| 39 | +| **Ease of Use** | Hard (API Keys) | Medium | **Easy (Single File)** | |
| 40 | +| **Logic Hiding** | String Encryption | Variable Renaming | **VM Virtualization** | |
| 41 | +| **Tamper Protection** | Error Logs | Print Warning | **Encrypted Roast + Crash** | |
| 42 | +| **Visual "Weight"** | Clean/Small | Readable | **Fat Brick Wall (Intimidating)** | |
35 | 43 |
|
| 44 | +--- |
36 | 45 |
|
| 46 | +## 🚀 Pro-Tier Features |
| 47 | +* **The Fat Header:** Maps 40+ global functions to hide internal Lua calls and break static analysis. |
| 48 | +* **Junk-Bit Injection:** Every byte is protected by a random noise buffer, stripped only at the final execution layer. |
| 49 | +* **Logo-Bound Integrity:** The decryption key is mathematically tied to the ASCII logo length. Modification = Corruption. |
| 50 | +* **Silent Roast Trap:** Encrypted insults triggered only during unauthorized tamper attempts. |
37 | 51 |
|
38 | 52 | --- |
39 | 53 |
|
40 | | -## 🛠️ Deployment (Zero-Cost Hosting) |
41 | | -Because this is a **Monolith Build**, you don't need APIs or Servers: |
| 54 | +## 🧱 The Logic (Pobfus-Type) |
| 55 | +1. **Bitwise XOR Mapping:** $c_{enc} = c \oplus k$ |
| 56 | +2. **Chunky Hex Conversion:** Bytes are converted to Hex and padded with noise. |
| 57 | +3. **Control-Flow Flattening:** The VM uses a `repeat...until` state machine (Dispatcher) to hide the execution order. |
| 58 | + |
42 | 59 |
|
43 | | -1. **Fork** this repository. |
44 | | -2. **Upload** your `index.html`. |
45 | | -3. **Enable GitHub Pages** (Settings > Pages > Main Branch). |
46 | | -4. Your obfuscator is live at `https://yourname.github.io/Pobfus`. |
47 | 60 |
|
48 | 61 | --- |
49 | 62 |
|
50 | | -## 📝 v1.1 Roadmap (Maintenance Tasks) |
51 | | -- [ ] **JobId/PlaceId Locking:** Restrict script execution to specific game servers. |
52 | | -- [ ] **Discord Webhook Integration:** Notify the developer when a script is tampered with. |
53 | | -- [ ] **Variable Randomization:** Change the "Fat Names" (`Eb`, `ob`, etc.) on every click. |
54 | | -- [ ] **Recursive Virtualization:** Running the VM inside another VM for maximum weight. |
| 63 | +## 🛠️ Deployment (Single-File Hosting) |
| 64 | +1. **Fork** this repository. |
| 65 | +2. **Upload** your customized `index.html`. |
| 66 | +3. **Enable GitHub Pages** (Settings > Pages > Main Branch). |
| 67 | +4. Your custom obfuscator is live at `https://yourname.github.io/Pobfus`. |
55 | 68 |
|
56 | 69 | --- |
57 | 70 |
|
58 | 71 | ## ⚠️ Disclaimer |
59 | | -Developed by **tenringsofdoom1x**. This tool is for educational purposes regarding code protection. We do not condone the malicious use of this software. If the code looks like ȟ̸̨̯̲̝̳͓͎̭͖͊̄̔̽̓̂̋̇̋̀̕̚͜ẹ̷͓̺̰̽̍͛̉̐̔͋̓̚͜l̷̢̨̨̫̼͙̞͉̗͉̖̲̖̞̿̉, it's working as intended. |
| 72 | +This tool is for educational purposes regarding code protection and virtualization. Developed by **tenringsofdoom1x**. If the code looks like ȟ̸̨̯̲̝̳͓͎̭͖͊̄̔̽̓̂̋̇̋̀̕̚͜ẹ̷͓̺̰̽̍͛̉̐̔͋̓̚͜l̷̢̨̨̫̼͙̞͉̗͉̖̲̖̞̿̉, it's working as intended. |
0 commit comments