141 lines
3.0 KiB
Markdown
141 lines
3.0 KiB
Markdown
# 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/`.
|