“Windows protegió su PC” al iniciar Heronite
Elige Más información y luego Ejecutar de todas formas. Los archivos de Windows aún no tienen firma de código.
Heronite no inicia o muestra una ventana negra
En Linux, instala el controlador de Vulkan de tu GPU y comprueba que vulkaninfo muestra la GPU. Heronite usa Vulkan para mostrar la pantalla. Para AMD o Intel, instala vulkan-radeon o vulkan-intel en Arch, o mesa-vulkan-drivers en Debian y Ubuntu; para NVIDIA, el controlador de NVIDIA.
“Heronite ya está en ejecución pero no responde”
Cierra el Heronite bloqueado desde el administrador de tareas o con pkill heronite-rs, y vuelve a abrirlo.
Heronite no se actualiza
El AppImage no se actualiza
Mueve el AppImage a ~/Applications o a otra carpeta dentro de tu carpeta personal. Se reemplaza a sí mismo, así que su carpeta debe tener permiso de escritura.
“Límite de solicitudes de GitHub alcanzado”
Vuelve a buscar actualizaciones más tarde. Tu red hizo demasiadas peticiones a GitHub.
Falla un inicio de sesión o una descarga de una tienda
La ventana de inicio de sesión no se abre
Usa O inicia sesión con tu navegador en esa misma página y pega el código que te dé.
Para arreglar la propia ventana de inicio de sesión, instala:
- Linux: WebKitGTK 4.1 (
libwebkit2gtk-4.1owebkit2gtk-4.1) - Windows: Microsoft Edge WebView2 Runtime
Las descargas de GOG fallan en Linux
Instala python3. gogdl, la herramienta de descarga de GOG, lo necesita.
Un juego no abre (Linux)
Cuando un juego se cierra en los 30 segundos siguientes a abrirse y Heronite conoce la causa, aparece el diálogo Problema al abrir. Su primer botón aplica la solución y vuelve a abrir el juego. Para cualquier otro cierre, haz clic derecho en el juego y elige Solucionar problemas.
| Heronite dice | Solución |
|---|---|
| “Falta Visual C++ 2015-2022” (u otro runtime) | Haz clic en Instalar … y jugar: Heronite lo instala con Winetricks, solo en el prefijo de este juego |
| “Falta .NET Framework” | Haz clic en Instalar .NET Framework 4.8 y jugar (tarda unos minutos) |
| “DirectX 12 necesita VKD3D-Proton” | Haz clic en Activar VKD3D-Proton y jugar, o actívalo en Ajustes del juego → Compatibilidad |
| “Direct3D falló sin DXVK” | Haz clic en Activar DXVK y jugar, o actívalo en Ajustes del juego → Compatibilidad |
| “Vulkan no pudo iniciarse” | Haz clic en Copiar el comando y ejecútalo en una terminal. Instala el controlador de Vulkan, al que a menudo le falta la parte de 32 bits (lib32-vulkan-radeon, mesa-vulkan-drivers:i386, …) |
| “Wine se quedó sin archivos abiertos” | Haz clic en Usar fsync y jugar, o elige Fsync en lugar de Esync en Ajustes del juego → Compatibilidad |
| “El límite de mapas de memoria es bajo” | Haz clic en Subirlo y jugar y luego escribe la contraseña de administrador (detalles) |
| “Otro Wine sigue en marcha en el prefijo” | Haz clic en Cerrarlo y jugar, o cierra el otro juego |
| “Easy Anti-Cheat necesita su runtime” | Haz clic en Activar el runtime anti-cheat y jugar |
| “Easy Anti-Cheat bloquea a los jugadores de Linux” | Ninguna: el desarrollador no permite Linux (Are We Anti-Cheat Yet? lo marca como denegado) |
El límite de mapas de memoria es bajo (vm.max_map_count)
Muchos juegos, y Easy Anti-Cheat, necesitan vm.max_map_count en 1048576, el valor de SteamOS, Fedora, Ubuntu y Arch. Subirlo y jugar lo cambia ahora y lo mantiene tras reiniciar. Para cambiarlo tú:
echo 'vm.max_map_count = 1048576' | sudo tee /etc/sysctl.d/80-heronite-max-map-count.conf
sudo sysctl -w vm.max_map_count=1048576El juego sigue cerrándose
- Elige otra Versión en Wine / Proton, en Ajustes del juego → Compatibilidad. GE-Proton o Proton-CachyOS suelen tener las correcciones antes.
- Dale al juego un prefijo de Wine nuevo (una carpeta que funciona como un Windows solo para ese juego). En Ajustes del juego → Compatibilidad, elige Nuevo prefijo para este juego en el menú Prefijo. El prefijo nuevo empieza vacío, así que haz antes una copia de seguridad de tus partidas.
- Lee la página del juego en ProtonDB, donde los jugadores comparten lo que les funcionó.
El overlay dentro del juego no funciona (Linux)
- El botón Guide abre Steam: desactiva Guide Button Focuses Steam en Steam → Configuración → Mando.
- El overlay nunca aparece: marca Activar el overlay en Ajustes → Overlay (viene desactivado por defecto). Necesita Wayland con layer-shell (KDE Plasma, Hyprland, Sway), así que no funciona en GNOME ni en X11.
Busca los logs
Léelos en Ajustes → Logs, o abre logs/ en la carpeta de datos:
| Log | Dónde |
|---|---|
| El propio Heronite | logs/launcher/heronite-rs-<fecha>.log (uno por día, se conservan los últimos 7) |
| Un juego | logs/games/<juego>_<tienda>/launch.log (también install.log y otros) |
| Una herramienta de tienda | logs/runners/<herramienta>.log |
Para obtener más detalle:
- Inicia Heronite con
RUST_LOG=debug - Activa Logs detallados en Ajustes del juego → Avanzado (en Linux, también añade la salida de Wine)
Si Desactivar logs está marcado en Ajustes → Avanzado, desmárcalo antes de reportar un problema.
Reporta un error
Abre un issue con:
- Tu sistema: distribución o versión de Windows, escritorio, GPU y controlador
- Cómo instalaste Heronite (AppImage, paquete, instalador, portable) y su versión, en Ajustes → Acerca de
- Qué hiciste, qué pasó y qué esperabas
- Los logs de arriba