SuperAPI AI 工具集

roblox-data-stores

数据与分析

查看项目

更新于 10-15 21:37

技能介绍

用途:为 Roblox 体验实现玩家数据持久化与跨服务器共享状态,并规避重复物品、进度丢失等并发问题。

主要能力:按需求选择服务——玩家进度/背包/设置用 DataStore 配合 ProfileStore 会话锁(每玩家一键 User_{UserId},≤4 MB);全局排行榜用 OrderedDataStore(仅整数);临时跨服状态用 MemoryStoreService(有序映射、队列、哈希映射,均带 TTL);全服广播用 MessagingService(≤1 kB,尽力投递)。

使用方式:玩家数据推荐 ProfileStore,安装后放入 ServerScriptService,通过 StartSessionAsync 加载、AddUserId 关联用户、Reconcile 补默认字段、EndSession 保存并释放锁;服务端直接改 profile.Data,由自动保存处理。裸用 DataStoreService 时应在加入时加载到内存、定期(2–5 分钟加抖动)、离开、检查点及 BindToClose 时保存;依赖旧值时用 UpdateAsync,失败按指数退避加抖动重试并保持键内顺序。

限制与注意:键与数据存储名 ≤50 字符,值 JSON 编码后 ≤4,194,304 字符;不可存 Instances、Vector3、CFrame、函数或稀疏表。预算随 CCU 变化,UpdateAsync 同时消耗读写预算,可用 GetRequestBudgetForRequestType 检查、SetRateLimitForRequestType 调整。Studio 需在体验设置中启用 API 服务访问,并使用独立测试宇宙或数据存储名。模式迁移应保留 version 字段并按序执行迁移函数,不要在同版本删除字段或复用字段名。数据删除合规需使用静态键模式或 AddUserId 关联用户 ID。具体 API 细节以官方文档为准。