ZonelyCore
ZonelyCore, Minecraft sunucunuzu web sitenizle entegre etmek için tasarlanmış kapsamlı bir eklentidir. Web sitenize eklenen kategori ve ürünleri oyuna senkronize edebilir, oyuncuların site kredilerini kullanarak oyun içinden satın alma yapmasını sağlayabilir ve satın alma etkinliğini oyun içinde gösterebilirsiniz. SecureSocket desteğiyle web sitenizden oyun sunucunuza güvenli şekilde komut gönderebilirsiniz. Eklenti; mağaza, destek talepleri, cezalar, krediler, açık artırmalar, raporlar, turnuva sistemleri ve daha fazlasını tek yapı altında toplar.Gereksinimler
Kurulumdan önce aşağıdaki eklentilerin sunucunuzda kurulu olması önerilir:Özellikler
Web Mağazası
Oyuncular web sitenizdeki ürünleri oyun içi GUI üzerinden görüntüleyebilir ve satın alabilir. Ürünleri ve kategorileri yönetici panelinizden yönetebilirsiniz.Açık Artırmalar
Oyuncular, herhangi bir listeleme ücreti ödemeden kredi miktarı belirleyerek eşyalarını hem web sitenizde hem de oyun içinde Açık Artırmalar bölümünde listeleyebilir. Yeterli kredisi olan oyuncular açık artırmadaki eşyaları satın alabilir veya talep edebilir.NPC’ler
6 farklı menüyü açabilen NPC’ler oluşturabilirsiniz. Hologram ve PlaceholderAPI desteği dahildir.Destek Talepleri
Web sitesi destek talepleri oyun içinden canlı olarak yönetilebilir. Yetkililer taleplere yanıt verebilir, talepleri kapatabilir veya kullanıcıları yasaklayabilir. Oyuncular da sunucu içinden bir destek kategorisi seçerek yeni talep oluşturabilir.Cezalar
Yetkililer oyuncuları susturabilir, yasaklayabilir, uyarabilir ve ceza geçmişlerini görüntüleyebilir. Cezalı kullanıcılar web siteniz üzerinden yönetilebilir; oyuncular cezaları herkese açık şekilde görüntüleyebilir.Son Krediler
En son kredi yüklemeleri bir GUI içinde gösterilir ve kategoriye göre filtrelenebilir.Liderlik Tabloları
Son kredi yüklemeleri hologram olarak gösterilebilir. Hologram tıklanabilir olabilir ve kategoriye göre görüntülenebilir.Giriş ve Kayıt
Oyuncular web panelinde oluşturdukları aynı hesapla giriş yapabilir.Krediler
Oyuncularınızın kredilerini yönetebilirsiniz.Kredi Kuponları
Oyuncular site kredilerini kağıt kupon eşyasına dönüştürebilir. Bu kağıt eşyayı kullanarak birbirleriyle kredi paylaşabilirler. Sağ tıklandığında kredi oyuncunun hesabına eklenir.Raporlar + Replay
Oyuncular kuralları ihlal ettiğini düşündükleri kullanıcıları raporlayabilir. Yetkililer raporlanan oyuncuları GUI üzerinden görüntüleyip işlem yapabilir. Sistem ceza modülüyle entegredir. Raporlanan oyuncular video izler gibi incelenebilir ve sonrasında ceza uygulanabilir.WebSockets
Web sitesindeki ürün satışları için kullanılır. Web sitesi komutlarını şifreli veriyle oyun içinde güvenli şekilde çalıştırır. Yalnızca web sitesi tarafından doğrulanan komutların konsol tarafından yürütülmesini sağlar.Teslimatlar
Oyuncular zaman bazlı ödülleri GUI üzerinden talep edebilir.Web Profilleri
Bir oyuncunun web sitesi profili oyun içinden GUI aracılığıyla görüntülenebilir.Sohbet Renkleri
İzni olan kullanıcılar sohbet mesajı renklerini GUI üzerinden değiştirebilir. Mesajlar seçilen renkte görünür.E-Spor Turnuva Sistemi
Kulüp kaydı, bekleme lobisi, bracket ilerlemesi, canlı maç aşamaları, izleyici modu, kazanan yönetimi ve otomatik temizlik/sıfırlama dahil tam rekabetçi turnuva akışı sağlar.E-Spor Maç Etkinlikleri
Zamanlı kademe sandık düşüşleri, özel yardımcı eşya düşüşleri, dinamik hologramlar, meteor/tren arena etkinlikleri, maç özetleri ve kazanan kutlama efektlerini içerir.Kılık Değiştirme
Oyuncuların oyun içinde farklı bir kimlikle görünmesini sağlayan bir kitap GUI’si açar.Sohbet Filtreleri
Oyuncular tarafından gönderilen reklamları ve hakaret içeren mesajları engeller. Gerektiğinde otomatik ceza uygulayabilir.PlaceholderAPI ve MySQL Desteği
Eklenti veritabanına bağlanabilir ve PlaceholderAPI üzerinden çeşitli değişkenleri kullanabilir.Otomatik Giriş
İlk giriş veya kayıttan sonra güvenilir IP adresleri hatırlanır. Oyuncular yeniden giriş yapmaları istenmeden doğrudan sunucuya alınabilir.Bossbar Yönlendirmesi
Özel bossbarlar oyuncuları oyun içinde giriş, kayıt ve e-posta doğrulama adımlarında yönlendirir.Fallback Sunucusu
Başarılı giriş veya kayıt sonrasında oyuncular otomatik olarak önceden tanımlanmış bir BungeeCord sunucusuna aktarılabilir.E-posta Doğrulama
Etkinleştirildiğinde oyunculardan e-posta adresi belirlemeleri istenir. Gelen kutularına doğrulama kodu gönderilir ve bu kodu oyun içinde girdikten sonra oynamaya devam edebilirler.2FA (TOTP)
TOTP tabanlı iki faktörlü kimlik doğrulama, oyuncular oyuna girmeden önce tek kullanımlık kodla doğrulama yapar.E-posta Değiştirme
E-posta adresini değiştirmek için oyuncunun gelen kutusuna tek kullanımlık kod gönderilir. Kod oyun içinde girildiğinde e-posta adresi güvenli şekilde güncellenir.Şifre Sıfırlama
Oyuncular/passwordreset komutuyla oyun içinden token isteyebilir ve web sitesi üzerinden zaman ve güvenlik kısıtlamaları altında yeni şifre belirleyebilir.
ChatBridge
Web sitesi sohbetini oyun sunucusuyla senkronize eder. Oyuncular web sitesinde bir sunucu seçebilir, komut veya mesaj gönderebilir ve çevrim içi oyuncu listesiyle birlikte canlı olarak görüntüleyebilir.Envanter Anlık Görüntüleri
Oyuncu her katıldığında veya ayrıldığında envanteri kaydedilir ve web profilinde GUI olarak gösterilir. İsteğe bağlı olarak diğer oyunculara da görünür hale getirilebilir.Launcher Auth
Sunucuya erişmek için özel ZonelyLauncher’ınızın kullanılmasını gerektirir. Launcher olmadan katılan oyuncular indirme bağlantısıyla atılır ve yalnızca launcher üzerinden oynayabilir.Gruplar
Başka bir eklenti üzerinden izin atayarak kullanıcılara ek ayrıcalıklar verebilirsiniz. Bu, profil menüsünde kullanılabilir.Kılık Değiştirme Sistemi
Dil destekli menü metinleriyle tamamen GUI tabanlı rol/skin kılık değiştirme akışı sağlar.Çoklu Dil
languages.yml tabanlı yerelleştirme, fallback stratejisi ve geniş modül kapsaması sunar.
Komutlar
E-Spor Genel Bakış
E-Spor modülü; kulüp kaydı, bekleme lobisi yönetimi, bracket oluşturma, canlı maç durum takibi, izleyici araçları, zamanlı loot ilerlemesi, özel düşme mekanikleri, dinamik arena etkinlikleri ve maç sonrası otomatik sıfırlama/temizlik dahil tam turnuva yönetimi içerir.İzinler
Placeholderlar
Görseller
ZonelyCore API Hızlı Referans
Tüm örnekler ZonelyCore’un etkin olduğunu ve eklentinizin ona bağlı olduğunu varsayar.API’ye Erişim
Modül Anahtarlarını Kontrol Etme
Cash API
getBalance(name|player) mevcut kredi toplamını döndürür ve offline kullanım için güvenlidir.
addBalance, withdraw ve setBalance güncellenmiş bakiyeyi döndürür. Yetersiz bakiye, veritabanı sorunları veya doğrulama hatalarında CreditOperationException fırlatırlar.
isCached ve invalidateCache, manuel veritabanı düzenlemelerinden sonra bellek içi önbelleği yönetmek için kullanılabilir.
Async yardımcılar (addBalanceAsync, withdrawAsync, setBalanceAsync) CompletableFuture<Long> döndürür ve işlemlerin ana thread dışında kalmasını sağlar.
Voucher API
issueVoucher(issuer, target, amount) kredileri düşer ve VoucherIssueResult döndürür. Sonuç, eşya ve metadata bilgilerini içerir.
parseVoucher(item) eşyaları güvenli şekilde inceler.
redeemVoucher(details|item) krediyi hedef oyuncuya ekler.
Yetersiz bakiye gibi doğrulama sorunlarında CreditOperationException fırlatır.
Deliveries API
listDeliveries() yapılandırılmış ödül girişlerini dışa açar.
getStatus(player, delivery) izin ve bekleme süresi durumunu açıklar.
claim(player, delivery) ödülü verir. Profil yükleme hatalarında CreditOperationException fırlatabilir.
Last Credits API
getLeaderboard(category) önbelleğe alınmış girişleri döndürür.
Desteklenen kategoriler:
getLastLeaderboardRefresh(category) anlık görüntünün güncelliğini dışa açar.
getRecentTopups() PlaceholderAPI önbelleğini yansıtır.
getViewerCategory(player) ve setViewerCategory(player, category) hologramları ve GUI görünümlerini oyuncu başına senkron tutar.
openMenu(player, category) oyuncunun aktif kategorisine göre menüyü açar.
Secure Socket API
Secure Socket modülüconfig.yml üzerinden yönetilir.
İlgili ayarlar:
start(), stop() ve restart() dinleyiciyi yönetir.
isActive() ve getPort() çalışma zamanı durumunu dışa açar.
Auction API
openMainMenu, openSoldMenu, openPurchasedMenu ve openPurchaseMenu async threadlerden güvenle çağrılabilir. Yönetici gerektiğinde Bukkit threadine geri geçer.
getMenuManager() GUI kontrolcüsünü dışa açar.
getDao() özel iş akışları için doğrudan veritabanı erişimi sağlar.
Özel komutlar yayınlamadan önce api.areAuctionsEnabled() kontrolü yapın.
