拾起物品同步

This commit is contained in:
2026-10-03 18:48:04 +08:00
parent 0dcfb88bfe
commit 3d23804fa5
10 changed files with 359 additions and 86 deletions
+103 -31
View File
@@ -3,12 +3,14 @@ extends McpTestSuite
## 回归测试:抱起物品系统的契约。
##
## 谁能被抱由**物品自己**决定(挂 carryable.gd + 进 carryable 组),玩家只管找/抱/扔;
## 抱持偏移和投掷速度也写在物品上。这里盯住这几条契约,改物品或改玩家时先让测试红一次。
## 抱持偏移和投掷速度也写在物品上。联机只同步 `carrier_peer` 一个整数 ——
## 抱着的时候位置不走同步,每端都从持有者的抱持点算出来,这几条契约坏了联机就会「各看各的」。
const PLAYER_SCENE_PATH := "res://character/player/player.tscn"
const ITEM_SCENE_PATH := "res://world/items/carryable_box.tscn"
const CARRY_ACTION := "carry"
const THROW_ACTION := "throw_carry"
const HOLDER_PEER := 7
func suite_name() -> String:
@@ -33,6 +35,28 @@ func _into_tree(node: Node) -> Node:
return node
func _spawn_item() -> Carryable:
var packed := load(ITEM_SCENE_PATH) as PackedScene
if packed == null:
return null
return _into_tree(packed.instantiate()) as Carryable
## 造一个「假持有者」:玩家节点在世界里以 peer id 命名、进 net_player 组,抱持点挂在相机架上
func _fake_holder() -> Node3D:
var holder := Node3D.new()
holder.name = str(HOLDER_PEER)
holder.add_to_group(Carryable.PLAYER_GROUP)
var rig := Node3D.new()
rig.name = "CameraRig"
holder.add_child(rig)
var socket := Marker3D.new()
socket.name = "CarrySocket"
socket.position = Vector3(0.0, 1.0, -2.0)
rig.add_child(socket)
return _into_tree(holder) as Node3D
func test_carry_actions_exist() -> void:
_ensure_input_map()
# 动作没了按键就完全没反应,而且不报错 —— 这种静默失效必须由测试兜住
@@ -56,63 +80,111 @@ func test_player_scene_has_carry_nodes() -> void:
"Body/CarryArms 没挂 carry_arms.gd,胳膊不会抱东西")
func test_example_item_is_carryable() -> void:
var packed := load(ITEM_SCENE_PATH) as PackedScene
assert_true(packed != null, "%s 未能加载 —— 可抱物品的示例没了" % ITEM_SCENE_PATH)
## 第一人称要看得见自己的胳膊。
## player.gd 不是 @tool,在编辑器里是 placeholder、方法调不动,所以这里查两件事:
## 代码里确实按 `arm_` 前缀把胳膊留下来,且模型里真的有这些独立 mesh(换模型改名会红)。
func test_first_person_keeps_arms_visible() -> void:
var file := FileAccess.open("res://character/player/player.gd", FileAccess.READ)
assert_true(file != null, "读不到 player.gd")
if file == null:
return
var source := file.get_as_text()
assert_true(source.contains("_hide_body_keep_arms"), "player.gd 里没有「第一人称保留胳膊」的逻辑")
assert_true(source.contains("begins_with(\"arm_\")"),
"藏身体时没有按 arm_ 前缀把胳膊留下来,第一人称会看不到自己的手")
var packed := load(PLAYER_SCENE_PATH) as PackedScene
if packed == null:
return
var item := packed.instantiate()
assert_true(item is Carryable, "示例物品根节点不是 Carryable(%s)" % item.get_class())
if not item is Carryable:
track(item)
var player := packed.instantiate()
track(player)
var skeleton := player.get_node_or_null("Body/mouse/MouseRig/Skeleton3D")
assert_true(skeleton != null, "找不到骨架,模型结构变了?")
if skeleton == null:
return
var carryable := item as Carryable
_into_tree(carryable)
assert_true(carryable.is_in_group(Carryable.GROUP),
var arms := 0
var others := 0
for child in skeleton.get_children():
var mesh := child as MeshInstance3D
if mesh == null:
continue
if str(mesh.name).begins_with("arm_"):
arms += 1
else:
others += 1
assert_true(arms > 0, "模型里没有 arm_* 网格,第一人称看不到手")
assert_true(others > 0, "模型里没有别的部位网格,藏身体就无从谈起")
func test_example_item_is_carryable() -> void:
var item := _spawn_item()
assert_true(item != null, "%s 实例化失败 —— 可抱物品的示例没了" % ITEM_SCENE_PATH)
if item == null:
return
assert_true(item.is_in_group(Carryable.GROUP),
"可抱物品没进 %s 组,玩家就找不到它" % Carryable.GROUP)
assert_true(carryable.get_node_or_null("Collision") is CollisionShape3D,
assert_true(item.get_node_or_null("Collision") is CollisionShape3D,
"示例物品没有碰撞体,扔出去会穿地")
## 联机靠 Sync 复制 position / rotation / carrier_peer;漏了 carrier_peer 别人就不知道被抱走了。
func test_item_sync_config_covers_carry_state() -> void:
var item := _spawn_item()
if item == null:
return
var sync := item.get_node_or_null("Sync") as MultiplayerSynchronizer
assert_true(sync != null, "示例物品没有 MultiplayerSynchronizer,联机看不到别人抱走它")
if sync == null or sync.replication_config == null:
return
var paths: Array[String] = []
for path in sync.replication_config.get_properties():
paths.append(str(path))
for required in [".:carrier_peer", ".:position", ".:rotation"]:
assert_true(paths.has(required), "同步配置里少了 %s(实际 %s)" % [required, paths])
func test_carry_freezes_body_and_restores_on_release() -> void:
var item := _into_tree((load(ITEM_SCENE_PATH) as PackedScene).instantiate()) as Carryable
assert_true(item != null, "示例物品实例化失败")
var item := _spawn_item()
if item == null:
return
var layer := item.collision_layer
assert_true(item.can_be_carried(), "新物品应该是可以抱的")
var holder := Node3D.new()
track(holder)
item.begin_carry(holder)
item.request_pickup(HOLDER_PEER)
assert_eq(item.carrier_peer, HOLDER_PEER, "抱起请求没记到 carrier_peer 上")
assert_true(not item.can_be_carried(), "抱起来之后不该还能被别人抱走")
assert_true(item.freeze, "抱起来要冻结物理,否则会和抱着它的人打架")
assert_eq(item.collision_layer, 0, "抱起来要清掉碰撞层,否则物品会把玩家顶飞")
item.end_carry(Vector3(1.0, 2.0, 3.0))
item.request_release(Vector3(1.0, 2.0, 3.0))
assert_eq(item.carrier_peer, 0, "放下之后 carrier_peer 要清零")
assert_true(item.can_be_carried(), "放下之后应该又能被抱")
assert_true(not item.freeze, "放下要恢复物理")
assert_true(not item.freeze, "单机 / 服务器端放下要恢复物理模拟")
assert_eq(item.collision_layer, layer, "放下要恢复原来的碰撞层")
assert_true(item.linear_velocity.is_equal_approx(Vector3(1.0, 2.0, 3.0)),
"放下时要继承扔出去的速度,实际 %s" % item.linear_velocity)
func test_hold_transform_snaps_to_socket() -> void:
var item := _into_tree((load(ITEM_SCENE_PATH) as PackedScene).instantiate()) as Carryable
if item == null:
## 抱着的时候位置不走同步:每端都从持有者的抱持点算。这里用一个假持有者验这件事。
func test_carried_item_follows_holder_socket() -> void:
var item := _spawn_item()
var holder := _fake_holder()
if item == null or holder == null:
return
var socket := Marker3D.new()
track(socket)
socket.position = Vector3(1.0, 2.0, -3.0)
socket.rotation = Vector3(0.0, PI * 0.5, 0.0)
var root: Node = Engine.get_main_loop().root
root.add_child(socket)
item.apply_hold_transform(socket)
item.request_pickup(HOLDER_PEER)
item._physics_process(0.016)
var socket := holder.get_node("CameraRig/CarrySocket") as Node3D
var expected := socket.global_position + socket.global_basis * item.hold_offset
assert_true(item.global_position.distance_to(expected) < 0.001,
"物品没摆到抱持点上:实际 %s,期望 %s" % [item.global_position, expected])
"物品没跟住持有者的抱持点:实际 %s,期望 %s" % [item.global_position, expected])
# 松开之后就不该再跟了
item.request_release(Vector3.ZERO)
var after_release := item.global_position
holder.position += Vector3(10.0, 0.0, 0.0)
item._physics_process(0.016)
assert_true(item.global_position.distance_to(after_release) < 0.001,
"已经放手了还在跟持有者跑")
func test_throw_speed_scales_with_charge() -> void:
var item := _into_tree((load(ITEM_SCENE_PATH) as PackedScene).instantiate()) as Carryable
var item := _spawn_item()
if item == null:
return
assert_true(absf(item.throw_speed(0.0) - item.throw_speed_min) < 0.001,