Dueños y creadores de plugins
Docs
Recompensa a los jugadores cuando votan y comprueba si alguien ya votó hoy — sin ahogarte en jerga.
Recompensas por voto (Votifier)
Cuando alguien vota en tu listado, MineBuff puede avisar a tu servidor de Minecraft al instante para que tu plugin de recompensas dé ítems, rangos o llaves.
- El jugador vota Abre tu página de voto en MineBuff e introduce su nombre de Minecraft.
- Avisamos a tu servidor MineBuff se conecta a tu puerto Votifier y entrega el voto.
- Se activan las recompensas NuVotifier / Classic Votifier / GAListener (o similar) gestiona la recompensa.
Configúralo en cuatro pasos
-
Instala Votifier en tu servidor de Minecraft
Usa Classic Votifier o NuVotifier. Abre el puerto 8192 (o el que elijas) en el firewall / panel del host para que internet público pueda alcanzarlo.
-
Copia tu clave o token
v1: pega plugins/Votifier/rsa/public.key (o NuVotifier rsa/public.key). v2: copia un token de NuVotifier config.yml (a menudo default).
-
Actívalo en tu listado
Panel → editar servidor → Votifier. Activa el reenvío, configura host (déjalo en blanco para usar tu IP Java), puerto y protocolo, pega la clave/token y guarda.
-
Envía un voto de prueba
Usa «Enviar voto de prueba» en el mismo formulario. Si eso funciona, los votos reales también.
Auto (recomendado)
Elige NuVotifier v2 cuando hay challenge + token disponibles; si no, cae a v1 RSA.
v1 — Clave RSA
Classic Votifier y NuVotifier RSA. Necesita el contenido del archivo de clave pública.
v2 — Token
Token HMAC de NuVotifier desde config.yml. Rápido y simple si ya usas NuVotifier.
Los plugins de recompensa que filtran por sitio de lista deberían permitir el nombre de servicio «MineBuff». Si falla la entrega, el voto del sitio sigue contando — revisa firewall y credenciales.
API de comprobación de voto
Pregunta «¿esta IP ya votó por mi servidor hoy?» Gratis, pública, sin API key.
Los jugadores siguen votando en la página de voto de MineBuff. Estas URLs solo leen si ya existe un voto para hoy (UTC).
Texto plano
Ideal para plugins simples: toda la respuesta es un solo carácter.
https://minebuff.com/api/vote/{slug}/{ip}
1- Ya votó hoy
0- Aún no ha votado (o servidor desconocido / no publicado)
curl -s "https://minebuff.com/api/vote/your-server/203.0.113.10"
JSON
La misma respuesta, más cuándo votaron y cuánto falta hasta el reinicio diario.
https://minebuff.com/api/vote/{slug}/{ip}/json
| Campo | Significado |
|---|---|
vote |
«1» o «0» (cadenas) — votó hoy o no. |
voted_at |
Hora UTC del voto de hoy, o null. |
reset_at_midnight |
Siempre true — la ventana diaria de comprobación de voto se reinicia a las 00:00 UTC (los totales de ranking son aparte y se reinician aproximadamente cada mes). |
time_until_next_vote |
Segundos hasta la próxima medianoche UTC si ya votaron; si no, 0. |
{
"vote": "1",
"voted_at": "2026-09-12T14:32:01Z",
"reset_at_midnight": true,
"time_until_next_vote": 34199
}
Qué poner en la URL
| En la URL | Significado |
|---|---|
{slug} |
El slug de tu servidor desde la URL del listado (p. ej. /servers/tu-slug). |
{ip} |
La dirección IP del jugador. La hasheamos; un voto por servidor, por IP y por día UTC. |
También funciona desde navegadores (CORS). Servidores desconocidos devuelven 0 en texto plano, o JSON HTTP 404 con error server_not_found.
Reglas de voto
Una lista corta para que el timing de tu plugin coincida con el nuestro.
- Puedes votar una vez por servidor y por IP cada día UTC (00:00 UTC). Los totales de votos de ranking se borran aproximadamente una vez al mes.
- Un voto por servidor publicado, por dirección IP y por día UTC.
- Los votos necesitan un nombre de usuario de Minecraft en el formulario de MineBuff (requerido para Votifier).
- La API de comprobación nunca crea un voto; solo informa el estado de hoy.
Ayuda
Problemas comunes cuando las recompensas o la API no se comportan.
El voto de prueba falla o no llega nada in-game
Confirma que el puerto 8192 (o el tuyo) está abierto a internet, que el host coincide con una dirección alcanzable y que la clave/token coincide exactamente con los archivos del plugin (sin espacios de más).
¿Qué protocolo debo elegir?
Empieza con Auto. Usa v2 si solo tienes un token NuVotifier. Usa v1 si solo tienes la clave pública RSA.
La API siempre devuelve 0
Comprueba que el listado está publicado, que el slug es exacto y que pasas la IP real del jugador (no 127.0.0.1 salvo que votaran desde la misma máquina).
¿Las entregas Votifier fallidas cancelan el voto?
No. El voto de MineBuff sigue contando. Arregla la conectividad y prueba de nuevo el voto de prueba del panel.
¿Puedo emitir votos por la API?
No. Los votos se emiten en la página pública de voto. La API es de solo lectura para comprobar el voto de hoy.
