LuckPerms Yetki Yönetimi: Eksiksiz Türkçe Rehber

Kurulum, komutlar, grup sistemi, kalıtım, prefix/suffix, web editör, context, weight, storage, verbose — tüm LuckPerms wiki Türkçe.

45 dk okuma

# 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

Kutsal Üçlü: LuckPerms tek başına yetmez. Chat'te prefix/suffix görmek için Vault + EssentialsX Chat pluginlerini de kurmanız gerekir.

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

/reload komutu LuckPerms'ü bozabilir. Her zaman sunucuyu tamamen kapatıp açı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

Web editör oturum bazlıdır — her açtığınızda yeni link oluşur. Değişiklikler kaydedilmeden sunucuya yansımaz.

# Komut Referansı — Kullanıcı

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

# Komut Referansı — Grup

Komut	Açıklama
`lp creategroup <isim>`	Yeni grup oluşturur
`lp deletegroup <isim>`	Grubu siler
`lp listgroups`	Tüm grupları listeler
`lp group <isim> info`	Grup bilgilerini gösterir
`lp group <isim> permission set <yetki> true`	Gruba yetki verir
`lp group <isim> permission unset <yetki>`	Gruptan yetki kaldırır
`lp group <isim> parent add <üst-grup>`	Kalıtım (miras) ekler
`lp group <isim> parent remove <üst-grup>`	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]

Komut	Açıklama
`lp group <grup> meta addprefix <weight> "<prefix>"`	Prefix ekler
`lp group <grup> meta addsuffix <weight> "<suffix>"`	Suffix ekler
`lp group <grup> meta removeprefix <weight>`	Prefix kaldırır
`lp group <grup> meta removesuffix <weight>`	Suffix kaldırır
`lp user <isim> meta set <key> <value>`	Özel meta verisi atar
`lp user <isim> meta unset <key>`	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

Weight sadece prefix/suffix için değil, grup sıralaması için de önemlidir. Grup weight'ini /lp editor üzerinden ayarlayabilirsiniz.

# 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öntem	Kullanım	Not
H2	Varsayılan, tek sunucu	Yapılandırma gerektirmez
MySQL / MariaDB	Network kurulumları	Çoklu sunucu senkronizasyonu için zorunlu
PostgreSQL	Alternatif ilişkisel DB	Gelişmiş kullanım
MongoDB	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

Storage değiştirmeden önce sunucuyu tamamen durdurun. /reload kullanmayın.

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

Komut	Açıklama
`lp verbose on`	Verbose'u açar, chat'e bildirim gönderir
`lp verbose record`	Sessiz kayıt (chat spam'i olmadan)
`lp verbose off`	Kapatır ve sonuçları web viewer'a yükler
`lp verbose command <n> <komut>`	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

Sunucu yetki sisteminizi biz kuralım

LuckPerms kurulum, yapılandırma ve özel yetki sistemi tasarımı hizmeti veriyoruz. Teklif alın →