角色动画
This commit is contained in:
@@ -14,3 +14,55 @@
|
||||
标定类问题：`get_bone_pose_position()` 是相对父骨的姿态，Z 轴受父骨朝向影响，GLTF 导入后与 Blender 不一致，z_min/z_max 必须实测标定；`face_index` 只做了亮度乘，没真正切换表情图层。
|
||||
|
||||
与本项目相关的判断：角色是 `character-male-e.glb`，需先确认有独立面部材质槽 + 展平 UV；多人下 SubViewport/材质必须每实例一份，远端玩家的画要按 PNG 字节流同步。
|
||||
|
||||
## 重写 player_animator.gd（7 状态）
|
||||
|
||||
按新枚举 `{IDLE, WALK, CROUCH, RUN, FALL, SNEAK, JUMP}` 重写 `character/player/player_animator.gd`。
|
||||
改动：加 `class_name PlayerAnimator`（`player.gd` 用它当类型）、新增 `Stance{STAND,CROUCH,SNEAK}`、
|
||||
`set_motion(velocity, on_floor, sprinting=false, stance=STAND)`、片段基准速度扩到 walk/run/crouch/sneak。
|
||||
|
||||
实测结论（用 @tool 副本跑 McpTestSuite，14 条断言全过）：
|
||||
- 短片段名查不到，必须用 `"库名/片段名"`（`walk/walk`）；`_ready()` 里扫库解析一次并写入 `_clips`。
|
||||
- 状态映射、自动绑兄弟 AnimationPlayer、`play("walk/walk")`、loop_mode 补丁、倍率 5/5≈1.0 均正确。
|
||||
- `class_name` 之后 `self is AnimationPlayer` 是编译期错误 → 脚本不能挂在 AnimationPlayer 节点上。
|
||||
|
||||
**未改、留给用户决定的场景问题**（`player.tscn`）：
|
||||
1. 脚本目前挂在 `Body/AnimationPlayer` 上，而 `player.gd`、`player_sync.tres`、`tests/test_net_replication.gd` 都找 `Body/PlayerAnimator` —— 需要新增独立 PlayerAnimator 节点。
|
||||
2. 该节点的 6 个 float 导出在 .tscn 里被序列化成 `null`（实测运行时是 `Nil`），会覆盖脚本默认值。
|
||||
3. `tests/test_net_replication.gd` 里的 `REQUIRED_CLIPS` 仍是旧的 `sprint`，需要同步成新状态集。
|
||||
|
||||
## 收尾：按用户决定接线 + 清场景脏数据
|
||||
|
||||
用户决定「脚本就挂在 `Body/AnimationPlayer` 上」，据此改完并验证（`test_run` 20/20，320 条断言；实机跑 player.tscn 确认 idle→fall 切换正常）。
|
||||
|
||||
- `player_animator.gd`：文档改成「脚本挂在 AnimationPlayer 上、`animation_player` 留空自绑自身」。
|
||||
- `player.gd`：`$Body/PlayerAnimator` → `$Body/AnimationPlayer`，场景结构注释同步；`_ride_zipline` 里 `tan` 改名 `tan_dir`（消 built-in 遮蔽警告）。
|
||||
- `player_sync.tres`：同步字段路径改 `Body/AnimationPlayer:anim_state` / `:anim_speed`。
|
||||
- `player.tscn`：删掉被序列化成 `null` 的 6 个 float 导出（`blend_time` 等）—— 实测运行时确实是 `Nil`，会覆盖脚本默认值。
|
||||
- `tests/test_net_replication.gd`：路径、`REQUIRED_CLIPS` 全部同步；新增 `_find_clip()` 按库解析（短名断言会假红）。
|
||||
- `tests/test_zipline.gd`：`test_interact_action_exists` 先调 `InputMap.load_from_project_settings()` —— 编辑器进程的 InputMap 不带项目动作（实测 `interact`/`jump` 均为 false，只有 `ui_accept`），这条一直假红。
|
||||
- `world/zipline/zipline.gd`：`tan` → `tan_dir`。
|
||||
|
||||
**Godot MCP 注意**：`node_get_properties` 读不到脚本的 @export 属性（`unknown_fields`），但 `node_set_property` 能写进去；数值标量经 MCP 会变成字符串（`node_set_property` 返回 `"0.15"`），`batch_execute` 里的 `set_property` 直接报 INTERNAL_ERROR。改 `.tscn` / `.tres` 这类被编辑器占用的文件，直接用文本工具写反而更省事（`.tscn` 可写、`.tres` 报 EBUSY，用 `filesystem_manage(op="write_text")`），写完 `scene_open(force_reload=true)` 让编辑器重新读盘。
|
||||
|
||||
## 接线：Ctrl 蹲下 / Ctrl+移动 潜行
|
||||
|
||||
用户定的规则：`crouch` 绑 Ctrl；**蹲着不动 = CROUCH，蹲着走 = SNEAK**。
|
||||
|
||||
- `project.godot`：用 `input_map_manage(op="ensure_binding", {action:"crouch", event_type:"key", keycode:"Ctrl"})`
|
||||
加的动作，落在 keycode 4194326，和已有的 `sprint`(Shift/4194325) 同一套写法。
|
||||
- `player_animator.gd`：**删掉 `Stance` 枚举**，`set_motion` 第 4 个参数改成 `crouching: bool`。
|
||||
「蹲 / 潜行」的区分放回表现层（`moving := 水平速度 >= idle_threshold`），控制器只传「按没按 Ctrl」。
|
||||
优先级改成 空中 > 蹲 > 移动。
|
||||
- `player.gd`：调用点传 `Input.is_action_pressed("crouch")`；操作说明补上 Ctrl。
|
||||
- `tests/test_net_replication.gd`：加 `test_crouch_action_exists`（先 `InputMap.load_from_project_settings()`）。
|
||||
|
||||
验证：`test_run` 21/21；另用 @tool 副本跑了 4 组状态映射断言（Ctrl+不动→CROUCH、Ctrl+移动→SNEAK、
|
||||
Ctrl+Shift→仍是 SNEAK、空中→JUMP/FALL 优先于蹲），片段也确认切到了 `crouch/crouch` / `sneak/sneak`。
|
||||
|
||||
**踩坑**：`test_run` 的脚本缓存按路径，删掉重建同名文件会跑旧版本 —— 第一次探针就因此假失败
|
||||
（旧版 `stance: int` 收到 `true` 被当成 `Stance.CROUCH`）。换文件名才拿到真实结果。
|
||||
|
||||
**未做**：蹲下目前不改移动速度、也不改碰撞胶囊高度 —— 潜行时用走速（5 m/s）播 sneak 片段，
|
||||
`speed_scale` 会被 clamp 到上限 1.6。要不要减速/压低碰撞盒等用户定。
|
||||
|
||||
|
||||
@@ -2,18 +2,37 @@
|
||||
|
||||
## 工程约定
|
||||
|
||||
- 玩家控制器只认「运动结果」，不认识任何动画片段名；表现层在 `Body/PlayerAnimator`。
|
||||
新增动作状态改 `player_animator.gd` 的 `ANIM_CLIPS`，不要往 `player.gd` 里塞片段名。
|
||||
- 玩家控制器只认「运动结果」，不认识任何动画片段名；表现层脚本 `player_animator.gd` 直接挂在
|
||||
`Body/AnimationPlayer` 上（`animation_player` 留空即自绑自身，所以两者是同一个节点）。
|
||||
新增动作状态改 `ANIM_CLIPS`，不要往 `player.gd` 里塞片段名。
|
||||
- 组件的可调参数放在组件自己身上（如 Zipline 的速度 / 刹车 / 吸附半径），控制器只读不定义。
|
||||
- 头顶 UI（血条、交互提示）是 `player.tscn` 里的 Label3D 节点，不在代码里动态创建。
|
||||
- 测试用 `McpTestSuite`（`addons/godot_ai/testing`），脚本放 `res://tests/`。
|
||||
|
||||
## 动画（AnimationPlayer）
|
||||
|
||||
- **多 AnimationLibrary 下，片段必须用「库名/片段名」的限定键**。实测（4.7.2）：
|
||||
`has_animation("idle")` 为假，`has_animation("idle/idle")` 才为真，`get_animation` 同理。
|
||||
本项目每个 glb 导入成一个库、库名与片段同名，所以真键形如 `walk/walk`。
|
||||
短名播不出来且不报错，是典型的静默失效 —— `PlayerAnimator._ready()` 里扫库解析一次。
|
||||
- 导入的 GLB 片段 `loop_mode` 默认是 `NONE`，编辑器里改不了，只能运行时补。
|
||||
- **带 `class_name` 的脚本挂在 AnimationPlayer 上没问题，但不能写 `self is AnimationPlayer`**：
|
||||
`class_name X extends Node` 之后 `self` 的静态类型就是 X，那句是编译期错误。
|
||||
要拿「自己就是播放器」这个事实得绕一圈：遍历 `get_parent().get_children()` 找 `is AnimationPlayer` 的兄弟
|
||||
—— 自己就在里面。见 `PlayerAnimator._ready()`。
|
||||
- 状态集 `IDLE/WALK/CROUCH/RUN/FALL/SNEAK/JUMP`。签名 `set_motion(velocity, on_floor, sprinting, crouching)`：
|
||||
第 4 个参数是「按住蹲键」这个输入事实（`crouch` 动作 = Ctrl），蹲着不动 → CROUCH、蹲着走 → SNEAK，
|
||||
这个区分在表现层做，控制器不需要知道两者差别。优先级：空中 > 蹲 > 移动。
|
||||
|
||||
## Godot MCP 踩坑
|
||||
|
||||
- **数值标量会被字符串化**：直接调 `node_set_property` 传 `1` / `false` 会报
|
||||
`WRONG_TYPE: Cannot write String to a int/bool property`。
|
||||
绕法：改用 `batch_execute`，把 value 放进每条 command 的 `params` 里（嵌套数字能正常保型）。
|
||||
字符串、Vector / Color 对象不受影响。
|
||||
- **数值标量经 MCP 会被字符串化**：`node_set_property` 传 `0.15` 能写进去，但回显是 `"0.15"`；
|
||||
而 `batch_execute` 里包 `{"command": "set_property", "params": {...}}` 直接报
|
||||
`INTERNAL_ERROR … handler returned malformed result`（和旧版本文档里写的正好相反，以实测为准）。
|
||||
改被编辑器占用的 `.tscn` / `.tres` 时别绕这个弯 —— 直接写文本更省事：`.tscn` 可写，
|
||||
`.tres` 报 EBUSY 就改用 `filesystem_manage(op="write_text")`。
|
||||
- **`node_get_properties` 读不到脚本的 @export 属性**（会列进 `unknown_fields`），但 `node_set_property` 能写。
|
||||
改完场景文件要 `scene_open(force_reload=true)` 让编辑器重读盘，否则节点上还挂着旧脚本实例。
|
||||
- **@tool 脚本现造的节点不会写进 .tscn**：`add_child` 后不给 `owner`，
|
||||
`PackedScene::pack()` 就会跳过它。缆绳网格因此可以纯由锚点推导，不存在「文件和锚点对不上」的脏数据。
|
||||
- **新 `class_name` 要跑一次 `filesystem_manage(op="scan")`** 才进全局类表，
|
||||
@@ -22,3 +41,14 @@
|
||||
想抓「运行中途某一瞬间」的画面不可靠，只能靠日志 / 属性断言验证。
|
||||
- 测试跑在编辑器进程里，`@tool` 节点必须真的 `add_child` 进编辑中场景才会跑 `_ready()`；
|
||||
用完在 `teardown()` 摘掉，节点名以 `_McpTest` 开头可被测试运行器兜底清理。
|
||||
- **非 `@tool` 脚本在编辑器里是「placeholder instance」**：`load(path).can_instantiate()` 返回 false，
|
||||
`.new()` 报 `Nonexistent function 'new' in base 'GDScript'`，`set_script` 后调方法报
|
||||
`Attempt to call a method on a placeholder instance`（`player.gd` 也一样，不是脚本本身的问题）。
|
||||
想在 `test_run` 里验非 @tool 脚本，就临时生成一个「去掉 class_name、加上 @tool」的副本喂给测试，跑完删掉。
|
||||
- **`test_run` 的 GDScript 编译缓存是按路径的**：删掉再重建同名脚本，跑到的可能还是旧版本
|
||||
（现象：逻辑明明改了，测试却按旧逻辑失败）。要验新代码就换个文件名，或者重启编辑器。
|
||||
- **编辑器进程的 `InputMap` 只有内建动作**（`ui_accept` 有，`interact` / `jump` 没有）——
|
||||
项目动作要等游戏进程启动时才 load 进去。所以断言 `InputMap.has_action(...)` 的测试在编辑器里必然假红，
|
||||
先调一次 `InputMap.load_from_project_settings()`。
|
||||
- 改输入动作走 `input_map_manage(op="ensure_binding", params={action, event_type="key", keycode="Ctrl"})`，
|
||||
幂等且直接落 `project.godot`，比手改文件稳。
|
||||
|
||||
Reference in New Issue
Block a user