VoteListener

HytaleVoteListener

Un plugin de recompensas por votaciones para servidores de Hytale. Escucha los votos de HytaleVotifier y recompensa a los jugadores con comandos configurables. ¡NECESITAS instalar HytaleVotifier para que este plugin funcione!

Instalación

• Descarga la última versión de hytale-votelistener-1.0.0-SNAPSHOT.jar desde Releases
• Coloca el archivo JAR en la carpeta mods/ de tu servidor
• Instala HytaleVotifier si aún no lo has hecho
• Inicia tu servidor; se generará un config.json por defecto
• Configura tus recompensas en plugins/HytaleVoteListener/config.json
• Reinicia el servidor o recarga el plugin

Configuración

El plugin crea un archivo config.json en plugins/HytaleVoteListener/ con las siguientes opciones:

Ajustes Básicos

{
  "commands": [
    "say %player% ha votado en %service%",
    "give %player% Weapon_Staff_Onyxium"
  ],
  "broadcastVote": false,
  "debugMode": false
}

Opción	Tipo	Descripción
commands	Array	Lista de comandos a ejecutar cuando un jugador vote. Soporta marcadores de posición (ver abajo).
broadcastVote	Booleano	No se utiliza actualmente. Usa un comando say en tu lista de comandos en su lugar.
debugMode	Booleano	Habilita el registro detallado para solucionar problemas.

Marcadores de posición

Utiliza estos marcadores de posición en tus comandos; se reemplazarán con valores reales:

Marcador de posición	Descripción
%player%	El nombre de usuario del jugador que votó
%service%	El nombre del sitio de votación
%uuid%	El UUID del jugador (si está disponible)
%timestamp%	Cuándo se recibió el voto
%streak%	La racha actual de votos del jugador (días consecutivos)
%totalvotes%	El total de votos de por vida del jugador
%reward%	El nombre del nivel de recompensa aleatoria recibido

Recompensas Aleatorias

Ofrece a los jugadores la oportunidad de recibir recompensas adicionales con probabilidad ponderada.

{
  "randomRewardsEnabled": true,
  "randomRewards": [
    {
      "name": "common",
      "chance": 70.0,
      "commands": ["give %player% Consumable_Apple 5"]
    },
    {
      "name": "rare",
      "chance": 25.0,
      "commands": ["give %player% Armor_Leather_Chest"]
    },
    {
      "name": "legendary",
      "chance": 5.0,
      "commands": [
        "give %player% Weapon_Sword_Legendary",
        "say %player% ha recibido una recompensa de voto legendaria!"
      ]
    }
  ]
}

Opción	Tipo	Descripción
randomRewardsEnabled	Booleano	Habilitar o deshabilitar recompensas aleatorias.
randomRewards	Array	Lista de niveles de recompensa con probabilidades ponderadas.
name	String	Nombre para mostrar del nivel de recompensa.
chance	Número	Peso para este nivel (no necesita sumar 100).
commands	Array	Comandos a ejecutar si se selecciona este nivel.

Cómo funcionan las probabilidades: Las probabilidades son pesos, no porcentajes. Si tienes recompensas con probabilidades de 70, 25 y 5, el total es 100, por lo que funcionan como 70%, 25% y 5%. Pero si tuvieras probabilidades de 7, 2.5 y 0.5, funcionaría de la misma manera.

Bonificaciones por Racha de Votos

Recompensa a los jugadores por votar en días consecutivos.

{
  "streakBonusEnabled": true,
  "streakBonuses": [
    {
      "streakDays": 3,
      "name": "3-días",
      "commands": ["give %player% Consumable_Potion_Health"]
    },
    {
      "streakDays": 7,
      "name": "semanal",
      "commands": [
        "give %player% Tool_Pickaxe_Iron",
        "say %player% tiene una racha de votos de %streak% días!"
      ]
    },
    {
      "streakDays": 30,
      "name": "mensual",
      "commands": ["give %player% Armor_Set_Rare"]
    }
  ]
}

Opción	Tipo	Descripción
streakBonusEnabled	Booleano	Habilitar o deshabilitar bonificaciones por racha.
streakBonuses	Array	Lista de hitos de racha.
streakDays	Número	El día exacto de la racha para activar esta bonificación (por ejemplo, 7 = en su séptimo día consecutivo).
name	String	Nombre para mostrar de esta bonificación por racha.
commands	Array	Comandos a ejecutar cuando el jugador alcance esta racha.

Nota: Las bonificaciones por racha se activan cuando la racha del jugador coincide exactamente con streakDays. Un jugador con una racha de 7 días recibirá la bonificación de 7 días, pero no la bonificación de 3 días en esa votación.

Bonificaciones por Hitos

