SuperAPI AI 工具集

save-load-systems

编程与开发

查看项目

更新于 10-16 22:43

技能介绍

Save/Load Systems 是一个为游戏存档与读档系统提供专家级蓝图的技能,通过 JSON 序列化、版本迁移和 PERSIST 分组模式来实现稳健的数据持久化。该技能主要基于 Godot 引擎(GDScript)示例,涵盖玩家进度、设置等内容的保存与加载。

【可用脚本】 技能附带以下脚本:

  • save_migration_manager.gd:专家级存档文件版本管理,支持 schema 版本之间的自动迁移。
  • save_system_encryption.gd:AES-256 加密存档并压缩,用于防止随意的存档编辑。

注意:对于生产环境,必须在发布前阅读 save_migration_manager.gd,以处理 schema 变更。

【存档系统中绝不要做的事】

  • 绝不在没有版本字段的情况下保存——游戏更新会导致旧存档失效,必须包含 "version": "1.0.0" 以及针对 schema 变更的迁移逻辑。
  • 绝不使用绝对路径——FileAccess.open("C:/Users/...") 在其他机器上会失效,应使用 user:// 协议(映射到操作系统特定的应用数据文件夹)。
  • 绝不保存节点引用——save_data["player"] = $Player 不可行,节点无法序列化,应通过 player.save_data() 方法提取数据。
  • 绝不忘记关闭 FileAccess——未调用 .close() 会导致文件句柄泄漏,进而造成存档损坏,应使用 close() 或依靠 GDScript 在作用域退出时自动关闭。
  • 绝不对大型二进制数据使用 JSON——将 10MB 纹理以 base64 放入 JSON 会导致文件巨大且解析缓慢,应使用二进制格式(store_var)或单独的资产文件。
  • 绝不信任加载的数据——存档文件可能被用户编辑,使用 data.get("health", 100) 可在字段缺失时防止崩溃,必须验证所有加载的值。
  • 绝不在物理/动画帧内保存——在 _physics_process 中触发保存,若游戏在写入过程中崩溃会导致文件损坏,只应在明确事件(关卡完成、菜单)时保存。

【模式一:JSON 存档系统(推荐用于大多数游戏)】 步骤 1:创建 SaveManager 自动加载(AutoLoad),提供 save_game、load_game、delete_save 方法,使用 user://savegame.save 路径,通过 JSON.stringify 格式化写入,读取时解析 JSON 并处理错误。 步骤 2:保存玩家数据,在 player.gd 中实现 save_data() 返回包含 health、score、level 和位置分量的字典,以及 load_data() 使用 get 方法带默认值加载。 步骤 3:触发保存/读取,在 game_manager.gd 中收集玩家数据、时间戳、版本号后调用 SaveManager,加载时检查数据是否为空并调用玩家的 load_data。

【模式二:二进制存档系统(高级,更快)】 适用于大存档文件或无需人类可读的场景,使用 user://savegame.dat 路径,通过 store_var(data, true) 写入,get_var(true) 读取。

【模式三:PERSIST 分组模式】 用于自动保存带有 persist 组的节点。通过 add_to_group("persist") 将节点加入分组,每个持久化节点实现 save() 和 load() 方法。SaveManager 通过 get_tree().get_nodes_in_group("persist") 收集所有持久节点并保存。

【最佳实践】

  1. 使用 user:// 协议:平台无关,Windows 对应 %APPDATA%\Godot\app_userdata[project_name],macOS 对应 ~/Library/Application Support/Godot/app_userdata/[project_name],Linux 对应 ~/.local/share/godot/app_userdata/[project_name]。
  2. 版本化存档格式:保存时写入 SAVE_VERSION,加载时若版本不匹配则触发迁移。
  3. 优雅处理错误:保存函数返回布尔值,打开文件失败时输出错误并返回 false。
  4. 自动保存模式:使用 Timer 每 300 秒触发一次自动保存。

【测试存档系统】 在调试构建中可调用 test_save_load(),写入测试数据后加载并断言字段值,验证存档/读档是否正常。

【常见陷阱】

  • 保存的 Vector2/Vector3 加载不正确:应将位置存储为 x、y 分量,再重建 Vector2。
  • 资源路径无法解析:应将资源路径存储为字符串(如 texture.resource_path),再通过 load() 重新加载。

【参考】 Godot 文档:Saving Games、File System。

该技能未提供关于平台支持范围、收费方式或价格的信息。