游戏客户端架构 / 系统课时
先定义一份跨引擎存档模型
先定义一份跨引擎存档模型
如果存档模型直接引用 Unity 组件、Unreal UObject 或 Godot 节点,存档格式就会被某个引擎的运行时结构绑死。更稳妥的做法是先定义一份只表达游戏事实的数据模型,再让不同引擎负责把运行时对象映射进去,从一开始就把“数据协议”和“引擎实现”分开。
学习目标
- 定义与具体引擎类型无关的存档边界
- 设计稳定的存档根对象、模块数据和版本字段
- 建立保存、加载与迁移接口,避免业务系统直接依赖文件格式
先把运行时对象挡在存档边界之外
跨引擎模型只保存能够跨进程、跨版本表达的值,例如字符串、数字、布尔值、数组、键值对象和稳定 ID。不要把 GameObject、Actor、Node、组件引用、指针或场景实例直接放进存档。
可以把完整存档看成三层:最外层是文件级元数据,中间是各业务模块的持久化数据,最内层是实体和数值。引擎只负责把运行时对象转换成这些纯数据,并在加载后重新绑定资源和实例。

根对象只放长期稳定的信息
推荐让根对象承担“识别、版本、校验、分区”四类职责,而不是把所有业务字段平铺进去。下面用 TypeScript 表达接口约束;这是片段示例,用于描述跨引擎数据协议,不依赖具体引擎运行。
type SaveId = string;
interface SaveEnvelope {
saveVersion: number;
saveId: SaveId;
createdAtUtc: string;
gameBuild: string;
player: PlayerSave;
world: WorldSave;
quests: QuestSave[];
}
interface PlayerSave {
playerId: string;
level: number;
hp: number;
inventoryItemIds: string[];
}
interface WorldSave {
sceneId: string;
openedChestIds: string[];
defeatedEnemyIds: string[];
}
interface QuestSave {
questId: string;
state: "locked" | "active" | "completed";
}这组接口刻意没有出现引擎对象。sceneId、questId、playerId 等都应该是项目自己维护的稳定标识,而不是实例地址、节点路径或运行时自动生成的短期 ID。这样换引擎、换场景组织方式时,存档协议仍然可以保持不变。
让业务系统通过适配接口接入
存档服务不应该直接遍历整个场景树,也不应该知道每个系统内部如何组织对象。更稳妥的是由各业务模块主动实现“导出纯数据”和“根据纯数据恢复”两个方向的适配。
下面仍是片段示例,重点是接口边界:
interface SaveAdapter<T> {
capture(): T;
restore(data: T): void;
}
interface SaveRepository {
write(slot: string, save: SaveEnvelope): Promise<void>;
read(slot: string): Promise<SaveEnvelope>;
}其中 SaveAdapter<T> 属于业务层与存档层之间的映射接口,SaveRepository 负责文件、云端或平台存储等介质差异。Unity 可以用 C# 实现同样语义,Unreal 可以用 C++/Blueprint 包装,Godot 可以用 GDScript 实现,但它们都应输出等价的数据字段。
版本迁移属于协议的一部分
跨引擎不等于“永远不改结构”。真正稳定的是迁移规则,而不是字段一成不变。每次出现破坏性变化时提升 saveVersion,加载旧档后按版本逐级迁移,再交给当前业务系统恢复。
例如旧版本只有 hp,新版本增加 maxHp,迁移时可以为旧档填入合理默认值。若某个字段只是运行时缓存,就不要为了兼容而把它加入协议;越少保存可重建数据,长期维护成本越低。
用一次序列化验证模型独立性
验证跨引擎模型最简单的方法,是把一份 SaveEnvelope 序列化成标准 JSON,然后确认其中只有稳定值,没有引擎类型名、内存地址、节点引用或资源实例。
{
"saveVersion": 1,
"saveId": "slot-001",
"createdAtUtc": "2026-10-08T00:00:00Z",
"gameBuild": "1.0.0",
"player": {
"playerId": "player-main",
"level": 12,
"hp": 86,
"inventoryItemIds": ["item-potion-small", "item-key-forest"]
},
"world": {
"sceneId": "forest-01",
"openedChestIds": ["chest-forest-003"],
"defeatedEnemyIds": ["enemy-wolf-007"]
},
"quests": [
{
"questId": "quest-find-key",
"state": "completed"
}
]
}这段 JSON 是数据结构示例,不要求直接执行。验证时只需检查字段能否被任意标准 JSON 库读取,并确认所有对象引用都已转换为稳定 ID。只要这层协议保持纯数据,不同引擎之间的差异就会被限制在适配器内部,而不会扩散到存档格式本身。