Minecraft eklentisi AzLink

🔌 AzLink hakkında

AzLink, bir oyun sunucusunu veya proxy'yi bir Azuriom web sitesiyle bağlayan bir Minecraft eklentisidir. Sunucunun çalışma ortamı ile Azuriom sitesi arasında bir köprü kurarak hesapla ilgili verileri, mağaza ve oy bağlantılarını senkronize eder ve eklentilerde ve mesajlarda kullanılmak üzere sunucu tarafı yer tutucuları sağlar.

🎯 Amaç

Eklentinin temel amacı web sitesi ile sunucu arasında entegrasyon sağlamaktır: oyuncu hesaplarını ve site odaklı özellikleri (mağaza satın alımları, oy ödülleri, ödül verme) bir Azuriom sitesi ile bir veya daha fazla Minecraft sunucu arka ucu ya da proxy'si arasında tutarlı tutmak. Azuriom web sitesi işleten ve oyun içi entegrasyonlar için desteklenen, bakımı yapılan bir bağlantı aracına ihtiyaç duyan sunucu sahipleri için tasarlanmıştır.

⚙️ Özellikler

• Hesap yönetimi ve kimlik doğrulama akışları için Sunucu↔Site bağlantısı.
• Azuriom mağaza ve oy eklentileri için entegrasyon noktaları (yapılandırma ile etkinleştirilebilir).
• Bukkit tabanlı platformlarda PlaceholderAPI desteği (bir oyuncunun web sitesi parasını ve mağaza/oy ile ilgili yer tutucuları kaydeder).
• Tek bir .jar, birden fazla desteklenen sunucu platformunda çalışır (çok eski sunucular için eski sürüm yapılarıyla).
• Yapılandırma odaklı davranış (yer tutucular ve entegrasyon seçenekleri yapılandırma dosyasıyla kontrol edilir).

🧩 Kimin için

• Azuriom web sitesi çalıştıran ve oyun içi mağaza, oy veya hesap senkronizasyonuna ihtiyaç duyan sunucu sahipleri.
• Proxy (Bungee/Velocity) kullanan ağlar veya Bukkit ailesi sunucularda tek sunuculu kurulumlar.
• Web sitesi verileriyle doldurulan, PlaceholderAPI uyumlu yer tutucular isteyen yöneticiler.

🏗️ Örnek kullanım alanları

• Bir oyuncunun Azuriom web sitesi bakiyesini PlaceholderAPI üzerinden sohbette veya skor tablolarında göstermek.
• Azuriom mağazası üzerinden satın alma yapıldığında oyun içi öğeleri veya rütbeleri otomatik vermek.
• Site oy eklentisi bir oyu kaydettiğinde sunucuda oy ödülleri vermek.

⚙️ Kurulum

📥 Kurulum

• Platformunuza uygun resmi AzLink eklenti JAR dosyasını indirin ve sunucunun plugins/ (veya platformun karşılığı olan) dizinine yerleştirin.
• Eklentiyi yüklemek için sunucuyu yeniden başlatın.
• AzLink'in doğru şekilde başlatıldığını doğrulamak için sunucu konsolundaki başlangıç mesajlarını kontrol edin.

📦 Bağımlılıklar

• PlaceholderAPI — Bukkit tabanlı sunucularda yer tutucu kaydı için desteklenir ve isteğe bağlıdır.
• Entegrasyonun çalışması için bir Azuriom web sitesi örneği gereklidir (eklentinin siteyle iletişim kurması gerekir).

🧾 Yapılandırma

• AzLink, mağaza ve oy yer tutucuları gibi özellikleri açıp kapatabileceğiniz ve Azuriom web siteniz için bağlantı bilgilerini sağlayabileceğiniz bir yapılandırma dosyası oluşturur ve kullanır.
• Mağaza ve oy özellikleri için yer tutucu kaydı, Bukkit ailesi sunucularda yapılandırmadan açılıp kapatılabilir.

🧠 Teknik notlar

• Desteklenen sunucu platformları arasında Bukkit ailesi sunucular (Bukkit, Spigot, Paper, Folia) ve çeşitli proxy/alternatif sunucu platformları (BungeeCord, Velocity, Sponge) yer alır. Modlanmış ortamlar için mod/forge yükleyicili portlar (Fabric/Forge/NeoForge) mevcuttur.
• Eklenti açık kaynak kodludur ve MIT lisansı altında yayımlanır.
• Resmi sürümler ve değişiklik günlükleri Azuriom projesi tarafından yayımlanır ve AzLink deposunda tutulur.

🤝 Bu eklenti ne zaman kullanışlıdır

Bir Azuriom web sitesi çalıştırıyor ve site odaklı özellikleri oyunda göstermek için bakımı yapılan bir bağlantı aracına ihtiyaç duyuyorsanız (mağaza, oylar, hesap verileri, yer tutucular), AzLink bu sistemleri özel geliştirme olmadan entegre eden, yapılandırılabilir ve çok platformlu bir köprü sunar.