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

docs/UMINEKO.md

@@ -0,0 +1,109 @@
+
+## Descripcion
+
+Umineko no Naku Koro ni utiliza el motor **ONScripter-RU**, que no es compatible con OnscripterYuri generico porque usa scripts encriptados en archivos `.file` (`en.file`, `es.file`, `ru.file`).
+
+Para ejecutarlo en el navegador se utiliza el proyecto **umineko_web_asm**, que compila ONScripter-RU a WebAssembly mediante Emscripten.
+
+## Requisitos
+
+- Docker y docker-compose instalados.
+- ~15 GB de espacio libre para la imagen y los assets.
+- Archivos del juego en `/opt/novelas/projects/umineko/`.
+
+## Estructura esperada del juego
+
+```
+/opt/novelas/projects/umineko/
+├── en.file              # Script principal (ingles)
+├── es.file              # Script en espanol
+├── ru.file              # Script en ruso
+├── chiru.file           # Coordenadas de imagenes
+├── default.cfg          # Configuracion del juego
+├── game.hash            # Hash de integridad
+├── fonts/
+├── backgrounds/
+├── sprites/
+├── graphics/
+├── sound/
+└── video/
+```
+
+## Instalacion del contenedor
+
+```bash
+sudo mkdir -p /opt/novelas/tools
+cd /opt/novelas/tools
+sudo git clone --depth 1 https://github.com/VictoriqueMoe/umineko_web_asm.git umineko-web-asm
+sudo cp /opt/novelas/repo/bin/umineko-web.sh umineko-web-asm/run-umineko-web.sh
+sudo chmod +x umineko-web-asm/run-umineko-web.sh
+```
+
+## Configuracion
+
+Edita `/opt/novelas/tools/umineko-web-asm/run-umineko-web.sh`:
+
+```bash
+export GAME_PATH=/opt/novelas/projects/umineko
+export PORT=8081
+export HOSTING_MODE=local
+export SITE_URL=http://192.168.10.111/games/umineko/
+```
+
+### Modos de hosting
+
+- `local`: sirve los archivos originales. Inicio rapido.
+- `production`: convierte PNG a WebP, MP4 a WebM, etc. Reduce tamano pero tarda en iniciar.
+- `remote`: el usuario sube sus propios archivos desde el navegador.
+
+## Gestion del contenedor
+
+```bash
+sudo /opt/novelas/bin/umineko-web.sh start
+sudo /opt/novelas/bin/umineko-web.sh stop
+sudo /opt/novelas/bin/umineko-web.sh restart
+sudo /opt/novelas/bin/umineko-web.sh status
+sudo /opt/novelas/bin/umineko-web.sh logs
+sudo /opt/novelas/bin/umineko-web.sh update
+```
+
+## Integracion con nginx
+
+El portal redirige `/games/umineko/` al puerto 8081:
+
+```nginx
+location /games/umineko/ {
+    return 301 http://192.168.10.111:8081/;
+}
+```
+
+Asegurate de que el puerto 8081 este abierto en ufw.
+
+## Portada
+
+Coloca una imagen en:
+
+```bash
+/var/www/novelas/games/umineko/cover.jpg
+```
+
+Sera mostrada en el portal.
+
+## Solucion de problemas
+
+### El contenedor no arranca
+
+```bash
+sudo docker logs umineko-web-asm_umineko-web_1
+```
+
+### El juego no carga
+
+- Verifica que `default.cfg` apunte a `game-script=en.file`.
+- Comprueba que `chiru.file` y `game.hash` existan.
+- Revisa la consola del navegador.
+
+### Rendimiento lento
+
+- Considera cambiar a `production` para assets optimizados.
+- Asegurate de tener suficiente RAM y CPU.