PAK ULTRA MASTER PRO (V5.0 SUPREME)

The Ultimate High-Performance, Multi-Threaded Unreal Engine & Tencent .PAK Tool Suite.
Built for complete reliability, zero path errors, and future-proof compatibility across all PUBG Mobile versions (Current 4.x, upcoming 4.7, 4.8, 5.0, and beyond).

---

Key Highlights & Engineering Features

• Multi-Threaded Engine (10x-20x Faster): 12-thread parallel worker pool extracts 50,000+ assets in seconds with zero crashes.
• Universal 100% Clean Rebuild Repacker: Reconstructs payload, offset tables, SHA1 signatures, and RSA key blocks. Files can be any size (even 10x larger than original).
• Auto Stem-Hash CRC32 Signature: Automatically signs the UTF-32LE CRC32 filename stem hash for any patch name (e.g. game_patch_4.7.0.xxxxx.pak), bypassing in-game CRC integrity checks.
• Game-Native SM4 Encryptor & Decryptor: Handles all Tencent SM4 encryption types (Types 31-52, Type 47, Type 2, Type 4) and rolling key ciphers (Simple 1 & 2).
• Smart Flat & Nested File Resolver: Automatically maps files placed in UNPACK/<pak>/edited/ using index.csv fingerprints.
• Custom Path Direct Injection: Inject modded Lua scripts / assets directly into target pak directories with automatic Tencent unk2 path hashing.
• Universal Cross-Platform Compatibility: Runs seamlessly on Windows, Linux, macOS, and Android (Termux) without path syntax errors.
• Self-Healing Dependency Installer: Automatically detects and installs required libraries on first launch.

---

Repository Structure

PAK_ULTRA_MASTER_PRO/
├── PAK/                    # Place your original .pak files here
├── UNPACK/                 # Extracted assets + index.csv + 'edited/' folder
├── EDIT/                   # Place files for direct injection (Options 3 & 4)
├── RESULT/                 # Final game-ready rebuilt .pak files
├── LOGS/                   # Detailed debug & extraction logs
├── pak_engine.py           # Core high-speed crypto & rebuild engine
├── tool.py                 # Interactive CLI with Rich UI
├── RUN_TOOL.bat            # 1-Click launcher for Windows
├── INSTALL_REQUIREMENTS.bat# 1-Click dependency installer for Windows
├── run.sh                  # 1-Click launcher for Linux / macOS / Termux
├── requirements.txt        # Python dependency specifications
├── .gitignore              # Clean git configuration
├── LICENSE                 # MIT Open Source License
└── README.md               # Complete documentation

---

Quick Start (Installation & Usage)

1. Clone the Repository

git clone https://github.com/your-username/PAK_ULTRA_MASTER_PRO.git
cd PAK_ULTRA_MASTER_PRO

2. Launch the Tool

Windows:

• Double-click RUN_TOOL.bat (or open CMD and run python tool.py).

Linux / macOS / Android Termux:

chmod +x run.sh
./run.sh

---

How To Mod & Repack (Step-by-Step)

Workflow A: Unpack & Repack (Standard Modding)

1. Copy your .pak into the PAK/ folder.
2. Select [1] UNPACK PAK in the menu.
3. Edit your files inside UNPACK/<pak_name>/edited/.
4. Select [2] REPACK PAK to generate the game-ready file in RESULT/.

Workflow B: Custom Path Injection (Fastest Lua Modding)

1. Place your modded Lua file (e.g. BRPlayerCharacterBase.lua) into EDIT/.
2. Select [3] REPACK TO CUSTOM PATH.
3. Enter target path (e.g. ShadowTrackerExtra/Content/Lua/GameLua/Mod/BRMod/Gameplay/Core).
4. Rebuilt PAK is immediately created in RESULT/.

Workflow C: Protect Mod (SM4 Anti-Leak Cloak)

1. Select [5] PROTECT PAK (SM4 CLOAK).
2. Encrypts all assets with game-native SM4 so generic tools cannot unpack your mod while remaining 100% playable in-game.

---

License

This project is licensed under the MIT License - see the LICENSE file for details.