Skip to content

Commit 231ea55

Browse files
authored
Revise README for Pobfus v1.0 release
Updated README for Pobfus to reflect version 1.0 and added new features.
1 parent ed11cba commit 231ea55

1 file changed

Lines changed: 48 additions & 21 deletions

File tree

README.md

Lines changed: 48 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,59 @@
1-
# 🛡️ Pobfus v0.9 Beta
2-
### *Next-Generation Lua Virtualization & Protection*
1+
# 🛡️ Pobfus v1.0 | The Monolith
2+
### *Advanced Lua Virtualization & Control-Flow Flattening*
33

4-
![Pobfus Web Interface](webpic.png)
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)
58
6-
Developed by **[tenringsofdoom1x](https://github.com/tenringsofdoom1x)**, Pobfus 0.9 is a security-focused obfuscator designed to combat AI-driven de-compilation and manual script analysis.
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.
710

811
---
912

10-
## 💎 Proprietary Technology: CamBuscate 0.1.1
11-
Unlike standard obfuscators, Pobfus utilizes the **CamBuscate Engine**, which transforms your code into a virtualized bytecode state.
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+
19+
---
20+
21+
## 🧱 The "Pobfus-Type" Logic
22+
To build a Pobfus-Type engine, the logic follows a specific three-stage transformation:
23+
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+
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+
### 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."
1235

13-
* **Environmental Keying:** Decryption keys are derived from the file's own metadata (`debug.getinfo`), preventing static analysis. With Current Beta Testing on Maintenance, We are Trying to improve it to look like a Perfect Obfuscation Tool (POT)
14-
* **Shedletsky Anti-Tamper:** Any modification to the script's header or logic triggers an immediate execution block and crash loop.
15-
* **Non-Linear Control Flow:** Logic is shattered across a state machine, making it unreadable to LLMs like Grok or ChatGPT.
1636

17-
## 🚀 Getting Started
18-
1. Access the [Live Obfuscator Here](https://tenringsofdoom1x.github.io/).
19-
2. Paste your raw Lua code into the editor.
20-
3. Click **Protect Code** to deploy the CamBuscate engine.
21-
4. Download your unique build (Filename: `pobfus-[RandomID].lua`).
2237

23-
## ⚖️ Terms of Service & Disclaimer
24-
* **No Exploiting:** We do not condone the use of exploiting. This tool is provided for the protection of intellectual property and educational purposes only.
25-
* **Support Policy:** If your script gets skidded, **do not** ping me in the thousands.
26-
* **Reporting:** If you have issues or feedback, please leave them in the **Remarks** section or via GitHub Issues.
38+
---
39+
40+
## 🛠️ Deployment (Zero-Cost Hosting)
41+
Because this is a **Monolith Build**, you don't need APIs or Servers:
42+
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`.
2747

28-
Sincerely,
29-
**tenringsofdoom1x**
48+
---
49+
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.
3055

3156
---
32-
[![Status](https://img.shields.io/badge/Status-Maintenance-yellow)](https://github.com/tenringsofdoom1x)
57+
58+
## ⚠️ 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.

0 commit comments

Comments
 (0)