LuckPerms Nedir?

LuckPerms, Minecraft sunucuları için modern, yüksek performanslı ve açık kaynaklı bir yetki yönetim pluginidir. PermissionsEx, GroupManager gibi eski alternatiflerin yerini almıştır ve 2026 itibarıyla sektör standardıdır.

  • Yüksek performans — sunucuya lag bindirmez
  • Web tabanlı görsel editör
  • Çoklu platform desteği (Paper, Spigot, BungeeCord, Velocity, Forge, Fabric)
  • Tamamen ücretsiz ve açık kaynak
  • Aktif geliştirme ve topluluk desteği

Kurulum

Bukkit / Spigot / Paper

  • luckperms.net/download adresinden Bukkit jar'ını indirin
  • plugins/ klasörüne koyun
  • Sunucuyu tamamen yeniden başlatın (stop komutu ile, asla /reload kullanmayın)

Forge / Fabric

İlgili platformun jar/mod dosyasını indirip mods/ klasörüne koyun ve sunucuyu yeniden başlatın.

Network (BungeeCord / Velocity)

Network kurulumlarında MySQL veritabanı zorunludur. Tüm backend sunuculara ve proxy'ye LuckPerms kurulmalıdır.

İlk Erişim

LuckPerms ilk kurulduğunda hiç kimsenin LP komutlarına erişimi yoktur. Konsola şunu yazın:

lp user KULLANICI_ADINIZ permission set luckperms.* true

Temel Kavramlar

Gruplar (Groups)

Gruplar, yetkilerin toplandığı kaplardır — rütbe/rank sisteminizin temelini oluştururlar. Örneğin: default, vip, moderator, admin.

Kalıtım (Inheritance)

Bir grup başka bir grubun yetkilerini miras alabilir. Böylece yetkileri tekrar tekrar tanımlamak gerekmez. Örneğin admin grubu moderator'ün tüm yetkilerini otomatik olarak alır.

Meta (Prefix / Suffix)

Oyuncu isimlerinin önüne (prefix) veya arkasına (suffix) eklenen metinler. Weight (ağırlık) sistemi ile öncelik belirlenir.

Web Editör

LuckPerms'ün en güçlü özelliği tarayıcı tabanlı görsel editördür. Komut ezberlemeden tüm yetkileri yönetebilirsiniz:

/lp editor
  • Tarayıcınızda güvenli bir link açılır
  • "+" butonu ile yeni grup oluşturun
  • "Parents" bölümünden kalıtım ayarlayın
  • "Add Permission" kutusuna yetki yazıp ekleyin
  • Sağ üstten "Save" tıklayın
  • Oluşan komutu sunucu konsoluna yapıştırın

Komut Referansı — Kullanıcı

KomutAçıklama
<code>lp user &lt;isim&gt; info</code>Kullanıcı bilgilerini gösterir
<code>lp user &lt;isim&gt; parent set &lt;grup&gt;</code>Birincil grubu ayarlar (diğerlerini temizler)
<code>lp user &lt;isim&gt; parent add &lt;grup&gt;</code>Gruba ekler (mevcut grupları korur)
<code>lp user &lt;isim&gt; parent remove &lt;grup&gt;</code>Gruptan çıkarır
<code>lp user &lt;isim&gt; permission set &lt;yetki&gt; true</code>Yetki verir
<code>lp user &lt;isim&gt; permission unset &lt;yetki&gt;</code>Yetkiyi kaldırır
<code>lp user &lt;isim&gt; promote &lt;track&gt;</code>Track üzerinde terfi ettirir
<code>lp user &lt;isim&gt; demote &lt;track&gt;</code>Track üzerinde rütbe düşürür

Komut Referansı — Grup

KomutAçıklama
<code>lp creategroup &lt;isim&gt;</code>Yeni grup oluşturur
<code>lp deletegroup &lt;isim&gt;</code>Grubu siler
<code>lp listgroups</code>Tüm grupları listeler
<code>lp group &lt;isim&gt; info</code>Grup bilgilerini gösterir
<code>lp group &lt;isim&gt; permission set &lt;yetki&gt; true</code>Gruba yetki verir
<code>lp group &lt;isim&gt; permission unset &lt;yetki&gt;</code>Gruptan yetki kaldırır
<code>lp group &lt;isim&gt; parent add &lt;üst-grup&gt;</code>Kalıtım (miras) ekler
<code>lp group &lt;isim&gt; parent remove &lt;üst-grup&gt;</code>Kalıtımı kaldırır

Prefix, Suffix ve Meta

LuckPerms prefix/suffix'leri dahili olarak yetki düğümü şeklinde saklar. Örneğin [Admin] prefix'i weight 100 ile = prefix.100.[Admin]

KomutAçıklama
<code>lp group &lt;grup&gt; meta addprefix &lt;weight&gt; "&lt;prefix&gt;"</code>Prefix ekler
<code>lp group &lt;grup&gt; meta addsuffix &lt;weight&gt; "&lt;suffix&gt;"</code>Suffix ekler
<code>lp group &lt;grup&gt; meta removeprefix &lt;weight&gt;</code>Prefix kaldırır
<code>lp group &lt;grup&gt; meta removesuffix &lt;weight&gt;</code>Suffix kaldırır
<code>lp user &lt;isim&gt; meta set &lt;key&gt; &lt;value&gt;</code>Özel meta verisi atar
<code>lp user &lt;isim&gt; meta unset &lt;key&gt;</code>Meta verisini siler

