Quick Start zh TW

🌐 English · 繁體中文 · 日本語

Quick Start: Install & Run

有兩種方式可以將 UE5CEDumper 導入遊戲並將即時資料流傳輸到 UI：

• 方法 A — Proxy DLL (推薦使用的方式，不需要用到 Cheat Engine)
• *方法 B — Cheat Engine DLL 注入 (適用於 Proxy 無法載入的遊戲)

選擇其中一種 — 絕不要同時執行兩種方法（見 Don't mix methods）。

---

0. 取得檔案

選項 1 — 下載最新版本（最簡單）： 從 Releases 取得最新的 UE5CEDumper-vNNNN-win-x64.zip 並解壓到任何位置。

選項 2 — 從原始碼構建 (環境要先建置好)：

powershell -NoProfile -ExecutionPolicy Bypass -File build.ps1 -Mode Publish -Clean

輸出會放在 dist\。(需要 Visual Studio 2022 / MSVC v143、CMake 3.25+、Ninja、.NET SDK 10。)

無論使用哪種方法，您應該會拿到這些檔案：

檔案	用於	用途
UE5DumpUI.exe	兩者	您連接的 GUI。保持支援 .dll 在其旁邊。
proxy\version.dll、proxy\dxgi.dll、proxy\dinput8.dll	A	三種 Proxy 變體 — 您可將其中一個複製到遊戲資料夾、或用UI直接套用。
UE5CEDumper.CT	B	Cheat Engine 表格，注入 DLL 並啟動管道伺服器。
UE5Dumper.dll	B	.CT 注入遊戲的 DLL。
ue5_dissect.lua、其他 .dll	支援	執行階段/CE 輔助程式 — 將它們留在原位。

需求： Windows 10/11 x64 · 執行中的 UE4 / UE5 x64 遊戲 · Cheat Engine 7.6+ (僅用於方法 B)。

---

Method A — Proxy DLL（推薦）

不需要用到 Cheat Engine。Windows 在遊戲啟動時會載入我們的 DLL。

1. 放置一個 Proxy DLL。 從 proxy\ 複製單一檔案到遊戲的可執行檔資料夾（在遊戲 .exe 旁邊、一般在 Win64 資料夾）。先從 version.dll 開始。
2. 正常啟動遊戲。 Proxy 會自動載入並在背景啟動管道伺服器。
3. 載入存檔/到達主遊戲世界，以便 UE 物件填充在記憶體中。
4. Connect + Scan。 執行 UE5DumpUI.exe → Connect → Start Scan。
5. 瀏覽與分析。 瀏覽 UObject 樹狀結構、找到實例、深入容器、匯出 CE 結構。

選擇哪個 Proxy DLL？

• version.dll — 適用於大多數遊戲。先試這個。
• dxgi.dll — 如果遊戲啟動但 UI 無法連接時使用：EXE 根本不匯入 version.dll。每個 D3D11/D3D12 UE 遊戲都匯入 dxgi，所以它載入穩定。
• dinput8.dll — 一些遊戲手把/DirectInput 標題的替代選項。

💡 UI 的 Proxy Deploy 分頁可以掃描您的 Steam 資料庫、為每個遊戲選擇正確的 Proxy，可以簡單的部署 DLL。

模組化構建（例如 Satisfactory）

某些遊戲將實際可執行檔放在 Engine\Binaries\Win64\ 而不是遊戲自己的資料夾下。將 Proxy 放在該實際 .exe 旁邊（Proxy Deploy 分頁會檢測此佈局並自動放置）。在 Satisfactory v1.2.3.1 / UE 5.6 上使用 version.dll 驗證。

---

Method B — Cheat Engine DLL 注入

當 Proxy 無法載入時使用 — 例如限制 DLL 搜尋路徑的 EA app / Epic launcher 標題，或阻止側載 DLL 的反篡改。掃描本身在 DLL 進程內後的工作完全相同。

1. 附加。 開啟 Cheat Engine 7.6+、附加遊戲進程，並先載入存檔以便遊戲資料在記憶體中。
2. 開啟表格。 開啟 UE5CEDumper.CT。啟用 init <== enable after process attached，然後啟用 Inject DLL + Start Pipe Server。
3. 自動掃描。 DLL 會自動定位 GObjects / GNames / GWorld 並偵測 UE 版本和記憶體佈局。等待幾秒鐘。
4. Connect。 執行 UE5DumpUI.exe → Connect（.CT 中的掃描已經執行）。
5. 瀏覽與分析。 與方法 A 相同的工作流程。

---

Don't mix methods

如果遊戲資料夾中有 Proxy DLL，不要也 CE-inject UE5Dumper.dll。DLL 會偵測到重複實例並跳過自動啟動以防止衝突。選擇 Proxy 或 Cheat Engine，不能兩者都選。

---

故障排除

症狀	修復
UI 無法連接 (Proxy)	錯誤的 Proxy 變體 → 試試 dxgi.dll。或者 Proxy 不在實際 exe 旁邊 → 對於模組化構建，將其放在 Engine\Binaries\Win64\。
UI 無法連接 (CE)	確認遊戲已附加，且 init 和 Inject DLL 指令碼都已啟用；點擊 Connect 之前等待掃描完成。
空的/無物件	在掃描前載入存檔並到達主遊戲世界 — 引擎物件在標題/選單畫面未填充。
EA / Epic launcher 標題	Proxy 無法載入（啟動程式限制 DLL 搜尋路徑） → 使用 Method B (Cheat Engine)。
GWorld 未找到	一些遊戲將 GWorld 隱藏在替身後面；轉儲程式會自動恢復它，但您也可以從 Object Tree 或 Instance Finder 開始。

---

後續步驟

• 完整功能列表、面板和螢幕截圖：Repository README。
• 更深入的指南（提示、匯出格式、技術說明）：該儲存庫的 docs/ 資料夾。