# Guía de motores soportados

NovelasVM soporta varios motores de novelas visuales. Esta guía describe cómo preparar y publicar cada uno.

## Tabla de motores

| Motor | Extensión/detección | Build | URL resultante |
|-------|---------------------|-------|----------------|
| Ren'Py | `project.json`, `game/script.rpy` | Compilación web | `/games/<slug>/` |
| Unity WebGL | `Build/`, `TemplateData/`, `index.html` | Copia directa | `/games/<slug>/` |
| Web genérico | `index.html` | Copia directa | `/games/<slug>/` |
| ONScripter | `0.txt`, `nscript.dat`, `ons.cfg` | Copia + OnscripterYuri | `/games/<slug>/` |
| ONScripter-RU / Umineko | `*.file`, `default.cfg`, `chiru.file` | Contenedor Docker | `/games/umineko/` |

---

## Ren'Py

### Estructura esperada

```
mi-novela/
├── project.json
├── game/
│   ├── script.rpy
│   ├── images/
│   └── audio/
└── meta.json
```

### Comando

```bash
sudo /opt/novelas/bin/build-novela.sh mi-novela /opt/novelas/projects/mi-novela renpy
```

### Consideraciones

- Requiere `xvfb` para compilar sin display.
- El build puede tardar varios minutos.
- Se generan `index.html`, `renpy.js`, `renpy.wasm`, `renpy.data`, `game.zip`.
- Recibe headers `COOP`/`COEP` automáticamente.

---

## Unity WebGL

### Estructura esperada

```
mi-juego/
├── index.html
├── Build/
│   ├── mi-juego.data.gz
│   ├── mi-juego.framework.js.gz
│   ├── mi-juego.loader.js
│   └── mi-juego.wasm.gz
└── TemplateData/
    ├── style.css
    └── UnityProgress.js
```

### Comando

```bash
sudo /opt/novelas/bin/build-novela.sh mi-juego /opt/novelas/projects/mi-juego unity
```

### Consideraciones

- No requiere compilación adicional.
- Asegúrate de que los nombres de archivo en `index.html` coincidan con los de `Build/`.

---

## Web genérico

### Estructura esperada

```
mi-web/
├── index.html
├── css/
├── js/
└── assets/
```

### Comando

```bash
sudo /opt/novelas/bin/build-novela.sh mi-web /opt/novelas/projects/mi-web web
```

### Consideraciones

- Cualquier proyecto con un `index.html` funciona.
- Si carga recursos externos, asegúrate de que CORS lo permita.

---

## ONScripter (genérico)

### Estructura esperada

```
mi-ons/
├── 0.txt              # o nscript.dat
├── default.ttf
├── ons.cfg
├── backgrounds/
├── sprites/
└── sound/
```

### Comando

```bash
sudo /opt/novelas/bin/build-novela.sh mi-ons /opt/novelas/projects/mi-ons onscripter
```

### Consideraciones

- Usa OnscripterYuri web.
- Si el script está en `nscript.dat`, OnscripterYuri debería soportarlo.
- No soporta los archivos `.file` encriptados de ONScripter-RU (ver Umineko).

---

## ONScripter-RU / Umineko

Ver [`docs/UMINEKO.md`](UMINEKO.md) para la guía completa.

Resumen:

```bash
sudo /opt/novelas/bin/umineko-web.sh start
```

- Se sirve desde contenedor Docker en `http://IP:8081/`.
- El portal redirige desde `/games/umineko/`.