🗳️ Oy sistemini sunucuna bağlama (Votifier)

NuVotifier kurulumu, token ayarı, port açma ve oy verenlere oyun içi ödül verme.

Votifier, bir oyuncu sitemizde sunucuna oy verdiğinde sunucuna anında haber gönderen sistemdir. Sunucundaki bir ödül eklentisi bu haberi alıp oyuncuya ödül verir (para, eşya, anahtar...). Bu, oyuncuların her gün oy vermesi için en iyi teşviktir.

1. NuVotifier eklentisini kur

1. NuVotifier'ı indir (Modrinth, Hangar veya SpigotMC'de "NuVotifier" diye ara).
2. Dosyayı sunucunun plugins klasörüne at ve sunucuyu yeniden başlat.
3. BungeeCord/Velocity ağın varsa NuVotifier'ı proxy'e kurmak en kolay yoldur; ödül eklentisi lobide ise NuVotifier'ın "forwarding" (yönlendirme) ayarıyla oyları alt sunuculara iletebilirsin.

2. Token'ı al

İlk açılışta NuVotifier bir ayar dosyası oluşturur (Paper/Spigot'ta genelde plugins/Votifier/config.yml). İçinde şuna benzer bir kısım vardır:

host: 0.0.0.0
port: 8192
tokens:
  default: 'a1b2c3d4e5f6g7h8i9j0'

default: karşısındaki değer senin token'ındır. port değerini de not al (genelde 8192).

Eski Votifier (NuVotifier değil) kullanıyorsan token yerine plugins/Votifier/rsa/public.key dosyasının içeriğini kullanacaksın. Sitemiz ikisini de otomatik tanır.

3. Portu aç

Sitemizin sunucuna ulaşabilmesi için Votifier portunun dışarıya açık olması gerekir.

• Hosting paneli (Pterodactyl vb.): Panelde "Ağ / Network" bölümünden ek bir port al ve config.yml'deki port değerini bu port yap.
• Kendi VPS'in: Güvenlik duvarında bu portu TCP olarak aç (ör. sudo ufw allow 8192/tcp).

4. Sitemize gir ve test et

Votifier ayarlarını sunucunu eklerken formdaki Oy ödülü (Votifier) bölümüne, sonradan değiştirmek için de yönetim bağlantındaki aynı bölüme gir:

1. Votifier IP: Oyuncuların bağlandığı adresle aynıysa boş bırak. Farklıysa (ör. hosting panelin verdiği IP) onu yaz. Port yazma, onun ayrı kutusu var.
2. Votifier portu: 3. adımdaki port (genelde 8192).
3. NuVotifier token: 2. adımdaki default: değeri. Eski Votifier kullanıyorsan token kutusunu boş bırakıp public key kutusuna public.key dosyasının içeriğini yapıştır.
4. Kendi Minecraft adını yaz ve Bağlantıyı test et'e bas. "Bağlantı başarılı" görürsen her şey tamam; hata görürsen aşağıdaki sorun giderme kısmına bak. Test, ayarları kaydetmeden çalışır.
5. Formu kaydet.

Bundan sonra oyuncular sunucu sayfanda oy verirken Minecraft adlarını da yazar ve oy anında sunucuna iletilir.

5. Ödül eklentisini ayarla

NuVotifier sadece oyu iletir; ödülü vermek için bir ödül eklentisi gerekir. En yaygınları VotingPlugin ve SuperbVote'tur. Sitemiz oyları şu servis adıyla gönderir:

ServerRealms Kopyala

Bazı eklentiler, ödülü hangi siteden gelen oya vereceğini bu adla eşleştirir. Örneğin VotingPlugin'de VoteSites.yml dosyasına şuna benzer bir site eklenir:

VoteSites:
  ServerRealms:
    Enabled: true
    ServiceSite: 'ServerRealms'
    VoteURL: 'sunucu sayfanın adresi'
    VoteDelay: 24
    Rewards:
      Commands:
        - 'eco give %player% 500'

Bu bir örnektir; ayar adları eklentinin sürümüne göre değişebilir. Kesin ayarlar için kullandığın eklentinin kendi rehberine bak.

Sorun giderme

• "Votifier'a bağlanılamadı": Port kapalı ya da yanlış. 3. adımı kontrol et; hosting panelindeysen panelin verdiği IP'yi Votifier adresi olarak yaz.
• "Token yanlış": Token'ı boşluk bırakmadan, tırnak işaretleri olmadan yapıştır.
• "Bu port Votifier değil gibi görünüyor": Port, oyunun portuyla karıştırılmış olabilir. Votifier portu oyun portundan farklıdır.
• "Sunucu eski Votifier kullanıyor": Token kutusunu boşalt, public.key içeriğini public key kutusuna yapıştır.
• "Public key tanınmadı": Dosyanın içeriğini eksiksiz, tek parça olarak kopyala.
• Test başarılı ama ödül gelmiyor: Ödül eklentisinin ayarında servis adının ServerRealms olduğundan emin ol.

Yönetim sayfan, son gönderim hatasını tarihiyle birlikte gösterir.