Guía de solución de problemas

Si al hacer clic en jugar no hay respuesta o la ventana del juego se cierra de inmediato, comprueba los siguientes pasos:

• Comprobación de procesos en segundo plano: Si un proceso activo de Minecraft ya se está ejecutando en segundo plano (already_running), no se iniciará una nueva instancia. Haz clic en Stop en la pantalla de inicio del lanzador o finaliza el proceso colgado a través del Administrador de tareas de Windows.
• Asignación de memoria (RAM): Asignar muy poca memoria RAM (menos de 2 GB) o más del 75 % de la RAM total de tu sistema puede impedir que se inicie la máquina virtual de Java. Activa RAM automática en los ajustes del perfil o ajusta el control deslizante a una cantidad recomendada.
• Conflictos de mods: Si los mods añadidos recientemente tienen versiones o API en conflicto, la secuencia de inicio puede bloquearse. Abre Rendimiento > Solucionador de problemas para desactivar los mods sospechosos y vuelve a intentarlo.

Si Windows SmartScreen o Windows Defender muestra una advertencia al iniciar Kepler, sigue estas instrucciones:

• Por qué aparece la advertencia: Kepler Client es un proyecto en desarrollo activo y las primeras versiones aún no están firmadas con un certificado digital comercial de firma de código (sin firmar). La pantalla azul Windows protegió su PC que muestra Windows Defender SmartScreen no significa que la aplicación sea maliciosa; simplemente indica que el ejecutable aún no ha establecido una reputación amplia.
• Pasos para continuar a través de SmartScreen: Haz clic en el enlace Más información situado directamente debajo del mensaje de advertencia. A continuación, haz clic en el botón Ejecutar de todas formas que aparece en la esquina inferior derecha para iniciar el lanzador.
• Añadir una exclusión en Windows Defender para la carpeta de Kepler: Para evitar que la protección en tiempo real bloquee por error archivos del lanzador, puedes añadir una exclusión:
  1. Abre Seguridad de Windows desde el menú Inicio.
  2. Selecciona Protección contra virus & amenazas.
  3. En Configuración de protección contra virus & amenazas, haz clic en Administrar la configuración.
  4. Desplázate hacia abajo hasta la sección Exclusiones y haz clic en Agregar o quitar exclusiones.
  5. Haz clic en Agregar una exclusión, elige Carpeta y selecciona tu directorio de instalación de Kepler.

Kepler Client administra automáticamente los entornos de ejecución de Java y no requiere configuración manual en condiciones normales.

• Gestión automática de Java: Kepler determina automáticamente la versión exacta de Java requerida por la versión de Minecraft de tu perfil mediante el manifiesto oficial de versiones de Mojang, y la descarga directamente desde fuentes oficiales. No necesitas instalar Java manualmente.
• Qué hacer si falla la descarga: Las caídas temporales de red o las reglas del cortafuegos pueden interrumpir la descarga.
  1. Comprueba tu conexión a internet y confirma que tu software de seguridad no bloquee los puntos de conexión oficiales de Mojang.
  2. Abre Rendimiento > Java en el lanzador y haz clic en Detectar automáticamente/descargar Java para reiniciar el proceso.
  3. Si ya tienes un entorno de ejecución de Java compatible instalado localmente (Java 21 para Minecraft 1.20.5+ y 1.21.x, o Java 17 para 1.18–1.20.4), puedes seleccionar manualmente el binario de Java (javaw.exe) en los ajustes del perfil.

Los errores de OpenGL, los tiempos de espera del controlador o las ventanas en blanco al iniciar se suelen resolver con los siguientes pasos:

• Actualizar los controladores gráficos: La gran mayoría de los fallos en la fase de renderizado se deben a controladores de GPU desactualizados. Descarga e instala el controlador estable más reciente directamente desde los sitios web oficiales de soporte de NVIDIA, AMD o Intel.
• Probar sin shaders: Los paquetes de shaders consumen muchos recursos de la GPU y pueden tener problemas de compatibilidad con ciertas versiones del controlador. Si el juego se cierra al entrar a un mundo, desactiva los shaders en Ajustes de vídeo y prueba con el renderizado vanilla.
• Portátiles con GPU doble: Windows puede seleccionar de forma predeterminada los gráficos integrados del procesador (iGPU). Abre la Configuración de gráficos de Windows y asegúrate de que Kepler y javaw.exe estén asignados explícitamente a tu tarjeta gráfica dedicada de alto rendimiento.

Si un archivo de mod que has añadido no aparece dentro de Minecraft o en su menú de mods, comprueba estos criterios de compatibilidad:

• Requisito del cargador Fabric: Kepler Client funciona sobre el cargador de mods Fabric. Verifica que el mod que has descargado esté compilado para Fabric; los mods exclusivos para Forge o NeoForge no se cargarán en un entorno Fabric.
• Versión coincidente de Minecraft: El archivo del mod debe coincidir estrictamente con la versión de Minecraft de tu perfil (por ejemplo, un mod diseñado para 1.21.x no se cargará en un perfil 1.20.x). Buscar a través del navegador integrado de Modrinth del lanzador garantiza automáticamente la compatibilidad de versiones.
• Dependencias complementarias: Muchos mods de Fabric requieren bibliotecas auxiliares como la API de Fabric para cargarse. Consulta la documentación del mod para confirmar que todas las bibliotecas complementarias necesarias estén activadas en tu perfil.

Si te encuentras con un fallo irresoluble, puedes revisar los registros de diagnóstico y enviar un informe:

• Vista de informes de fallos del lanzador: Cuando el juego se cierra inesperadamente, el supervisor de procesos captura el código de salida y los registros de stdout/stderr. Ve a Rendimiento > Solucionador de problemas para ver la causa principal y los conflictos de mods identificados.
• Enmascaramiento de privacidad: Al hacer clic en Copiar informe o Compartir registro, se eliminan automáticamente del texto tu nombre de usuario del sistema y las rutas de archivos privadas.
• Contactar con soporte: Copia el informe depurado y visita nuestra Página de soporte para ponerte en contacto con nosotros o enviar comentarios.