> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zonely.gen.tr/llms.txt
> Use this file to discover all available pages before exploring further.

# Roles

> Edit role appearance, panel permissions, time, game authorizations and Discord role mapping; role or reclaim users.

**Management panel → Member Settings → Roller** Manage users’ roles and role definitions from the section. You can prepare the appearance, management permissions, time, game authorizations and Discord opposite on the same screen.

## Know Roller Screen

Find the user with the search on the left. The list on the right is located in the defined roles. Role user’s role in the card **drag and drop** you can get a gift.

[![User cards, Definition roles](https://mintcdn.com/zonely-a8cd49e7/pg8jiJCV8iizmk8t/images/panel/roles-guide-20261025/r01-rol-listesi-en.png?fit=max\&auto=format\&n=pg8jiJCV8iizmk8t\&q=85\&s=8ae99645b9fbff8fefdf108a2ce18506)](https://docs.zonely.gen.tr/images/panel/roles-guide-20261025/r01-rol-listesi-en.png)

> [card] 1. User cards
>
> Find an account and check out the assigned roles.

> [card] 2. Definition roles
>
> Drag the user to the Rolu; open editing and copying transactions from the list.

| Transaction | What does it? |
| - | - |
| Role in the user card **×** button | The assigned role removes it from the user. |
| Role list **Edit** | Opens the settings of the selected role. |
| Role list **Copy** | The current role opens the new role display based on the settings. |
| Role list **Delete** | Opens the erasing process of role definition. |
| Drag Rolu list | Organizes the role sequence. |

Top **Cast A Role**, **Give Everyone A Role** and **Get A Role From Everyone** buttons are for assigning or re-entering existing roles to users. To prepare a new role **Add Role** Press the button.

## Prepare the name and appearance of the role

**Add Role** On screen **View, Permissions, Time, Game Authorization, Discord and HTML** tabs are available. First **View** Click on the role in the preview on the tab and for example, **News** type. The user name on the side shows how changes you do.

### Featured color and style

**Cow Style**formats role tag next to the user name. Select a color ready from the pallet or **Drop** Select custom color with button. **Tags** The button returns to default color.

[![Featured color, Featured style](https://mintcdn.com/zonely-a8cd49e7/pg8jiJCV8iizmk8t/images/panel/roles-guide-20261025/r02-onek-en.png?fit=max\&auto=format\&n=pg8jiJCV8iizmk8t\&q=85\&s=441636cf516302e7daba6a0170cb602c)](https://docs.zonely.gen.tr/images/panel/roles-guide-20261025/r02-onek-en.png)

> [card] 1. Featured color
>
> Choose ready or custom color for role label.

> [card] 2. Featured style
>
> Select the appearance of Solid, Soft, Striped or Gradyan.

| Style | View |
| - | - |
| **Solid** | It uses a label floor filled with selected color. |
| **Soft** | Light color floor uses colorful font and edge. |
| **Striped** | The phrase shows colorful font and edge on the ground. |
| **Gradient** | It forms a derived color pass from the selected color on the floor of the label. |

As color and style changed, preview on the top is renewed. Click the tag on the preview to change the role name.

### Select one color for user name

**User Name Style → Solid**shows the account name with one color. Ready-made pallet, drop and default color buttons change the color of the user name in this field.

[![User name color](https://mintcdn.com/zonely-a8cd49e7/pg8jiJCV8iizmk8t/images/panel/roles-guide-20261025/r03-kullanici-adi-en.png?fit=max\&auto=format\&n=pg8jiJCV8iizmk8t\&q=85\&s=a844b39d247be219d69f044c9fe0d3d6)](https://docs.zonely.gen.tr/images/panel/roles-guide-20261025/r03-kullanici-adi-en.png)

> [card] 1. User name color
>
> Set single color for account name in solid style.

### Create two-color transition

**Gradient** Two-color presets are opened when selected. You can choose a ready-to-pass or set the start and finish colors separately with two drop buttons.

[![Two-color switch, Animation speed](https://mintcdn.com/zonely-a8cd49e7/Wpf_61uG_rT-Ut4y/images/panel/roles-guide-20261025/r04-gradyan-en.png?fit=max\&auto=format\&n=Wpf_61uG_rT-Ut4y\&q=85\&s=b6de733b1e2a656ce62112d51cc9b078)](https://docs.zonely.gen.tr/images/panel/roles-guide-20261025/r04-gradyan-en.png)

> [card] 1. Two-color switch
>
> Select ready pass or start and finish colors.

> [card] 2. Animation speed
>
> The transition slows down as the second; 0 stops the movement.

### Adjust the holographic view

**Holographic**The user uses three color stops named. Change the color of each stop from its drop button and check the result from preview.

[![Holographic appearance, Movement time](https://mintcdn.com/zonely-a8cd49e7/Wpf_61uG_rT-Ut4y/images/panel/roles-guide-20261025/r05-holografik-en.png?fit=max\&auto=format\&n=Wpf_61uG_rT-Ut4y\&q=85\&s=80ae0d515e2e1710edb3e25e87b36eeb)](https://docs.zonely.gen.tr/images/panel/roles-guide-20261025/r05-holografik-en.png)

> [card] 1. Holographic appearance
>
> Separately select three color stops.

> [card] 2. Movement time
>
> Set the speed of multi-color passage from this area.

**Animation Speed** slider appears in Gradyan and Holographic styles. The value is in the second breed: **0**stops movement; slows the color pass as the time increases.

## Add badge and drop-down message

**Badge**The picture shown next to the user name. Select your file by printing it to the visual field or the installation icon. The file selection starts loading; you can follow the progress from the percentage on the visual. **×** The button removes the selection of badges available.

[![Badge visual, Drop-down message](https://mintcdn.com/zonely-a8cd49e7/Wpf_61uG_rT-Ut4y/images/panel/roles-guide-20261025/r06-rozet-en.png?fit=max\&auto=format\&n=Wpf_61uG_rT-Ut4y\&q=85\&s=70b5ba84244a1563e52401fcad366cd9)](https://docs.zonely.gen.tr/images/panel/roles-guide-20261025/r06-rozet-en.png)

> [card] 1. Badge visual
>
> Select the picture to show next to the username.

> [card] 2. Open message
>
> Write the description to show when it comes to the badge.

**Popup Message** type short description to show when the area is on the badge. For example, for the role of the guide **Team helping players** You can use the description.

## Select Avatar Frame

**Avatar frame** open the space and select the frame you want from the list. **Unframed** Removes the option frame. The choice appears in the small picture and name field; the preview on the top is also updated.

[![Avatar Frame](https://mintcdn.com/zonely-a8cd49e7/Wpf_61uG_rT-Ut4y/images/panel/roles-guide-20261025/r07-avatar-cercevesi-en.png?fit=max\&auto=format\&n=Wpf_61uG_rT-Ut4y\&q=85\&s=baff5135a92584bea188d35b10ae94ae)](https://docs.zonely.gen.tr/images/panel/roles-guide-20261025/r07-avatar-cercevesi-en.png)

> [card] 1. Avatar frame
>
> Select a frame; Remove selection with your frame.

## Select the sequence and role options

**Row**is the numerical ranking weight of the role. You can also change ranking by dragging roles in the main list. Access to the management panel, **Permits** The selections are determined on the tab.

[![Sort, Role options](https://mintcdn.com/zonely-a8cd49e7/Wpf_61uG_rT-Ut4y/images/panel/roles-guide-20261025/r08-sira-ve-davranis-en.png?fit=max\&auto=format\&n=Wpf_61uG_rT-Ut4y\&q=85\&s=f5a4d5c404130bd07e84bbfa88cf1599)](https://docs.zonely.gen.tr/images/panel/roles-guide-20261025/r08-sira-ve-davranis-en.png)

> [card] 1. Row
>
> Determine the weight of the role numerical ranking.

> [card] 2. Role options
>
> Separate views, set by the purpose of the role of the default, prohibited and the unsued member options.

| Option | Usage |
| - | - |
| **Members with Role show separate from the remaining members.** | This role determines the accounts with other members. |
| **Will it be the default role for everyone?** | Signs as the role of the default member of the Rolı. To assign roles to all accounts **Give Everyone A Role** Use the process. |
| **Will this be a banned member role?** | It determines the role type to be used for ban-for-for-the-counter members. |
| **Will this be a silenced member role?** | Sustured members determine the role type to be used for. |

## Select management panel permissions

**Permits** Type the area to be managed to search on the tab and tick the corresponding boxes. For example support team **Support** search **Live Support Manageable** You can choose the permission.

[![Permission search, Permission selection](https://mintcdn.com/zonely-a8cd49e7/grsNKI9o8QwBbkcr/images/panel/roles-guide-20261025/r09-izinler-en.png?fit=max\&auto=format\&n=grsNKI9o8QwBbkcr\&q=85\&s=35dad54f39d4c4b5ff7a8ce16cfe35d6)](https://docs.zonely.gen.tr/images/panel/roles-guide-20261025/r09-izinler-en.png)

> [card] 1. Permission search
>
> Find the domain to be managed.

> [card] 2. Permission selection
>
> Check the management areas that need to access the role.

**Select Seen**Signs along the permissions appear as a result of the search. **Clear**clears the choice of permission. Set the areas where the role will manage from these buttons or single boxes.

### Super Manager

**Super Manager** When the existing management permissions are selected. You can open this option for the role that will use all management fields.

[![Super Manager](https://mintcdn.com/zonely-a8cd49e7/grsNKI9o8QwBbkcr/images/panel/roles-guide-20261025/r10-super-yonetici-en.png?fit=max\&auto=format\&n=grsNKI9o8QwBbkcr\&q=85\&s=3107ecbafb1c7d165daea2b87e43102e)](https://docs.zonely.gen.tr/images/panel/roles-guide-20261025/r10-super-yonetici-en.png)

> [card] 1. Super Manager
>
> Selects all available management permissions.

The next authorizations on the game server **Game Authorization** Describe in the section also.

## Set the role time

**Duration** On the tab **Unlimited** or **Limited** Select. Type the time to the space opened in the limited option. For example **10m**means 10 minutes.

[![Time Type, Role Time](https://mintcdn.com/zonely-a8cd49e7/grsNKI9o8QwBbkcr/images/panel/roles-guide-20261025/r11-sure-en.png?fit=max\&auto=format\&n=grsNKI9o8QwBbkcr\&q=85\&s=069dc1ddbedb651cc829b1db6b24c260)](https://docs.zonely.gen.tr/images/panel/roles-guide-20261025/r11-sure-en.png)

> [card] 1. Time type
>
> Select Unlimited or Limited.

> [card] 2. Role time
>
> Type time for limited role; 10m means 10 minutes.

## Prepare game authorizations

Before you use game roles with the site [LuckPerms link](https://docs.zonely.gen.tr/en/integrations/luckperms.md) prepare. Check the site and the game server connected to the same database, the correct table forward.

**Game Authorization** on the tab **Cow Style** and **User Name Style** Type Minecraft formatting to areas. For example to stand out \*\*\&a\[Rehber]\*\*for user name **\&r** You can use it. See preview under the consequent areas.

[![Game prefix, Authorization permissions](https://mintcdn.com/zonely-a8cd49e7/grsNKI9o8QwBbkcr/images/panel/roles-guide-20261025/r12-oyun-yetkisi-en.png?fit=max\&auto=format\&n=grsNKI9o8QwBbkcr\&q=85\&s=db6fcf847ffc0e1abc282ff28859b5dd)](https://docs.zonely.gen.tr/images/panel/roles-guide-20261025/r12-oyun-yetkisi-en.png)

> [card] 1. Game prefix
>
> Write the prefix of the role in Minecraft formatting.

> [card] 2. Authorization permissions
>
> Set the scope that LuckPerms nodes and will be valid.

**Authorization Permissions** Type LuckPerms nodes in the field. For example **group.rehber**, on your gaming server **guide** expresses the membership of the group; this group must be predefined on the server.

**+ Add Permission** Add other nodes with. From the scope list of the line **global** or select the listed server. Use the delete button on the same line to remove a knot.

## Connect the role of the site to the role of Discord

Discord to use role mapping **Discord Bot** Prepare and link **Add-ons → Discord Match** Activate the plugin. Bot Discord connects your server to the site; the account pair connects the member with its own Discord account.

1. [Discord Bot guide](https://docs.zonely.gen.tr/en/guides/discord-bot.md) add bot to your server with steps and **Link Token → /esle** Complete the link.
2. [Discord account matching steps](https://docs.zonely.gen.tr/en/guides/linked-accounts.md#discord-hesabi-esleme) Activate the plugin and review how the user will connect his/her account.
3. Home **Discord** Open the tab. **Discord Role** Select the opposite of this site role from the list on the server.

[![Discord role, Sync the username, Matched account condition](https://mintcdn.com/zonely-a8cd49e7/grsNKI9o8QwBbkcr/images/panel/roles-guide-20261025/r13-discord-rolu-en.png?fit=max\&auto=format\&n=grsNKI9o8QwBbkcr\&q=85\&s=39e1394eef8941a5e10002c2064b5390)](https://docs.zonely.gen.tr/images/panel/roles-guide-20261025/r13-discord-rolu-en.png)

> [card] 1. Discord role
>
> Select the opposite of the site role on the Discord server.

> [card] 2. Sync user name
>
> Select the use of the site as the Discord name of the user name.

> [card] 3. Matched account condition
>
> Do not require the matching of the personal Discord account for the role.

| Area | What does it? |
| - | - |
| **Discord Role** | Determines the opposite of the site role in the connected Discord server. For example, you can connect the role of the site guide to the role of Discord Guide. |
| **Username should appear as discord name** | The user name on the site allows the use of the Discord server as a name. |
| **Only given to users with a Discord account.** | To ensure that this site role has been given, the user must have matched the Discord account. |

The user must also be member of the connected Discord server. Check the link to the correct server of the bot if the list is empty. Although it does not data despite the role looks [Controls in Discord Bot guide](https://docs.zonely.gen.tr/en/guides/discord-bot.md) Check out.

## Edit and save HTML view

**HTML** You can edit the special HTML presentation on the site of the role tab. Check the result of the code from the preview on the top. **Restore**Recreate HTML code from existing settings on the View tab.

[![HTML view, Restore](https://mintcdn.com/zonely-a8cd49e7/grsNKI9o8QwBbkcr/images/panel/roles-guide-20261025/r14-html-en.png?fit=max\&auto=format\&n=grsNKI9o8QwBbkcr\&q=85\&s=8f934028fa4d2b69764281c654c9eeec)](https://docs.zonely.gen.tr/images/panel/roles-guide-20261025/r14-html-en.png)

> [card] 1. HTML view
>
> Edit and preview the special HTML presentation of the role.

> [card] 2. Restore Back
>
> Use this button to recreate the appearance.

After completing all tabs, under the screen **Publish** Create new role with the button. If you are organizing a current role **Update** Save with the button.

## Role a user

Main screen **Cast A Role** Press the button. Search and select the user; then select one or multiple roles to be given. **Give** button assigns the selected roles into this account.

[![User, roles to be given](https://mintcdn.com/zonely-a8cd49e7/CQiXr9MeKko3ftBp/images/panel/roles-guide-20261025/r15-kullaniciya-rol-en.png?fit=max\&auto=format\&n=CQiXr9MeKko3ftBp\&q=85\&s=bb467d4e8740354a053a864a74da627a)](https://docs.zonely.gen.tr/images/panel/roles-guide-20261025/r15-kullaniciya-rol-en.png)

> [card] 1. User
>
> Select the role-to-play account.

> [card] 2. Rollers to be given
>
> Select one or more roles and take into account with Ver.

Next to the selected role \*\*×\*\*The role is yet sent from the choice. On this screen **Select All**Signs of all the roles to be given to the user you choose; the transaction is applied to the selected account.

## Role all users

**Give Everyone A Role** Open the button and select the assigned roles. **Select All** marking all roles; **Clear Selection** Removes the selected roles. **Apply** The button gives all the accounts of the roles you choose.

[![Give Everyone A Role](https://mintcdn.com/zonely-a8cd49e7/CQiXr9MeKko3ftBp/images/panel/roles-guide-20261025/r16-herkese-rol-en.png?fit=max\&auto=format\&n=CQiXr9MeKko3ftBp\&q=85\&s=4ab8945c94f34c783328f291a97f9bc2)](https://docs.zonely.gen.tr/images/panel/roles-guide-20261025/r16-herkese-rol-en.png)

> [card] 1. Role All
>
> All users are given to the following roles with the Apply.

## Take part of all users

**Get A Role From Everyone** Open the button and select the roles to be restored. **Remove** The button removes the selected roles from all users. **Cancel**closes the window from the application.

[![Get A Role From Everyone](https://mintcdn.com/zonely-a8cd49e7/CQiXr9MeKko3ftBp/images/panel/roles-guide-20261025/r17-herkesten-rol-en.png?fit=max\&auto=format\&n=CQiXr9MeKko3ftBp\&q=85\&s=3758f5c0368a8a77c2446fb3e657cdbe)](https://docs.zonely.gen.tr/images/panel/roles-guide-20261025/r17-herkesten-rol-en.png)

> [card] 1. Role of Everyone
>
> Remove the roles you choose from all users.

The main role list on the right to delete the role definition **Delete** Use the process.

## See the remaining role time of the user

Find user card on the home screen. Next to a periodic role **Come on the clock icon**. In the pop-up information box **EndÅ** Date and **Remaining** time appears. This time indicator is not available indefinite roles.

[![Time of remaining role](https://mintcdn.com/zonely-a8cd49e7/CQiXr9MeKko3ftBp/images/panel/roles-guide-20261025/r18-sureli-rol-en.png?fit=max\&auto=format\&n=CQiXr9MeKko3ftBp\&q=85\&s=fe7b67a7a444b80cb35abb23d2acf780)](https://docs.zonely.gen.tr/images/panel/roles-guide-20261025/r18-sureli-rol-en.png)

> [card] 1. The remaining role time
>
> See the date of finish and remaining time by coming on the watch icon.

[Manage user account, products and history →](https://docs.zonely.gen.tr/en/guides/users.md)

> [card] [Non-service authorization](https://docs.zonely.gen.tr/en/integrations/non-service-authorization.md)
>
> Give your long or time-free gaming authority with LuckPerms and follow the remaining time on the user.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.