retoc GUI — Unreal Engine IoStore Tool - wiki thư viện pc , ps2, ps3, ps4, ps5, switch...

GUI + batch wrappers cho retoc — công cụ CLI pack/unpack IoStore containers (.utoc/.ucas) của Unreal Engine, đồng thời convert giữa Zen assets và Legacy assets.

📁 File trong gói này

File	Mô tả
`retoc_gui.py`	GUI chính — giao diện đồ họa đầy đủ (Python/tkinter)
`launch_retoc_gui.bat`	Launcher — click đúp để mở GUI
`retoc_commands.bat`	CLI menu — chạy từng lệnh qua menu text
`README.md`	Tài liệu này

🚀 Yêu cầu

1. Python 3.8+

Tải tại https://www.python.org/
Khi cài, chọn “Add Python to PATH”.

Kiểm tra:

python --version

2. retoc.exe

Tải bản mới nhất tại:
👉 https://github.com/trumank/retoc/releases

Đặt retoc.exe vào cùng thư mục với retoc_gui.py, hoặc chọn đường dẫn trong GUI.

▶ Cách dùng

GUI (khuyến nghị)

double-click: launch_retoc_gui.bat

hoặc:

python retoc_gui.py

CLI Menu

double-click: retoc_commands.bat

🔑 Cài đặt AES Key

Hầu hết game UE đều mã hóa pak file. Bạn cần AES key đúng cho game đó.
Nhập key vào ô “AES Key” trong sidebar của GUI.

Format: 0x + 64 ký tự hex
Ví dụ: 0xABCDEF1234567890...

📋 Tất cả lệnh được hỗ trợ

Lệnh	Tab GUI	Mô tả
`manifest`	📄 Manifest	Trích xuất manifest từ .utoc
`info`	ℹ Info	Hiển thị thông tin container
`list`	📋 List	Liệt kê files trong directory index
`verify`	✅ Verify	Kiểm tra tính toàn vẹn container
`unpack`	📦 Unpack	Giải nén files từ .utoc
`unpack-raw`	📤 Unpack Raw	Giải nén raw chunks
`pack-raw`	📥 Pack Raw	Đóng gói raw chunks vào container
`to-legacy`	🔄 → Legacy	Chuyển Zen → Legacy .pak
`to-zen`	🔄 → Zen	Chuyển Legacy .pak → Zen IoStore
`get`	🔍 Get	Lấy chunk theo index
`gen-script-objects`	🔧 Script Objects	Tạo script objects từ .jmap
`print-script-objects`	🔧 Script Objects	In script objects từ container
Custom	💻 Custom	Chạy bất kỳ lệnh retoc nào

⚙ Override Versions

Một số game pre-5.0 cần override version để extract đúng.
Chọn trong sidebar GUI:

Override Container Header Version: PreInitial, Initial, LocalizedPackages, v.v.
Override TOC Version: Initial, DirectoryIndex, PerfectHash, v.v.

🔄 Ví dụ: Convert game sang Legacy PAK

Input:  D:\Game\Content\Paks\          (thư mục chứa global.utoc + pakchunk0.utoc)
Output: D:\Mods\legacy_P.pak

Dùng tab “🔄 → Legacy” trong GUI.

🔄 Ví dụ: Pack mod trở lại Zen

Input:  D:\Mods\legacy_mod_P.pak
Output: D:\Mods\mod_P.utoc
UE Version: UE5_4

Dùng tab “🔄 → Zen” trong GUI.

🔗 Links

retoc repo: https://github.com/trumank/retoc
retoc releases: https://github.com/trumank/retoc/releases
jmap (script objects): https://github.com/trumank/jmap