56 lines
2.6 KiB
Markdown
56 lines
2.6 KiB
Markdown
# 2026-10-12
|
||
|
||
## 可拖拽判断（PickupItem 标记）
|
||
|
||
**需求**：`scripts/item.gd` 提供 `can_pickup`，只有为 true 时才能拖拽。
|
||
|
||
**item.gd 本次改动**：加了 `class_name PickupItem` 和说明注释，功能不变。
|
||
```gdscript
|
||
class_name PickupItem
|
||
extends Node
|
||
@export var can_pickup: bool = true
|
||
```
|
||
|
||
### ⚠ 关键发现：脚本挂载位置 ≠ 射线打中的节点
|
||
|
||
用户在 `world/main.tscn` 第 155 行把 item.gd 挂在了 `SM_Bottle_12` 上，但那个节点**不是刚体**。
|
||
实例来源 `res://assets/Furniture_FREE-af040129/SM_Bottle_1.glb`，实际结构是：
|
||
|
||
```
|
||
SM_Bottle_12 (Node3D) ← item.gd 挂在这一层（glb 实例的根）
|
||
└── SM_Bottle_1 (RigidBody3D) ← 射线实际打中的是这一层
|
||
├── SM_Bottle_1 (MeshInstance3D)
|
||
└── CollisionShape3D
|
||
```
|
||
|
||
**实测确认**：glb 内部节点的 `owner` 指向实例根（`SM_Bottle_1.owner == SM_Bottle_12`），
|
||
再往上为 null。所以「沿 owner 链向上找标记」正好一步命中。
|
||
|
||
### 实现（`player_pickup.gd`）
|
||
|
||
- 新增 `@export var allow_unmarked: bool = false`
|
||
- **false（默认）＝ 白名单**：只有挂了 `PickupItem` 且 `can_pickup=true` 的才拖得动
|
||
- true ＝ 黑名单：没挂标记的默认可拖，只有显式设 false 的不能拖
|
||
- 新增 `can_grab(collider) -> bool`：先判 `is RigidBody3D`，再查标记
|
||
- 新增 `_find_item_marker(body)`：顺序 **刚体自身 → 直接子节点 → owner 链向上**
|
||
- 向上时**只查节点自身、不查子节点** —— 否则走到 World 层会遍历几百个子节点，而这是每物理帧都要跑的
|
||
- `_update_interact_state()` 的 hovering 判定改用 `can_grab()`
|
||
- `_grab()` 里再判一次（悬停状态来自上一物理帧，其间 can_pickup 可能已被改掉）
|
||
|
||
### 实测验证（headless，全部符合预期）
|
||
```
|
||
can_grab(SM_Bottle_1 RigidBody3D) = true ✓
|
||
can_grab(SM_Bottle_12 Node3D) = false ✓（不是刚体）
|
||
can_grab(Can2 内部刚体) = false ✓（严格/白名单模式）
|
||
allow_unmarked=true 后 Can2 = true ✓
|
||
```
|
||
|
||
### ⚠ 副作用（需告知用户）
|
||
默认白名单模式下，场景里**所有没挂 item.gd 的刚体都拖不动了**
|
||
（`Can2`、饭盒、水果等）。要么逐个挂标记，要么把 `allow_unmarked` 勾上。
|
||
|
||
### MCP 备注
|
||
4 次 `script_patch` 均返回 `replacements: 1` 但伴随 `gdscript_reload_failed (code 43)`
|
||
假报错（`fallback_line: true`）—— 与 10-10 记录的是同一现象。
|
||
离线 `--check-only` 两个脚本均通过；`PickupItem` 已进 `global_script_class_cache.cfg`。
|