LuckPerms ile Minecraft Yetki Sistemi Kurma

LuckPerms kurulumu, Minecraft sunucusunda yetki sistemi kurmanın en hızlı yoludur: platformunuza uygun jar dosyasını plugins klasörüne kopyalar, sunucuyu yeniden başlatır ve /lp creategroup vip gibi tek satırlık komutlarla grupları oluşturmaya başlarsınız. Yapılandırma dosyası düzenlemek zorunlu değildir; her işlem oyun içi komutlarla ya da web editörüyle yapılabilir.

LuckPerms bugün Minecraft ekosisteminde izin yönetiminin standart aracıdır. Eskiden yaygın olan PermissionsEx ve GroupManager geliştirilmeyi bıraktı ve modern sürümlerde çalışmıyor; bu yüzden 2026 sunucularında pratikte tek gerçek seçenek LuckPerms. Güncel sürüm 5.5.57, Minecraft 26.2 “Chaos Cubed” dâhil bütün modern sürümleri destekliyor.

Bu rehberde grup hiyerarşisi kurmayı, izin düğümlerini vermeyi, prefix ve suffix ayarlamayı, sunucu ve dünya bazlı bağlam (context) kullanmayı, web editörünü ve /lp verbose ile hata ayıklamayı adım adım göreceksiniz.

LuckPerms Ne Yapar, Ne Yapmaz?#

LuckPerms bir izin motorudur. Hangi oyuncunun hangi komutu kullanabileceğini, hangi gruba ait olduğunu ve o grubun hangi metadata değerlerini taşıdığını saklar. Sunucudaki diğer eklentiler bir komut çalıştırılmadan önce LuckPerms’e “bu oyuncunun essentials.fly izni var mı?” diye sorar.

Buna karşılık LuckPerms ekrana hiçbir şey basmaz. Prefix’i saklar ama sohbette göstermez; bunu yapan EssentialsXChat, TAB veya benzeri bir eklentidir. Aynı şekilde arazi koruma, ekonomi ve ışınlanma da LuckPerms’in işi değildir. Tipik bir kurulumda LuckPerms, EssentialsX, Vault ve WorldGuard birlikte çalışır.

Platform ve Sürüm Seçimi#

LuckPerms indirme sayfasında her platform için ayrı jar sunar. Yanlış yapıyı indirmek en sık yapılan hatadır: Paper sunucusuna Velocity jar’ı atarsanız eklenti hiç yüklenmez.

Bir sunucu ağı işletiyorsanız hem proxy’ye hem alt sunuculara LuckPerms kurmanız ve hepsini aynı veritabanına bağlamanız gerekir. Ağ mimarisi için BungeeCord ve Velocity ile sunucu ağı kurulumu sayfasına bakın.

İndirmeniz Gereken Dosyalar#

LuckPerms Kurulumu: Adım Adım#

1. Jar dosyasını yükleyin ve sunucuyu yeniden başlatın#

   Doğru platform yapısını plugins klasörüne kopyalayın. Yükleme yöntemleri plugin kurulumu rehberinde ayrıntılı anlatılıyor. Ardından konsola stop yazıp sunucuyu düzgün kapatın ve tekrar başlatın; /reload kullanmayın.

2. Kurulumu doğrulayın#

   Sunucu açıldığında konsolda aşağıdaki komutu çalıştırın. Sürüm bilgisi, depolama yöntemi ve yüklü grup sayısı listeleniyorsa kurulum tamamdır.

   /lp info

3. Herkesi OP’tan çıkarın#

   Bukkit’te OP olan oyuncu bütün izin kontrollerini atladığı için LuckPerms grupları OP’lerde hiçbir etki göstermez. Kurucular dâhil herkesi OP listesinden çıkarın ve yetkiyi gruplar üzerinden verin. İki yaklaşımın farkı OP verme ve yetki yönetimi sayfasında karşılaştırılıyor.

   /deop KullaniciAdi

4. /op komutunu tamamen kapatın#

   plugins/LuckPerms/config.yml dosyasında enable-ops değerini false yapın. Böylece hiç kimse, konsol dâhil, kimseyi OP yapamaz ve tüm yetki tek noktadan yönetilir.

   enable-ops: false
   auto-op: false
   commands-allow-op: false

5. İlk gruplarınızı oluşturun#

   Kurulumdan sonra yalnızca default grubu vardır ve silinemez; yeni katılan her oyuncu otomatik olarak bu gruba düşer.

   /lp creategroup vip
   /lp creategroup vipplus
   /lp creategroup yetkili
   /lp creategroup admin

Depolama Seçimi: H2 mi MySQL mi?#

