# Leaderboards

To use leaderboards you need to create in LootLocker's dashboard first, you can follow this [**guide**](https://docs.lootlocker.com/game-systems/leaderboards/create-a-leaderboard) to do it.

{% hint style="info" %}
To learn more about Leaderboards you can go to LootLocker's documentation [**here**](https://docs.lootlocker.com/game-systems/leaderboards)
{% endhint %}

<figure><img src="/files/CcASJKBYm3KGvdHrHk70" alt=""><figcaption></figcaption></figure>

## UI

To show a UI you have to use the **Loot Locker Leaderboard UI** component

<figure><img src="/files/qPWQABjNglvJkFXhQBqv" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="201">Parameter</th><th>Description</th></tr></thead><tbody><tr><td>Leaderboard Id</td><td>Key of the leaderboard to get entries for</td></tr><tr><td>Count</td><td>How many entries to get</td></tr><tr><td>After</td><td>How many after the last entry to receive</td></tr><tr><td>Show Player if Not Present</td><td>If enabled and if player is not part of the list a new entry will be generated</td></tr><tr><td>Player Content</td><td>The container for the player entry</td></tr><tr><td>Empty Player Name</td><td>If player has no name this will be displayed instead</td></tr><tr><td>Empty Player Rank</td><td>If player has no rank in the leaderboard this will be displayed instead</td></tr><tr><td>Prefab Cell</td><td>The leaderboard entry UI</td></tr><tr><td>Content</td><td>The container for all leaderboard entries</td></tr><tr><td>Regular Background Color</td><td>A color used for the background of regular entries</td></tr><tr><td>Alternate Background Color</td><td>A color used to alternate regular entries color</td></tr><tr><td>Regular Text Color</td><td>Text color for regular entries</td></tr><tr><td>Player Text Color</td><td>Text color for the player entry</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ninjutsugames.com/game-creator-2/loot-locker/leaderboards.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.