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

build-macos-client.sh

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+# 打包 macOS 完整客户端（登录 → 选人 → 进游戏）。
+#
+#   ./build-macos-client.sh [debug|release]
+#
+# 产物：build/export/mtgodot-poc.app  +  旁边一个 assets 符号链接（不进包，2.1G）。
+# 依赖：Godot 4.7.1 的 macOS 导出模板（editor 里 “管理导出模板” 装，或放
+#       ~/Library/Application Support/Godot/export_templates/4.7.1.stable/macos.zip）。
+set -euo pipefail
+cd "$(dirname "$0")"
+REPO="$(pwd)"
+CFG="${1:-debug}"
+OUT="$REPO/build/export"
+APP="$OUT/mtgodot-poc.app"
+GODOT="${GODOT:-godot}"
+
+echo "== 1. GDExtension .dylib =="
+cmake --build build --target mtgodot -j8
+DYLIB="project/bin/libmtgodot.macos.template_${CFG}.dylib"
+if [ ! -f "$DYLIB" ]; then
+  # CMake 目前只出 debug 名；release 就复用它
+  cp -f project/bin/libmtgodot.macos.template_debug.dylib "$DYLIB"
+fi
+
+echo "== 2. 导出 =="
+mkdir -p "$OUT"
+if [ "$CFG" = release ]; then
+  "$GODOT" --headless --path project --export-release macOS "$APP"
+else
+  "$GODOT" --headless --path project --export-debug macOS "$APP"
+fi
+
+echo "== 3. 资源（不打进包）=="
+# .app 同级放一个 assets 链接；AssetRoot 会在 <.app 同级>/assets 找到它。
+ln -sfn "$REPO/assets" "$OUT/assets"
+ln -sfn "$REPO/bgm" "$OUT/bgm"
+
+echo "== 4. ad-hoc 签名（Apple Silicon 直跑）=="
+codesign --force --deep --sign - "$APP" 2>/dev/null || true
+xattr -dr com.apple.quarantine "$APP" 2>/dev/null || true
+
+echo
+echo "OK -> $APP"
+echo "跑：  open '$APP'                （用 $OUT/assets）"
+echo "或：  MT_ASSETS='$REPO/assets' '$APP/Contents/MacOS/mtgodot-poc'   （看控制台日志）"