> ## Documentation Index
> Fetch the complete documentation index at: https://docs.launcherforge.io/llms.txt
> Use this file to discover all available pages before exploring further.

# common-errors

> Resuelve problemas frecuentes del dashboard, CLI, cargas y autenticación.

# Errores comunes

## La CLI vuelve al menú después de un error

Lee el mensaje completo. Las causas habituales son sesión vencida, permisos, carpeta inválida, versión duplicada, red o límites del workspace.

Corrige la causa antes de repetir el flujo.

## El juego no aparece en la CLI

Comprueba:

* Workspace correcto.
* Permisos de la cuenta.
* Juego guardado.
* Sesión de la cuenta esperada.
* CLI actualizada.

Cierra sesión e ingresa nuevamente cuando corresponda.

## La carpeta es rechazada

Selecciona la raíz del juego empaquetado, no la raíz del proyecto de Unreal o Unity.

Debe contener el ejecutable final y sus archivos de runtime.

## La versión ya existe

Utiliza una nueva versión según tu convención. No sobrescribas una release publicada salvo que la plataforma permita explícitamente esa operación.

## La carga falla

* Mantén abierta la CLI.
* No modifiques la carpeta.
* Revisa la conexión.
* Comprueba almacenamiento y ancho de banda.
* Verifica que el antivirus o firewall no bloquee la aplicación.

## El juego se instala, pero no inicia

Revisa la ruta del ejecutable, dependencias, directorio de trabajo, permisos y nombres de archivos.

## La autenticación devuelve `valid: false`

* Inicia el juego desde LauncherForge.
* Confirma `--launchToken`.
* Revisa el entorno del endpoint.
* Comprueba expiración.
* Mantén el retraso recomendado en Unreal.
* Utiliza HTTPS en Unity.

## No se ven logs en Shipping

Añade una pantalla segura de estado o error. No expongas tokens ni datos privados.