Recompensar los votos de tus jugadores

Esta guía explica paso a paso cómo dar una recompensa en el juego a cada jugador que vota por tu servidor en MineRadar.

¿Qué método elegir?

• Plugin de MineRadar: lo más sencillo. Un archivo que colocar y un comando que escribir. Sin puerto ni Votifier.
• Votifier: el método más común. Tu servidor tiene NuVotifier (o puede instalarlo) y un puerto abierto.
• API de MineRadar: tu proveedor bloquea los puertos, o tienes un plugin o una web propios.
• Discord, como extra: cada voto anunciado en un canal de tu servidor de Discord.

Método 1: el plugin de MineRadar (lo más sencillo)

1. Descarga MineRadar.jar (Spigot o Paper, de la 1.7 a la última versión) y ponlo en la carpeta plugins/ del servidor. Reinicia.
2. En MineRadar: perfil → tu servidor → pestaña Recompensas → Generar mi comando.
3. Copia el comando /mineradar setup … y escríbelo en la consola del servidor. El plugin responde que está instalado.
4. Para elegir la recompensa, edita rewards en plugins/MineRadar/config.yml (un comando por línea, %player% = el jugador) y escribe /mineradar reload. /mineradar status muestra el estado.

rewards:
  - "give %player% diamond 1"
  - "eco give %player% 100"

Método 1: Votifier

1. Descarga NuVotifier y pon el archivo .jar en la carpeta plugins/ de tu servidor. Reinicia.
2. Abre plugins/NuVotifier/config.yml (o plugins/Votifier/). Apunta el port (8192 por defecto) y el token en tokens → default. Detalles: guía oficial de NuVotifier.
3. Comprueba que ese puerto está abierto al exterior. Con un proveedor, a menudo hay que añadirlo en el panel («Puertos» o «Allocations»).
4. En MineRadar: perfil → tu servidor → pestaña Recompensas. Pega el puerto y el token y guarda.
5. Pulsa Probar la conexión y envía un voto de prueba con tu nombre. Falta configurar el plugin que da la recompensa: mira abajo.

Configurar VotingPlugin (u otro plugin de recompensas)

NuVotifier recibe el voto, pero es otro plugin el que da la recompensa. El más usado es VotingPlugin. Solo recompensa un voto si el nombre de servicio coincide: para MineRadar es MineRadar (sin importar mayúsculas).

1. Instala VotingPlugin igual que NuVotifier y reinicia.
2. Abre plugins/VotingPlugin/VoteSites.yml y añade el bloque de abajo (tu pestaña Recompensas lo da ya relleno con tu enlace de voto).
3. Cambia la recompensa (Commands, Messages…) y escribe /av reload.
4. Envía un voto de prueba desde MineRadar. La consola debe mostrar «Received a vote from service site 'MineRadar'» y /av servicesites debe listar MineRadar. Más: documentación de VotingPlugin sobre nombres de servicio.

VoteSites:
  MineRadar:
    Enabled: true
    ServiceSite: 'MineRadar'
    VoteURL: 'https://mineradar.games/vote/votre-serveur'
    VoteDelay: 12
    Rewards:
      Messages:
        Player: '&aMerci pour ton vote sur MineRadar !'
      Commands:
      - 'give %player% diamond 1'

¿Otro plugin (SuperbVote, GAListener…)? Es lo mismo: si pide un nombre de servicio, pon MineRadar.

Método 2: la API de MineRadar

Aquí no se envía nada a tu servidor: es él quien pregunta a MineRadar quién ha votado. Ningún puerto que abrir.

1. Pestaña Recompensas → Generar una clave API. Cópiala: solo se muestra una vez.
2. Dásela a tu plugin o a tu desarrollador, solo en el servidor (nunca en una página web).
3. Cuando un jugador se conecta o escribe /vote, el plugin llama a claim con su nombre. Si la respuesta dice "reclame": true, da la recompensa. Un voto solo se reclama una vez.
4. Extra: classement devuelve tus mejores votantes (mes, 30 días o temporada) y serveur tu estado y tu puesto, para mostrarlos en tu web o tu Discord.

GET  https://mineradar.games/api/v1/votes/check?pseudo=Steve
POST https://mineradar.games/api/v1/votes/claim?pseudo=Steve
GET  https://mineradar.games/api/v1/votes/classement?periode=mois&limite=10
GET  https://mineradar.games/api/v1/serveur
Authorization: Bearer mr_…

Extra: anunciar los votos en Discord

1. En Discord: Ajustes del servidor → Integraciones → Webhooks → Nuevo webhook. Necesitas el permiso «Gestionar webhooks». Ayuda oficial de Discord.
2. Elige el canal y pulsa Copiar URL del webhook.
3. Pega la URL en la pestaña Recompensas, parte Discord, y guarda.
4. Pulsa Enviar un mensaje de prueba: debe aparecer en el canal.

Compartir tu enlace de voto

Tu pestaña Recompensas da tu enlace de voto. Añade ?pseudo= seguido del nombre del jugador para que ya esté relleno: útil en un comando /vote que envía un enlace personal.

¿No funciona?

• «Ninguna respuesta de Votifier»: el plugin no está activo, o el puerto no está abierto en tu proveedor o en el cortafuegos.
• «Token rechazado»: vuelve a copiar el token de config.yml, sin espacios antes ni después.
• Llega el voto pero no la recompensa: el nombre de servicio no es MineRadar en tu plugin de recompensas.
• «Dirección aún no resuelta»: MineRadar todavía no ha medido tu servidor. Inténtalo unos minutos más tarde.
• Recompensa doble: no uses Votifier y la API para la misma recompensa.

Volver a mi pestaña Recompensas