# 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="https://2056457066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO0fJVi4OrBJoOYrP9n9t%2Fuploads%2Fw4Hmp3GF7U4EoJcYviPH%2Fimage.png?alt=media&#x26;token=dd0a8139-3eb5-4bdf-9a37-e342360e512d" 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="https://2056457066-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO0fJVi4OrBJoOYrP9n9t%2Fuploads%2FjHMmpgtBTtd1yMNgNWhd%2Fimage.png?alt=media&#x26;token=456b584c-ed77-4423-9256-913f288a3131" alt=""><figcaption></figcaption></figure></div>

