# Configuration

## Materials

Since GrantX is heavily based on GUI menus, there are many cases in the configuration files where you need to enter a material name. GrantX uses the XSeries library for compatibility with multiple Minecraft versions. [**Click here**](https://github.com/CryptoMorin/XSeries/blob/master/src/main/java/com/cryptomorin/xseries/XMaterial.java) for a list of valid materials. Ignore content inside the parentheses.

## Placeholders

A list of placeholders you can use in configuration files. Some placeholders may return the word "not applicable" if it is not available (ex. %revoke-time% will return N/A if the grant has not been revoked yet).

### Grant Placeholders

| Placeholder             | Description                                                                         |
| ----------------------- | ----------------------------------------------------------------------------------- |
| %id%                    | The unique identifier of the grant.                                                 |
| %status%                | The current status of the grant (Active, Expired, or Revoked).                      |
| %time%                  | The formatted date and time of when the grant was activated.                        |
| %date%                  | The formatted date (no time) of when the grant was activated.                       |
| %target%                | The username of the grant target player.                                            |
| %target-uuid%           | The UUID of the target.                                                             |
| %issuer%                | The username of the grant issuer player (or the word "console").                    |
| %issuer-uuid%           | The UUID of the issuer.                                                             |
| %revoker%               | The username of the grant revoker player.                                           |
| %revoker-uuid%          | The UUID of the revoker.                                                            |
| %revoke-time%           | The time of when the grant was revoked.                                             |
| %expiration%            | The time of which the grant will expire (or the word "never").                      |
| %rank-{placeholder}     | Use any rank placeholder by adding the **rank-** prefix to the placeholder.         |
| %server-{placeholder}   | Use any server placeholder by adding the **server-** prefix to the placeholder.     |
| %duration-{placeholder} | Use any duration placeholder by adding the **duration-** prefix to the placeholder. |
| %reason-{placeholder}   | Use any reason placeholder by adding the **reason-** prefix to the placeholder.     |

### Rank Placeholders

| Placeholder                 | Description                                             |
| --------------------------- | ------------------------------------------------------- |
| %id%                        | The unique identifier of the rank.                      |
| %type%                      | The type of rank- Rank or Permission.                   |
| %real-name%                 | The real name (group/node) of the rank.                 |
| %weight%                    | The weight of the rank.                                 |
| %slot%                      | The slot of the rank.                                   |
| %material%                  | The name of the material representing the rank.         |
| %display-name%              | The display name of the rank.                           |
| %stripped-display-name%     | The display name of the rank, without color.            |
| %lore-type%                 | The type of lore- Default, Custom, None.                |
| %permission%                | The permission required to choose the rank.             |
| %dummy%                     | If this rank is a dummy- Yes or No.                     |
| %grantable%                 | If this rank is grantable. Exact opposite of dummy.     |
| %glow%                      | If this rank will glow in GUIs- Yes or No.              |
| %blacklisted-servers%       | The servers where this rank cannot be chosen.           |
| %blacklisted-servers-count% | The number of servers where this rank cannot be chosen. |

### Server Placeholders

| Placeholder             | Description                                         |
| ----------------------- | --------------------------------------------------- |
| %id%                    | The unique identifier of the rank.                  |
| %real-name%             | The real name (group/node) of the rank.             |
| %weight%                | The weight of the rank.                             |
| %slot%                  | The slot of the rank.                               |
| %material%              | The name of the material representing the rank.     |
| %display-name%          | The display name of the rank.                       |
| %stripped-display-name% | The display name of the rank, without color.        |
| %lore-type%             | The type of lore- Default, Custom, None.            |
| %permission%            | The permission required to choose the rank.         |
| %dummy%                 | If this rank is a dummy- Yes or No.                 |
| %grantable%             | If this rank is grantable. Exact opposite of dummy. |
| %glow%                  | If this rank will glow in GUIs- Yes or No.          |

### Duration Placeholders

| Placeholder                 | Description                                             |
| --------------------------- | ------------------------------------------------------- |
| %id%                        | The unique identifier of the rank.                      |
| %time%                      | THe number of seconds this duration is worth.           |
| %weight%                    | The weight of the rank.                                 |
| %slot%                      | The slot of the rank.                                   |
| %material%                  | The name of the material representing the rank.         |
| %display-name%              | The display name of the rank.                           |
| %stripped-display-name%     | The display name of the rank, without color.            |
| %lore-type%                 | The type of lore- Default, Custom, None.                |
| %permission%                | The permission required to choose the rank.             |
| %dummy%                     | If this rank is a dummy- Yes or No.                     |
| %grantable%                 | If this rank is grantable. Exact opposite of dummy.     |
| %glow%                      | If this rank will glow in GUIs- Yes or No.              |
| %blacklisted-servers%       | The servers where this rank cannot be chosen.           |
| %blacklisted-servers-count% | The number of servers where this rank cannot be chosen. |

### Reason Placeholders

| Placeholder             | Description                                         |
| ----------------------- | --------------------------------------------------- |
| %id%                    | The unique identifier of the rank.                  |
| %weight%                | The weight of the rank.                             |
| %slot%                  | The slot of the rank.                               |
| %material%              | The name of the material representing the rank.     |
| %display-name%          | The display name of the rank.                       |
| %stripped-display-name% | The display name of the rank, without color.        |
| %lore-type%             | The type of lore- Default, Custom, None.            |
| %permission%            | The permission required to choose the rank.         |
| %dummy%                 | If this rank is a dummy- Yes or No.                 |
| %grantable%             | If this rank is grantable. Exact opposite of dummy. |
| %glow%                  | If this rank will glow in GUIs- Yes or No.          |


---

# 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.demeng.dev/grantx/configuration.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.