Oy Ödülleri Kurulum Kılavuzu

Hylist'te sunucunuz için oy veren oyunculara oyun içi ödüllerin nasıl kurulacağını öğrenin.

Votifier2 Nedir?

Votifier2, Hylist gibi sunucu listeleme sitelerinin oy bildirimlerini doğrudan oyun sunucunuza göndermesine olanak tanıyan bir protokoldür. Bir oyuncu sunucunuz için oy verdiğinde, Hylist sunucunuza güvenli bir mesaj gönderir ve sunucu oyuncuyu otomatik olarak ödüllendirebilir.

Gereksinimler

  • Sunucunuzda yüklü Votifier2 uyumlu bir eklenti
  • Votifier dinleyicisi için açık bir port (varsayılan: 8192)
  • Oy verenlere eşya/ayrıcalık vermek için bir ödül eklentisi (isteğe bağlı ama önerilir)

Adım 1: Votifier2 Eklentisi Kurun

Öncelikle Hytale sunucunuza Votifier2 uyumlu bir eklenti kurmanız gerekiyor. Önerimiz:

Hytale Votifier'ı İndir

Eklentiyi sunucunuza eklemek için eklentinin kurulum talimatlarını izleyin.

Adım 2: Hylist'te Oyun İçi Ödülleri Etkinleştirin

Votifier token'ınızı almak için Hylist panelinizde oyun içi ödülleri etkinleştirin.

  1. Hylist panelinde sunucunuzun düzenleme sayfasına gidin
  2. "Oyun içi ödülleri etkinleştir" seçeneğini AÇIK konuma getirin
  3. Votifier portunu ayarlayın (varsayılan: 8192)
  4. Değişikliklerinizi kaydedin
  5. Bir sonraki adım için Votifier token'ınızı kopyalayın

Adım 3: Eklentiyi Yapılandırın

Hylist'ten aldığınız Votifier token'ını eklentinizin yapılandırma dosyasına yapıştırın.

Örnek yapılandırma (config.json):

{
  "BindHost": "0.0.0.0",
  "BindPort": 8192,
  "DisableV1Protocol": false,
  "RewardCommands": [
    "gm adventure %player%"
  ],
  "RewardMessages": [
    "<gray>Thanks for your vote on <gold>%from%</gold>!"
  ],
  "Tokens": {
    "Hylist.io": "<YOUR_TOKEN_FROM_HYLIST>"
  }
}

İsteğe bağlı: Oy komutu yapılandırması (voteCommand.json):

{
  "Enabled": true,
  "OpenCustomGui": true,
  "SendChatMessage": true,
  "ChatMessageHeader": [
    "<gold><b>Vote for our server!</b></gold>"
  ],
  "ChatMessageTemplate": "<yellow><click:%link%>%name% (Click)</click></yellow>",
  "VoteLinks": {
    "Hylist.io": "https://hylist.io/vote/<YOUR_SERVER_SLUG>"
  }
}

<YOUR_SERVER_SLUG> kısmını sunucunuzun slug'ı ile değiştirin (örn. "my-awesome-server"). Bunu Hylist'teki sunucu URL'nizde bulabilirsiniz.

İpucu: Daha iyi kullanıcı deneyimi için kullanıcı adını önceden doldur

Oyuncunun kullanıcı adını otomatik olarak doldurmak için oy URL'sine ?username=OyuncuAdi ekleyebilirsiniz:

https://hylist.io/vote/your-server?username=PlayerName

Not: Çoğu eklenti bunu varsayılan olarak desteklemediğinden bu özel eklenti desteği gerektirir.

Adım 4: Portu Açın

Votifier portunun internetten erişilebilir ve açık olduğundan emin olun.

Portun sunucunuzun güvenlik duvarında açık olduğundan emin olun. Bir hosting sağlayıcısı kullanıyorsanız, port yönlendirmesini yapılandırmanız gerekebilir.

Kurulumunuzu Test Etme

