用途:面向 Roblox 开发者在搭建或审计变现系统(Developer Products、Gamepasses、货币礼包)时使用,减少“扣了钱没到账”或“无限免费领取”这类真实资金相关的错误。
主要能力:
- ProcessReceipt 正确写法:回调必须幂等(Roblox 会重复投递直到返回 PurchaseGranted)且原子(发放与去重记录写入同一次持久化保存)。文中给出“提交-回滚”模式:先检查 receipts[PurchaseId] 是否已发放;发放后写入 receipt 标记;若 PlayerData.save 失败则撤销发放与标记并返回 NotProcessedYet,等待重投。
- 发放约束:ProcessReceipt 内只发放通用(fungible)内容,如货币或可由客户端兑换的持久令牌数量;不要在其中随机抽取特定非通用奖励,否则保存失败回滚加重投会造成数据丢失和虚假“大赢”事件。若必须发放具体物品,需快照精确增量以便回滚完全逆转。
- 保存与序列化:PurchaseId 必须与奖励在同一次 save() 中持久化,两者一起回滚;save() 需返回成功布尔值。禁止用配置表作表键(如把 { id = "x", count = 2 } 直接当键),否则 DataStore 无法序列化导致保存抛错、发放永久回滚、玩家被扣费却拿不到东西;应提取 def.id 与 def.count。
- 测试限制:ProcessReceipt 是只写回调,无法读取或调用测试,只能通过静态阅读与纯逻辑检查验证。
- Gamepasses:以实时所有权为准(加入时 UserOwnsGamePassAsync,PromptGamePassPurchaseFinished 时即时授予),保存布尔值仅作缓存并在加入时复核;“全通行证/超级包”用持久 mega 标记在每次加入时重放所有通行证标记,使后续新增通行证自动解锁。
- 配置与展示:productId 或 gamePassId 为 0 时视为未配置占位,显示“尚未设置”而非发起购买;配置中的 Robux 数字仅供展示,真实扣费以创作者后台设定价格为准;区域定价会使硬编码价格标签漂移,可用 GetProductInfo / GetGamePassProductInfo 获取实时价格。
- 上线清单:需开发者自行在后台创建各 DevProduct/Gamepass、把真实 ID 填入配置并保存发布。
- 持久化一致性:receipts、currency、pass 标记、tokens、invitedBy 等购买相关字段需保存/加载完全对齐,否则会出现可重复领取的一次性礼物或购买丢失。
使用方式:资料以规则与代码片段形式给出,示例展示了 ProcessReceipt 的提交-回滚结构;需结合项目自身的 PlayerData 保存模块落地,并按清单在 Roblox 创作者后台完成商品配置。
适用场景:设计或审查 Roblox 内购发放流程、通行证权限校验、货币礼包、上线前变现审计。
限制:ProcessReceipt 不可直接调用测试;receipts 标记在 save() 让出前设置存在低概率并发窗口,资料建议记录而不必过度设计;商品创建、ID 填写与发布必须由开发者在后台完成,技能本身无法代做。