Cómo conectar NuVotifier y premiar los votos

· Administración de MinecraftRating

NuVotifier recibe eventos de voto; VotingPlugin u otro listener ejecuta el premio. Instalar solo el receptor no entrega objetos. En nuestro Paper verificamos el recorrido sitio → receptor → plugin → comando de scoreboard.

Recursos oficiales

Consulta NuVotifier, su guía, VotingPlugin, los premios y Paper. Elige versiones estables compatibles; la compilación CI de nuestra prueba no es una recomendación de producción.

Instalación y vinculación

Detén Minecraft, coloca ambos JAR en plugins, inicia y comprueba que estén activos. Ejemplo para un servidor independiente:

host: 0.0.0.0
port: 8192
disable-v1-protocol: false
forwarding:
  method: none

MinecraftRating utiliza v1. Permite ese protocolo y el puerto TCP elegido en el alojamiento/firewall, preferiblemente solo para el monitor; no abras RCON. Una red con proxy necesita otra configuración de forwarding. Confirma tu propiedad mediante MOTD en Mis servidores; en integraciones guarda dirección pública, puerto y plugins/Votifier/rsa/public.key. Nunca publiques private.key. Localhost y direcciones internas de Docker no son destinos públicos.

Premios

En VoteSites.yml activa un sitio con ServiceSite: 'MinecraftRating.com', una URL de voto y DisplayItem, por ejemplo DIAMOND. Comando de ejemplo:

Rewards:
  Commands:
  - 'give %player% minecraft:diamond 1'

Requiere un jugador conectado. Configura la cola para jugadores desconectados según la documentación. ForceOffline permite ejecutar comandos offline, pero no convierte give en un comando para inventarios offline. El modo UUID debe coincidir con tu servidor. El sitio admite un voto por servidor/cuenta/día de Moscú; cada voto cuenta dos meses naturales. Comprueba cualquier cooldown adicional para evitar conflictos.

Comprobación

Envía una prueba desde integraciones y después un voto real con el apodo correcto. Comprueba logs, listener y resultado del comando. Nuestra recompensa de prueba fue scoreboard players add %player% mcr_votes 1 con un objetivo dummy y ejecución offline explícita. Las solicitudes duplicadas no añadieron puntos. Objetos, economía y permisos necesitan sus propias comprobaciones.

FAQ

v1 confirma envío, no descifrado ni ejecución. Nuestra prueba con una clave ajena llegó a SENT sin cambiar el scoreboard. Revisa clave pública actual, ServiceSite, apodo, listener y reglas offline.

Falló la conexión. Revisa host público, puerto, mapeo Docker y firewall. Un puerto cerrado produjo un reintento limitado; restaurarlo recuperó la entrega. Una prueba local del plugin no valida el camino desde el monitor.

No. Nuestro /tmp tenía noexec e impedía cargar SQLite nativo. Usamos un directorio dedicado y -Djava.io.tmpdir=/data/cache/native, además de las rutas JNA/Netty. Adapta la ruta y permisos; no desactives globalmente la protección del sistema.

La integración actual requiere compatibilidad v1. v2 es una tarea separada.

Todos los artículos