Cómo configurar la lista blanca y el contador de jugadores de Minecraft Bedrock

Antes de empezar

• Ten un servidor de Minecraft Bedrock ya existente en un panel de Pterodactyl. Este módulo se conecta a ese servidor: no contrata alojamiento ni crea un servidor por ti.
• Ten un bot de Build Discord Bots en línea en el servidor de Discord que gestionas, con Pro para poder activar el módulo Game Server.
• Un administrador que pueda crear un usuario limitado del panel para el servidor existente y concederle los permisos necesarios. Guarda los datos de conexión en privado e introdúcelos solo en el panel del bot.
• Para las solicitudes de lista blanca, prepara un canal privado de consola en Discord y un rol aprobador del staff. Para el contador de jugadores, prepara un canal de voz existente que el bot pueda ver y gestionar. Ambas funciones necesitan el panel en vivo de Bedrock y un canal de estado.

1. Activa Game Server y conecta tu servidor existente

   Abre el panel de tu bot, entra en Módulos, activa Game Server si está desactivado y abre su configuración. Elige el servidor de Discord que vas a configurar antes de guardar cualquier ajuste específico; los ajustes se leen para el servidor seleccionado, así que confirma ese selector antes de continuar.

   La sección de conexión de Pterodactyl y la del panel en vivo son independientes. No actives el panel en vivo hasta haber guardado y probado la conexión con el servidor existente. El módulo es un complemento de Discord para tu servidor Bedrock ya existente, no un asistente para crear alojamiento.

2. Prepara un usuario limitado del panel

   Pide al administrador del panel que cree un usuario, lo añada al servidor existente correspondiente y le conceda solo los permisos que necesita el panel en vivo. Los permisos básicos son websocket.connect y control.console. Los botones de encendido en vivo, opcionales, también necesitan control.start, control.stop y control.restart.

   No pegues los datos de conexión en Discord, capturas de pantalla, publicaciones de soporte ni en un canal público. Mantén el usuario del panel limitado al servidor de destino. Un usuario del panel no es una cuenta de alojamiento nueva y no cambia quién posee u opera el servidor.

3. Guarda y prueba la conexión del panel

   En la sección de Pterodactyl, introduce la conexión del servidor existente y guarda los ajustes. Usa «Probar conexión» antes de activar el panel en vivo. El panel comprueba los datos del servidor, una credencial de WebSocket, los recursos y los permisos necesarios, sin devolver las credenciales de conexión en el resultado.

   Si la prueba indica un permiso que falta, corrige el acceso del usuario limitado del panel y vuelve a probar. No evites una prueba fallida activando antes los controles de consola o de encendido. Confirma que la prueba corresponde al servidor Bedrock correcto antes de continuar.

4. Elige qué puede mostrar Discord y quién controla la consola

   En la sección del panel en vivo, elige el canal de estado y decide si el mensaje puede mostrar «Mostrar nombres de jugadores», «Mostrar dirección de conexión» y la actividad reciente. El mensaje mantenido puede mostrar el estado del servidor, el número de jugadores, la versión de Bedrock, el mundo, el modo de juego, la dificultad, CPU, memoria, disco y uso de red cuando el panel y los datos de Bedrock disponibles lo permitan.

   Si activas «Canal de consola», elige un canal de consola privado y revisa la opción de ocultar el ID de los jugadores. El puente de consola envía la salida de la consola del servidor, filtrada y agrupada, a Discord. «Permitir comandos de consola», activado por separado, permite a los administradores autorizados enviar comandos de consola sin filtrar desde ese canal. Ninguno de los dos es el chat de miembros descrito más adelante.

5. Limita la consola y los botones de encendido a administradores

   Elige los roles de Discord autorizados para usar la entrada de consola y, si los activas, «Botones de encendido». Los botones de iniciar, detener y reiniciar están restringidos por rol. El administrador que los solicita debe confirmar la acción antes de que el bot la envíe al panel.

   Prueba cada control activado con un miembro del staff en un servidor controlado. Mantén el canal de consola privado y asegúrate de que los roles elegidos coincidan con quienes deban operar el servidor existente. No trates un rol de Discord como sustituto de los límites de permisos propios del panel.

