Inventory

Player inventory are a list of assets the player owns. Assets can be gifted or refunded.

Retrieve Inventory in Game

To retrieve the inventory of player in game use the following SDK code

Unity

LootLockerSDKManager.GetInventory((response) =>
{
    if (response.success)
    {
        Debug.Log("Successfully retrieved player inventory: " + response.inventory.Length);
    } else
    {
        Debug.Log("Error getting player inventory");
    }
});

Unreal

Blueprint example of retrieving the players inventory

To copy and paste the above example into your editor, look here.

Input

You need to exchange the white empty event for whatever event you want to use to trigger this flow.

Output

We recommend branching the completed events on the success flag in the response, and if you do this, you will probably want to add error handling in case the request fails as well as what (if any) continued actions you want on success.

REST

curl -X GET "https://api.lootlocker.io/game/v1/player/inventory/list" \
  -H "x-session-token: your_token_here"

Example response:

{
    "success": true,
    "inventory": [
        {
            "instance_id": 538,
            "variation_id": 45,
            "rental_option_id": null,
            "acquisition_source": "grant_default_loadout",
            "acquisition_date": "2022-05-30T07:57:58+00:00",
            "asset": {...},
            "rental": {
                "is_rental": false,
                "time_left": null,
                "duration": null,
                "is_active": null
            }
        }
    ]
}

Gift an Asset

Gifting is the ability to grant a specific Asset to a player directly through the LootLocker Management Console.

To gift an Asset to a player, click the Give Asset button in the Player Manager interface. Search for and select an Asset from the popup Asset list. This will immediately grant the player the Asset. A list of all granted Assets can be found in the Orders tab in the Player Manager interface.

Refund an Order

Refunds can be used in case a player purchases an Asset unintentionally or needs to be refunded their purchase for other reasons. Refunding an Order in LootLocker is an easy and simple process.

To refund an Order, navigate to the Inventory tab in the Player Manager interface. Find the Asset in question and use the Refund button to refund the Asset. This will immediately refund the purchased Assets and return the Currency to the player’s wallet. If the player purchased an Asset Package, you will need to refund all Assets from that package for the Currency to be returned to the player's wallet.

Only purchased Assets can be refunded. Assets granted through other LootLocker systems cannot be refunded.