Catalog
最后更新：2026 年 8 月 6 日
Catalog 是你定义 Player 可购买内容的地方 —— 货币包、皮肤，以及把若干道具打成一份的礼包。创建一个道具，给它名称、SKU、图片和描述，之后还可以把它变成 Bundle。
打开方式：在 Project 侧边栏中点击 Catalog。
道具
道具列表会显示这个 Project 中的所有 Catalog 道具。
用搜索栏按名称、SKU 或 ID 查找道具。New item 用于新建，Export 用于下载整个 Catalog。
| 列 | 说明 |
|---|---|
| Item | 图标、显示名称和描述。Bundle 会带一个小方盒标记。 |
| SKU | 该道具的标识符，会出现在收据里。 |
| Updated | 该道具最后一次改动的时间。 |
点击任意一行，即可打开该道具的详情面板。
创建道具
打开 New item 对话框
点击 Catalog 页面右上角的 New item。
填写名称和 SKU
填入 Name（Player 在游戏内和收据上看到的名字）和 SKU（内部标识符）。用 Suggest from name 可以自动生成 SKU。Description 是可选的。
创建并继续
点击 Create and continue，打开这个新道具的详情面板，在那里添加图片和描述。
SKU 由小写拉丁字母、数字和下划线组成，必须以字母开头，最长 24 个字符（例如 coins_500）。道具上线之后，请保持它不变。
道具详情面板
它以侧边面板的形式覆盖在道具列表上。面板顶部显示道具名称及其内部 id（itm_*）。
面板有两个标签页：Details 和 History。
- Details
- History
Name 和 SKU —— 道具的显示名称与标识符。
Image —— 拖入或浏览上传缩略图（PNG、JPG 或 WebP，不超过 2 MB，最小 256×256）。在上传图片之前，列表缩略图会用一个占位色。
Description —— 面向 Player 的 可选文案。
Make this a bundle —— 把这个道具变成 Bundle（见 Bundles）。
按时间顺序记录该道具的所有改动 —— 创建、编辑、变成 Bundle —— 最新的在最前。每条记录都显示由谁改动、何时改动。
用 Save 应用改动，Cancel 放弃改动，Delete 删除该道具。
Bundles
Bundle 是一个道具，购买一次即可获得其中若干其他道具 —— 新手礼包、赛季礼包、宝箱。
把道具变成 Bundle
在该道具的 Details 标签页中，点击 Make this a bundle。
往 Bundle 里加道具
点击 Add item，在 Catalog 中搜索，点击结果即可加入。用步进器给每一项设定数量。What's inside 会列出 Player 购买该 Bundle 时得到的全部内容。
保存
点击 Save。有未保存的改动时，页头会出现 unsaved changes 标记提醒你。
Bundle 不能装另一个 Bundle —— 只能装普通道具。请直接逐个添加道具并设定数量。
下一步
- Managing Players —— 拥有这些道具的 Player 账号
- Building a Game Schema —— 为你的道具所授予的数据建模
- API Key Management —— SDK 所用的 Project 凭据