Yapılandırma başvurusu

config.yml, operatörün sahip olduğu kontrol yüzeyidir. ReferralTrack özelleştirilmiş bir dosyanın üzerine sessizce yazmaz. Şema sürümü değiştiğinde eklenti özgün dosyayı config.yml.bak-v<old> olarak saklar, tam yeni başvuruyu config.new-v<new>.yml dosyasına yazar, etkin dosyada yalnızca sürüm işaretini günceller ve açılışta eksik yolları bildirir. Bukkit'in pakete dahil varsayılanları, operatör bunları kopyalayana veya özelleştirene kadar yeni seçeneklerin çalışır kalmasını sağlar.

Yönetim erişimi ayrıntılı Bukkit izin düğümlerini kullanır ve OP ya da sabit bir API bağımlılığı olmadan LuckPerms ile çalışır. Bkz. Komutlar ve izinler; referraltrack.admin tüm erişimi veren üst izin olmaya devam eder.

Ana sistemler #

• database: SQLite veya MySQL/MariaDB bağlantısı ve sınırlı havuz zamanlamaları. Kimlik bilgilerini gizli tutun.
• referral: talep politikası, bilinen kaynaklar, kişisel kodlar, doğrulama, ödül sınırları, komutlar, kilometre taşları ve elde tutma atfı.
• campaigns: motor anahtarı, saat dilimi ve bağımsız kampanya tarihleri, filtreler, kodlar, çarpanlar, ödüller ve kilometre taşları. Bkz. Kampanyalar.
• fraud: risk motoru anahtarı, yetkili inceleme eşiği ve hesap/oynama süresi sinyalleri. Bkz. Hile incelemesi.
• discord: isteğe bağlı webhook rotaları, raporlar, canlı istatistik güncelleme aralığı, markalı embed alanları ve güvenli HTTPS medya/düğme URL'leri. Tam bir Discord botu bu sürümün parçası değildir.
• integrations.developer-api: salt okunur eşzamansız API için Bukkit ServicesManager kaydı. events.pre-claim ve events.claim-result, iki herkese açık talep olayını bağımsız olarak denetler; API'yi kapatmak ikisini de kapatır. Bkz. Geliştirici API'si.
• text-formatting: MiniMessage biçimlendirmesini ve eski ampersand kodlarını bağımsız olarak etkinleştirir. Tanınan MiniMessage gradyanları, gökkuşağı, RGB renk ve stil etiketleri & ve &#RRGGBB ile bir arada bulunabilir; sıradan açılı parantezli yer tutucular olduğu gibi kalır.
• player-interface: AUTO, INVENTORY veya DIALOG seçer. AUTO, mevcutsa Paper'ın yerel Java Dialog API'sini kullanır, aksi halde bağımsız envanteri açar. Diyalog gövdesi/düğme genişlikleri, sütunlar, duraklatma/kaçış davranışı ve geri dönüş politikası sınırlıdır ve yapılandırılabilir. Diyalog metni ve dört düğme etiketinin tümü dashboard.dialog-* altında yerelleştirilir. /referral inventory her zaman bağımsız menüyü açar.
• player-feedback.claim: talep başlığı, alt başlığı, action bar, ses ve parçacık denetimleri. Her kanalın kendi anahtarı vardır; başlık zamanlamaları, ses seviyesi/perdesi ve parçacık sayısı/kayması/hızı sınırlıdır. Parçacık animasyonu sınırlı BURST, RING ve HELIX şekillerini destekler; kareler, aralık, yarıçap ve yükseklik yapılandırılabilir. Geçersiz ses, parçacık veya animasyon değerleri, yalnızca bir kez verilen bir tanılamayla sessizce yumuşak şekilde başarısız olur.
• onboarding: ilk başlangıç rehberliği, otomatik salt okunur doğrulama ve bildirilen en fazla bulgu sayısı. /referraltrack validate; veritabanı/havuz sınırlarını, davet kimliği ve ödül kısıtlarını, doğrulama/hile eşiklerini, rapor zamanlamalarını, pasif ağ düğümlerini ve etkin ama yapılandırılmamış Discord'u denetler. Yolları ve güvenli beklentileri bildirir, yapılandırılmış gizli değerleri asla.
• velogrowth: kalite sıralama anahtarı, asgari örneklem, liderlik tablosu boyutu, değerlendirme penceresi ve altı göreli ağırlık. Ham hacim yalnızca uygunluğu belirler. Doğrulama, ret güvenliği, risk güvenliği ve olgun D1/D7/D30 elde tutma 0–100 puana katkıda bulunur; olgunlaşmamış kohortlar dışarıda bırakılır ve her girdi /referraltrack growth ile gösterilir.
• campaign-guard: etkinleştirme ön kontrol anahtarı, yakında bitiyor penceresi, ödül çarpanı uyarısı, en fazla komut sayısı, eksik ekonomi önem düzeyi ve yapılandırılabilir talep başına/tahmini toplam para eşikleri. Toplam tahmini exposure.expected-claims kullanır. Kritik bulgular kampanyanın etkinleştirilmesini ve motorun açılmasını engeller; uyarılar kampanyayı sessizce değiştirmeden görünür kalır.
• reward-rescue: yetkili izni, liste boyutu, bekleyen/takılı yaş eşikleri ve en fazla manuel deneme sayısı. /referraltrack rescue, retry veya cancel komutu confirm ve yazdırılabilir bir gerekçe içermedikçe salt okunurdur. İşleniyor durumundaki satırlar asla otomatik yeniden denenmez; çünkü Vault veya bir konsol komutu bir çökmeden önce zaten çalışmış olabilir. Bkz. Reward Rescue.
• settings: ağlar için takip/teslimat sahipliği, yok sayılan kimlikler ve elde tutma temizliği.
• menu: tüm gönderilen envanter boyutları, slotlar, materyaller, başlıklar, lore, sayfa kapasiteleri, gezinme, ödül geçmişi zaman gösterimi ve ilerleme çubuğu görünümü.

