Oyuncularınızın oylarını ödüllendirin

Bu rehber, MineRadar’da sunucunuza oy veren her oyuncuya oyun içi ödül vermeyi adım adım anlatır.

Hangi yöntemi seçmeli?

• MineRadar eklentisi: en kolayı. Bırakılacak bir dosya, yazılacak bir komut. Port yok, Votifier yok.
• Votifier: en yaygın yöntem. Sunucunuzda NuVotifier var (ya da kurabilirsiniz) ve açık bir port var.
• MineRadar API’si: sağlayıcınız portları engelliyor ya da kendi eklentiniz veya siteniz var.
• Discord, ek olarak: her oy Discord sunucunuzdaki bir kanalda duyurulur.

Yöntem 1: MineRadar eklentisi (en kolayı)

1. MineRadar.jar dosyasını indirin (Spigot ya da Paper, 1.7’den son sürüme kadar) ve sunucunun plugins/ klasörüne koyun. Yeniden başlatın.
2. MineRadar’da: profil → sunucunuz → Ödüller sekmesi → Komutumu oluştur.
3. /mineradar setup … komutunu kopyalayıp sunucu konsoluna yazın. Eklenti kurulumun tamamlandığını söyler.
4. Ödülü seçmek için plugins/MineRadar/config.yml içindeki rewards kısmını düzenleyin (satır başına bir komut, %player% = oyuncu), sonra /mineradar reload yazın. /mineradar status durumu gösterir.

rewards:
  - "give %player% diamond 1"
  - "eco give %player% 100"

Yöntem 1: Votifier

1. NuVotifier’ı indirin ve .jar dosyasını sunucunuzun plugins/ klasörüne koyun. Yeniden başlatın.
2. plugins/NuVotifier/config.yml (ya da plugins/Votifier/) dosyasını açın. port değerini (varsayılan 8192) ve tokens → default altındaki token’ı not edin. Ayrıntılar: NuVotifier resmî rehberi.
3. Bu portun dışarıya açık olduğundan emin olun. Bir sağlayıcıda genellikle panelden eklemek gerekir («Portlar» ya da «Allocations»).
4. MineRadar’da: profil → sunucunuz → Ödüller sekmesi. Portu ve token’ı yapıştırıp kaydedin.
5. Bağlantıyı test et’e tıklayın, sonra kendi adınızla bir test oyu gönderin. Geriye ödülü veren eklentiyi ayarlamak kalıyor: aşağıya bakın.

VotingPlugin’i (ya da başka bir ödül eklentisini) ayarlayın

Oyu NuVotifier alır ama ödülü başka bir eklenti verir. En çok kullanılanı VotingPlugin’dir. Bir oyu yalnızca servis adı eşleşirse ödüllendirir: MineRadar için bu MineRadar’dır (büyük/küçük harf fark etmez).

1. VotingPlugin’i NuVotifier gibi kurun, sonra yeniden başlatın.
2. plugins/VotingPlugin/VoteSites.yml dosyasını açın ve aşağıdaki bloğu ekleyin (Ödüller sekmeniz bunu oy bağlantınızla doldurulmuş olarak verir).
3. Ödülü değiştirin (Commands, Messages…) sonra /av reload yazın.
4. MineRadar’dan bir test oyu gönderin. Konsolda «Received a vote from service site 'MineRadar'» görünmeli ve /av servicesites MineRadar’ı listelemelidir. Daha fazlası: VotingPlugin servis adları belgesi.

VoteSites:
  MineRadar:
    Enabled: true
    ServiceSite: 'MineRadar'
    VoteURL: 'https://mineradar.games/vote/votre-serveur'
    VoteDelay: 12
    Rewards:
      Messages:
        Player: '&aMerci pour ton vote sur MineRadar !'
      Commands:
      - 'give %player% diamond 1'

Başka bir eklenti mi (SuperbVote, GAListener…)? Mantık aynı: servis adı isterse MineRadar yazın.

Yöntem 2: MineRadar API’si

Burada sunucunuza hiçbir şey gönderilmez: kimin oy verdiğini MineRadar’a o sorar. Açılacak port yok.

1. Ödüller sekmesi → API anahtarı oluştur. Kopyalayın: yalnızca bir kez gösterilir.
2. Eklentinize ya da geliştiricinize verin, yalnızca sunucu tarafında (asla bir web sayfasında değil).
3. Bir oyuncu bağlandığında ya da /vote yazdığında eklenti onun adıyla claim çağırır. Yanıt "reclame": true diyorsa ödülü verir. Bir oy yalnızca bir kez talep edilir.
4. Ek: classement en çok oy verenlerinizi (ay, 30 gün ya da sezon), serveur durumunuzu ve sıranızı verir; sitenizde ya da Discord’da göstermek için.

GET  https://mineradar.games/api/v1/votes/check?pseudo=Steve
POST https://mineradar.games/api/v1/votes/claim?pseudo=Steve
GET  https://mineradar.games/api/v1/votes/classement?periode=mois&limite=10
GET  https://mineradar.games/api/v1/serveur
Authorization: Bearer mr_…

Ek: oyları Discord’da duyurun

1. Discord’da: Sunucu Ayarları → Entegrasyonlar → Webhook’lar → Yeni Webhook. «Webhook’ları Yönet» izni gerekir. Discord’un resmî yardımı.
2. Kanalı seçin, sonra Webhook URL’sini Kopyala’ya tıklayın.
3. URL’yi Ödüller sekmesinin Discord bölümüne yapıştırıp kaydedin.
4. Test mesajı gönder’e tıklayın: kanalda görünmelidir.

Oy bağlantınızı paylaşın

Ödüller sekmeniz oy bağlantınızı verir. Doldurulmuş olması için ?pseudo= ve ardından oyuncunun adını ekleyin: kişisel bağlantı gönderen bir /vote komutunda kullanışlıdır.

Çalışmıyor mu?

• «Votifier yanıtı yok»: eklenti çalışmıyor ya da port sağlayıcınızda veya güvenlik duvarında açık değil.
• «Token reddedildi»: token’ı config.yml’den önünde ve arkasında boşluk olmadan yeniden kopyalayın.
• Oy geliyor ama ödül gelmiyor: ödül eklentinizdeki servis adı MineRadar değil.
• «Adres henüz çözümlenmedi»: MineRadar sunucunuzu henüz ölçmedi. Birkaç dakika sonra tekrar deneyin.
• Çift ödül: aynı ödül için Votifier’ı ve API’yi birlikte kullanmayın.

Ödüller sekmeme dön