6. Aprueba una solicitud de lista blanca de Bedrock

   Cuando la prueba de conexión sea correcta, activa el panel en vivo con un canal de estado y después activa «Activar comandos de lista blanca» en la configuración de Game Server. Define los IDs de rol permitidos para añadir, retirar y consultar entradas. Para aceptar solicitudes de miembros, activa «Permitir solicitudes de miembros» y define «ID del rol aprobador». Configura el canal privado de consola para que @everyone no pueda verlo y el bot sí pueda publicar ahí. El servidor Bedrock debe estar en marcha y conectado.

   Como ejemplo, haz que un miembro de prueba envíe /whitelist request gamertag:AlexCraft. AlexCraft es un gamertag clásico de ejemplo; usa el gamertag real del jugador de prueba. El bot publica la solicitud con botones Aprobar y Denegar en el canal privado de consola. Un miembro del rol aprobador configurado pulsa Aprobar en los diez minutos siguientes. El bot envía whitelist add "AlexCraft" mediante Wings y registra si se envió. Denegar cierra la solicitud sin enviar el comando de añadir.

   El resultado de la aprobación confirma el envío a Wings, no que Bedrock aceptara el cambio. Comprueba la consola del panel y después pide al staff autorizado que ejecute /whitelist list y al jugador de prueba que intente entrar. Si no llega una respuesta de lista reconocida en ocho segundos, el bot lo indica en lugar de mostrar una lista guardada en caché. El staff también puede usar /whitelist add gamertag:AlexCraft o /whitelist remove gamertag:AlexCraft; ambos piden confirmación. Un rol de Discord por sí solo nunca añade un gamertag.

7. Muestra el número de jugadores de Bedrock en un canal de voz

   Con el panel en vivo y el canal de estado activados, activa «Canal de voz con contador de jugadores» y elige un canal de voz existente de este servidor de Discord. Dale al bot Ver canal y Gestionar canales ahí, y guarda. Esta función renombra el canal elegido; no crea un servidor de Minecraft nuevo ni una sala de voz nueva.

   Por ejemplo, una muestra actual de siete jugadores en un servidor con veinte plazas produce «Ejemplo: Jugadores: 7/20». El nombre del canal nunca contiene nombres de jugadores. Las actualizaciones se espacian al menos unos cinco minutos, así que no es un contador instantáneo de entradas y salidas. Una muestra de jugadores no disponible se muestra como desconocida; el estado desconectado y otros estados usan etiquetas de estado. Revisa el panel junto con Discord en tu primera prueba.

8. Activa el chat unidireccional de Discord a Minecraft

   El puente de chat, independiente del panel en vivo, funciona con un servidor Java o Bedrock existente mediante Pterodactyl/Wings. Guarda y prueba la conexión con los permisos websocket.connect y control.console. En la configuración de Game Server, activa «Retransmitir un canal de Discord al chat de Minecraft», introduce «ID del canal de Discord» y, si quieres, «ID del rol requerido (opcional)». Elige un canal distinto del de la consola privada de administración. El panel en vivo puede permanecer desactivado si solo usas este puente.

   Con el servidor en marcha, haz que un miembro autorizado envíe «Hello from Discord» en el canal del puente. El bot envía una emisión say filtrada con el nombre visible y el mensaje del miembro. Comprueba Minecraft durante la prueba. El texto se limita a 200 caracteres, con un máximo de un mensaje cada dos segundos por canal. Los mensajes de sobra o que no se puedan entregar se descartan, no se encolan. Los mensajes de bots y webhooks se ignoran.

   Esto es solo de Discord a Minecraft. No retransmite el chat de Minecraft a Discord, no avisa de muertes ni concede acceso al juego. Mantén el puente de consola privado para el diagnóstico del staff; permitir que los miembros envíen chat es distinto de permitirles enviar comandos de consola sin filtrar.

9. Comprueba el mensaje de estado y el alcance actual

   Activa el panel en vivo después de que la prueba de conexión sea correcta y revisa el único mensaje de estado mantenido en Discord. Comprueba que el estado mostrado y la información de recursos coincidan con tu servidor Bedrock existente, y revisa los ajustes de visibilidad elegidos antes de compartir el canal con tu comunidad.

   El analizador de estado en vivo, las herramientas de lista blanca y el canal de contador de jugadores admiten Minecraft Bedrock en Pterodactyl. No añaden estado en vivo de Java ni soporte de CS2. El puente de chat de Discord a Minecraft, por separado, admite Java o Bedrock; no devuelve el chat de Minecraft a Discord ni avisa de muertes. La aprobación de la lista blanca es una decisión del staff, no una sincronización automática de roles de Discord.