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

extension/src/metin2_anim.h

@@ -1,10 +1,13 @@
 #pragma once
 
 #include <godot_cpp/classes/node3d.hpp>
+#include <godot_cpp/variant/dictionary.hpp>
 #include <godot_cpp/variant/node_path.hpp>
 #include <godot_cpp/variant/string.hpp>
+#include <godot_cpp/variant/vector3.hpp>
 
 #include <gr2/gr2.h>
+#include <msa.h>
 
 #include <optional>
 #include <vector>
@@ -13,14 +16,18 @@ namespace mtgodot {
 
 class Metin2Model;
 
-// Drives a Metin2Model's Skeleton3D each frame by sampling a (possibly
-// separate) animation .gr2 with libgr2, then writing per-bone global poses.
+// Drives a Metin2Model each frame by sampling a (possibly separate) animation
+// .gr2 with libgr2, then skinning it with the resulting matrices:
 //
-//   world[i] = gr2::sample_pose(model.skeleton, anim, t)
-//   skel.set_bone_global_pose(i, gr2_to_godot(world[i]))
+//   sample_pose(model.skeleton, anim, t) -> world[i], skin[i]
+//   skin[i] = inverse_world[i] * world[i]   (gr2 deformer matrix per bone)
 //
-// Godot's renderer then computes skin matrix = global_pose(i) * bind_pose(i)
-// which equals gr2's deformer matrix (see gr2_bridge.h).
+// The skinning itself is done in Metin2Model (NOT via Skeleton3D — Godot's
+// built-in skinning orthonormalizes the bone matrix and drops the shear Granny
+// bakes onto some rig bones; see docs/MIDREVIEW.md §4):
+//   - default            : cpu_skin(skin[])  — CPU LBS, ArrayMesh rebuilt/frame
+//   - MTGODOT_GPUSKIN=1   : gpu_skin(skin[])  — full 4x3 matrices in a float
+//                           texture, LBS in the SRC_SKIN vertex shader
 class Metin2AnimPlayer : public godot::Node3D {
 	GDCLASS(Metin2AnimPlayer, godot::Node3D)
 
@@ -39,10 +46,17 @@ public:
 
 	void set_playing(bool v) { playing = v; }
 	bool get_playing() const { return playing; }
+	void set_loop(bool v) { loop = v; }
+	bool get_loop() const { return loop; }
 
 	void set_time_scale(double s) { time_scale = s; }
 	double get_time_scale() const { return time_scale; }
 
+	// Crossfade duration (s) applied when anim_path changes while a clip is
+	// already playing (PARITY §2.9). 0 = hard cut (old behaviour).
+	void set_blend_time(double s) { blend_time = s < 0.0 ? 0.0 : s; }
+	double get_blend_time() const { return blend_time; }
+
 	void set_time(double t);
 	double get_time() const { return time; }
 
@@ -50,6 +64,11 @@ public:
 	void reload();
 	godot::String get_info() const { return last_info; }
 
+	// .msa metadata (empty / zero when anim_path is a raw .gr2).
+	godot::Vector3 get_accumulation() const { return accumulation; }
+	godot::Array get_events() const; // [{type,start_time,effect,sound,pos}, ...]
+	godot::Dictionary get_loop_data() const;
+
 	// NaN-scan every animation in anim_path across [0,dur]; returns a report string.
 	godot::String selfcheck(int samples = 24);
 
@@ -60,18 +79,37 @@ private:
 	godot::String anim_path;
 	godot::NodePath model_path;
 	bool playing = true;
+	bool loop = true; // whole-clip playback mode; independent from .msa LoopData
 	double time_scale = 1.0;
 	double time = 0.0;
 	double duration = 0.0;
-	bool verified_ = false;
 	godot::String last_info;
 
 	std::optional<gr2::File> anim_file;
 	std::vector<gr2::Mat4> world_buf;
 	std::vector<gr2::Mat4> skin_buf;
 
+	// Crossfade state: the outgoing clip is kept and sampled at a frozen time,
+	// its pose blended into the incoming clip for `blend_time` seconds.
+	double blend_time = 0.15;
+	std::optional<gr2::File> prev_anim_file;
+	double prev_anim_time = 0.0;
+	double prev_anim_duration = 0.0;
+	bool prev_anim_loop = true;
+	double blend_elapsed = 0.0;
+	std::vector<gr2::Mat4> prev_world_buf, prev_skin_buf, blend_world_buf;
+
+	godot::Vector3 accumulation;      // .msa Accumulation (root motion)
+	std::vector<fmt::MotionEvent> events;
+	fmt::Msa msa_metadata;
+	int next_event = 0;              // index into `events`, for _process dispatch
+	double prev_time = 0.0;
+
 	Metin2Model *resolve_model() const;
 	void apply_pose(double t);
+	void dispatch_events(double from, double to);
+	// .msa path -> real motion .gr2 path; passes plain .gr2 paths through.
+	static godot::String resolve_anim_gr2(const godot::String &spec);
 };
 
 } // namespace mtgodot