# Custom Styling

## Adventure Styling

[Adventure](https://docs.advntr.dev) handles our color, gradient, hover, click and most other styles for messages, titles, and action bar messages along with items, menus and any other configurable style component. By default, Adventure comes preconfigured with [these tags](https://docs.advntr.dev/minimessage/format.html). The following additional tags are added by us. If you encounter issues or require assistance with these tags please do not report them to Adventure, instead open a ticket in our [Discord](https://guccidev.us/discord).

{% hint style="info" %}
Make sure to also check out the [Message Formats](/important-information/configuration-options/message-formats.md) wiki.
{% endhint %}

### Centered Tag

Centers a given string for the Minecraft chat bar max length. If players use a different size, it will not be centered for them.

`<centered>`

### Legacy Tag

Allows for use of legacy color codes. Not intended to be used for all styling, but does add some legacy support for things like Factions `%rel_factions_relation_color%`

`<legacy:color-code>`

* `color-code` - The legacy color code(s) you want to include. [Supports only regular color codes.](https://minecraft.fandom.com/wiki/Formatting_codes)

### Progress Bar Tag

Generates a progress bar with the given input params.&#x20;

`<progress:current:total:bar-length:complete-color:incomplete-color:char>`

* `current` - This is the current amount out of the total amount required already complete.
* `total` - This is the expected "total" amount of progress
* `bar-length` - How long should the progress bar be (in characters)
* `complete-color` - The color of the completed side of the bar (optional)
* `incomplete-color` - The color of the incomplete side of the bar (optional)
* `char` - The character which the bar is made of. (`|,`▌) (optional)

### Block Font

Converts regular English text to the block-font equivilent.&#x20;

`<block-font:"Text">`

* `"Text"` - This is the text which you'd like to translate to Block Font.

{% hint style="warning" %}
Only English letters can be converted. No numbers, special chars, or Unicode's exist in the same font style. Please let our developers know if you find some! \
\
Namespace is only `[.a-zA-Z]`
{% endhint %}

### Percentage

Finds the completion percentage of 2 given input numbers.

`<percentage:complete:total:\"Complete!\">`

* `complete` - The amount out of the total
* `total` -  The total amount to divide with
* `"Complete!"` - If the amount is 100% or more, this text will be displayed if present (optional)

### Roman Numerals

Converts a given input number into its roman numeral counterpart.

`<roman:amount>`

* `amount` - The number to convert to roman numerals.


---

# 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.supremeventures.ca/important-information/configuration-options/custom-styling.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.
