Cómo vigilar un servidor de Minecraft Java desde Discord

Antes de empezar

• Ten un bot en marcha conectado a tu servidor de Discord, con acceso Pro y el módulo Vigilancia de servidores activado.
• Ten un nombre de host público o una dirección IPv4 de Minecraft Java, más un puerto si tu servidor lo necesita. La dirección se enviará a mcsrvstat.us.
• Necesitas el permiso Gestionar servidor o el rol gestor configurado para los comandos. El bot necesita Ver canal y Enviar mensajes en el canal de alertas; quien añade una vigilancia debe poder verlo.

1. Activa Vigilancia de servidores para el servidor correcto

   Abre el área de Módulos de tu bot, activa Vigilancia de servidores y abre su configuración. Selecciona el servidor de Discord, activa «Activar en este servidor» y guarda. La vigilancia por servidor está desactivada de forma predeterminada.

   Elige, si quieres, «Canal de alertas predeterminado» y «Rol de gestión». Sin canal predeterminado, una vigilancia nueva usa el canal donde se añade. Define «Límite de vigilancias» de 1 a 5; el valor predeterminado es 3. Reducir este límite no elimina las vigilancias existentes.

2. Añade una dirección pública de Java

   Usa /serverwatch add y rellena address con el nombre de host público o la IPv4 de tu servidor, opcionalmente seguido de :puerto. Por ejemplo, play.example.com:25566 ilustra la sintaxis; sustitúyela por tu propia dirección. Los puertos deben ir de 1 a 65535. El puerto predeterminado de Java, 25565, se normaliza y se elimina, así que añadir el mismo host con ese puerto no crea una vigilancia distinta.

   Introduce la dirección sola, sin https://, rutas ni espacios. No se aceptan literales IPv6 ni IPv4 privadas. Los nombres de host solo locales tampoco son válidos. Guardar una vigilancia valida el formato de la dirección; no verifica que esa dirección aloje Minecraft. El bot pregunta al servicio de estado externo por la disponibilidad, en lugar de conectarse a la consola de tu servidor.

   La respuesta indica el ID guardado de la vigilancia. Usa /serverwatch list para ver los IDs, direcciones, canales de destino, estados confirmados, estado de la comprobación y estado de entrega de alertas. Los tres comandos de gestión requieren Gestionar servidor o el rol gestor elegido.

3. Entiende cuándo puede aparecer una alerta

   Cada vigilancia vence cada cinco minutos aproximadamente mientras está activada, y el planificador busca trabajo pendiente cada 30 segundos aproximadamente. Son comprobaciones periódicas, no vigilancia en tiempo real. El primer resultado correcto establece una base silenciosa, aunque ese resultado sea desconectado; por eso guardar un servidor ya desconectado no envía de inmediato una alerta de desconexión.

   Tras esa base, dos comprobaciones consecutivas con un estado distinto confirman un cambio y disparan una alerta de desconexión o recuperación. Un hueco largo exige una nueva confirmación. Una caída que empieza y termina entre comprobaciones puede pasar desapercibida. No trates un canal silencioso como prueba de disponibilidad ininterrumpida.

   Desconectado significa que el servicio de estado devolvió un resultado desconectado para la dirección Java. No es un diagnóstico de que el proceso del servidor haya fallado. Una solicitud fallida, una respuesta inválida o un servicio de estado no disponible se registran como error de comprobación, reinician la confirmación pendiente y no cuentan como una observación de desconexión.

4. Revisa la entrega y el estado guardado

   Las vigilancias, los estados confirmados y las confirmaciones pendientes se guardan en los reinicios del bot. Desactivar el módulo pausa las comprobaciones y los comandos, pero conserva las vigilancias guardadas. No puede reconstruir una caída que ocurrió por completo mientras el bot estaba desconectado.

   El bot registra una transición confirmada antes de intentar publicarla. La falta de acceso al canal marca la entrega como bloqueada; un envío interrumpido o fallido puede quedar sin confirmar. Las alertas perdidas o inciertas no se reenvían. Revisa el destino y /serverwatch list antes de publicar una actualización manual, y restaura los permisos de canal del bot para las próximas transiciones.

5. Mueve o elimina una vigilancia

   Cambiar el canal de alertas predeterminado afecta solo a las vigilancias nuevas. Para mover una dirección existente, anota su ID, usa /serverwatch remove con id y vuelve a añadir la dirección tras elegir el nuevo destino. La vigilancia nueva empieza con una base nueva.

   Los gestores pueden eliminar una vigilancia aunque su canal anterior se haya borrado o quedado inaccesible. Eliminarla detiene las próximas comprobaciones, pero deja intactas las alertas ya publicadas en Discord. Para configurar la lista blanca de Bedrock, sigue la guía independiente en vez de intentar una dirección Bedrock aquí.