Docs | MineBuff

Oy ödülleri (Votifier)

Birisi listelemede oy verdiğinde MineBuff Minecraft sunucuna hemen haber verebilir; ödül eklentin eşya, rütbe veya anahtar verebilir.

Oyuncu oy verir MineBuff oy sayfanı açar ve Minecraft adını girer.
Sunucunu bilgilendiririz MineBuff Votifier portuna bağlanır ve oyu iletir.
Ödüller tetiklenir NuVotifier / Classic Votifier / GAListener (veya benzeri) ödülü işler.

Dört adımda kur

Minecraft sunucuna Votifier kur
Classic Votifier veya NuVotifier kullan. Genel internetin erişebilmesi için güvenlik duvarı / barındırma panelinde 8192 (veya seçtiğin) portunu aç.
Anahtarı veya token'ı kopyala
v1: plugins/Votifier/rsa/public.key (veya NuVotifier rsa/public.key) yapıştır. v2: NuVotifier config.yml'den bir token kopyala (sıkça default).
Listelemede etkinleştir
Panel → sunucuyu düzenle → Votifier. İletmeyi aç, host (Java IP'ni kullanmak için boş bırak), port ve protokolü ayarla; anahtar/token'ı yapıştırıp kaydet.
Test oyu gönder
Aynı formdaki “Test oyu gönder”i kullan. O çalışırsa gerçek oylar da çalışır.

Otomatik (önerilen)

Challenge + token varsa NuVotifier v2 seçer; aksi halde v1 RSA'ya düşer.

v1 — RSA anahtarı

Classic Votifier ve NuVotifier RSA. Genel anahtar dosyasının içeriği gerekir.

v2 — Token

config.yml'deki NuVotifier HMAC token. Zaten NuVotifier kullanıyorsan hızlı ve basit.

Liste sitesine göre filtreleyen ödül eklentileri “MineBuff” hizmet adına izin vermelidir. İletim başarısız olsa bile sitedeki oy sayılır — güvenlik duvarını ve kimlik bilgilerini kontrol et.

Paneli aç Sunucu nasıl eklenir

Oy kontrol API

“Bu IP bugün sunucuma oy verdi mi?” diye sor. Ücretsiz, herkese açık, API anahtarı yok.

Bu bir oy oluşturmaz

Oyuncular yine MineBuff oy sayfasında oy verir. Bu URL'ler yalnızca bugün (UTC) için oy olup olmadığını okur.

GET

Düz metin

Basit eklentiler için en iyisi — tüm yanıt tek bir karakterdir.

https://minebuff.com/api/vote/{slug}/{ip}

1: Bugün zaten oy verilmiş
0: Henüz oy yok (veya bilinmeyen / yayınlanmamış sunucu)

Örnek curl -s "https://minebuff.com/api/vote/your-server/203.0.113.10"

GET

JSON

Aynı yanıt, artı ne zaman oy verdikleri ve günlük sıfırlamaya ne kadar kaldığı.

https://minebuff.com/api/vote/{slug}/{ip}/json

Alan	Anlamı
`vote`	“1” veya “0” (metin) — bugün oy verilmiş mi.
`voted_at`	Bugünkü oyun UTC zamanı veya null.
`reset_at_midnight`	Her zaman true — günlük oy kontrol penceresi 00:00 UTC'de sıfırlanır (sıralama toplamları ayrıdır ve yaklaşık aylık sıfırlanır).
`time_until_next_vote`	Zaten oy verdilerse sonraki UTC gece yarısına saniye; aksi halde 0.

Örnek

{
  "vote": "1",
  "voted_at": "2026-09-12T14:32:01Z",
  "reset_at_midnight": true,
  "time_until_next_vote": 34199
}

URL'ye ne konur

URL'de	Anlamı
`{slug}`	Listeleme URL'sindeki sunucu slug'ın (ör. /servers/your-slug).
`{ip}`	Oyuncunun IP adresi. Hash'leriz; sunucu başına IP başına UTC gününde bir oy.

Tarayıcılardan da çalışır (CORS). Bilinmeyen sunucular düz metinde 0 veya server_not_found hatalı HTTP 404 JSON döner.

Oy kuralları

Eklenti zamanlamanın bizimkiyle uyuşması için kısa bir kontrol listesi.

Her UTC gününde (00:00 UTC) sunucu başına IP başına bir kez oy verebilirsin. Sıralama oy toplamları yaklaşık ayda bir silinir.
Yayınlanmış sunucu başına IP adresi başına UTC gününde bir oy.
Oylar MineBuff formunda bir Minecraft kullanıcı adı gerektirir (Votifier için zorunlu).
Kontrol API asla oy oluşturmaz; yalnızca bugünün durumunu bildirir.

Yardım

Ödüller veya API beklediğin gibi davranmadığında sık karşılaşılan sorunlar.

Test oyu başarısız veya oyun içine bir şey gelmiyor

8192 (veya portunun) internete açık olduğunu, host'un erişilebilir bir adresle eşleştiğini ve anahtar/token'ın eklenti dosyalarıyla birebir uyduğunu (fazladan boşluk olmadan) doğrula.

Hangi protokolü seçmeliyim?

Otomatik ile başla. Yalnızca NuVotifier token'ın varsa v2 kullan. Yalnızca RSA genel anahtarın varsa v1 kullan.

API her zaman 0 dönüyor

Listelemenin yayınlandığını, slug'ın birebir olduğunu ve oyuncunun gerçek IP'sini geçirdiğini kontrol et (aynı makineden oy vermedilerse 127.0.0.1 değil).

Başarısız Votifier iletimleri oyu iptal eder mi?

Hayır. MineBuff oyu yine de sayılır. Bağlantıyı düzelt ve paneldeki test oyunu yeniden dene.

API üzerinden oy verebilir miyim?

Hayır. Oylar genel oy sayfasında verilir. API bugünkü oyu kontrol etmek için salt okunurdur.