# 操作参数

> Understand the operational limits and parameter caps for Economy configurations.

为了确保 Economy 正常运行，可通过一些参数从存储和运行时使用的角度让服务保持最佳运行状态。

## 参数上限##parameter-caps

### 货币##currencies

一个项目中最多可以配置 20 种货币。如果您尝试配置超过 20 种货币，系统会返回错误。

### 配置物品##configuration-items

游戏中的配置物品总数为每个项目 750 个。其中包括，您可以拥有最多 20 种货币。

### 采购中的成本物品##cost-items-in-a-purchase

对于虚拟购买，单笔交易允许的成本资源数量上限为 20。成本资源是进行交易所需的任何货币或背包物品。当您尝试向购买中添加超过 20 个成本物品时，Economy 会禁用控制面板 UI 中的 \*\*Add（添加）\*\*按钮。

### 购买中的所得物品##reward-items-in-a-purchase

对于所有购买（虚拟和真实货币），单次购买交易可授予玩家的物品数量上限为 20。当您尝试添加超过 20 件物品作为购物所得物品时，Economy 会禁用控制面板 UI 中的 \*\*Add（添加）\*\*按钮。

### 自定义数据##custom-data-parameters-of-operation

如果与商品关联的[自定义数据](./custom-data.md)超过每个商品或商品实例 5 KB，并且该错误源自配置，Economy 会在控制面板 UI 中显示错误消息。如果错误源自游戏本身，API 将返回错误消息。

### 背包实例##inventory-instances

每个玩家的背包实例上限为 1000 个。仅在 Player API 中报告错误。尝试向玩家添加更多物品将导致 API 返回错误。

## 限制汇总##summary-of-limits

| 物品       | 描述                                  | 上限                   | 实现                                                          |
| -------- | ----------------------------------- | -------------------- | ----------------------------------------------------------- |
| 货币       | 游戏中使用的货币数量上限。                       | 每个项目 20（从 15 开始发出警告） | 仅限 Admin API，超过此上限时会在控制面板 UI 中返回错误横幅。                       |
| 配置物品总数   | 游戏中的配置物品总数，包括货币。                    | 每个项目 750 个           | 仅限 Admin API，超过此上限时会在控制面板 UI 中返回错误横幅。                       |
| 采购中的成本物品 | 单次购买允许的成本物品总数。仅适用于虚拟购买。             | 每次购买 20 个            | 仅限 Admin API，达到此上限会禁用 UI 中的 **Add an item（添加物品）**按钮。 |
| 购买中的所得物品 | 单次购买可包含的不同所得物品的总数。                  | 每次购买 20 个            | 仅限 Admin API，达到此上限会禁用 UI 中的 **Add an item（添加物品）**按钮。 |
| 自定义数据    | 与配置物品或实例物品相关联的[自定义数据](custom-data)。 | 每个物品或物品实例 5 KB       | 仅限 Admin API，超过此上限时会在控制面板 UI 中返回错误信息。                       |
| 背包实例     | 与玩家相关联的物品数量。                        | 每个玩家 1000 个物品        | 仅限 Player API，超过此上限时会在控制面板 UI 中返回错误横幅。                      |