Oyuncunun/yetkilinin gördüğü her cümle lang/<language>.yml içindedir; beş tam dil pakete dahildir. Eksik özel çeviri anahtarları, özel dil dosyasının üzerine yazmadan paketle gelen İngilizceye geri döner.

Talep geri bildirim metni feedback.claim-title, feedback.claim-subtitle ve feedback.claim-action-bar ile yerelleştirilir. Desteklenen yer tutucular {player}, {source} ve {status} değerleridir. Görsel ve işitsel mekanikler player-feedback.claim altında kalır; böylece operatörler çevirileri düzenlemeden sunumu değiştirebilir.

Menü güvenlik kuralları #

Envanter boyutları 9 ile 54 arasında 9'un katı olmalıdır. Slotlar sıfırdan başlar ve yapılandırılan envantere sığmalıdır. Materyal alanları Bukkit materyallerini ve HeadDatabase kurulu ve yüklüyken HEADDB:<id>, HDB:<id> ile DeluxeMenus tarzı hdb-<id> başvurularını kabul eder. Eksik eklentiler, bilinmeyen kimlikler ve geçersiz materyaller, konsol uyarısıyla güvenli yerleşik bir materyale döner. Aralık dışı sayısal değerler sınırlanır ve tanılanır. Slot listeleri geçersiz ve yinelenen girdileri atar; hiçbiri kalmazsa güvenli yerleşik düzen kullanılır.

menu.player-dashboard.progress; ilerleme slotunu, materyali, uzunluğu (1–40), glifleri ve renkleri denetler. reward-history-button kendi giriş düğmesini denetler.

menu.reward-history; envanter boyutunu, sıralı içerik slotlarını, en fazla satırı (1–45), kuyrukta/işleniyor/teslim edildi/iptal edildi materyallerini, boş/geri/kapat denetimlerini, Java tarih desenini ve saat dilimini denetler. Ana makinenin saat dilimi için SYSTEM veya Europe/Istanbul gibi bir IANA kimliği kullanın.

menu.admin-dashboard ve menu.admin-review; boyutları, sıralı sayfa slotlarını, durum/risk materyallerini ve her gezinme/denetim slotunu denetler. Etkin sayfa kapasiteleri geçerli içerik slotlarının sayısıdır; böylece sayfalama özel düzenlerle tutarlı kalır.

İki eylemi aynı slota atamaktan kaçının: en son yazılan eşya görünür olur ve bu, başka bir eylemin erişilemez kalmasına yol açabilir. Herhangi bir düzen düzenlemesinden sonra /referraltrack reload çalıştırın, konsol tanılamalarını inceleyin, ardından üretime almadan önce oyuncu ve yetkili menülerini elle açın.

Ön ayarlar ve gizli bilgiler #

/referraltrack install <preset> confirm komutunu uygulamadan önce Ön ayarlar ve temalar bölümüne bakın. Ön ayarlar veritabanı kimlik bilgilerini, belirteçleri veya webhook URL'lerini asla değiştirmez. /referraltrack doctor, dışa aktarmalar ve arayüzler bu değerleri göstermez. Yedekleri herkese açık indirilebilir web köklerinin dışında tutun ve dosya sistemi erişimini Minecraft hizmet hesabıyla sınırlayın.

Temalar #

/referraltrack theme <theme> confirm komutunu uygulamadan önce Ön ayarlar ve temalar bölümüne bakın. Tema önizlemesi salt okunurdur; onaylı kurulum tam bir yedek oluşturur ve yalnızca belgelenmiş menü/ilerleme/talep geri bildirimi sunum yollarını değiştirir. Ödül, kampanya, izin, veritabanı veya gizli veri hiçbir zaman değişmez.