novelasvm/docs/TROUBLESHOOTING.md

El juego no aparece en el portal

1. Verifica que games.json existe:

   curl -s http://localhost/games.json
   

2. Revisa los logs de nginx:

   sudo tail -50 /var/log/nginx/novelas-error.log
   

3. Asegurate de que los permisos sean correctos:

   sudo chown -R www-data:www-data /var/www/novelas
   

Ren'Py no genera index.html

• Revisa el log del proyecto en /opt/novelas/builds/<slug>/log.txt.
• Asegurate de que xvfb este instalado.
• Aumenta el timeout en build-novela.sh si el proyecto es grande.

Unity WebGL no carga

• Verifica que index.html referencie correctamente los archivos de Build/.
• Abre la consola del navegador para ver errores 404.

Umineko no carga

1. Verifica que el contenedor este corriendo:

   sudo docker ps
   

2. Revisa los logs:

   sudo /opt/novelas/bin/umineko-web.sh logs
   

3. Verifica que el manifest se genero:

   curl -sI http://localhost:8081/manifest.json
   

Error 403/404 en assets

• Revisa permisos de /var/www/novelas.
• Verifica que nginx tenga acceso a los archivos.

Cambio de tema no persiste

• Asegurate de que localStorage no este deshabilitado.
• El tema se guarda bajo la clave novelasvm-theme.