Plugin Votifier para Hytale
Plugin de votação moderno para servidores Hytale desenvolvido pela Top-Games. Recompense automaticamente seus jogadores quando votam com um sistema de níveis configurável.
Requisitos
- Servidor Hytale funcionando
- Java 25 ou superior
- Plugin WebServer instalado (plugin recomendado pelo Hytale)
- Acesso aos arquivos de configuração do servidor
Instalação do SimpleVotifier
Instalar o plugin
Copie o arquivo SimpleVotifier.jar para a pasta mods/ do seu servidor Hytale.
mods/SimpleVotifier.jar
Verificar WebServer
Certifique-se de que o plugin WebServer (plugin recomendado pelo Hytale) esteja instalado e funcionando.
Iniciar o servidor
Inicie seu servidor Hytale para que o SimpleVotifier possa gerar automaticamente sua configuração.
Configurar o plugin
Edite o arquivo de configuração gerado de acordo com suas necessidades (veja a seção Configuração).
Configuração
Após a primeira inicialização, o SimpleVotifier cria automaticamente o arquivo de configuração mods/SimpleVotifier/config.json.
Configuração padrão
mods/SimpleVotifier/config.json
{
"language": "pt",
"token": "AbCdEfGh123456789XyZ0123",
"allowedIps": [],
"logVotes": true,
"broadcastVotes": true,
"rewards": {
"enabled": false,
"monthlyReset": true,
"everyVoteCommands": [
"give {player} Plant_Crop_Carrot_Item"
],
"tiers": [
{
"votesRequired": 10,
"commands": ["give {player} Container_Bucket"]
},
{
"votesRequired": 50,
"commands": ["give {player} Armor_Iron_Head"]
},
{
"votesRequired": 100,
"commands": ["give {player} Rock_Gem_Diamond"]
}
]
},
"leaderboard": {
"enabled": true,
"format": "html",
"showVoteSites": true
},
"voteSites": [
{
"service": "Top-Games",
"url": "https://top-games.net/hytale/my-server"
}
]
}Opções de configuração
| Opção | Tipo | Descrição |
|---|---|---|
language |
string | Código do idioma (en, fr, es, de, it, pt, ru, uk, zh, ja) |
token |
string | Token seguro para autenticação HMAC (gerado automaticamente) |
allowedIps |
array | Lista de IPs permitidos (vazio = permitir todos) |
logVotes |
boolean | Registrar votos no console |
broadcastVotes |
boolean | Anunciar votos para todos os jogadores |
Configuração Top-Games
Obtenha seu token
O SimpleVotifier gera automaticamente um token que você precisa recuperar do arquivo de configuração.
mods/SimpleVotifier/config.json
Configurar no Top-Games
Vá para seu painel Top-Games, seção "Votifier" do seu servidor Hytale.
- Habilitar "SimpleVotifier"
- Digite o IP do seu servidor
- Porta: por padrão, porta do servidor + 3 (exemplo:
5523) - Digite seu token do config.json
Testar a conexão
Use o botão "Testar" no seu painel Top-Games para verificar se a comunicação funciona corretamente.
Sistema de Recompensas (opcional)
O SimpleVotifier inclui um sistema de recompensas integrado com comandos para cada voto e recompensas por níveis.
Configuração de recompensas
config.json (rewards section)
{
"rewards": {
"enabled": true,
"monthlyReset": true,
"everyVoteCommands": ["give {player} Plant_Crop_Carrot_Item"],
"tiers": [
{
"votesRequired": 10,
"commands": ["give {player} Container_Bucket"]
},
{
"votesRequired": 50,
"commands": ["give {player} Armor_Iron_Head"]
},
{
"votesRequired": 100,
"commands": ["give {player} Rock_Gem_Diamond"]
}
]
}
}Comandos do jogador
| Comando | Descrição |
|---|---|
/rewards |
Reivindicar recompensas de voto pendentes |
/vote |
Listar sites de votação configurados |
/voteinfo |
Ver suas estatísticas de voto e progresso de níveis |
API para Desenvolvedores
Plugins de terceiros podem ouvir eventos de voto através do EventBus do Hytale.
MyPlugin.java
import com.hypixel.hytale.server.core.HytaleServer;
import net.top_games.hytale.plugins.simplevotifier.VoteEvent;
public class MyPlugin extends JavaPlugin {
@Override
protected void setup() {
HytaleServer.get().getEventBus()
.listenFor(VoteEvent.class, null)
.listen(this::onVote);
}
private void onVote(VoteEvent event) {
String username = event.getUsername();
String service = event.getServiceName();
getLogger().atInfo().log(username + " voted on " + service);
// Add your custom logic here
}
}Ranking (opcional)
O SimpleVotifier inclui um endpoint de ranking para exibir os melhores votantes no seu servidor.
Configuração do ranking
config.json (leaderboard section)
{
"leaderboard": {
"enabled": true,
"format": "html",
"showVoteSites": true
}
}Opções do ranking
| Opção | Tipo | Descrição |
|---|---|---|
enabled |
boolean | Habilitar/desabilitar o endpoint de ranking (desabilitado por padrão) |
format |
string | Formato de saída padrão: "html" ou "json" (html por padrão) |
showVoteSites |
boolean | Mostrar/ocultar a seção de sites de votação no ranking |
Endpoint do ranking
GET https://your-server:port/Top-Games/SimpleVotifier/leaderboard
Solução de Problemas
- Verifique se o plugin WebServer está instalado
- Verifique os logs do servidor para mensagens de erro
- Verifique se a assinatura HMAC está sendo gerada corretamente
- Verifique a configuração de allowedIps
- Revise os logs do servidor para mensagens de erro
- Certifique-se de que rewards.enabled seja true
- Verifique a sintaxe dos comandos na configuração
- Verifique se o jogador está online ou use /rewards para reivindicar
- Confirme que monthlyReset está habilitado
- Verifique o arquivo last_reset.txt para a última data de reset
- O reset é acionado no primeiro voto do novo mês
Informações
Funcionalidades
- Autenticação HMAC-SHA256 segura
- Sistema de recompensas integrado
- Suporte a 10 idiomas
- Broadcast de votos para todos os jogadores
- Reset mensal de votos
- API baseada em eventos para plugins de terceiros
- Endpoint de ranking (HTML/JSON)
Resumo da configuração
- Instalar o plugin WebServer
- Instalar SimpleVotifier
- Configurar config.json
- Configurar no Top-Games
- Testar a conexão
- Configurar recompensas
- Configurar o ranking
Suporte
Precisa de ajuda para configurar o SimpleVotifier? Nossa equipe está aqui para ajudá-lo.
Descubra servidores Hytale
Explore nosso ranking dos melhores servidores Hytale e junte-se à comunidade!
Ver servidores Hytale