Create Player Feedback

In this How-to, we'll go through how to report a Player.

Prerequisites

• An active Game Session

• At least 1 configured Player Feedback Category

Retrieve Category IDs

Before we can create the Feedback report, we first need to find the category to report the player under.

If you only have a single category, you could manually retrieve the category ID from the LootLocker Console. However, if you have multiple categories, you should list the categories and let the player choose which category to report under.

When working with Category IDs manually in your code, be aware that switching between environments (e.g. development, staging, production) requires you to modify which ID is used in your game code. This is not the case when using the endpoint to list the categories.

To retrieve all the categories, we can use the following code:

Unity

public void RetrieveCategoryIDs()
{
    LootLockerSDKManager.ListPlayerFeedbackCategories((response) =>
    {
        if (!response.success)
        {
            // Replace this with your own error handling
            Debug.Log("Could not list player related feedback categories");
            Debug.Log(response.errorData.ToString());
            return;
        }

        // Replace this section with your own UI to let the player choose the category
        foreach (var category in response.categories)
        {
            Debug.Log(category.name + "\n"
                + category.description + "\n"
                + category.id);
        }
    });
}

Unreal

Blueprint example of listing feedback categories for players

REST

curl -X "https://api.lootlocker.io/game/feedback/category/entity/player" \
    -H "x-session-token: your_token_here"

Send Player Report

Now that we have the category ID, we can send the player report.

To send a player report, we need to provide the following information:

• The category ID

• The ULID of the player being reported

• Optionally a description, which can be entered by the player, or filled in by the game

How to get the ULID for the player being reported will vary from game to game, but it's currently returned in the player session endpoints, leaderboard endpoints and lookup endpoints.

Unity

public void SendPlayerReport()
{
    string cateogryID = "category_id_here";
    string reportedPlayerULID = "player_id_here";
    string description = "The Player had an inappropiate profile picture";

    LootLockerSDKManager.SendPlayerFeedback(reportedPlayerULID, description, cateogryID, (response) =>
    {
        if (!response.success)
        {
            // Replace this with your own error handling
            Debug.Log("Could not report player");
            Debug.Log(response.errorData.ToString());
            return;
        }

        // Replace this with your own success handling
        Debug.Log("Report sent to LootLocker");
    });
}

Unreal

Blueprint example of reporting players

REST

curl -X "https://api.lootlocker.io/game/feedback" \
    -H "x-session-token: your_token_here" \
    -D '{
    "entity": "player",
    "entity_id": "",
    "category_id": "category_id_here",
    "description": "The Player had an inappropiate profile picture"
    }'

Conclusion

In this How-to, we've gone through how to list categories and report a player. If you want to learn more you can read our Create Game Feedback or Create UGC Feedback How-to's.