- Katılım
- 1 Ağustos 2025
- Mesajlar
- 92
- Elmaslar
- 19
- Puan
- 705
- Konum
- Valinor
- Minecraft
- fuseheisen
Discord:
fuseteas.
- Minecraft Sürümleri
- 1.21.X
Merhaba MC-TR üyeleri, ben fuseheisen.
Sunucularda yıllardır kullanılan, eski kod yapılarına sahip ve TPS düşüren hantal etkinlik eklentilerinden sıkıldığım için tamamen sıfırdan geliştirdiğim TFish eklentisini sizlerle paylaşıyorum. TFish, oyuncularınıza keyifli bir balık tutma etkinliği sunarken, sunucunuzun performansını zirvede tutmak için tasarlandı.
Sunucularda yıllardır kullanılan, eski kod yapılarına sahip ve TPS düşüren hantal etkinlik eklentilerinden sıkıldığım için tamamen sıfırdan geliştirdiğim TFish eklentisini sizlerle paylaşıyorum. TFish, oyuncularınıza keyifli bir balık tutma etkinliği sunarken, sunucunuzun performansını zirvede tutmak için tasarlandı.
Neden TFish? (Optimizasyon ve Altyapı)
Piyasadaki birçok eklenti, saniyede onlarca kez çalışan ağır döngüler (tick loop) veya eski mesajlaşma sistemleri kullanır. TFish ise baştan aşağı güncel teknolojilerle kodlanmıştır:
- Modern Kyori Adventure API: Paper'ın yeni nesil mesajlaşma altyapısı kullanılmıştır. Eski ChatColor methodları tamamen terk edilmiş, renk kodlarında veya ActionBar/BossBar işlemlerinde sıfır hata prensibiyle çalışır.
- Asenkron Veritabanı İşlemleri: Eklenti; YAML, MySQL, MariaDB ve SQLite destekler. Veri kaydetme ve çekme (istatistik) işlemleri tamamen Asenkron (Asynchronous) olarak farklı bir thread üzerinden yapılır. Ana makinenizi asla yormaz.
- Ağırlıklı Rastgele (Weighted Random) Algoritması: Ganimet sistemi, sunucuyu yoran ağır matematiksel hesaplamalar yerine en hafif ağırlık algoritmasıyla çalışır.
Çalışma Sistemi
Yöneticiler, oyun içinde özel bir seçim aracıyla suyu (etkinlik alanını) belirler. Etkinlik başladığında, sadece bu alanın içindeki oyuncular özel BossBar'ı görür. Alana giren oyuncular olta attığında "Hızlı Balık" sistemi devreye girer (balıklar saniyeler içinde oltaya vurur).
Balık tutulduğunda vanilla balık gelmez; oyuncular Vault entegrasyonu sayesinde anında para kazanır (ekrandan ActionBar ile bildirilir) ve yöneticinin belirlediği özel eşyaları düşürme şansı elde ederler. Etkinlik alanından çıkan oyuncunun BossBar'ı otomatik kaybolur.
Balık tutulduğunda vanilla balık gelmez; oyuncular Vault entegrasyonu sayesinde anında para kazanır (ekrandan ActionBar ile bildirilir) ve yöneticinin belirlediği özel eşyaları düşürme şansı elde ederler. Etkinlik alanından çıkan oyuncunun BossBar'ı otomatik kaybolur.
Özel Ganimet Sistemi (/balikevent loot)
TFish'in en güçlü yanlarından biri özel eşya menüsüdür. MMOItems eşyaları, özel büyülü kılıçlar veya NBT verisine sahip herhangi bir eşyayı Base64 ile eksiksiz kaydeder.
Nasıl Kullanılır?
Nasıl Kullanılır?
- Ödül olarak vermek istediğiniz eşyayı envanterinize alın.
- /balikevent admin loot komutunu yazarak ganimet menüsünü açın. (Bu menü Anti-Dupe korumalıdır; eşya kopyalamaya karşı Shift-Click, Drag, Number Key gibi tüm açıklar kapatılmıştır).
- Eşyanızı menüdeki boş bir slota koyun ve üzerine Sağ Tıklayın.
- Menü anında kapanır ve sistem sizden sohbete bir şans oranı girmenizi ister.
- Sohbete düşme yüzdesini yazın (Örn: 2.5 veya 15.0).
- Sistem "Ağırlıklı Rastgele" mantığıyla bu eşyayı havuza kaydeder. Balık tutulduğunda bu gerçekçi yüzdelik dilime göre şanslı oyuncuya eşyayı verir ve tüm sunucuya özel bir ses eşliğinde duyuru geçer!
Komutlar ve Yetkiler
Eklentinin kullanımı son derece basittir. Yönetici komutları için gereken yetki: tfish.admin
- /balikevent time - Devam eden etkinliğin veya bir sonraki etkinliğin süresini gösterir.
- /balikevent stats [oyuncu] - Sizin veya başkasının toplam tuttuğu balık ve kazandığı para istatistiğini gösterir.
- /balikevent admin wand - Alan belirlemek için seçim aracını verir (Sol tık / Sağ tık).
- /balikevent admin setarea - Seçtiğiniz kordinatları etkinlik alanı olarak kaydeder.
- /balikevent admin loot - Özel eşya ve ganimet ayarlama menüsünü açar.
- /balikevent admin start - Etkinliği beklemeden, anında başlatır.
- /balikevent admin stop - Etkinliği anında bitirir.
- /balikevent admin addtime <saniye> - Aktif etkinliğin süresini uzatır.
- /balikevent admin reload - Config ve veritabanı ayarlarını yeniler.
PlaceholderAPI Desteği
Hologramlarınızda veya Scoreboard'larınızda kullanabileceğiniz değişkenler:
- %fishevent_status% - Etkinliğin durumunu gösterir (Aktif / Bekleniyor).
- %fishevent_time_left% - Etkinlik aktifse kalan süreyi (00:00) gösterir.
- %fishevent_next_time% - Bir sonraki etkinliğe ne kadar kaldığını gösterir.
- %fishevent_in_zone% - Oyuncunun etkinlik alanında olup olmadığını belirtir (Evet/Hayır).
- %fishevent_player_caught_current% - Oyuncunun aktif etkinlikte kaç balık tuttuğunu gösterir.
- %fishevent_player_caught_alltime% - Oyuncunun tüm zamanlarda kaç balık tuttuğunu gösterir.
- %fishevent_player_earned_money% - Oyuncunun tüm zamanlarda etkinlikten ne kadar para kazandığını gösterir.
İndirme ve Açık Kaynak
TFish, topluluğa katkı sağlamak amacıyla Açık Kaynak (Open Source) olarak paylaşılmıştır. Kod kalitesini incelemek veya kendi sistemlerinize entegre etmek için GitHub deposunu ziyaret edebilirsiniz. Sunucunuza kuracağınız .jar dosyası güvenlik standartları gereği ProGuard ile şifrelenmiştir (obfuscated).
Kaynak Kodları İncele:
Hemen İndir (.jar):
Umarım bu eklenti işinize yarar amacım türk sunucu sahiplerine yardımcı olmak ve yabancı pluginlere onlarca dolar vermesini engellemek. Elimden geleni yaptım, gördüğünüz hatalar, sorunlar için bana discord üzerinden ulaşabilirsiniz.
Herkese iyi forumlar.
geliştirici : fuseheisen
Kaynak Kodları İncele:
Değerli ziyaretçimiz, içeriği görebilmek için
şimdi giriş yapın veya kayıt olun.
Hemen İndir (.jar):
Değerli ziyaretçimiz, içeriği görebilmek için
şimdi giriş yapın veya kayıt olun.
Umarım bu eklenti işinize yarar amacım türk sunucu sahiplerine yardımcı olmak ve yabancı pluginlere onlarca dolar vermesini engellemek. Elimden geleni yaptım, gördüğünüz hatalar, sorunlar için bana discord üzerinden ulaşabilirsiniz.
Herkese iyi forumlar.
geliştirici : fuseheisen
