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

# LuckPerms

> LuckPerms is one of the most flexible permission management plugins developed for Minecraft. It allows you to assign different roles and permissions to players on your server. It integrates perfectly with the site’s role system, enabling you to manage roles and permissions easily without using complex in-game commands.

Before integrating your website with LuckPerms, ensure you are using the latest official version. You can download the newest LuckPerms release here:

Download Link: [https://luckperms.net/download/](https://luckperms.net/download/)

Using **Zonely**, you can assign time-limited or permanent roles that automatically sync to the game. You can add timed roles to products and define other roles effortlessly. When a player joins the server, their assigned permissions will automatically apply to their account.

## 1. Connect the plugin to the database

First, open the `/plugins/LuckPerms/config.yml` file in your server’s main directory. Edit the database configuration section as shown below:

```yaml theme={null}
data:
  address: DATABASE_HOST:DATABASE_PORT
  database: DATABASE_NAME
  username: DATABASE_USERNAME
  password: 'DATABASE_PASSWORD'
  pool-settings:
    maximum-pool-size: 3
    minimum-idle: 1
    maximum-lifetime: 1140000
    keepalive-time: 0
    connection-timeout: 5000
    properties:
      useUnicode: true
      characterEncoding: utf8
  table-prefix: 'zonely_perms_' # Required for compatibility with the website.
  mongodb-collection-prefix: ''
  mongodb-connection-uri: ''
```

Replace all placeholder values with your actual database credentials.

<Warning>
  If database credentials are incorrect or incompatible with other systems, the plugin may fail to work or cause server errors.
</Warning>

<Check>
  LuckPerms setup completed successfully. **Congratulations!**
</Check>