> ## 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.

# LuckPerms

> Connect the site roles to play groups in the common MySQL store and give unleaded authorization.

LuckPerms connection allows the roles on the site to integrate with the allow groups on the game side.

> [!NOTE]
>
> **Joint Structure and Zero Delay:** Zonely’s main role system and SkinsRestorer tables are in common structure. This is a much more optimized system without extra table cost or an external relay server. The player is reflected in the role and authority defined from the site when entering the server directly into the game.

## Install LuckPerms

[From LuckPerms download page](https://luckperms.net/download/) Get the file that fits your server platform. Dry the plugin and create the first set file. On the Bukkit **plug-ins/LuckPerms/config.yml** the file is used.

## Prepare MySQL storage

Zonely panel **Settings → Database** open the part. Get the address, port, name and access information of your own database. **Integration Builder → LuckPerms** You can get the connection draft from the section.

[![Select the plugin, Pre-configured](https://mintcdn.com/zonely-a8cd49e7/_i4983VN4UZSjv0x/images/panel/system-security-guide-20261027/veritabani-03-en.png?fit=max\&auto=format\&n=_i4983VN4UZSjv0x\&q=85\&s=6a6a6f9be5696a4cdf7ffb879dd39e96)](https://docs.zonely.gen.tr/images/panel/system-security-guide-20261027/veritabani-03-en.png)

> [card] 1. Select the plugin
>
> Open the configuration draft of the plugin you will connect.

> [card] 2. Ready-to-configure
>
> Copy the partition produced by your own link.

```yaml title="plugins/LuckPerms/config.yml" theme={"theme":"css-variables"}
storage-method: mysql
data:
  address: db.example.com:3306
  database: DATABASE_NAME
  username: DATABASE_USER
  password: 'DATABASE_PASSWORD'
  table-prefix: 'zonely_perms_'
sync-minutes: 1
```

**table-prefix** value **zonely\_perms\_** Match as. **sync-minutes: 1**The updates in the warehouse are taken at a minute intervals. Save the file and restart the game server.

***

## Unleaded authorization and role assignment

You can directly export the role of in-game authorizations from console command or delivery without waiting.

### 1. Connect to the game group with the ball

Zonely in the management panel:
**Users → Roller → Role Insert**

1. Type role name (e.g.. `VIP`).
2. **Game Authorization → Authorization Permissions** add group nodes to the field (e.g.. `group.vip`). A same island on the LuckPerms side `vip` group should be defined.
3. Role of permissions on the site **Permits** Select from the tab.

### 2. Set the duration of the role

**Duration** Select the type of validity of the authorization on the tab:

* **Unlimited:** Defines permanent authorization.
* **Limited:** It defines automatic shield authorization after a certain time (e.g... `30d` = 30 days, `10m` = 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 limited or unlimited role type.

> [card] 2. Role time
>
> Enter the validity time for limited authorization.

### 3. Connect to the user or store product

> [tab] Direct assignment to the user
>
> **Roller → Role Ver** Enter the screen. Select the user name and the role you create. **Give** When you press the button, the authorization is written in the database instantly. If the player is in the game `sync-minutes` In the period, the moment when the game is connected to the server is activated.

> [tab] Automatic appointment with store product
>
> **Store → Products** Edit the VIP product to be sold in the section. **General → Roller to be assigned** Select the role you prepare from the field and save the product. When purchasing is completed, the role and authority is defined instantly without delivery.

### 4. Follow the remaining time

When you open user record on the roller page, you can view the remaining time and the date of the end of the clock icon next to the duration of the duration role. When the time expires, the system automatically terminates the role and in-game LuckPerms permissions.

***

[LuckPerms official source](https://github.com/LuckPerms/LuckPerms) · [Roles](https://docs.zonely.gen.tr/en/guides/permissions.md) · [Products](https://docs.zonely.gen.tr/en/guides/products.md) · [Connections and tools](https://docs.zonely.gen.tr/en/integrations/overview.md)


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