Introduction to Entitlements
Last updated on October 24, 2024
Introduction
The AccelByte Gaming Services (AGS) Entitlements service manages individual player ownership of items that they have purchased or otherwise received. You can use the Entitlements service to grant or revoke instances of items to or from players. Item creation and configuration is handled in Stores. For more information, refer to Set up, Configure, and Prepare a Store.
There are two types of entitlements:
- Durable entitlements are non-stackable and permanent. They do not disappear after use. Examples of durable entitlements include, game skins, weapons, unlockable characters, and similar game features.
- Consumable items disappear after use. Consumables can be stackable or non-stackable; multiple stackable items will be under the same entitlement, whereas multiple non-stackable items will each have their own entitlement, even if they result from identical items. Examples of consumable entitlements include: ammo, potions, and food.
Entitlement management lets you see the entitlement history of a particular player, or players who own a particular entitlement.
Entitlement source
There are many different types of entitlement sources that can be applied to players.
| Entitlement source | Description |
|---|---|
| Purchase | Entitlement from normal purchase of an item via real currency or virtual currency |
| Promotion | Entitlement grant from some promotion/activity |
| Referral_Bonus | Entitlement grant from inviting a new player |
| Redeem_Code | Entitlement from a code redemption |
| Other | Another kind of entitlement source that does not belong to those listed above |
note
Currently, only Purchase, Redeem_Code and Other are supported. The other entitlements are coming soon.
Service architecture
