# PlaceholderAPI Hook

PlaceholderAPI is an optional dependency/hook for this plugin. Here is everything you can do with it.

### 📋 Available Placeholders

Here are all the placeholders you can use in any plugin that supports PlaceholderAPI (Scoreboards, Tablists, etc).

| Placeholder                                                             | Description                                                                                                    |
| ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| `%aliienchatcolor_active%`                                              | Returns the raw ID of the player's equipped color (e.g., `cotton_candy`). Returns "None" if empty.             |
| `%aliienchatcolor_format%`                                              | Returns the raw MiniMessage tags (e.g., `<#FF0000>`). Returns "None" if the player isn't using any chat color. |
| `%aliienchatcolor_has_<colorId>%`                                       | Returns `True` or `False` (as a string) if the player has permission for that specific color.                  |
| `%aliienchatcolor_name%`                                                | Displays the full colored display name of the chat color that the player is using.                             |
| `%aliienchatcolor_is_hex%`                                              | Returns `True` or `False` if the player is using a custom chat color set with `/cc hex` or not                 |
| `%aliienchatcolor_purchasable_%` or `%aliienchatcolor_is_purchasable_%` | Returns `True` or `False` if a color is purchasable or not through the main plugin menu.                       |


---

# 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://aliien.gitbook.io/aliien-docs/aliienchatcolor/placeholderapi-hook.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.