# Ranks / prefixes

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-aa204cbdea33fb42d5ce255e1db7b1278c17212b%2Fimage%20\(27\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(3\).png?alt=media)

{% 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 %}

### Download the example ranks here

{% embed url="<https://www.spigotmc.org/resources/ranks-betterranks-with-custom-textures-for-itemsadder.84852/>" %}

## Create a rank

Open `contents/betterranks/configs/ranks.yml` file and **copy** and **paste** one of them.\
Then rename it to your rank, also decide a new **.png** file name, for example `custom`.

### Configuration

```yaml
  custom:
    permission: "ranks.custom"
    show_in_gui: true
    suggest_in_command: false
    path: "custom.png"
    scale_ratio: 9
    y_position: 8
```

{% hint style="warning" %}
Don't change `scale_ratio` and `y_position`. It would make the ranks look pixelated.
{% endhint %}

### Image

**Copy** one of my ranks **.png** files and edit it from folder `contents/betterranks/textures/`\
\
You can edit it using **Photoshop**, **GIMP**, **Paint.NET** or any other editing software you use.\
For example copy `admin.png`, name it `custom.png` and edit it.

{% hint style="danger" %}
**Don't change the rank image height!**\
**Change only the width or the image will look pixelated!**
{% endhint %}

### Example

For example in order to make a similar rank to my **BetterRanks** addon you just have to use the [Minecraftia ](https://www.dafont.com/andrew-tyler.d2526)font and cut some pixels.

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-980712e51a0ce138aeaba4f07d7b766b8ba4da8d%2Fimage%20\(36\).png?alt=media)

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-186eba610fa349808dabd024f4091334a9154fa5%2Fimage%20\(37\).png?alt=media)

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-d6bce7231b05ce45c7ef91ea90804d9d9d122239%2Fimage%20\(38\).png?alt=media)

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-554b9e5348b59b78293b0c13ef4ca138129b0d09%2Fimage%20\(39\).png?alt=media)

## Using the rank ingame

### Luckperms

#### Creating a group, example (admin)

Use this command `/lp creategroup admin`

#### Add the prefix

Use this command to get the editor: `/lp editor`\
Now click on the link and open the web editor.

Select the role, in this case `admin`.

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-464449151330055a16f41464f5850bc2d99d6586%2Fimage%20\(77\).png?alt=media)

Write `prefix.100.` followed by the prefix placeholder in the bottom input box, in this example I will use `:admin:`

`prefix.100.:admin:` (make sure you write it correctly).

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-454d7e0b6cb0e8c0cd967dbb16dbc1e99d8b359e%2Fimage%20\(80\)%20\(1\).png?alt=media)

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

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-c358e3853486ac9306d8ad0345e2e55095728eaf%2Fimage%20\(74\)%20\(1\).png?alt=media)

As you can see you have a new line in the permissions list, this is the prefix setting.

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-5ab8c59a8f0fe82f83d75e179244c1c4e23937a0%2Fimage%20\(70\).png?alt=media)

Now save your changes

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-45f233803490b59a60959052abb477d3cbd9e9e9%2Fimage%20\(44\).png?alt=media)

#### Assign the group to a player

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

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-01343012a77293a5f56a18cad020acf2e1941aad%2Fimage_\(40\).png?alt=media)

### TAB plugin

{% hint style="warning" %}
Make sure you installed [PlaceholderAPI](https://github.com/LoneDev6/Wiki-ItemsAdder/blob/japanese/plugin-usage/adding-content/broken-reference/README.md)
{% 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`

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-2125dbfd4b72c24c6e13e2dde92cd90b208058b0%2Fimage_\(38\).png?alt=media)

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-a8e1572881e44335f12d30a1967b960e9c7f7e88%2Fimage_\(39\).png?alt=media)
