Invoke Trigger In-Game

This how-to invokes one or multiple Triggers from your game, granting the player any Rewards attached to them.

Prerequisites

• Unity, Unreal, or Godot SDK installed and configured in your project (not required for REST).
• An active Player session (see Authentication).
• At least one Trigger configured in the Web Console.

Invoke Triggers

When invoking Triggers, you can specify one or multiple keys in the same call.

Unity

// If you want to check and notify the player of what they received, save the keys of the successfully invoked triggers
List<string> successfulKeys = new List<string>();
LootLockerSDKManager.InvokeTriggersByKey(new string[] { "key_one", "key_two" }, (response) =>
{
    if (response.success)
    {
        // Even if keys fails, the call is successful, so you need to check which triggers were successful and which ones failed
        foreach (var item in response.Successful_keys)
        {
            Debug.Log("Key " + item.Key + " was successfully invoked.");
            // Save this key if you want the check what the player got
            successfulKeys.Add(item.Key);
            // Add your own code here to handle successful keys
        }
        foreach (var item in response.Failed_keys)
        {
            Debug.LogWarning("Key " + item.Key + " failed with reason:"+item.reason);
            // Add your own code here to handle the error
        }

        // Here you would put code to check notifications for what the player received.
    }
    else
    {
        Debug.Log(response.errorData.message);
        // Add your own code here to handle the error
    }
});

See the Reference Documentation for the full response.

Unreal

Blueprint example of invoking triggers from your game

Even if the request succeeds, some Triggers may still fail invocation — always check the Failed_keys list in the response. The response also doesn't tell you what was rewarded; check the player's notifications for that, using the successfully invoked keys to identify which notifications correspond to which Trigger.

Godot

Coming soon — this sample hasn't been written yet. In the meantime, refer to the Reference Documentation for this endpoint.

REST

curl --location --request POST 'https://api.lootlocker.io/game/triggers/cozy-crusader/v1' \
--header 'x-session-token: 3266edd928f5769545425469ac417fee456d8367' \
--header 'Content-Type: application/json' \
--data-raw '{
    "keys": [
        "key1",
        "key2",
        "key3"
    ]
}'

See the Reference Documentation for the full response.

Note

Sending the same Trigger key multiple times in one request only invokes it once. To invoke the same Trigger multiple times, call it in separate requests.

Conclusion

You've invoked a Trigger and granted its Rewards to the player. Once you've gotten successful key responses, check the player's notifications to see the specific Rewards they received.