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 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 Dashboard UI when you try to add more than 20 items as a reward.

Custom data

If the Introduction to resources in Economy associated with an item exceeds 5 KB per item or item instance, Economy displays an error message in the 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 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 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 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 Dashboard UI.