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

> Site rollerini ortak MySQL deposundaki oyun gruplarına bağlayın ve teslimatsız yetki verin.

LuckPerms bağlantısı, sitedeki rollerin oyun tarafındaki izin gruplarıyla entegre çalışmasını sağlar.

> [!NOTE]
>
> **Ortak Yapı ve Sıfır Gecikme:** Zonely'nin ana rol sistemi ve SkinsRestorer tabloları ortak yapıdadır. Bu sayede ekstra tablo maliyeti veya harici bir relay sunucusu olmadan çok daha optimize bir sistem sunulur. Oyuncu sunucuya girdiği anda siteden tanımlanan rol ve yetkisi doğrudan oyun içerisine yansır.

## LuckPerms’i kurun

[LuckPerms indirme sayfasından](https://luckperms.net/download/) sunucu platformunuza uygun dosyayı alın. Eklentiyi kurup ilk ayar dosyasını oluşturun. Bukkit tarafında **plugins/LuckPerms/config.yml** dosyası kullanılır.

## MySQL deposunu hazırlayın

Zonely panelinde **Ayarlar → Veritabanı** bölümünü açın. Kendi veritabanınızın adresini, portunu, adını ve erişim bilgilerini alın. **Entegrasyon Oluşturucu → LuckPerms** bölümünden bağlantı taslağını alabilirsiniz.

[![Eklentiyi seçin, Hazır yapılandırma](https://mintcdn.com/zonely-a8cd49e7/_i4983VN4UZSjv0x/images/panel/system-security-guide-20261027/veritabani-03.png?fit=max\&auto=format\&n=_i4983VN4UZSjv0x\&q=85\&s=5e4fb7050d93e5bbb3140e0cfd2611f1)](https://docs.zonely.gen.tr/images/panel/system-security-guide-20261027/veritabani-03.png)

> [card] 1. Eklentiyi seçin
>
> Bağlayacağınız eklentiye ait yapılandırma taslağını açın.

> [card] 2. Hazır yapılandırma
>
> Kendi bağlantınıza göre üretilen bölümü kopyalayın.

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

**table-prefix** değerini **zonely\_perms\_** olarak eşleştirin. **sync-minutes: 1**, depodaki güncellemelerin bir dakikalık aralıklarla alınmasını sağlar. Dosyayı kaydedip oyun sunucusunu yeniden başlatın.

***

## Teslimatsız yetki ve rol atama

Bir site rolünü LuckPerms grubuna bağlayarak oyun içi yetkileri konsol komutu veya teslimat beklemeden doğrudan rol üzerinden verebilirsiniz.

### 1. Rolü oyun grubuna bağlayın

Zonely yönetim panelinde:
**Kullanıcılar → Roller → Rol Ekle**

1. Rol adını yazın (örn. `VIP`).
2. **Oyun Yetkisi → Yetki İzinleri** alanına ilgili grup düğümünü ekleyin (örn. `group.vip`). LuckPerms tarafında da aynı ada sahip bir `vip` grubu tanımlı olmalıdır.
3. Sitedeki izinlerini rolün **İzinler** sekmesinden belirleyin.

### 2. Rolün süresini belirleyin

**Süre** sekmesinde yetkinin geçerlilik türünü seçin:

* **Sınırsız:** Kalıcı yetki tanımlar.
* **Sınırlı:** Belirli bir süre sonra otomatik kalkan yetki tanımlar (örn. `30d` = 30 gün, `10m` = 10 dakika).

[![Süre türü, Rol süresi](https://mintcdn.com/zonely-a8cd49e7/grsNKI9o8QwBbkcr/images/panel/roles-guide-20261025/r11-sure.png?fit=max\&auto=format\&n=grsNKI9o8QwBbkcr\&q=85\&s=5b90cc70bb1270156f7d12cadc5aa6e2)](https://docs.zonely.gen.tr/images/panel/roles-guide-20261025/r11-sure.png)

> [card] 1. Süre türü
>
> Sınırlı veya sınırsız rol türünü seçin.

> [card] 2. Rol süresi
>
> Sınırlı yetki için geçerlilik süresini girin.

### 3. Kullanıcıya veya mağaza ürününe bağlayın

> [tab] Kullanıcıya doğrudan atama
>
> **Roller → Rol Ver** ekranına girin. Kullanıcı adını ve oluşturduğunuz rolü seçin. **Ver** butonuna bastığınızda yetki anında veritabanına yazılır. Oyuncu oyundaysa `sync-minutes` periyodunda, oyunda değilse sunucuya bağlandığı an yetki devreye girer.

> [tab] Mağaza ürünüyle otomatik atama
>
> **Mağaza → Ürünler** bölümünden satılacak VIP ürününü düzenleyin. **Genel → Atanacak Roller** alanından hazırladığınız rolü seçip ürünü kaydedin. Satın alma tamamlandığında rol ve yetki teslimatsız olarak anında hesaba tanımlanır.

### 4. Kalan süreyi takip edin

Roller sayfasında kullanıcı kaydını açtığınızda süreli rolün yanındaki saat simgesinden kalan süreyi ve bitiş tarihini görüntüleyebilirsiniz. Süre dolduğunda sistem rolü ve oyun içi LuckPerms izinlerini otomatik olarak sonlandırır.

***

[LuckPerms resmi kaynak](https://github.com/LuckPerms/LuckPerms) · [Roller](https://docs.zonely.gen.tr/guides/permissions.md) · [Ürünler](https://docs.zonely.gen.tr/guides/products.md) · [Bağlantılar ve araçlar](https://docs.zonely.gen.tr/integrations/overview.md)


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