Parameters of operation
Understand the operational limits and parameter caps for Economy configurations.
Read time 2 minutesLast updated a day ago
To ensure the proper operation of Economy, there are some parameters in place to keep the service running optimally, both from a storage and runtime usage perspective.
Parameter caps
Currencies
The maximum number of currencies you can configure in a project is 20. If you try to configure more than 20 currencies, the system returns an error.Configuration items
The total number of configuration items in a game is 750 per project. This includes up to 20 currencies you might have.Cost items in a purchase
For virtual purchases, the maximum amount of cost resources allowed for a single transaction is 20. A cost resource is any currency or inventory item needed to proceed with a transaction. Economy disables the Add button in the Unity Dashboard UI when you try to add more than 20 cost items to a purchase.Reward items in a purchase
For all purchases (virtual and real money), the maximum amount of items given to the player as the reward of a single purchase transaction is 20. Economy disables the Add button in the Unity Dashboard UI when you try to add more than 20 items as a reward.Custom data
If the Custom data associated with an item exceeds 5 KB per item or item instance, Economy displays an error message in the Unity Dashboard UI, if the error originates from the configuration. If the error originates from the game itself, the API returns an error message.Inventory instances
There is a limit of 1000 inventory instances per player. An error is only reported in the Player API. Trying to add more items to a player will result in an error returned by the API.Summary of limits
Item | Description | Cap | Implementation |
|---|---|---|---|
| Currencies | Max number of currencies used in a game. | 20 per project (warning starts at 15) | Admin API only, exceeding this cap returns an error banner in the Unity Dashboard UI. |
| Total configuration items | Total number of configuration items in a game, including the currencies. | 750 per project | Admin API only, exceeding this cap returns an error banner in the Unity Dashboard UI. |
| Cost items in a purchase | Total number of cost items allowed for a single purchase. This is only valid for virtual purchases. | 20 per purchase | Admin API only, reaching this cap disables the Add an item button in the UI. |
| Reward items in a purchase | Total number of different reward items that can be included in a single purchase. | 20 per purchase | Admin API only, reaching this cap disables the Add an item button in the UI. |
| Custom data | Custom data associated with configuration items or instance items. | 5 KB per item or item instance | Admin API only, exceeding this cap returns an error message in the Unity Dashboard UI. |
| Inventory instances | Number of items associated with a player. | 1000 items per player | Player API only, exceeding this cap returns an error banner in the Unity Dashboard UI. |