Skip to content

Commit d03ca20

Browse files
authored
Update README.md
1 parent a9aa51b commit d03ca20

1 file changed

Lines changed: 48 additions & 35 deletions

File tree

README.md

Lines changed: 48 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,59 +1,72 @@
11
# 🛡️ Pobfus v1.0 | The Monolith
2-
### *Advanced Lua Virtualization & Control-Flow Flattening*
2+
### *High-Density Lua Virtualization & Control-Flow Flattening*
33

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+
![Version](https://img.shields.io/badge/Version-1.0--Stable-green?style=for-the-badge&logo=github)
5+
![Build](https://img.shields.io/badge/Build-Success-blue?style=for-the-badge)
6+
![Status](https://img.shields.io/badge/Security-Hell--Mode-red?style=for-the-badge)
7+
![License](https://img.shields.io/badge/License-MIT-gray?style=for-the-badge)
88

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.
1015

1116
---
1217

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.
1820

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.
2029

21-
## 🧱 The "Pobfus-Type" Logic
22-
To build a Pobfus-Type engine, the logic follows a specific three-stage transformation:
2330

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$$
2731

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)
3235

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)** |
3543

44+
---
3645

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.
3751

3852
---
3953

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+
4259

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`.
4760

4861
---
4962

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`.
5568

5669
---
5770

5871
## ⚠️ 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

Comments
 (0)