SuperAPI AI 工具集

roblox-server-data

编程与开发

查看项目

更新于 10-16 09:41

技能介绍

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。