Guía de usuario

Kepler se encuentra actualmente en pruebas privadas y las descargas aún no están disponibles. Cuando se lance, funcionará en Windows, macOS y Linux; el entorno de ejecución de Java necesario se selecciona automáticamente desde el manifiesto de versiones de Mojang y se descarga desde fuentes oficiales, por lo que no es necesaria ninguna instalación manual de Java.

• Por qué aparece el aviso de SmartScreen: Kepler es una aplicación nueva y todavía no está firmada con un certificado digital de firma de código. Windows Defender SmartScreen puede mostrar la pantalla azul Windows protegió su PC para binarios nuevos; esto no es una detección de malware, sino simplemente un aviso de editor no reconocido.
• Instalación paso a paso: Haz clic en el enlace Más información debajo del mensaje en el cuadro de diálogo de SmartScreen y, a continuación, haz clic en el botón Ejecutar de todas formas en la esquina inferior derecha para continuar.
• Verificación de SHA-256: Para verificar la integridad del archivo, ejecuta Get-FileHash .\KeplerClient-Kurulum.exe -Algorithm SHA256 en Windows PowerShell y compara el hash resultante con la suma de comprobación oficial de SHA-256 indicada en la página de descargas.

En el primer inicio, el asistente de configuración te guía a través de las preferencias iniciales. Puedes volver a ejecutar el asistente en cualquier momento desde Ajustes > Avanzado > Volver a ejecutar configuración o navegar rápidamente mediante la paleta de comandos Ctrl+K.

• Añadir una cuenta: Abre el menú de cuentas en la esquina superior derecha para iniciar sesión con una cuenta oficial de Microsoft/Xbox mediante PKCE OAuth2 en el navegador de tu sistema (los tokens de actualización se guardan en el depósito de claves de tu SO), o crea una Cuenta sin conexión local de 3 a 16 caracteres para jugar en solitario.
• Perfil listo o personalizado: Empieza con el perfil optimizado predeterminado o crea una instancia limpia o con mods (Fabric, Quilt) desde Biblioteca > + Nuevo perfil. Inicialmente se admite Minecraft 1.21.x con Fabric; 6 versiones desde 1.20 hasta 26.3 están en pruebas.
• Importar desde otros lanzadores: Escanea automáticamente los lanzadores instalados (como Prism Launcher o la app de Modrinth) e importa los perfiles existentes junto con sus mundos.

El catálogo de mods de Kepler comienza con Modrinth. Kepler no distribuye archivos de juego modificados preempaquetados; todos los mods se descargan directamente desde fuentes oficiales con verificación SHA-1.

• Buscar e instalar mods: Selecciona tu perfil de destino en la pantalla Descubrir y busca en el catálogo de Modrinth. La compatibilidad de mods y las dependencias requeridas se resuelven automáticamente para la versión del juego de tu perfil.
• Gestionar y actualizar mods: En la pestaña Mods de un perfil bajo Biblioteca, filtra los mods instalados por Todos, Activados o Desactivados, y haz clic en Buscar actualizaciones para revisar las nuevas versiones.
• Paquetes de mods .mrpack: Importa archivos .mrpack y .zip compatibles de Modrinth con protección contra escalada de directorios y filtrado de dominios permitidos, o exporta tu perfil como un paquete.

Comparte la configuración de tu perfil sin enviar archivos pesados mediante un código compacto de compartición de perfil KEPLER1:.

• Estructura de la carga útil: Con el prefijo KEPLER1: seguido de JSON en Base64 seguro para URL, el código codifica la versión del esquema, el nombre del perfil, la versión de Minecraft, información opcional del cargador de mods e identificadores de mods de Modrinth (project_id, version_id, filename).
• Límites de privacidad y validación: Un código de compartición nunca incluye el contenido de archivos, rutas del sistema de archivos local, credenciales de cuenta ni configuraciones privadas. Las importaciones validan un tamaño máximo de 64 KB y hasta 500 mods.
• Exportación de ajustes: También puedes exportar e importar la configuración del lanzador, temas y listas de servidores como un archivo JSON independiente.

Para ordenadores con memoria limitada o procesadores modestos, Kepler proporciona análisis de hardware y ajustes preestablecidos de inicio optimizados.