Renk Kodları

Prefix/suffix'lerde & işareti ile Minecraft renk kodları kullanılır:

lp group admin meta addprefix 100 "&c[Admin] "
lp group moderator meta addprefix 80 "&6[Mod] "
lp group vip meta addprefix 50 "&9[VIP] "
lp group default meta addsuffix 10 " &8[Oyuncu]"

Weight (Ağırlık) Sistemi

Bir oyuncunun birden fazla prefix/suffix'i olabilir (kalıtım yoluyla). Weight sistemi hangisinin görüntüleneceğini belirler:

  • Yüksek weight = yüksek öncelik
  • Admin (100) > Moderator (80) > VIP (50) > Default (10)
  • Aynı weight'te ise kalıtım ağacında ilk bulunan kullanılır

Context (Bağlam) Sistemi

Context, yetkilerin belirli koşullara bağlı olarak uygulanmasını sağlar:

  • Server context: Network'te belirli sunucuya özel yetkiler
  • World context: Belirli dünyaya özel yetkiler (örn: sadece creative dünyasında fly)
  • Dimension context: Nether/End gibi boyutlara özel
# Sadece survival sunucusunda fly yetkisi
lp user Oyuncu permission set essentials.fly true server=survival

# Sadece creative dünyasında build yetkisi
lp user Oyuncu permission set worldguard.build true world=creative

Track (Rütbe Sıralaması)

Track'ler grupları sıralı bir hiyerarşiye dizer. /promote ve /demote komutları track üzerinde çalışır.

# Track oluştur
lp createtrack main

# Grupları sırasıyla ekle
lp track main append default
lp track main append vip
lp track main append moderator
lp track main append admin

# Oyuncuyu terfi ettir
lp user Oyuncu promote main

# Rütbe düşür
lp user Oyuncu demote main

Storage (Veri Saklama)

YöntemKullanımNot
<strong>H2</strong>Varsayılan, tek sunucuYapılandırma gerektirmez
<strong>MySQL / MariaDB</strong>Network kurulumlarıÇoklu sunucu senkronizasyonu için zorunlu
<strong>PostgreSQL</strong>Alternatif ilişkisel DBGelişmiş kullanım
<strong>MongoDB</strong>NoSQL tercih edenlerÖzel durumlar için

Storage ayarları LuckPerms klasöründeki config.yml dosyasından yapılır:

# config.yml
storage-method: mysql

data:
  address: localhost:3306
  database: luckperms
  username: root
  password: sifreniz
  pool-settings:
    maximum-pool-size: 10

Verbose (Hata Ayıklama)

Verbose modu, sunucudaki tüm yetki kontrollerini gerçek zamanlı izlemenizi sağlar. Eksik yetkileri bulmak için en güvenilir yöntemdir.

KomutAçıklama
<code>lp verbose on</code>Verbose'u açar, chat'e bildirim gönderir
<code>lp verbose record</code>Sessiz kayıt (chat spam'i olmadan)
<code>lp verbose off</code>Kapatır ve sonuçları web viewer'a yükler
<code>lp verbose command &lt;n&gt; &lt;komut&gt;</code>Belirli komutun yetki kontrollerini gösterir

Filtre Kullanımı

# Sadece essentials yetkilerini göster
lp verbose on essentials.*

# LuckPerms kendi kontrollerini hariç tut
lp verbose on !luckperms

# Birden fazla filtre
lp verbose on (essentials.* | minecraft.*)

Eksiksiz Kurulum Örneği

Sıfırdan bir sunucu yetki sistemi kurmak için adım adım:

1. Grupları Oluştur

lp creategroup admin
lp creategroup moderator
lp creategroup vip

2. Kalıtım Ayarla

lp group moderator parent add default
lp group admin parent add moderator

3. Yetkileri Ata

# Admin yetkileri
lp group admin permission set luckperms.* true
lp group admin permission set essentials.ban true
lp group admin permission set essentials.kick true
lp group admin permission set essentials.gamemode true

# Moderator yetkileri
lp group moderator permission set essentials.kick true
lp group moderator permission set essentials.mute true
lp group moderator permission set essentials.tp true

# VIP yetkileri
lp group vip permission set essentials.kit.vip true
lp group vip permission set essentials.sethome.multiple.5 true

4. Prefix/Suffix Ekle

lp group admin meta addprefix 100 "&c[Admin] "
lp group moderator meta addprefix 80 "&6[Mod] "
lp group vip meta addprefix 50 "&9[VIP] "
lp group default meta addprefix 10 "&7"

5. Track Oluştur

lp createtrack main
lp track main append default
lp track main append vip
lp track main append moderator
lp track main append admin

6. Oyuncuyu Gruba Ata

lp user OyuncuAdi parent set vip

# veya track üzerinde terfi
lp user OyuncuAdi promote main

Sık Yapılan Hatalar

  • Prefix görünmüyor: Vault ve EssentialsX Chat kurulu mu kontrol edin
  • /reload sonrası sorunlar: Asla /reload kullanmayın, sunucuyu stop ile kapatıp açın
  • Yetki çalışmıyor: /lp verbose on ile hangi yetkinin kontrol edildiğini bulun
  • Network'te senkronizasyon: Tüm sunucularda aynı MySQL bağlantısı olmalı, lp networksync çalıştırın
  • Yanlış prefix gösteriliyor: Weight değerlerini kontrol edin, yüksek weight = yüksek öncelik

Faydalı Kaynaklar