LuckPerms varsayılan olarak H2 dosya veritabanı kullanır ve bu tek sunuculu kurulumlarda tamamen yeterlidir; ek yapılandırma istemez, yedeklemesi de klasörü kopyalamak kadar basittir. Ancak lobi, survival ve minigame sunucularının aynı yetkileri paylaşması gerekiyorsa MySQL şarttır.

MySQL’e geçmek için plugins/LuckPerms/config.yml dosyasını düzenleyip sunucuyu yeniden başlatın:

storage-method: mysql

data:
  address: 127.0.0.1:3306
  database: luckperms
  username: luckperms
  password: 'guclu-bir-parola'
  table-prefix: 'luckperms_'
  pool-settings:
    maximum-pool-size: 10
    minimum-idle: 5
    connection-timeout: 5000

messaging-service: auto
sync-minutes: 3
server: lobi

server anahtarı ağdaki her sunucuda farklı olmalıdır; sunucu bazlı izin verirken bu ad kullanılır. messaging-service: auto ise bir sunucuda yapılan değişikliğin diğerlerine anında yayılmasını sağlar; bu satır olmadan değişiklikler ancak sync-minutes dolduğunda görünür.

Grup Hiyerarşisi ve Kalıtım (Inheritance)#

LuckPerms’in en güçlü yanı kalıtımdır. Bir grubu başka bir grubun ebeveyni yaptığınızda alt grup, üst grubun tüm izinlerini otomatik devralır. Böylece essentials.home iznini beş ayrı gruba tek tek yazmak zorunda kalmazsınız.

/lp group vip parent add default
/lp group vipplus parent add vip
/lp group yetkili parent add vipplus
/lp group admin parent add yetkili

Bu zincirde admin, kendisinden aşağıdaki bütün grupların izinlerine sahiptir. Sıralamayı netleştirmek için her gruba bir ağırlık (weight) verin; ağırlık, prefix çakışmalarında hangi değerin kazanacağını da belirler.

/lp group default setweight 0
/lp group vip setweight 10
/lp group yetkili setweight 50
/lp group admin setweight 100

İzin Verme, Geri Alma ve Negatif İzinler#

İzin düğümleri her eklentinin kendi dokümanında yazar. Komut kalıbı her zaman aynıdır:

/lp group vip permission set essentials.back true
/lp group vip permission set essentials.sethome.multiple.vip true
/lp group yetkili permission set essentials.ban true
/lp group vip permission unset essentials.back
/lp group vip permission set essentials.tpahere false

Üç farklı durum vardır ve karıştırılmaları çok yaygındır. true izni açar, unset düğümü tamamen kaldırır (kalıtımdan gelen izin yine geçerli olur), false ise izni açıkça reddeder ve kalıtımdan gelen izni bile ezer. Bir üst gruptan gelen bir yetkiyi tek bir grupta kapatmak istiyorsanız false kullanmalısınız.

Oyuncuyu bir gruba almak, süreli üyelik vermek ve kontrol etmek için:

/lp user Oyuncu parent add vip
/lp user Oyuncu parent addtemp vip 30d
/lp user Oyuncu parent remove vip
/lp user Oyuncu info
/lp user Oyuncu permission check essentials.fly

addtemp ile verilen VIP üyeliği süre dolduğunda otomatik düşer; el yordamıyla takip etmeniz gerekmez. Süre birimi 30d, 12h, 90m biçiminde yazılır.

Prefix, Suffix ve Sohbet Görünümü#

Prefix ve suffix LuckPerms’te birer metadata değeridir. Öncelik numarası, oyuncu birden fazla gruba üyeyse hangi prefix’in görüneceğini belirler; büyük sayı kazanır.

/lp group vip meta setprefix 10 "&6[VIP] &f"
/lp group yetkili meta setprefix 50 "&4[Yetkili] &f"
/lp group admin meta setprefix 100 "&c[Admin] &f"
/lp group vip meta setsuffix 10 " &e★"

Bu komutları çalıştırdıktan sonra sohbette hiçbir değişiklik görmüyorsanız sebep neredeyse her zaman aynıdır: prefix’i ekrana basacak eklenti yok. EssentialsXChat kurun, Vault’un yüklü olduğundan emin olun ve plugins/Essentials/config.yml içindeki sohbet biçimine yer tutucuyu ekleyin:

chat:
  format: '{PREFIX}&f{DISPLAYNAME}{SUFFIX}&7: &f{MESSAGE}'

Sunucu ve Dünya Bazlı İzinler (Context)#

Bağlam sistemi, aynı izni yalnızca belirli bir sunucuda veya dünyada geçerli kılmanızı sağlar. Komutun sonuna server= ve world= ekleyerek kullanılır.

/lp group vip permission set essentials.fly true server=lobi
/lp group vip permission set worldedit.wand true world=yapi_dunyasi
/lp group default permission set essentials.tpa false world=minigame

