Metin2 game client (P0–P11) + mobile asset pipeline

Networked client on the existing Godot 4.7 + libgr2 renderer:
- net: m2dev wire protocol (libsodium KX + XChaCha20), auth/select/game
  phases, EntityStore world model, ~all GC/CG headers. char create/delete,
  private shop / mall / cube, SHOP_GC_START_EX, guild, party (+ CG_PARTY_SET_STATE),
  quests, dragon soul, refine, safebox, exchange.
- UI: in-game windows migrated 1:1 from the reference uiscript/root .py —
  char status (/stat), inventory+equipment, select-item ([SELECT_ITEM] quest
  token), system-option + game-option + ESC system menu, private-shop 39-grid,
  party info board, shop tabs, atlas, minimap, quickbar, chat, …
- EterGrnLib polish: GR2 material blend/two-sided, LOD crossfade, motion-event
  dispatch, contact shadow, ray-AABB picking, weapon grip pre-transform.

Portable asset IO (A1) — all extension/libgr2/formats/mtproto reads routed
through godot::FileAccess (res:// PCK works on iOS/Android); standalone-lib
*_path() kept for the non-Godot CTests. AssetResolver + PropertyRegistry
switched to a baked index (bake_asset_index.gd) instead of std::filesystem.

Mobile builds: build-{android,ios}.sh, export-android.sh, pack-assets.sh,
gen-debug-keystore.sh. Assets ship as a zip mounted at runtime by
project/asset_pack.gd (adb push now; HTTP download is a drop-in later).

ctest 10/10, 34 GDScript suites, macOS/iOS/Android all build.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013EJxkHiNKS4kybHS3XKyAJ

test/README.md

@@ -0,0 +1,22 @@
+# test/
+
+| 文件 / 目录 | 产出者 | 内容 |
+|---|---|---|
+| `golden/` | M1 起 | Godot 渲染的对拍截图（`m1-*.png` / `m2-*.png` / `m25-*.png`） |
+| `bgfx-reference/` | 归档自 xrender-poc | bgfx demo 的同题材参考截图 + `render-samples/`。Godot 输出与之**结构化目视 + 直方图**对比（渲染器不同，不做像素比） |
+| `assets.list` | xrender-poc M0 T9c | 精选 `.gr2`（多部件 / 全 4 级 LOD / 多 stage 材质 / 异常个例）；里程碑对拍跑这套 |
+| `assets-good.txt` | xrender-poc | 全量可解析清单 |
+| `noise_floor.json` | xrender-poc M2 | 对拍噪声底：同 DLL 确定性 0、跨实现 ≤6.5e-5、epsilon=1e-3。Godot 对拍沿用此口径 |
+| `m2-numeric.json` | `oracle/run-diff-suite.sh` | libgr2 vs Granny oracle 逐字段对拍结果（23 用例）。**libgr2 vendored 进本仓库后，这条链仍用 xrender-poc 时期建立的基线** |
+| `godot-macos-stress.json` | M2 T2.7 | 1–100 角色 `_process` 帧时间 + 资产构建成本采样（供 Phase 2 A/B 决策，非门禁） |
+| `compare.py` | mtgodot 回归 harness | 运行 CPU/GPU 固定时间截图；Godot 退出/超时/缺截图/0 surface/缺 selfcheck/NaN 为硬失败，CPU↔GPU 像素差暂作 advisory |
+| `oracle_dumps/` | `run-diff-suite.sh`（gitignored） | oracle 二进制转储中间产物 |
+
+## 跑 libgr2 回归
+
+```bash
+cmake -B build-tools -DMTGODOT_BUILD_EXTENSION=OFF -DMTGODOT_BUILD_TOOLS=ON && cmake --build build-tools -j8
+./build-tools/tools/gr2fuzz "$PWD/../m2dev-client-main/assets"   # 全量解析：期望 9166/9166 ok
+./oracle/run-diff-suite.sh                                       # vs Granny：期望 23/23 PASS（需 Wine + oracle.exe）
+ctest --test-dir build --output-on-failure                       # loader 损坏输入单测
+```