Cómo gestionar la lista blanca de Minecraft Bedrock desde Discord

Antes de empezar

• Ten un servidor de Minecraft Bedrock en marcha en Pterodactyl, con la aplicación de lista blanca configurada en ese servidor.
• Ten la URL del panel de Pterodactyl, el identificador del servidor y una clave API de cliente con los permisos websocket.connect y control.console para ese servidor.
• Ten un bot de Discord conectado con Game Server activado, un canal de estado en vivo y los roles gestores de lista blanca elegidos.
• Para las solicitudes de miembros, prepara un canal de consola oculto para @everyone y un rol aprobador designado con acceso a ese canal.

1. Conecta el servidor Bedrock en marcha

   Crea tu cuenta con el enlace de registro, conecta tu bot y activa Game Server en Módulos. Abre la configuración de tu servidor de Discord. Introduce la URL del panel de Pterodactyl, la clave API de cliente y el identificador del servidor. Guarda la clave en el campo de configuración en vez de publicarla en Discord.

   Activa el panel en vivo y elige su canal de estado. Guarda los ajustes y usa «Probar conexión» para comprobar la conexión guardada. Los comandos de lista blanca necesitan esa configuración del panel en vivo, una conexión autenticada y un servidor en marcha. Esta guía configura la gestión de acceso de un servidor Bedrock ya existente; no crea ni aloja el servidor de Minecraft.

2. Elige los roles gestores y, si quieres, un aprobador de solicitudes

   Activa «Activar comandos de lista blanca» en la configuración de Game Server e introduce los IDs de rol de Discord autorizados para añadir, retirar y consultar entradas en «IDs de roles permitidos». Estos comandos comprueban los roles elegidos; el permiso Administrador de Discord o los roles de administrador de los controles de encendido del módulo, que son independientes, no evitan esta comprobación. No uses @everyone como rol gestor de lista blanca.

   Si quieres que los miembros puedan pedir acceso, activa «Permitir solicitudes de miembros» y define «ID del rol aprobador». Configura un canal de consola oculto para @everyone, con acceso para el bot y tus aprobadores; los botones de solicitud aparecen ahí. Un canal de consola visible para @everyone o un hilo se rechaza. Cuando hay un canal de consola configurado, los comandos directos también comprueban que sea privado.

3. Añade, retira y consulta gamertags de Bedrock

   Usa /whitelist add con la opción gamertag desde una cuenta con un rol permitido. Introduce un gamertag clásico de Bedrock, no un nombre de usuario de Java ni un nombre visible moderno con sufijo #. El formato aceptado es de 1 a 15 caracteres ASCII, empezando por una letra; se permiten letras, dígitos, comas y espacios simples, sin espacios al final ni repetidos.

   Revisa la confirmación y elige Confirmar para enviar la adición a la lista blanca, o Cancelar para detenerla. La confirmación pertenece a quien la solicitó y caduca al minuto. Usa /whitelist remove con la opción gamertag para retirarlo; usa el mismo flujo de confirmación.

   Usa /whitelist list para pedir la lista actual a la consola del servidor. El bot muestra la salida de lista blanca reconocida, no registros de consola arbitrarios. Si no llega una respuesta reconocida en ocho segundos, informa del tiempo agotado y pide que inspecciones la consola del panel; no muestra una lista guardada en caché.

4. Revisa las solicitudes de acceso de los miembros

   Con las solicitudes activadas, un miembro puede usar /whitelist request e introducir un gamertag. El bot publica la solicitud con botones Aprobar y Denegar en el canal privado de consola. La solicitud no verifica que quien la pide sea dueño de esa cuenta de Minecraft; tu aprobador debe evaluarla.

   Solo un miembro con el rol aprobador configurado puede aprobar o denegar esa solicitud. Aprobar envía un comando whitelist add; denegar no añade el gamertag. La solicitud caduca a los diez minutos. Tras la decisión, el bot cierra los botones de la solicitud y registra una entrada de auditoría.

   Las solicitudes y confirmaciones pendientes se guardan en memoria. Un reinicio del bot invalida los botones antiguos, y los cambios relevantes de conexión o de roles también pueden caducarlos. Pide al miembro que envíe una solicitud nueva si la anterior ya no es válida.

5. Lee los fallos y verifica el resultado

   Una respuesta de desactivado significa que la configuración de lista blanca o del panel en vivo está incompleta o no disponible para ese servidor de Discord. Una respuesta de denegado apunta a los roles o ajustes de solicitud elegidos. Una respuesta de desconectado significa que el servidor no está en marcha; una respuesta de conexión significa que la conexión autenticada no está disponible. Corrige lo indicado antes de volver a intentarlo.

   Los comandos tienen límite de frecuencia, y un miembro no puede acumular varias acciones pendientes. Si recibes una respuesta de límite de frecuencia o de acción pendiente, espera o termina la acción existente. Un fallo de canal privado exige comprobar el acceso al canal de consola. Tras un envío incierto, inspecciona la consola del panel antes de repetir el mismo cambio.

   Prueba con un gamertag que controles, comprueba la lista resultante del servidor y verifica la aplicación de la lista blanca en tu propio servidor. El módulo envía comandos individuales; no activa la aplicación del lado del servidor, no sincroniza roles de Discord con la lista blanca ni ofrece una conexión de lista blanca para Java.