Solución de problemas
Comprobaciones rápidas cuando “no arranca”. Claves/juegos/firmware: wiki oficial.
La app no inicia (Windows)
- Instala el .NET Desktop Runtime citado por el mensaje en Microsoft.
- Permite ejecución en Windows Security si quedó en cuarentena.
- SmartScreen: Más información → Ejecutar (solo ficheros desde la release oficial).
Se rompe tras actualizar
En Canary o Stable, elige etiqueta vieja y baja otro artefacto igual de plataforma. Rutas con Archivo → Abrir carpeta de Ryujinx tras abrir cualquier build. Haz backup antes.
Asset equivocado
x64 y ARM64 no son compatibles entre sí. Pasos de instalación.
Linux / SteamOS
- AppImage no corre: chmod +x al archivo u “ejecutable” desde propiedades.
- Steam Deck: solo build x64 Linux, no ARM64. Ver Linux → Steam Deck.
- No abre tras instalación vieja: cierra Ryujinx, renombra
~/.config/Ryujinx, abre de nuevo (config limpia) y repite configuración inicial. - Forge caído o login GitLab: puede ser mantenimiento — monitoriza Ryubing o reintenta; abre tag y Assets cuando el host responda.
- Modo juego (Deck) — Apply/OK atascado: abre teclado Steam (Steam + X), usa Tab para Apply luego OK. Input prueba Steam Controller em Options → Settings → Input (también Setup → Steam Deck).
- Si el teclado virtual desaparece tras suspender, reinicia el Deck.
Gráficos / sonido / input
En la app prueba otra API (Vulkan vs OpenGL) y revisa Options. Docs completas: