Initial commit: NovelasVM platform with multi-engine support and Umineko Web integration

docs/TROUBLESHOOTING.md

@@ -0,0 +1,51 @@
+
+## El juego no aparece en el portal
+
+1. Verifica que `games.json` existe:
+   ```bash
+   curl -s http://localhost/games.json
+   ```
+2. Revisa los logs de nginx:
+   ```bash
+   sudo tail -50 /var/log/nginx/novelas-error.log
+   ```
+3. Asegurate de que los permisos sean correctos:
+   ```bash
+   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:
+   ```bash
+   sudo docker ps
+   ```
+2. Revisa los logs:
+   ```bash
+   sudo /opt/novelas/bin/umineko-web.sh logs
+   ```
+3. Verifica que el manifest se genero:
+   ```bash
+   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`.