生物视觉与动画
选择最小 Hook
Section titled “选择最小 Hook”按需求选择最轻的视觉接入点:
| 需求 | 使用 |
|---|---|
| 替换打包好的视觉场景 | CharacterAssetProfile.Scenes.VisualsPath 或 MonsterAssetProfile.VisualsScenePath |
| 使用静态帧 cue | CharacterAssetProfile 上的 VisualCueSet |
| 用代码构建节点树 | 覆写 TryCreateCreatureVisuals() |
| 自己驱动战斗动画 | 覆写 SetupCustomCombatAnimationStateMachine(...) |
| 驱动商店 / 篝火视觉 | 覆写 SetupCustomMerchantAnimationStateMachine(...) 或使用 WorldProceduralVisuals |
从路径和 profile 开始。只有静态资源表达不了行为时,再使用 factory。
Visual Cue
Section titled “Visual Cue”VisualCueSet 适合可用命名静态图或帧序列表达的非 Spine 角色。
public override CharacterAssetProfile AssetProfile => new(){ VisualCues = new VisualCueSet( texturePathByCue: new Dictionary<string, string> { ["idle"] = "res://MyMod/images/character/idle.png", ["hit"] = "res://MyMod/images/character/hit.png", })};cue 名称应与模型或状态机请求的动画状态一致。
需要明确控制动画状态切换时,使用 ModAnimStateMachines 或 ModAnimStateMachineBuilder。
protected override ModAnimStateMachine? SetupCustomCombatAnimationStateMachine( Node visualsRoot, CharacterModel character){ return ModAnimStateMachines.Standard( CompositeBackendFactory.FromNode(visualsRoot));}返回 null 表示继续使用普通原版动画路径。
- 视觉资源放进 Mod PCK,并用
res://引用。 - 任何场景实例化前先注册 Godot 脚本。
- 非 Spine 生物至少准备一个可见回退姿势。
- 发布前测试死亡、受击、攻击、施放、待机和 relaxed 状态。
- 商店与篝火视觉需要同时验证正常进入和读档恢复路径。