Friends 1.0.1

Sunucunuzdaki sosyal etkileşimi bir üst seviyeye taşıyın!
Advanced Friends System, modern Minecraft sunucuları için özel olarak tasarlanmış, tamamen GUI odaklı, yüksek performanslı ve kullanıcı dostu bir arkadaşlık eklentisidir.

Komut karmaşasına son!
Tüm işlemler şık arayüzler üzerinden, yalnızca birkaç tıkla yapılır.

---

✨ Öne Çıkan Özellikler

🖼️ Tamamen GUI Odaklı
Arkadaş ekleme, silme ve yönetme işlemleri %100 arayüz üzerinden yapılır.

📩 Gelişmiş İstek Sistemi
Gelen arkadaşlık isteklerini tek bir menüden görüntüleyin, kabul edin veya reddedin.

📊 Gerçek Zamanlı Durum Takibi
Oyuncu kafaları sayesinde arkadaşlarınızın çevrimiçi / çevrimdışı durumunu anlık takip edin.

⚡ Ultra Performans
Tüm veritabanı işlemleri Asenkron (Async) çalışır, sunucuda lag oluşturmaz.

🛠️ Akıllı Bellek Yönetimi
Oyuncu çıktığında bekleyen davetler otomatik temizlenir, RAM kullanımı minimumda tutulur.

🔄 Sayfalı Menü Sistemi
Yüzlerce arkadaşınız olsa bile sayfalı yapı sayesinde kolayca yönetin.

🔗 Güncel Sürüm Desteği
Minecraft 1.21.8 ile tam uyumlu (Paper / Spigot).

---

📂 Menüler & Kullanım

• Ana Liste:
Tüm arkadaşlar, çevrim içi durumu ve son görülme bilgileri

• İşlem Menüsü:
Bir arkadaşınıza tıkladığınızda açılır (silme, hızlı işlemler)

• İstekler Menüsü:
Bekleyen tüm arkadaşlık davetlerini yönetin

• Modern Girdi Sistemi:
Tabela (Sign) ile hızlı oyuncu adı girişi

---

💻 Komutlar & Yetkiler

/friends
→ Ana arkadaş menüsünü açar

Yetki:
• friends.use (Varsayılan: Tüm oyuncular)

---

🛠️ Teknik Detaylar

Minecraft: 1.21.x
Yazılım: Paper / Spigot
Bağımlılık: VCore
Veritabanı: SQLite & MySQL
Veri Güvenliği: Kalıcı ve güvenli kayıt

---

🧩 Geliştiriciler İçin API

Friends sistemi, diğer pluginlerle kolayca entegre edilebilecek şekilde geliştirilmiştir.

✔ API Avantajları
• Tek satırda erişim
• PlayerData ile detaylı veri kontrolü
• Asenkron veritabanı işlemleri
• Event tabanlı genişletilebilir yapı

---

🔧 Maven Repository

<repository>
    <id>mineala-repo</id>
    <url>https://repo.mineala.com/repository</url>
</repository>

📦 Dependency

<dependency>
    <groupId>net.kayega</groupId>
    <artifactId>Friends</artifactId>
    <version>1.0.1</version>
    <scope>provided</scope>
</dependency>

---

💻 API Kullanım Örnekleri

Arkadaşlık Kontrolü

UUID player1 = player.getUniqueId();  
UUID player2 = target.getUniqueId();  

PlayerData data = Friends.getInstance()  
        .getPlayerDataManager()  
        .get(player1);  

if (data != null && data.getFriends().contains(player2)) {  
    player.sendMessage("§aBu senin arkadaşın!");  
}

Programatik Arkadaş Ekleme / Silme

FriendsApi.addFriend(uuid1, uuid2);
FriendsApi.removeFriend(uuid1, uuid2);

Arkadaş Sayısını Alma

public int getFriendCount(Player player) {  
    PlayerData data = Friends.getInstance()  
            .getPlayerDataManager()  
            .get(player.getUniqueId());  
    return data != null ? data.getFriends().size() : 0;  
}

Bekleyen Davetleri Kontrol Etme

UUID sender = FriendsApi.getPendingInvite(receiver.getUniqueId());  

if (sender != null) {  
    Bukkit.getLogger().info("Oyuncunun bekleyen daveti var.");  
}

---

📣 Event Sistemi

İstek Gönderildiğinde

@EventHandler  
public void onInviteSend(FriendInviteSendEvent event) {  
    event.getSender().sendMessage("§aİstek gönderildi!");  
}

Kabul Edildiğinde

@EventHandler  
public void onInviteAccept(FriendInviteAcceptEvent event) {  
    Bukkit.broadcastMessage(  
        "§6" + event.getReceiverName() +  
        " §eve §6" + event.getSenderName() +  
        " §eartık arkadaş!"  
    );  
}

Reddedildiğinde

@EventHandler  
public void onInviteDeny(FriendInviteDenyEvent event) {  
    // Reddedilme işlemleri  
}

---

📞 Destek & İletişim

Bir hata mı buldunuz veya özellik mi önermek istiyorsunuz?
Bizimle iletişime geçmekten çekinmeyin!

Geliştirici: Kayega

Bu plugin, sunucunuzun community yapısını güçlendirmek için optimize edilmiştir.