> For the complete documentation index, see [llms.txt](https://itemsadder.devs.beer/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://itemsadder.devs.beer/adding-content/font-images/ranks-prefixes.md).

# Ranks / prefixes

{% hint style="warning" %}
**You have to use** [**LuckPerms**](https://www.spigotmc.org/resources/luckperms.28140/) **and** [**TAB**](https://www.spigotmc.org/resources/tab-1-5-1-21-4.57806/) **to follow this tutorial, the method may differ if you're using other permissions and TABs plugins.**
{% endhint %}

![](/files/-MhUCceX4BzY8cOm9vxC)

Download the example ranks [here](https://www.spigotmc.org/resources/ranks-betterranks-with-custom-textures-for-itemsadder.84852/).

## Create a rank

Create a new file `contents/myranks/config.yml`.

```yaml
font_images:  
  admin:
    permission: "ranks"
    show_in_gui: true
    suggest_in_command: false
    path: "font/admin.png"
    scale_ratio: 9
    y_position: 8
```

{% hint style="warning" %}
Don't change the PNG image height (keep it 8px), do not change `scale_ratio` and `y_position`.\
It would make the ranks look pixelated.
{% endhint %}

### Official tool to create custom ranks

{% embed url="<https://itemsadder.github.io/minecraft-rank-generator/>" %}

<figure><img src="/files/hwHzJUKr6NsESHTxr1hn" alt=""><figcaption><p><a href="https://itemsadder.github.io/minecraft-rank-generator/">https://itemsadder.github.io/minecraft-rank-generator/</a></p></figcaption></figure>

Put the image into `contents/myranks/textures/font/admin.png`.

#### Create a group (for example `admin`)

Command `/lp creategroup admin`

#### Add the prefix

Open the editor `/lp editor`.

Click on the link and open the web editor.\
Select the role. In this case `admin`.

![](/files/Ydj25xpz6zAzCYcZn0bf)

Add a new permission:`prefix.100.:admin:` . Change `:admin:` based on your rank name.

![](/files/diTgIrzdmn62GJjghftk)

Press <mark style="color:green;">**`+Add`**</mark>

![](/files/UHKRGfES3qcmgEc6JbUl)

You now have a new line in the permissions list, this is the prefix setting.

![](/files/Q1vey6Lxu7Kx8AycclkX)

Save your changes.

![](/files/45lcgdh7ksdO1ya9WSMz)

#### Assign the group to a player

Use this command (change `LoneDev` to your player name) `/lp user LoneDev group add admin`

![](/files/-MSTMe0gDWIMv6HGffy1)

## TAB plugin

{% hint style="warning" %}
Make sure you installed [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi)
{% endhint %}

#### Editing the config.yml of TAB plugin

**Add** this under the `groups` category or edit it if already exists.\
(You have to use `%img_admin%` instead of `:admin:` because **TAB** recognized only **PlaceholderAPI** placeholders and not **ItemsAdder** placeholders. This can be valid also for **other plugins**)

```yaml
  Admin:
    tabprefix: '%img_admin%  '
    tagprefix: '%img_admin%  '
```

Then use the command `/tab reload`.

![](/files/-MSTMW2vnkKuTyRsbY_L)

![](/files/-MSTMYhiZ15gXm2pkLAQ)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://itemsadder.devs.beer/adding-content/font-images/ranks-prefixes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
