119 lines
4.7 KiB
GDScript
119 lines
4.7 KiB
GDScript
@tool
|
|
class_name Carryable
|
|
extends RigidBody3D
|
|
## 可抱起的物品。**只有带这个脚本（并进了 carryable 组）的东西才抱得起来** —— 这就是
|
|
## 「仅特定物品可抱」的实现方式：门槛不在玩家那边，而在物品自己身上。
|
|
##
|
|
## 和 Zipline 一样，手感参数放物品这一侧：不同物品可以有不同的抱持偏移、不同的投掷速度，
|
|
## 玩家只负责「找到它、把它摆到手上、扔出去」，不定义手感。
|
|
##
|
|
## 用法：把这个脚本挂在物品根节点（RigidBody3D）上，再给它加一个 MultiplayerSynchronizer
|
|
## （配置见 res://world/items/carryable_sync.tres，同步 position / rotation / carrier_peer）。
|
|
## 参考示例见 res://world/items/carryable_box.tscn。
|
|
##
|
|
## 联机只同步一个整数：`carrier_peer`（谁抱着）。
|
|
## **抱着的时候位置根本不走同步** —— 每一端都从「持有者的抱持点」把物品摆出来，
|
|
## 结果天然一致，也省掉了「持有者写位置、同步又把位置写回来」的互相打架。
|
|
## 空着的时候才靠 position / rotation 同步，而且只有服务器在模拟。
|
|
##
|
|
## 标了 @tool 是为了能在编辑器里跑测试（非 @tool 脚本在编辑器里是 placeholder，方法调不动）；
|
|
## 运行时行为完全一样。
|
|
|
|
## 所有可抱物品都进这个组，玩家靠它找物品
|
|
const GROUP: StringName = &"carryable"
|
|
## 玩家节点在世界里以 peer id 命名并进了这个组，靠它找持有者的抱持点
|
|
const PLAYER_GROUP: StringName = &"net_player"
|
|
## 抱持点在玩家场景里的相对路径
|
|
const SOCKET_PATH: String = "CameraRig/CarrySocket"
|
|
|
|
@export_group("抱持")
|
|
## 被抱时相对抱持点的偏移（米）。物品大小不同，靠它对准手心
|
|
@export var hold_offset: Vector3 = Vector3.ZERO
|
|
## 被抱时的朝向（度）
|
|
@export var hold_rotation_deg: Vector3 = Vector3.ZERO
|
|
|
|
@export_group("投掷")
|
|
## 长按蓄满力后的出手速度（米/秒）
|
|
@export var throw_speed_max: float = 14.0
|
|
## 轻点时最低出手速度（米/秒）
|
|
@export var throw_speed_min: float = 5.0
|
|
|
|
## 谁抱着它（peer id），0 = 没人抱。
|
|
## 由服务器改，通过物品自己的 MultiplayerSynchronizer 复制到各端；各端只读。
|
|
var carrier_peer: int = 0:
|
|
set(value):
|
|
if carrier_peer == value:
|
|
return
|
|
carrier_peer = value
|
|
_update_simulation()
|
|
|
|
var _saved_collision_layer: int = 1
|
|
|
|
|
|
func _ready() -> void:
|
|
add_to_group(GROUP)
|
|
_saved_collision_layer = collision_layer
|
|
_update_simulation()
|
|
|
|
|
|
func can_be_carried() -> bool:
|
|
return carrier_peer == 0
|
|
|
|
|
|
## 抱着的时候跟着持有者的抱持点走；空着的时候什么都不做（交给物理 / 同步）
|
|
func _physics_process(_delta: float) -> void:
|
|
if carrier_peer == 0:
|
|
return
|
|
var socket := _find_carrier_socket()
|
|
if socket != null:
|
|
apply_hold_transform(socket)
|
|
|
|
|
|
## 把自己摆到抱持点上。偏移和朝向由物品自己决定，玩家不用管。
|
|
func apply_hold_transform(socket: Node3D) -> void:
|
|
var socket_basis := socket.global_basis
|
|
global_position = socket.global_position + socket_basis * hold_offset
|
|
global_basis = socket_basis * Basis.from_euler(hold_rotation_deg * PI / 180.0)
|
|
|
|
|
|
## 按蓄力比例算出手速度（0 = 轻点，1 = 蓄满）
|
|
func throw_speed(charge: float) -> float:
|
|
return lerpf(throw_speed_min, throw_speed_max, clampf(charge, 0.0, 1.0))
|
|
|
|
|
|
## 请求抱起。客户端用 rpc_id(1, ...) 发给服务器仲裁（先到先得），单机时服务器直接执行。
|
|
## 服务器只改 `carrier_peer` 这一个值，其余交给同步 —— 各端看到的状态因此必然一致。
|
|
@rpc("any_peer", "call_remote", "reliable")
|
|
func request_pickup(peer_id: int) -> void:
|
|
if not multiplayer.is_server() or carrier_peer != 0:
|
|
return
|
|
carrier_peer = peer_id
|
|
|
|
|
|
## 放下 / 扔出。持有者算好初速度发给服务器：服务器收回模拟权，让物品带着这个速度接着飞。
|
|
@rpc("any_peer", "call_remote", "reliable")
|
|
func request_release(velocity: Vector3) -> void:
|
|
if not multiplayer.is_server() or carrier_peer == 0:
|
|
return
|
|
carrier_peer = 0
|
|
linear_velocity = velocity
|
|
|
|
|
|
## 抱着时冻结物理、清掉碰撞层（不清会把抱着它的人顶飞）；
|
|
## 空着时只有服务器模拟，其余端冻住跟着同步过来的位置走，免得各端各算一套。
|
|
func _update_simulation() -> void:
|
|
if carrier_peer != 0:
|
|
freeze = true
|
|
collision_layer = 0
|
|
return
|
|
collision_layer = _saved_collision_layer
|
|
freeze = not multiplayer.is_server()
|
|
|
|
|
|
## 找持有者的抱持点。找不到就什么都不做 —— 远端玩家还没生成时会出现这种情况。
|
|
func _find_carrier_socket() -> Node3D:
|
|
for node in get_tree().get_nodes_in_group(PLAYER_GROUP):
|
|
if str(node.name) == str(carrier_peer):
|
|
return node.get_node_or_null(SOCKET_PATH) as Node3D
|
|
return null
|