• Ajuste preestablecido para hardware modesto: En los ajustes del perfil bajo Ajuste de rendimiento, elige entre las plantillas de argumentos JVM Hardware modesto (modo PC modesto), Equilibrado o Alto rendimiento.
• RAM automática y calibración: La asignación recomendada de memoria (heap) se calcula a partir de la memoria RAM total/disponible de tu sistema, el recuento de núcleos de CPU, el número de mods y la versión de Minecraft. La calibración integrada en el lanzador de 2‑3 minutos prueba de 3 a 4 perfiles candidatos y selecciona el perfil ganador para tu hardware.
• Opciones de interfaz ligera: Desactiva las animaciones del lanzador y activa la Vista compacta en Ajustes > Juego.

Las capturas de pantalla del juego para cada perfil se almacenan por separado dentro del directorio <profile>/screenshots de esa instancia.

• Exploración y vista previa: El lanzador enumera las capturas de pantalla .png para el perfil seleccionado ordenadas de las más recientes a las más antiguas (hasta 500 capturas de pantalla por consulta y 12 MB por imagen).
• Eliminar y abrir carpeta: Elimina capturas de pantalla no deseadas directamente desde el lanzador o abre el directorio de screenshots del perfil en el administrador de archivos predeterminado de tu sistema operativo.

Antes de añadir mods o cambiar de versión, protege tus datos desde la pestaña Copias de seguridad dentro de cualquier perfil en Biblioteca.

• Copias de seguridad atómicas en .zip: Haz clic en Crear copia de seguridad, selecciona el alcance Solo mundos o Perfil completo, añade una etiqueta opcional y genera un archivo .zip con un solo clic.
• Restauración segura: Consulta las copias de seguridad existentes con metadatos de fecha y tamaño, elimina archivos antiguos o ejecuta Restaurar copia de seguridad, lo que crea automáticamente una copia de seguridad preventiva antes de restaurar.

Conéctate directamente a servidores multijugador desde la pantalla Servidores integrada en el lanzador o mediante argumentos de inicio por línea de comandos.

• Lista de servidores y ping SLP: Guarda servidores multijugador, supervisa el estado en línea, el recuento de jugadores y la latencia (ms) de forma individual o masiva mediante el protocolo Server List Ping (SLP), y haz clic en Unirse para acceder directamente a un servidor.
• Argumentos de inicio de CLI: Inicia Kepler con --server <host[:port]>, --port <n> y --profile <id> (o --server=host:port) para conectar el perfil elegido directamente al servidor de destino.
• Validación de direcciones: Las direcciones mal formadas que contienen espacios y las direcciones de enlace local/metadatos (169.254.x.x) se rechazan por seguridad.

Cuando el juego se cierra de forma inesperada, el supervisor del proceso inspecciona el código de salida y el búfer circular de líneas recientes de la consola stdout/stderr.

• Detección de conflictos: En Rendimiento > Solucionador de problemas, Kepler enumera las causas probables del fallo y los mods sospechosos de causar conflictos; puedes desactivar un mod en conflicto con un solo clic mediante Desactivar mod o Probar corrección.
• Enmascaramiento de privacidad: Al utilizar Copiar informe o Compartir registro, un filtro de privacidad oculta automáticamente tu nombre de usuario y las rutas de archivos del sistema local.

Advertencias habituales y cómo resolverlas:

• "El juego ya se está ejecutando" (already_running): Un proceso activo de Minecraft se está ejecutando en segundo plano. Haz clic en Detener en la pantalla de inicio o espera a que el proceso se cierre antes de iniciar de nuevo.
• El juego se cierra al iniciar: Dos mods pueden tener un conflicto de renderizado o de API. Abre Rendimiento > Solucionador de problemas y desactiva el mod sospechoso.
• Falta de memoria o tirones: Es posible que se haya asignado muy poca RAM o más del 75% de la memoria del sistema al perfil. Activa RAM automática en los ajustes del perfil o vuelve a ejecutar la prueba de calibración.
• Java no compatible (unsupported_java): Abre Rendimiento > Java y usa Detectar automáticamente/descargar Java para la versión de Minecraft seleccionada.
• El inicio de sesión de Microsoft no se completa: Si se agotó el tiempo de espera de autenticación en el navegador, haz clic en Cancelar e inicia de nuevo el proceso de inicio de sesión.