Her şeyin çalıştığını doğrulamak için:

  1. Sunucunuzun çevrimiçi olduğundan ve Votifier eklentisinin çalıştığından emin olun
  2. Hylist'te sunucunuz için oy verin ve oyun içi kullanıcı adınızı girin
  3. Oy bildirimleri için sunucu konsolunuzu kontrol edin
  4. Yapılandırılmış ödülleri oyun içinde aldığınızı doğrulayın

Güvenlik İpuçları

Votifier token'ınızı asla herkese açık paylaşmayın! Token'ınıza erişimi olan herkes sunucunuza sahte oy bildirimleri gönderebilir.

  • Votifier token'ınızı gizli ve güvenli tutun
  • Token'ın ele geçirildiğinden şüpheleniyorsanız hemen yenileyin
  • Mümkünse Votifier portunu yalnızca güvenilir IP adreslerine açın

Sorun Giderme

Oy almıyor musunuz?

  • Portun internetten erişilebilir ve açık olduğunu doğrulayın
  • Hylist'te sunucunuzun IP adresinin doğru olduğunu kontrol edin
  • Votifier eklentisinin çalıştığından emin olun (sunucu günlüklerini kontrol edin)
  • Token'ın tam olarak eşleştiğini doğrulayın (ekstra boşluk yok)

Oylar alındı ama ödül yok mu?

  • Oy işlendiğinde oyuncunun çevrimiçi olduğundan emin olun
  • Kullanıcı adının doğru yazıldığını kontrol edin (büyük/küçük harfe duyarlı!)
  • Ödül eklentinizin doğru yapılandırıldığını doğrulayın

Önemli: Kullanıcı adı büyük/küçük harfe duyarlıdır

Oyuncular kullanıcı adlarını, doğru büyük/küçük harf kullanımı dahil, oyun içinde göründüğü gibi girmelidir. Örneğin, "Player123" ve "player123" farklı kullanıcılar olarak kabul edilir.

Best Practices for Voting Rewards

Setting up voting rewards is just the first step. To maximize the impact on your server's ranking and player retention, follow these proven strategies that top-ranked Hytale servers use.

Choose Meaningful Rewards

Give rewards that players actually want but can't easily get otherwise. Exclusive cosmetics, bonus currency, or temporary boosters work better than common items. The goal is to make voting feel rewarding without making it mandatory for progression.

Create Vote Streaks

Consider implementing escalating rewards for consecutive daily votes. For example, voting 7 days in a row could unlock a special reward. This encourages habitual voting and dramatically increases your monthly vote count.

Announce Rewards In-Game

When a player receives a vote reward, broadcast it to the server. A message like "[Player] voted and received 500 coins!" reminds other players that voting rewards exist and encourages them to vote too.

Use Discord Reminders

Set up the Hylist Discord bot to post your server's vote link in a dedicated channel. Players who see a daily reminder are significantly more likely to vote consistently. You can also pin your vote link for easy access.

Frequently Asked Questions

What happens if my server is offline when a player votes?
The vote is still counted toward your server's ranking. However, the Votifier2 notification cannot be delivered while your server is offline, so the player won't receive their in-game reward immediately. Most Votifier2 plugins queue missed notifications and deliver them when the server comes back online, but this depends on your plugin's configuration.
Can I give different rewards to different players?
Yes, through your rewards plugin configuration. Most plugins support permission-based rewards, where players with certain ranks or groups receive different rewards. You can configure your voteCommand.json to run different commands based on player permissions or implement rank-based reward tiers.
Is Votifier2 compatible with proxy networks (BungeeCord/Velocity)?
Yes. Install the Votifier2 plugin on your proxy server (BungeeCord or Velocity) and configure it to forward vote notifications to backend servers. The vote port should be opened on the proxy machine. Most reward plugins support receiving forwarded votes from the proxy.
How do I test if voting rewards are working?
After setting up Votifier2 and enabling rewards in your Hylist dashboard, simply vote for your own server. Join your game server and check if you receive the configured reward. If the reward doesn't arrive, check your server console for Votifier2 connection logs and ensure the port is open and the token matches.
Sunucularıma Dön