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

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.