İlk satır uçma iznini yalnızca lobi sunucusunda açar; oyuncu survival sunucusuna geçtiğinde uçamaz. Bu, ağ yapılarında en çok kullanılan özelliktir ve her sunucuya ayrı grup açma zahmetinden kurtarır. Bağlamların çalışması için config.yml içindeki server değerinin her sunucuda farklı yazılmış olması gerekir.

Track ile terfi sistemi#

Track, grupları sıralı bir merdivene dizer; böylece tek komutla terfi ve tenzil yapabilirsiniz. Otomatik rank satın alma eklentileri de bu yapıyı kullanır.

/lp createtrack ranklar
/lp track ranklar append default
/lp track ranklar append vip
/lp track ranklar append vipplus
/lp user Oyuncu promote ranklar
/lp user Oyuncu demote ranklar

Web Editörü ve Hata Ayıklama#

Onlarca izin düğümünü komut satırından girmek yorucudur. /lp editor yazdığınızda konsola tek kullanımlık bir bağlantı düşer; bağlantıyı tarayıcıda açıp grupları, izinleri ve prefix’leri tablo hâlinde düzenlersiniz. Kaydettiğinizde verilen kodu sunucuda uygularsınız:

/lp editor
/lp applyedits abc123xyz

Bir izin çalışmıyorsa hangi düğümün sorulduğunu görmek en hızlı teşhis yöntemidir. Verbose modu açın, sorunlu komutu çalıştırın ve sonucu raporlayın:

/lp verbose on
/lp verbose paste
/lp verbose off

/lp verbose paste komutu, o sırada kontrol edilen tüm izin düğümlerini bir bağlantı hâlinde verir. Çoğu zaman eklentinin dokümanında yazan düğümle gerçekte sorduğu düğümün farklı olduğunu burada görürsünüz. Diğer tanı komutları için sunucu konsol komutları sayfası işinize yarar.

Yedekleme ve Göç#

İzin verisi kaybolduğunda sunucudaki bütün rank ve VIP satın alımları uçar. LuckPerms bunu tek komutla dışa aktarır:

/lp export yedek-2026-08
/lp import yedek-2026-08

Dosya plugins/LuckPerms/export klasöründe .json.gz olarak oluşur; haftalık yedek planınıza bu klasörü de ekleyin. Genel yedek stratejisi için Minecraft sunucu yedekleme rehberini takip edebilirsiniz.

Eski bir izin eklentisinden geçiyorsanız iki eklentiyi kısa süreliğine birlikte kurup göç komutunu çalıştırın, sonra eskisini kaldırın:

/lp migration permissionsex
/lp migration groupmanager
/lp listgroups

Performans ve Sunucu Tarafı Notlar#

LuckPerms izin kontrollerini bellekte önbellekler, bu yüzden TPS üzerinde ölçülebilir bir yükü yoktur. Yine de eklenti sayısı arttıkça toplam bellek ihtiyacı büyür: LuckPerms, EssentialsX, WorldGuard, Vault ve PlaceholderAPI’nin birlikte çalıştığı bir Paper sunucusunda 2-10 oyuncu için 8 GB, 10-30 oyuncu için 10-12 GB, 30-60 oyuncu için 16 GB RAM planlayın.

İşlemci tarafında saat hızı belirleyicidir; Minecraft’ın ana tick döngüsü tek çekirdekte çalıştığı için AMD Ryzen 9 7900X sınıfı yüksek frekanslı bir işlemci, çok çekirdekli ama düşük frekanslı sunucu işlemcilerinden çok daha iyi sonuç verir. MySQL depolaması kullanıyorsanız veritabanının da NVMe SSD üzerinde durması gecikmeyi düşürür. Uygun paketleri Minecraft sunucu paketleri sayfasından karşılaştırabilir, ayrıntılı hesaplama için RAM tablosuna bakabilirsiniz.

Özetle#

LuckPerms ile yetki sistemi kurmanın sırası şudur: doğru platform jar’ını yükleyin, sunucuyu yeniden başlatın, herkesi OP’tan çıkarıp enable-ops değerini kapatın, grupları oluşturun ve parent add ile kalıtım zincirini kurun. Ardından her gruba ağırlık ve prefix verin, izinleri joker düğüm yerine tek tek tanımlayın, ağ kullanıyorsanız MySQL ve messaging-service ayarını yapın.

Sorun çıktığında ilk refleksiniz /lp verbose on olsun; eksik iznin gerçek adını size o söyler. Kurulum bittikten sonra EssentialsX yapılandırması ile komut izinlerini eşleştirin ve 2026 eklenti listesinden sunucunuza uygun diğer eklentileri seçin.