完善客户端功能并同步差距文档

project/remote_player_test.gd

@@ -0,0 +1,70 @@
+# remote_player_test —— 远端 PC 真模型 + awPart[4] 换装链回归。
+#   godot --headless --path project --script remote_player_test.gd
+extends SceneTree
+
+const ItemListDB = preload("res://ui/item_list.gd")
+const RemotePlayerView = preload("res://ui/remote_player_view.gd")
+const NetWorld = preload("res://net_world.gd")
+
+class FieldProbe extends Node3D:
+	var calls: Array = []
+	func set_armor(v: int) -> void: calls.append(["armor", v])
+	func set_weapon(v: int) -> void: calls.append(["weapon", v])
+	func set_head(v: int) -> void: calls.append(["head", v])
+	func set_hair(v: int) -> void: calls.append(["hair", v])
+
+var _fail := 0
+
+func _ck(ok: bool, msg: String) -> void:
+	if not ok:
+		_fail += 1
+		printerr("FAIL: " + msg)
+
+func _init() -> void:
+	await _run()
+	if _fail == 0:
+		print("PASS: remote_player_test (remote PlayerView + awPart[4])")
+		quit(0)
+	else:
+		printerr("%d check(s) failed" % _fail)
+		quit(1)
+
+func _run() -> void:
+	if not ClassDB.class_exists("Metin2Model") or not ClassDB.class_exists("Metin2AnimPlayer"):
+		print("  (skip: animation extension not registered)")
+		return
+	var assets := AssetRoot.path()
+	if not DirAccess.dir_exists_absolute(assets.path_join("PC/ymir work/pc/warrior")):
+		print("  (skip: PC assets unavailable)")
+		return
+	var il := ItemListDB.new()
+	if not il.load_file(assets.path_join("locale/locale/common/item_list.txt")):
+		print("  (skip: item_list unavailable)")
+		return
+	var pv := RemotePlayerView.new()
+	get_root().add_child(pv)
+	var parts: Array = [0, 19, 0, 5]   # ARMOR / WEAPON / HEAD / HAIR
+	_ck(pv.build_remote(assets, 0, parts, il), "remote warrior PlayerView builds")
+	if pv.remote_equip == null:
+		return
+	_ck(pv.remote_equip._remote_parts == parts, "remote EquipModel receives awPart[4]")
+	await process_frame
+	pv.set_weapon(0)
+	await process_frame
+	_ck(int(pv.remote_equip._remote_parts[1]) == 0, "set_weapon updates awPart[WEAPON]")
+	pv.set_head(19)
+	await process_frame
+	_ck(int(pv.remote_equip._remote_parts[2]) == 19, "set_head updates awPart[HEAD]")
+	pv.set_hair(5)
+	await process_frame
+	_ck(int(pv.remote_equip._remote_parts[3]) == 5, "set_hair updates awPart[HAIR]")
+	pv.queue_free()
+
+	# NetworkActorManager::UpdateActor 的四个 awPart 字段序必须保持 ARMOR/WEAPON/HEAD/HAIR。
+	var nw := NetWorld.new()
+	var probe := FieldProbe.new()
+	nw._apply_field_updates(probe, {"parts": [11, 22, 33, 44]})
+	_ck(probe.calls == [["armor", 11], ["weapon", 22], ["head", 33], ["hair", 44]],
+			"NetWorld applies awPart[4] in reference order")
+	probe.free()
+	nw.free()