Solución de problemas
Diagnósticos concretos para compilación, recursos, controles, guardado y límites de la revisión auditada.
En esta página
CMake no configura el proyecto
Comprueba que estás en la raíz correcta y que cmake --version muestra 3.28 o posterior. Si elegiste -G Ninja, verifica que Ninja y el compilador estén disponibles en la terminal.
CMake utiliza FetchContent para descargar dependencias. Un error de conexión, proxy o Git puede detener esa fase antes de compilar el motor. Conserva el mensaje original para distinguir una descarga fallida de un error C++.
Si necesitas cambiar de generador o compilador, configura en un directorio nuevo; no reutilices una caché generada con herramientas diferentes.
El compilador no encuentra funciones de C++20
El proyecto solicita C++20 y usa funciones de la biblioteca estándar como std::format. Seleccionar el estándar no añade funciones que falten en una biblioteca de compilador antigua. Revisa tanto la versión del compilador como su biblioteca estándar.
Las rutas de .vscode corresponden al equipo del autor. Una ruta inválida en esas opciones no significa que debas instalar las herramientas en esa misma ubicación.
El ejecutable no encuentra Config.json o los recursos
Ejecuta desde la raíz, junto a Content:
.\Build\AwesomeEngine.exeNo cambies antes al directorio Build. La configuración, shaders, texturas, fuentes y sonidos usan rutas relativas. Revisa también que los nombres coincidan exactamente con los archivos de tu copia.
Un JSON inválido o una clave obligatoria ausente puede detener el arranque. Compara con el archivo de referencia y conserva los tipos esperados.
Fallos en sistemas sensibles a mayúsculas
La revisión auditada contiene diferencias entre rutas de Git y rutas usadas por el código. Por ejemplo, el árbol contiene Engine/Include/utils y varios includes usan Utils.
Windows puede tolerar estas diferencias en su configuración habitual. Otros sistemas pueden rechazarlas. La documentación no acredita compatibilidad Linux/macOS ni presenta su compilación como verificada.
Menu o la tecla M detienen la aplicación
Engine solicita una escena llamada Menu, pero SceneFactory no registra ese nombre. En Debug puede dispararse una aserción; en otras configuraciones la consulta del mapa también puede fallar.
Evita el botón Menu, M y Select del mando en esta revisión. Usa Escape para continuar, R para reiniciar o Quit para cerrar. No hay un selector de escenas funcional que esta documentación pueda recomendar.
El juego se pausa al cambiar de ventana
Es comportamiento definido: Engine responde a la pérdida de foco pausando la escena. El bucle deja de renderizar mientras no tiene foco y mantiene el reloj actualizado. Si al volver sigue visible el overlay, utiliza Resume o Escape.
En la revisión pública de referencia cada escena controla su respuesta a la pausa. La refactorización del reloj compartido de cooldowns observada en el equipo aún era un cambio local.
No aparecen los efectos o cambia su aspecto al redimensionar
La cadena se configura solo si sf::Shader::isAvailable() es verdadero. Cuando se crea, Bloom y Monitor están activos; Glitch e inversión no están conectados al flujo normal.
Las texturas de renderizado se construyen con el tamaño de configuración. El callback de redimensionado no las reconstruye, así que no debe esperarse un sistema completo de resolución dinámica.
Un mando responde de forma inesperada
El mapeo de botones distingue vendor Microsoft y utiliza una tabla alternativa para los demás mandos. Revisa InputBindings.cpp y la identificación que proporciona SFML. No se encontró una base de datos universal de controles ni remapeo persistente en una interfaz.
El guardado no se borra al llamar Clear
SaveManager vacía los datos en memoria, pero solo escribe al destruirse si conserva valores. Por tanto, Clear no elimina necesariamente el archivo anterior. Antes de probar cambios, guarda una copia de Content/Save.json y verifica su contenido con la aplicación cerrada.
Un archivo de guardado con JSON inválido tampoco tiene recuperación general implementada.
No se guarda una captura
F12 guarda dentro de Content/Screenshots. Comprueba permisos de escritura y espacio disponible. ScreenshotManager registra si pudo guardar la imagen; el sonido de captura se reproduce únicamente cuando la operación de guardado devuelve éxito.
Comunicar un problema reproducible
Al abrir una incidencia en el repositorio, incluye el commit utilizado, sistema operativo, compilador, comando ejecutado, directorio de trabajo, mensaje de error y pasos para reproducirlo. Indica si tu copia tiene cambios locales: permite distinguir el código publicado de trabajo todavía en desarrollo.