技能介绍

要解决的问题

Roblox 服务端把进度放进 DataStores，这条路却很容易踩坑：玩家进出服务器时忘了保存，一次异常退出就让进度回滚；两台服务器同时写同一个 key，SetAsync 直接互相覆盖；UpdateAsync 回调里顺手 task.wait 一下，线程当场报错；更隐蔽的是 Studio 没开 API 服务访问权限时，GetAsync 静默失败，测试时只看到功能像没写一样。这份技能就是把这类失败模式整理成一套固定的服务端写法。

技能如何工作

骨架是「进服加载、离服保存、停机也保存」的生命周期：

加载：在 PlayerAdded 里用 GetAsync 读，且必须包在 pcall 中——这些都是网络请求，失败会中断线程。
保存：PlayerRemoving 和 game:BindToClose 都要各存一次，服务器关闭时在线玩家才不会丢数据。
读写修改：优先用 UpdateAsync 而非 SetAsync，前者是读-改-写，多服务器环境下不会被对方覆盖；回调里不能 yield，新值要提前算好再返回。
失败策略：加载失败时不要拿默认值去存，那会把本来完好的数据抹掉；应当标记会话并拒绝写入。
排行榜：通过 GetOrderedDataStore 取 OrderedDataStore，再用 GetSortedAsync 排名。
重试：瞬时失败用退避重试，但要注意 per-key 与每分钟请求上限，不要每次属性变化都存一次。

适用边界与注意点

它只能在服务端 Script 里运行，LocalScript 跑不起来；只接受 JSON 可序列化的数据，Instance、Vector3、CFrame、函数都要先转成普通表。OrderedDataStore 没有 DataStoreKeyInfo，版本与元数据用不上。会话锁、分页、错误码和限额这些更细的内容在 references/sessions-and-limits.md。更通用的服务、实例、事件与客户端/服务端分工问题交给 roblox-luau，引擎无关的存档迁移思路看 save-systems。