Solución de problemas
Comprobaciones rápidas cuando “no arranca”. Claves/juegos/firmware: consulta la documentación oficialprimero; la wiki Forge para casos raros.
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:
Descargas oficiales
Preguntas frecuentes
- Ryujinx no arranca — ¿necesito .NET?
- En Windows, instala la versión de .NET Desktop Runtime que indique el error desde Microsoft y vuelve a abrir Ryujinx.
- Ryujinx en Steam Deck — ¿qué build?
- Descarga siempre el AppImage o tar.gz Linux x64 — no ARM64. Configura claves y firmware primero en Modo Escritorio. Guía Steam Deck.
- ¿Pantalla negra o cierre en juegos?
- Prueba a cambiar el backend gráfico entre Vulkan y OpenGL en Opciones → Ajustes → Gráficos. Actualiza drivers y borra la caché de shaders si hace falta.
- Canary vs Stable — ¿cuál usar?
- Stable es mejor para principiantes; Canary se actualiza más rápido pero puede romperse. Puedes revertir desde la página de versiones. Canary vs Stable.