组件模型

2026-10-09 15:10:44 +08:00
parent 7fd1d97099
commit 66d87d48d6
9 changed files with 260 additions and 129 deletions
@@ -9,3 +9,13 @@
 - 最终形态：准心 = 屏幕中心一个点，无十字、无样式开关（`enum Style` 已移除）。
 - 导出参数：`dot_color` / `dot_radius`(默认 2.5) / `outline` / `outline_color` / `outline_width`。
 - `_draw()` 先画描边圆再画主体圆，保证浅背景可见。
+
+## player.gd 拆解方案（待执行）
+- 现状：`character/player/player.gd` 155 行，混了视角 / 移动跳跃 / 拾取 / 多人权限四类职责。
+- 方案：**子节点组件化**（与既有 `PlayerAnimator` 同模式）。根节点降为协调器（~40 行），新增 `Look` / `Motor` / `Pickup` 三个 Node 子节点，各自挂 `player_look.gd` / `player_motor.gd` / `player_pickup.gd`。
+- 三条硬约束：① `move_and_slide()` 留在根节点，Motor 只写 `body.velocity`；② 物理顺序由根节点显式编排（motor.step → move_and_slide → animator → pickup），不让子节点各写 `_physics_process`；③ 非 authority 时三个组件的输入/物理必须一并关闭。
+- 范式定位：组合优于继承 + 组件模式（Component Pattern）；协调器部分带 Facade/Mediator 色彩；`setup()` 注入属手工依赖注入。**不是 ECS**（Godot 节点是「带行为的对象」，非纯数据组件）。
+- 状态：**已落地**（2026-10-09）。新增 `player_look.gd` / `player_motor.gd` / `player_pickup.gd`（均带 `class_name`：PlayerLook / PlayerMotor / PlayerPickup）；`player.gd` 重写为协调器（~65 行）；`player.tscn` 追加 Look / Motor / Pickup 三个 Node 子节点（挂 FaceRig 之后，ext_resource id 13_look / 14_motor / 15_pickup，未写 uid 由 Godot 补）。
+- 场景格式注意：本项目的 .tscn 节点带非标准 `unique_id=`（Godot 4.7 特性），`unique_id` 与 `load_steps` 均可省略；`paint_panel.tscn` 就完全没写，可作参照。
+- 已确认无外部脚本引用被搬走的属性（仅 `world/main.tscn` 通过场景 uid 引用玩家场景）。
+- 顺手去掉了原 `_pickObject` 里的两行 `print()` 调试输出。