Roblox 服务器与共享数据
何时加载
在涉及排行榜、消息传递、MemoryStore 协调、世界状态、赛季或公会时加载本技能。玩家持久化请使用 roblox-data;Open Cloud 请使用 roblox-cloud。
快速参考
OrderedDataStore(排行榜)
可排序的 DataStore:字符串键(tostring(UserId)),整数排序值;GetSortedAsync → 分页;BatchGetAsync 支持多键读取(缺失键会被省略)。
可通过 GetRequestBudgetForRequestType(OrderedWrite) 应对预算突发(每服务器:30 + numPlayers×5 次写入/分钟)。
仅用于排行榜,绝不要用于玩家存档。保持 player_<UserId> 作为静态键子串,以便 RTBF 模板匹配。
MessagingService(跨服务器)
SubscribeAsync / PublishAsync;不保证送达或顺序——需按幂等性设计。
请求/响应:使用 {reqId} 关联 + ack + 超时;没有 ack ≠ 未执行——重放相同 reqId,不要重复发放。
预算要覆盖广播接收,而不仅是发送;限制与轮询权衡详见 full.md。
GlobalDataStore(共享状态)
持久化的非玩家状态(公会、赛季、计数器)。使用 UpdateAsync;绝不要用于玩家会话数据。
MemoryStoreService(临时协调)
用于会过期的匹配、租约、协调的队列与有序映射。
仅在成功且幂等的处理完成后,才移除已读取的批次。
有序映射分页:最后一项的 {key, sortKey} = 下一个排他边界。配额为游戏级(单一共享池):请求单元 1000+120×CCU/分钟,内存 64 KB+1.2 KB/用户,值 ≤32 KB,TTL 45 天;批量调用按项计费。
跨服务器模式
用带过期的心跳注册服务器;通过 MessagingService 通知。
用户身份
使用 player.User(User.Id、DomainType、DomainId)识别用户;UserId 始终有效。域 ID 是按体验划分的:跨服务器数据要以 UserId 为键。
常见陷阱
- MessagingService:发后即忘、无序;不适用于时间关键型工作
- GlobalDataStore:与玩家 DataStore 相同的速率限制
- 绝不要存储 Instance;SetAsync 会覆盖——共享计数器请使用 UpdateAsync
存储选择与工作流详见 references/full.md。