# Icon

{% hint style="info" %}
You cannot use glyphs / images from other plugins. That's why you have to use the plugins built-in icon system.
{% endhint %}

Icons allow you to add your own custom textures into the tooltip text.

### Base configuration

```yaml
icon-id:
   path: "tooltips:icon.png"
   ascent: 2
   height: 8
   width: 4 # Only use if needed
```

All properties of the icon configuration are required.

#### path

Path to the texture of this icon inside `.../pack`

#### ascent

Vertical offset of this texture. Bigger number = higher, lower = lower.

#### height

Size of this texture. Preferably must be the real pixel height of the texture divided by two.

( if the texture is 16 pixels high, the `height` has to preferably be 8)

**width**

Overriding width, which will manually tell tooltips what it should interpet this icons width to be.

### Usage

Supported in all tooltip related text. Icons can be used by entering their placeholder:

```
{file/icon-id}
```

### Default icons

#### Images

A few default icons are included:

```
/tt sendtheme Septicuss default-one-line Default icons -> {default/gem} {default/box} {default/right-click}
```

<div align="left"><figure><img src="/files/QG2RnCNTLs55CzwUOPhS" alt=""><figcaption></figcaption></figure></div>

#### Spaces

You can also use predefined spaces to move your text around

The format is: <mark style="color:red;">`{+x}`</mark>- for positive offset and <mark style="color:red;">`{-x}`</mark> - for negative offset, where <mark style="color:red;">`x`</mark> is pixels

```
/tt sendtheme Septicuss default-one-line Default icons -> {-16}{default/gem} {default/box} {default/right-click}
```

<div align="left"><figure><img src="/files/rCdVWkTQ02qrQTxCm98S" alt=""><figcaption></figcaption></figure></div>


---

# 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://tooltips.gitbook.io/tooltips/configuration/icon.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.