For the complete documentation index, see llms.txt. This page is also available as Markdown.

游戏内产品

消耗品和通行证的创建方式类似,但使用场景略有不同!

产品类型

游戏通行证

将游戏通行证用于永久性一次性购买:

  • 解锁管理员通行证

  • 永久增益/能力

  • 购买房屋

消耗品

将消耗品用于你希望用户可以多次购买的产品:

  • 生命药水

  • 随时间过期的增益效果

  • 一次性游戏内货币购买

创建产品

Add Product form in the Monetization tab
要创建产品,请在你游戏的 Creator Portal 的“变现”选项卡中点击“+ 添加产品”按钮
Product form with the consumable option clear
如果未勾选“消耗品”复选框,这将是一个“游戏通行证”

了解产品列表

Products list with sales, revenue estimate, ID, and grant failures

产品列表会显示你所有产品的名称,以及一些有用的信息:

  • 已花费的火花数量(鼠标悬停在 ? 图标上可查看总销售次数)

  • 一个 估计 每个产品产生的收入金额

  • 产品 ID(可点击复制到 放到你的游戏代码中用于购买)

  • “发放失败”的数量

购买处理程序 / 发放失败

当用户在你的游戏中购买产品时,我们会运行 ao_purchase_handler 你在游戏代码中定义的函数。

你的购买处理程序通常会根据玩家购买的产品 ID 向其授予物品或功能。返回 true 仅在授予成功后。

如果你的购买处理程序失败——例如,他们的背包已满,而你没有处理这种情况——则返回 false。这将被计为“发放失败”,并显示在 Creator Portal 的“产品”页面中,以便你修复问题。

发放失败将会 在玩家每次加入时自动重试,直到成功。 处理程序必须能够安全地再次运行,并且在返回前不得部分发放奖励 false.

如果你的购买处理程序已成功,但由于某个原因,用户因游戏漏洞或其他原因丢失了该物品,你可以 重新运行 通过将该购买在 编辑/查看玩家数据 “购买”部分中标记为未发放,来为该用户重新运行购买处理程序。请先确认重放该处理程序不会重复发放奖励。

最后更新于