mcMMO Rewards: Minecraft'ta seviye ödülü eklentisine genel bakış
Minecraft sunucuları için mcMMO Rewards eklentisine kapsamlı bakış: seviye atlama tetikleyicilerini, komutları yapılandırma ve mcMMO API…
Minecraft sunucuları için mcMMO Rewards eklentisine kapsamlı bakış: seviye atlama tetikleyicilerini, komutları yapılandırma ve mcMMO API entegrasyonu.
Gereksinimler:
Loader: Paper / Spigot / Purpur
Minecraft sürümü: 1.20.x – 1.21.10
Eklentiler: McMMO
Popüler RPG sistemi mcMMO, Minecraft sunucularına balıkçılık, maden çıkarma veya bitkicilik gibi beceri seviyelendirme mekanikleri ekler. Ancak orijinal eklentinin geliştiricileri, oyuncular belirli seviyelere ulaştığında otomatik olarak eşya, para birimi veya özel unvan vermek için esnek bir sistem tasarlamamıştır. Yardımcı eklenti mcMMO Rewards tam olarak bu sorunu çözer. mcMMO'nun seviye sistemini sunucu konsol komutlarıyla ilişkilendirerek sunucu sahiplerinin karmaşık betikler yazmadan aktif oyuncular için otomatik ödüller oluşturmasını sağlar.
Olay İşleme ve API Entegrasyonu
mcMMO Rewards, Spigot/Paper sunucu çekirdeğine doğrudan entegre olan ve mcMMO eklentisinin resmi API'siyle iletişim kuran hafif bir event listener (olay dinleyici) olarak çalışır.
McMMOPlayerLevelUpEvent Olayının Yakalanması
Bir oyuncu herhangi bir beceride seviye atladığında (örneğin maden çıkararak veya ürün toplayarak), mcMMO bir McMMOPlayerLevelUpEvent olayı tetikler. mcMMO Rewards bu olayı yakalar ve şu mantığı çalıştırır:
Beceri adını ve oyuncunun ulaştığı yeni seviyeyi okur.
Bu verileri
config.ymlyapılandırma dosyasında tanımlanan ödül listeleriyle karşılaştırır.Bir eşleşme bulunursa, eklenti konsol adına yapılandırılmış komut listesini çalıştırır ve
%player%yer tutucusunun yerine oyuncunun adını koyar.
Olay İşlemenin Önemli Sınırlamaları
Eklenti yalnızca McMMOPlayerLevelUpEvent olayına bağlı olduğundan, sadece oyun sırasında doğal yollarla kazanılan seviye atlamalarına tepki verir. ⚠️ Seviye sıfırlamaları ve veritabanı değişiklikleri: bir yönetici, oyuncunun seviyesini doğrudan SQLite/MySQL veritabanı dosyaları üzerinden değiştirirse (örneğin istatistik taşıma veya wipe sırasında) ya da standart seviye atlama olayını tetiklemeden seviye değerini değiştiren konsol komutları kullanırsa, ödüller etkinleştirilmez. Eklenti ayrıca geriye dönük ödül verilmesini de desteklemez: bir oyuncu mcMMO Rewards kurulmadan önce zaten 50. seviyeye ulaşmışsa, bir sonraki seviyeye ulaşana kadar geçmişte aştığı seviyelerin (10, 20 vb.) ödüllerini almaz.
config.yml Yapısı ve Ödül Ayarları
Tüm ödüller tek bir yapılandırma dosyasında tanımlanır: plugins/mcMMORewards/config.yml. YAML'ın basit söz dizimi sayesinde geliştiriciler hızlıca çok katmanlı ödül sistemleri oluşturabilir.
Yapılandırma Söz Diziminin Açıklaması
Her ödül bloğu sıkı bir hiyerarşiyi takip eder:
Beceri adı (Skill): mcMMO'daki resmi beceri adıyla eşleşmelidir (örneğin
mining,woodcutting,swords,herbalism).Seviye (Level): komutların çalıştırılacağı seviyeyi belirten bir tam sayı.
Komut listesi: konsol eylemlerinin listesi. Komutların başına eğik çizgi
/eklemeye gerek yoktur, çünkü hepsi doğrudan sunucu tarafından konsol adına (OP seviyesinde) çalıştırılır.
Örnek Yapılandırma Dosyası
Aşağıda, eşya ve para vermek için doğru şekilde yapılandırılmış bir dosya örneği bulunmaktadır:
rewards:
mining:
10:
- "give %player% iron_ingot 5"
- "broadcast &6[RPG] &e%player% &fдосяг 10-го рівня видобутку руди!"
50:
- "eco give %player% 1000"
- "give %player% diamond 3"
swords:
25:
- "xp give %player% 500"Bu örnekte, %player% oyuncusu mining becerisinde 10. seviyeye ulaştığında demir külçe alır ve tüm sunucuya bir mesaj yayınlanır. 50. seviyeye ulaştığında oyuncu bir ekonomi eklentisi (örneğin EssentialsX) aracılığıyla 1000 birim para ve 3 elmas alır.
Eklentiyi Yönetme: Komutlar ve İzinler
mcMMO Rewards çok kompakt bir eklenti olduğundan, komut ve izin listesi yalnızca yönetimsel işlevlerle sınırlıdır.
Yapılandırmayı Yeniden Yükleme Komutu
config.yml dosyasındaki herhangi bir değişikliği uygulamak için tüm Minecraft sunucusunu yeniden başlatmaya veya oyunu kesintiye uğratmaya gerek yoktur. Sadece şu komutu çalıştırmak yeterlidir: /mcmmorewards reload Bu komut eski ayarları sunucunun belleğinden kaldırır ve yapılandırma dosyasını yeniden okuyarak yeni ödülleri anında uygular.
Yönetici İzinleri (Permissions)
Sunucu güvenliği için, yeniden yükleme komutunu çalıştırma yeteneği özel bir izne (permission node) bağlıdır. Sıradan oyuncuların bu komuta erişimi yoktur. Bir yöneticiye veya moderatöre bu hakkı vermek için (örneğin LuckPerms üzerinden), şu düğümü kullanın: mcmmorewards.reload Varsayılan olarak bu izin, sunucu operatörü (OP) statüsüne sahip her oyuncuya otomatik olarak verilir.
Sonuç
mcMMO Rewards, mcMMO beceri sistemini kullanan RPG ve survival öğeleri içeren Minecraft sunucuları için mükemmel bir yardımcı araçtır. Karmaşık betik dilleri öğrenmeye veya ağır betikler kullanmaya gerek kalmadan, oyun içi aktivite için otomatik ödül dağıtımını kolayca ayarlamayı sağlar.
mcMMO olaylarını dinlemek için kendi söz dizimini yazmayı gerektiren Skript gibi karmaşık betikler veya tam teşekküllü görev eklentileriyle karşılaştırıldığında, mcMMO Rewards mümkün olduğunca basit ve hızlı kurulabilen, sunucu kaynaklarını neredeyse hiç tüketmeyen bir sistem sunar. Bununla birlikte, mcMMO eklentisinin kurulu olmasına tamamen bağımlı olması ve komutların yalnızca konsol adına çalıştırılabilmesi, başlıca sınırlamalarıdır. Bu eklenti, kaynak toplama veya savaş becerilerini geliştirme için hızlıca basit ödüller eklemek isteyen sunucular için mükemmel bir seçimdir.
Kurulum
Tipik bir kurulum yaklaşık 5 dakika sürer. Akış aynıdır; yalnızca loader ve uygun build değişir.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.











