# Making a custom theme

Let's create a theme that will support 3 text lines, with fancy borders like so:

<figure><img src="/files/PcKxcxhbcEdqaL8Mfsbx" alt=""><figcaption></figcaption></figure>

### 1. Find the template texture

First, open up your pixel art software. I personally recommend Aseprite, but Photoshop or other programs can also be used with proper configuration. Important thing is, that it should be good for pixel art.

Next, find the default tooltip textures. They're located in:

* <mark style="color:red;">`plugins/Tooltips/pack/assets/tooltips/textures/tooltips/default`</mark>&#x20;
* or [on GitHub here](https://github.com/Septicuss/tooltips/tree/master/src/main/resources/default/pack/assets/tooltips/textures/tooltips/default).

Since we want 3 lines, we'll use the <mark style="color:red;">`default-three-lines.png`</mark>.&#x20;

<div align="left"><figure><img src="/files/fcoml5g33AxLnUryrorR" alt="" width="147"><figcaption><p>6x38 pixel default three lines</p></figcaption></figure></div>

### 2. Editing the texture

{% hint style="info" %}
**Note that a theme texture is split into 3 equal parts**:

* LEFT
* MIDDLE
* RIGHT

Which means that if your texture is 12 in width, each part will be 4 pixels:

<img src="/files/SkH8KbWlpT7hTOWfsH3F" alt="" data-size="original">

**(AS SUCH, YOUR WIDTH HAS TO ALWAYS BE A MULTIPLE OF 3)**
{% endhint %}

Now to make it our own, let's stretch it out so we have some room to work with \
(setting canvas width to 12)

<div align="left"><figure><img src="/files/WuIg2OD0eTtmEiQ10RJe" alt="" width="125"><figcaption><p>12x38 pixels</p></figcaption></figure></div>

Now expanding the texture itself:

<div align="left"><figure><img src="/files/T87ofacjwt1de9ehmq9w" alt="" width="136"><figcaption><p>12x38, filled up</p></figcaption></figure></div>

Change the corners to your liking:

<div align="left"><figure><img src="/files/6SxqsWcYNRW8CbkO2nIG" alt="" width="188"><figcaption></figcaption></figure></div>

And change the color:

<div align="left"><figure><img src="/files/GpUINNxlbWYbDFNRfLtv" alt="" width="146"><figcaption></figcaption></figure></div>

Now our texture is done!

### 3. Configuration

Now what's left is to configure the theme.

#### 1. Add texture to plugin

Save the modified template texture into \ <mark style="color:red;">`plugins/Tooltips/pack/assets/tooltips/textures/tooltips/custom`</mark>\
as\ <mark style="color:blue;">`custom.png`</mark>

<figure><img src="/files/3SGN2oZxcLHHyeEpN9Mm" alt=""><figcaption></figcaption></figure>

#### 2. Configure theme

Go into any theme <mark style="color:red;">`.yml`</mark> file (or create your own) inside <mark style="color:red;">`plugins/Tooltips/themes`</mark>. I will use <mark style="color:red;">`plugins/Tooltips/themes/custom.yml`</mark>.

Now, copy the configuration [of the template from here](https://github.com/Septicuss/tooltips/blob/master/src/main/resources/default/config/themes/themes.yml). Since we used `default-three-line` as the template, we'll also take `default-three-line` configuration:

<figure><img src="/files/fESrGg49iFAxvIL4elWX" alt=""><figcaption></figcaption></figure>

Paste it into your theme file:

<figure><img src="/files/UX6gF0FV2yLOHmvght4V" alt=""><figcaption></figcaption></figure>

Now edit the ID to your liking (don't leave it as `default-three-line`, because that already exists).

<figure><img src="/files/t8UJ7fgvld15CDlfspPv" alt=""><figcaption></figcaption></figure>

Edit the path to match the path where you put the texture. We put it into

* <mark style="color:red;">`.../assets/tooltips/textures/tooltips/custom/`</mark><mark style="color:blue;">`custom.png`</mark>

So the path is

* <mark style="color:red;">`tooltips:tooltips/custom/`</mark><mark style="color:blue;">`custom.png`</mark>

And lastly, edit the height to 19, because we changed the width. If not changed, it will look like this:

<figure><img src="/files/t0NMMe6fS1DSNyhLB138" alt=""><figcaption></figcaption></figure>

Here's the complete configuration:

<figure><img src="/files/qS8RoBPIYeFdI5g6gswW" alt=""><figcaption></figcaption></figure>

Once done, update your resource pack and test the theme with&#x20;

* `/tt sendtheme [PLAYER] custom Text`

Download the texture done in this page here:

{% file src="/files/RW7knlmzozUmqdH1KtcR" %}


---

# 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/theme/making-a-custom-theme.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.