自动关联目录：Montage 与 AnimNotify

1. 定位

Montage 解决的是"在基础动画之上叠加一段一次性动作"：挥剑、受击、翻滚、处决。它是 AnimBP 之外的独立轨道，通过 Slot 混入最终姿势。

一句话定位：Montage 管"播什么、怎么打断"，AnimNotify 管"播到某一点时通知代码"。两者一起构成了动画与逻辑的时间轴接口。

2. Montage 结构

Montage
 ├── Slot（决定混在哪一层，如 UpperBody / FullBody）
 ├── Section（分段：Start / Loop / End）
 │      └── Section 之间可定义过渡
 ├── 若干动画片段（可来自多个 AnimSequence）
 ├── AnimNotify / AnimNotifyState（时间轴上的标记）
 └── 曲线（Curve）

AnimBP 里必须有对应的 Slot 节点——这是最常见的"Montage 播了但没效果"的原因。

3. 播放与控制

// 播放
UAnimInstance* Anim = Mesh->GetAnimInstance();
float Duration = Anim->Montage_Play(Montage, /*InPlayRate=*/1.f);

// 跳到某个 Section
Anim->Montage_JumpToSection(FName("Loop"), Montage);

// 停止
Anim->Montage_Stop(0.25f, Montage);

// 查询
Anim->Montage_IsPlaying(Montage);
Anim->GetCurrentActiveMontage();

"蓄力循环直到松手"的经典写法：Montage_Play 后 Montage_SetNextSection("Start", "Loop")，松手时 Montage_SetNextSection("Loop", "End")。

4. 打断与混出

同一 Slot 上同时只能有一个 Montage 生效——想让上半身挥剑、下半身跑步，就要分两个 Slot。

5. AnimNotify

// C++ 实现 Notify
UCLASS()
class UAnimNotify_MyEffect : public UAnimNotify
{
    GENERATED_BODY()
public:
    virtual void Notify(USkeletalMeshComponent* MeshComp, UAnimBase* Animation,
                        const FAnimNotifyEventReference& EventReference) override;
};

// NotifyState
UCLASS()
class UAnimNotifyState_WeaponActive : public UAnimNotifyState
{
    virtual void NotifyBegin(...) override;   // 开启碰撞
    virtual void NotifyTick(...) override;
    virtual void NotifyEnd(...) override;     // 关闭碰撞
};

武器判定的标准做法是 NotifyState：Begin 开碰撞、End 关碰撞，而不是在 Notify 里做一次射线。

6. 网络与可靠性

最常见的错误：在 Notify 里直接扣血。Notify 在客户端和服务端各自触发，且时机可能不同——正确做法是 Notify 里发"命中帧到了"，由服务端做判定。

7. 代价与权衡

8. 踩坑与排查

9. 排查顺序

1. 完全没效果？→ AnimBP 里有没有对应 Slot
2. 被覆盖了？→ 是否同 Slot
3. 停不下来？→ Montage_Stop 是否被调用
4. Notify 没触发？→ 播 Montage 的那端才触发；服务端是否需要复制播放
5. 状态残留？→ NotifyState 的 End 是否清理
6. 判定不一致？→ 权威逻辑是否写在服务端

参考

• AnimInstance 与动画蓝图 · AnimGraph 与节点
• GameplayCue · 属性复制条件与 RepNotify