Guia de Configuração de Recompensas de Voto

Aprenda como configurar recompensas no jogo para jogadores que votam no seu servidor no Hylist.

O que é Votifier2?

Votifier2 é um protocolo que permite que sites de listagem de servidores como o Hylist enviem notificações de voto diretamente para seu servidor de jogo. Quando um jogador vota no seu servidor, o Hylist envia uma mensagem segura para seu servidor, que pode então recompensar o jogador automaticamente.

Requisitos

  • Um plugin compatível com Votifier2 instalado no seu servidor
  • Uma porta aberta para o listener Votifier (padrão: 8192)
  • Um plugin de recompensas para dar itens/vantagens aos votantes (opcional, mas recomendado)

Passo 1: Instalar um Plugin Votifier2

Primeiro, você precisa instalar um plugin compatível com Votifier2 no seu servidor Hytale. Recomendamos:

Baixar Hytale Votifier

Siga as instruções de instalação do plugin para adicioná-lo ao seu servidor.

Passo 2: Ativar Recompensas no Jogo no Hylist

Ative as recompensas no jogo no seu painel do Hylist para obter seu token Votifier.

  1. Vá para a página de edição do seu servidor no painel do Hylist
  2. Ative "Ativar recompensas no jogo"
  3. Defina a porta Votifier (padrão: 8192)
  4. Salve suas alterações
  5. Copie seu token Votifier para o próximo passo

Passo 3: Configurar o Plugin

Cole o token Votifier do Hylist no arquivo de configuração do seu plugin.

Exemplo de configuração (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>"
  }
}

Opcional: Configuração de comando de voto (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>"
  }
}

Substitua <YOUR_SERVER_SLUG> pelo slug do seu servidor (ex: "meu-servidor-incrivel"). Você pode encontrar isso na URL do seu servidor no Hylist.

Dica: Pré-preencher nome de usuário para melhor UX

Você pode adicionar ?username=NomeDoJogador à URL de voto para preencher automaticamente o nome de usuário do jogador:

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

Nota: Isso requer suporte de plugin personalizado, pois a maioria dos plugins não suporta isso por padrão.

Passo 4: Abrir a Porta

Certifique-se de que a porta Votifier está aberta e acessível pela internet.

Certifique-se de que a porta está aberta no firewall do seu servidor. Se você estiver usando um provedor de hospedagem, pode ser necessário configurar o encaminhamento de porta.

Testando Sua Configuração

Para verificar se tudo está funcionando:

  1. Certifique-se de que seu servidor está online e o plugin Votifier está rodando
  2. Vote no seu servidor no Hylist e insira seu nome de usuário no jogo
  3. Verifique o console do seu servidor para notificações de voto
  4. Verifique se você recebe as recompensas configuradas no jogo

Dicas de Segurança

Nunca compartilhe seu token Votifier publicamente! Qualquer pessoa com acesso ao seu token pode enviar notificações de voto falsas para seu servidor.

  • Mantenha seu token Votifier privado e seguro
  • Regenere seu token imediatamente se suspeitar que foi comprometido
  • Abra a porta Votifier apenas para endereços IP confiáveis, se possível

Solução de Problemas

Não está recebendo votos?

  • Verifique se a porta está aberta e acessível pela internet
  • Verifique se o endereço IP do seu servidor está correto no Hylist
  • Certifique-se de que o plugin Votifier está rodando (verifique os logs do servidor)
  • Verifique se o token corresponde exatamente (sem espaços extras)

Votos recebidos mas sem recompensas?

  • Certifique-se de que o jogador está online quando o voto é processado
  • Verifique se o nome de usuário está escrito corretamente (diferencia maiúsculas!)
  • Verifique se seu plugin de recompensas está configurado corretamente

Importante: Nome de usuário diferencia maiúsculas de minúsculas

Os jogadores devem inserir seu nome de usuário exatamente como aparece no jogo, incluindo a capitalização correta. Por exemplo, "Player123" e "player123" são tratados como usuários diferentes.

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.
Voltar para Meus Servidores