跳转到内容

生物视觉与动画

按需求选择最轻的视觉接入点:

需求使用
替换打包好的视觉场景CharacterAssetProfile.Scenes.VisualsPath 或 MonsterAssetProfile.VisualsScenePath
使用静态帧 cueCharacterAssetProfile 上的 VisualCueSet
用代码构建节点树覆写 TryCreateCreatureVisuals()
自己驱动战斗动画覆写 SetupCustomCombatAnimationStateMachine(...)
驱动商店 / 篝火视觉覆写 SetupCustomMerchantAnimationStateMachine(...) 或使用 WorldProceduralVisuals

从路径和 profile 开始。只有静态资源表达不了行为时,再使用 factory。

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 状态。
  • 商店与篝火视觉需要同时验证正常进入和读档恢复路径。