# Placeholders

AuroraCollections provides built-in placeholders for PlaceholderAPI.

* `%aurora_collections_[category]_[collection-id]_level%` - Current level of the player in the given collection. Can be a roman numeral depending on your configuration.
* `%aurora_collections_[category]_[collection-id]_level_raw%` - Current level of the player in the given collection. This will always be a number.
* `%aurora_collections_[category]_[collection-id]_name%` - Formatted name of the collection.
* `%aurora_collections_[category]_[collection-id]_count%` - Current progression for the player in the given collection. This is a formatted number.
* `%aurora_collections_[category]_[collection-id]_count_raw%` - Same as before, but this number is not formatted, meaning it can be passed to commands or other places.

Category only placeholders:

* `%aurora_collections_category_[category]_level%` - Level of the category (summed level of the collections inside the category)
* `%aurora_collections_category_[category]_level_raw%` - Same but without any kind of number formatting.
* `%aurora_collections_category_[category]_max_level%` - Maximum possible level of the category.
* `%aurora_collections_category_[category]_completed_percent%` - Category completion percent. Based on collection levels inside the category.
* `%aurora_collections_category_[category]_completed_percent_raw%` - Same, but without number formatting.
* `%aurora_collections_category_[category]_count_raw%` - Total collected items in the category without number formatting.
* `%aurora_collections_category_[category]_count_short%` - Same as above but with short number formatting.
* `%aurora_collections_category_[category]_count%` - Same as above, but with regular number formatting.

Category Leaderboard placeholders:

* `%aurora_lb_cc_[category]_name_[number]%` - name of the player
* `%aurora_lb_cc_[category]_value_[number]%` - value of the tracked stat
* `%aurora_lb_cc_[category]_fvalue_[number]%` - same but formatted number
* `%aurora_lb_cc_[category]_cvalue_[number]%` - Same but short formatted number, like 10K

Collection Leaderboard placeholders:

* `%aurora_lb_[category]_[collection]_name_[number]%` - name of the player
* `%aurora_lb_[category]_[collection]_value_[number]%` - value of the tracked stat
* `%aurora_lb_[category]_[collection]_fvalue_[number]%` - same but formatted number
* `%aurora_lb_[category]_[collection]_cvalue_[number]%` - Custom value that the leaderboard provides. This is also formatted. **It would be best if you used this as the value placeholder.** 


---

# 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.auroramc.gg/auroracollections/placeholders.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.