UE5运行时撤销系统插件设计与实现

1. 项目概述：UE5运行时操作撤销系统插件

在虚幻引擎5（UE5）项目开发中，运行时操作的撤销功能一直是开发者们头疼的问题。不同于编辑器模式下的撤销系统，运行时（Play Mode）的操作往往无法被引擎原生支持撤销。这个插件就是为了解决这个痛点而生的——它允许开发者在游戏运行过程中记录和撤销玩家或系统的操作，就像在编辑器模式下使用Ctrl+Z一样自然。

我最初是在开发一个建筑类沙盒游戏时遇到这个需求的。玩家在游戏中进行各种建造、拆除操作后，经常手误点错位置，却无法像创意软件那样简单地撤销上一步。市面上现有的解决方案要么性能开销大，要么实现方式过于复杂。经过三个版本的迭代优化，最终形成了这个轻量级但功能完备的运行时撤销系统。

2. 核心设计原理

2.1 命令模式的应用

插件采用经典命令模式(Command Pattern)实现撤销功能。每个可撤销操作都被封装成独立命令对象，包含执行(Execute)和撤销(Undo)两个核心方法。这种设计带来几个关键优势：

1. 操作与执行解耦：命令对象不关心具体执行者，只需知道如何反转操作
2. 历史记录简单：只需维护命令对象列表
3. 支持宏命令：多个操作可以组合成一个原子操作

cpp复制UCLASS(BlueprintType)
class UUndoableCommand : public UObject {
    GENERATED_BODY()
public:
    UFUNCTION(BlueprintNativeEvent)
    void Execute();
    
    UFUNCTION(BlueprintNativeEvent)
    void Undo();
};

2.2 数据快照与增量记录

对于复杂对象的状态保存，插件提供两种策略：

1. 完整快照：保存操作前对象的完整状态（适用于小型数据结构）
2. 增量记录：仅记录被修改的属性值（推荐用于大型对象）

实测表明，对Transform操作采用增量记录可减少85%的内存占用。插件内置了常用类型的序列化支持，包括：

• FVector/FRotator/FTransform
• TArray/TSet/TMap
• 所有UPROPERTY标记的变量

提示：对频繁