Recompensa a los jugadores por alcanzar hitos de votos totales.

{
  "milestoneBonusEnabled": true,
  "milestoneBonuses": [
    {
      "votesRequired": 10,
      "name": "primer-diez",
      "commands": ["give %player% Consumable_Potion_Health 3"]
    },
    {
      "votesRequired": 50,
      "name": "cincuenta",
      "commands": ["give %player% Weapon_Bow_Rare"]
    },
    {
      "votesRequired": 100,
      "name": "centuria",
      "commands": [
        "give %player% Mount_Horse_Rare",
        "say %player% alcanzó %totalvotes% votos totales!"
      ]
    }
  ]
}

Opción	Tipo	Descripción
milestoneBonusEnabled	Booleano	Habilitar o deshabilitar bonificaciones por hitos.
milestoneBonuses	Array	Lista de hitos de conteo de votos.
votesRequired	Número	El conteo total de votos exacto para activar esta bonificación.
name	String	Nombre para mostrar de este hito.
commands	Array	Comandos a ejecutar cuando el jugador alcance este hito.

Ejemplo Completo de Configuración

{
  "commands": [
    "say %player% ha votado en %service%",
    "give %player% Weapon_Staff_Onyxium"
  ],
  "broadcastVote": false,
  "debugMode": false,
  "randomRewardsEnabled": true,
  "randomRewards": [
    {
      "name": "common",
      "chance": 70.0,
      "commands": ["give %player% Consumable_Apple 5"]
    },
    {
      "name": "rare",
      "chance": 25.0,
      "commands": ["give %player% Armor_Leather_Chest"]
    },
    {
      "name": "legendary",
      "chance": 5.0,
      "commands": ["give %player% Weapon_Sword_Legendary"]
    }
  ],
  "streakBonusEnabled": true,
  "streakBonuses": [
    {
      "streakDays": 7,
      "name": "semanal",
      "commands": ["give %player% Tool_Pickaxe_Iron"]
    }
  ],
  "milestoneBonusEnabled": true,
  "milestoneBonuses": [
    {
      "votesRequired": 100,
      "name": "centuria",
      "commands": ["give %player% Mount_Horse_Rare"]
    }
  ]
}

Votación Offline

Si un jugador vota mientras está desconectado, sus recompensas se almacenan y se entregan automáticamente cuando se une al servidor de nuevo. Los jugadores también pueden usar el comando /claimvotes para reclamar manualmente cualquier recompensa pendiente.

Archivos de Datos

El plugin almacena datos en la carpeta plugins/HytaleVoteListener/:

Archivo	Descripción
config.json	Configuración del plugin
vote_data.json	Estadísticas de votos de los jugadores (rachas, votos totales)
pending_rewards.json	Recompensas en cola para jugadores offline

Comandos

Comando	Permiso	Descripción
/claimvotes	hyvote.claimvotes	Reclamar manualmente recompensas de votos pendientes

Requisitos

• Servidor de Hytale
• Plugin HytaleVotifier

Soporte

Para problemas y solicitudes de funciones, por favor abre un problema en GitHub, o contáctanos en https://hyvote.org.

Licencia

Licencia MIT

Copyright (c) 2026 Hyvote

Se concede por la presente, sin cargo, a cualquier persona que obtenga una copia de este software y los archivos de documentación asociados (el “Software”), el derecho a tratar en el Software sin restricción, incluyendo sin limitación los derechos a usar, copiar, modificar, fusionar, publicar, distribuir, sublicenciar y/o vender copias del Software, y a permitir a las personas a quienes se les proporcione el Software hacerlo, sujeto a las siguientes condiciones:

El aviso de copyright anterior y este aviso de permiso deberán incluirse en todas las copias o porciones sustanciales del Software.

EL SOFTWARE SE PROPORCIONA “TAL CUAL”, SIN GARANTÍA DE NINGÚN TIPO, EXPRESA O IMPLÍCITA, INCLUYENDO PERO NO LIMITÁNDOSE A LAS GARANTÍAS DE COMERCIABILIDAD, ADECUACIÓN PARA UN PROPÓSITO PARTICULAR Y NO INFRACCIÓN. EN NINGÚN CASO LOS AUTORES O TITULARES DEL COPYRIGHT SERÁN RESPONSABLES DE CUALQUIER RECLAMO, DAÑO O CUALQUIER OTRA RESPONSABILIDAD, YA SEA EN UNA ACCIÓN DE CONTRATO, AGRAVIO O DE OTRA MANERA, QUE SURJA DE O EN CONEXIÓN CON EL SOFTWARE O EL USO O CUALQUIER OTRA MANIPULACIÓN EN EL SOFTWARE.