Parameters of operation

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 Cloud 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 Cloud 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 Cloud 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

ItemDescriptionCapImplementation
CurrenciesMax 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 Cloud Dashboard UI.
Total configuration itemsTotal number of configuration items in a game, including the currencies.750 per projectAdmin API only, exceeding this cap returns an error banner in the Unity Cloud Dashboard UI.
Cost items in a purchaseTotal number of cost items allowed for a single purchase. This is only valid for virtual purchases.20 per purchaseAdmin API only, reaching this cap disables the Add an item button in the UI.
Reward items in a purchaseTotal number of different reward items that can be included in a single purchase.20 per purchaseAdmin API only, reaching this cap disables the Add an item button in the UI.
Custom dataCustom data associated with configuration items or instance items.5 KB per item or item instanceAdmin API only, exceeding this cap returns an error message in the Unity Cloud Dashboard UI.
Inventory instancesNumber of items associated with a player.1000 items per playerPlayer API only, exceeding this cap returns an error banner in the Unity Cloud Dashboard UI.