Alexia visual novel es un motor de novelas visuales con el cual puedes crear y reproducir novelas visuales de una manera muy sencilla desde tu celular android. Puedes ingresar textos, imágenes, sonidos y vídeos para crear un gran historia. Es muy fácil de usar con instrucciones intuitivas y no es necesario saber programar.
https://play.google.com/store/apps/details?id=maceda.alejandro.alexiavnplayer
Crear un proyecto en blanco desde la aplicación dirigiéndote al menú de la parte superior y presionando el botón Crear proyecto en blanco, Finalmente, ponle un nombre a tu proyecto y presiona aceptar.
quickstart1.mp4
Después, con ayuda de una navegador de archivos (recomendamos ASTRO) o conectando tu celular a una computadora dirígete a la carpeta alexavn.
Dentro de alexavn encontrarás una carpeta con el nombre de tu proyecto y dentro de esa carpeta verás lo básico para crear una novel visual.
Screenrecorder-2021-05-11-14-58-44-631.mp4
Dentro de la carpeta de tu proyecto tendrás que poner la imagen que quieras como portada de tu novela visual.
Ahora, dirígete a la carpeta Scenes y coloca la imagen que usaras como fondo en tu novela visual (en está carpeta pondrás todas las imágenes que vayas a ocupar).
Después, dirígete a la carpeta Scripts y crea un archivo con extensión .txt (en está carpeta guardarás los archivos que van a ser leídos por la aplicación).
Screenrecorder-2021-05-11-18-40-05-212.mp4
Con ayuda del editor de texto de tu preferencia abre el archivo con extensión .txt y comienza a escribir tu historia. Primero, coloca todos los recursos con los que quieres que inicie tu novela, en este caso agregamos el fondo y el texto que deseamos mostrar en la pantalla utilizando el símbolo + como separador.
Regresa a donde están todas las carpetas de tu proyecto y con ayuda de tu editor de texto abre el archivo config.avn, dentro de ese archivo pondrás el título de tu novela, el archivo de tu carpeta Scripts con el que deseas iniciarla y la imagen que desees como portada en ese orden y separados por una coma ",".
Abre Alexia VN player, busca el archivo config.avn y haz click sobre él para cargar tu novela.
Finalmente, haz click sobre la portada de tu novela para iniciarla.
Screenrecorder-2021-05-11-18-32-54-797.mp4
Un proyecto básico de Alexia VN contiene 10 carpetas:
- Carpeta con el nombre del proyecto
- BGM
- Chars
- FX
- Menu
- Scenes
- Scripts
- Textbox
- Video
- Voices
y 2 archivos:
- config.avn
- Una imagen para la portada de la novela
La estructura de las carpetas tiene la siguiente forma.
En la carpeta BGM se almacenan la música de fondo que van en la novela visual, la extensión de los archivos puede ser .mp3, .Wav, .Flac, etc.
En la carpeta Chars se almanecen las imagenes de los personajes de la novela visual, se recomienda utilizar imagenes con extensión .png y sin fondo.
En la carpeta FX se almencen los efectos de sonido que se utilicen en la novela visual, la extensión de los archivos puede ser .mp3, .Wav, .Flac, etc.
Estamos trabajando en ello...
En la carpeta Scenes se almacenan la mayoria de las imágenes que se van a utilizar en la novela visual, como los fondos, escenas, etc. La extensión de los archivos puede ser .jpp, .png, .bmp, etc.
En la carpeta Scripts se almacenan los archivos que son leidos por la aplicación los cuales contendrán todas las instrucciones, estos archivos deben tener una extensión .txt .
En la carpeta Textbox se almacenan las imágenes de las cajas de texto que se utilizarán en la novela visual, las imágenes se recomiendan guardar con extensión .png y sin fondo para una mejor experiencia.
En la carpeta Video se almacenan los vídeos que se utilizarán en la novela visual. La extensión de los archivos de video puede ser .mp4, .avi, .mkv, .flv, etc.
Estamos trabajando en ello...
El archivo config.avn debe contener solo 3 elementos:
- Título de la novela visual
- Archivo de la carpeta Scripts con el cual se desea iniciar la novela
- Imagen de la portada para la novela visual
Con ayuda de un editor de texto abrir el archivo y colocar los elementos en ese, orden separados por comas.
El archivo de portada es una imagen la cual será la portada de la novela visual y se vizualizara al cargar el archivo config.avn a la aplicación. La extensión del archivo puede ser .jpp, .png, .bmp, etc.
La manipulación y vizualización de las diferentes carpetas y archivos se puede hacer en la computadora sin ningún problema, solo se debe conectar el celular a está y navegar por sus archivos hasta encontrar el proyecto.
A continuación se describirán las intrucciones con las que cuenta Alexia VN, estas instrucciones van dentro de los archivos txt que se encuentran dentro de la carpeta Scripts, observe que se utiliza el símbolo + como separador.
La instrucción reproduce sonidos, debe llevar dos parámetros, la palabra looping y el nombre del archivo que se desea reproducir ubicado en la carpeta BGM.
La instrucción coloca la imagen de un personaje, necesita dos parámetros, la posición las cuales pueden ser left para ponerlo a la izquierda de la pantalla, center para ponerlo al centro de la pantalla o right para ponerlo a la derecha de la pantalla y el nombre de la imagen del personaje que se encuentra en la carpeta Chars.
La instrucción es similar a [CHAR] la diferencia es que [CHARBIG] hace la imagen del personaje mas grande, tiene los mismos parametros que char.
La instrucción es similar a [CHARBIGCLEAR], quita la imagen grande del personaje y necesita el mismo parametro que [CHARCLEAR].
La instrucción quita la imagen del personaje, necesita solo un parámeto el cual es la posición donde esta el personaje, para quitarlo.
La instrucción sirve para colocar botones en los cuales puedes poner decisiones dentro de la novela y asi tomar los diferentes caminos que existan, como mínimo se necesitan 7 parámetros:
- Texto que aparece en la parte inferior
- Texto que aparece en el botón
- Nombre del nuevo archivo que se va a leer y se debe encontrar en la carpeta Scripts
- Tamaño del botón en pixeles
- Tamaño del texto del botón
- Color de fondo del botón en hexadecimal
- Color del texto en hexadecimal
Para poner más de una decisión se debe agregar el simbolo + al final y poner los parámetros del 2 al 7 de nuevo, como se muestra en el ejemplo.
Se puede seguir asi hasta n decisiones agregando sus respectivos parametros (Todo debe ser en una sola línea). La instrucción [CHOISES] y [CHOISESIMAGE] deben ir al final de cada archivo de la carpeta Scripts para continuar la historia, exceptuando el ultimo archivo de la novela.
La instrucción es muy similar a [CHOICES], la diferencias es que en lugar de usar botones ahora se pueden utilizar imágenes, como minímo se necesitan 5 parámetros:
- Texto que aparece en la parte inferior
- Nombre de la imagen a utilizar la cual debe estar en la carpeta Scenes
- Nombre del nuevo archivo que se va a leer y se debe encontrar en la carpeta Scripts
- Ancho de la imagen en pixeles
- Alto de la imagen en pixeles
Se recomienda utilizar imágenes con extensión .png y sin fondo.
Para poner más de una decisión se debe agregar el simbolo + al final y poner los parámetros del 2 al 5 de nuevo, como se muestra en el ejemplo.
Se puede seguir asi hasta n decisiones agregando sus respectivos parametros (Todo debe ser en una sola línea). La instrucción [CHOISES] y [CHOISESIMAGE] deben ir al final de cada archivo de la carpeta Scripts para continuar la historia, exceptuando el ultimo archivo de la novela.
La instrucción quita el texto con el nombre de un personaje de la pantalla, no necesita ningún parámetro.
La instrucción termina la novela visual y muesta el mensaje "FIN DE LA NOVELA", no necesita ningún parámetro.
La instrucción hace el efecto de "aparecer", puede ser una imagen o un video, no lleva ningún parámetro.
La instrucción hace el efecto de "desaparecer", puede ser una imagen o un video, no lleva ningún parámetro.
La instrucción permite hacer anotaciones dentro del archivo, que no aparecerán en la novela, necesita un parámetro, la anotación que deseas poner en el archivo.
La instrucción coloca una imagen como fondo, necesita un parámetro el cual es el nombre de la imagen que se encuentra en la carpeta Scenes.
La instrucción permite colocar un texto con el nombre de un personaje, y se mostrara en la parte inferior de la pantalla, necesita cuatro parámetros, el nombre del personaje, el tamaño del texto, el color del texto y el color de fondo (Si no se desea color de fondo este parámetro puede quedar vacio).
La instrucción permite utilizar la información guardada en Configuración la cual es el nombre del jugador de la novela, pondra un texto seguido del nombre del jugador y opcionalmente se puede agregar mas texto.
La instrucción muestra una imagen o título en pantalla completa, no necesita ningún parámetro, se recomienda utilizar esta instrucción despues de la instrucción [TITLE].
La instrucción reproduce los efectos de sonido guardados en la carpeta FX, se necesitan 2 parámetros los cuales son la palabra now y el nombre del archivo del efecto.
La instrucción detiene cualquier sonido que se este reproduciendo, no necesita parámetros.
La instrucción quita la reproducción del video, no necesita ningún parámetro.
La instrucción coloca el texto en la parte inferior de la pantalla con un efecto, solo necesita un parámetro, el texto que desea que aparezca.
La instrucción coloca una imagen en la parte de abajo de la pantalla, la cual sirve para que el texto se vea mejor, necesita un parámetro, el nombre de la imagen que se encuentra en la carpeta Textbox.
La intrucción quita la imagen de la caja de texto, no necesita ningún parámetro.
La instrucción coloca una sombra en la parte inferior de la pantalla, la cual ayuda a que el texto se pueda vizualizar mejor, no necesita ningun parámetro.
La instrucción permite cambiar el color del texto que se va mostrando en pantalla, necesita un parámetro, el color que sea desea color en hexadecimal.
La instrucción coloca un texto de pantalla completa haciendo un efecto similar al de [FADEIN], necesita 3 parámetros, el texto que se desea mostrar, el nombre del color del texto en inglés o hexadecimal y el tamaño del texto.
La instrucción quita el título de la pantalla haciendo un efecto similar al de [FADEOUT], no necesita ningún parámetro.
La instrucción hace vibrar el teléfono por un período de tiempo, necesita un parámetro, el cual es el tiempo de vibrado en milisegundo. Por ejemplo 1000 significa que el teléfono va a vibrar por 1 segundo.
La instrucción reproduce un video, necesita un parámetro el cual es el nombre del video que se encuentra en la carpeta Video.
La instrucción detiene todo por un período de timpo, necesita un parámetro el cual es es tiempo que desea detener la novel y se expresa en milisegundos. Por ejemplo 2000 milisegundos lo detiene 2 segundos.
Para los colores se recomienda utilizar la página https://www.color-hex.com/.
Para la creación de nuevos proyectos debes presionar el botón del menú despegable que se encuentra en la parte superior derecha, despues hacer clic en Crear proyecto en blanco, finalmente, debes ingresar el nombre de tu proyecto y presionar "ACEPTAR", esto creará una carpeta con el nombre de tu proyecto y dentro de ella se encontraran las carpetas y archivos necesarios para crear tu novela, exceptuando la foto de portada. La visualización de todas las carpertas y archivos puedes hacerla utilizando cualquier navegador de archivos ya sea desde tu celular o utilizando una computadora.
craerProyecto.mp4
Si intentas crear un proyecto con el mismo nombre se mostrará un mensaje en pantalla diciendo que el proyecto ya existe y no se volveran a crear las carpetas.
Para cargar un proyecto debes presionar el botón de archivos que se encuentra en la parte inferior derecha de la pantalla, una vez hecho esto se mostrará una pantalla con los archivos de tu dispositivo debes buscar la carpeta alexavn y entrar en ella, despues debes buscar la carpeta con el proyecto que deseas cargar y entrar en ella, una vez ahí debes buscar el archivo config.avn y hace clic en él, se abrira de nuevo la pantalla principal mostrando el título y la portada del proyecto.
cargarProyecto.mp4
Cuando un proyecto este cargado a un lado del título se encontrárá el botón de Eliminar de color azul, al presionarlo se mostrará un mensaje diciendo ¿Estas seguro? se quitara de la lista, al presionar ELIMINAR el proyecto se eliminará de la pantalla principal pero aun se encontran guardadas sus carpetas en nuestro dispositvo.
eliminar.mp4
En la configuración se deben asignar el nombre del jugador de la novela y su sexo, este nombre se puede utilizar en la instrucción [NPLAYER] para un mejor desarrollo de la novela visual, para guaradar estos datos solo debes llenarlos y presionar el botón guardar. La información se puede vizualizar en la pantalla Preferencias.
configuracion.mp4
En la ventana de Ayuda se mostrarán enlances a tutoriales para utlizar la aplicación asi como un enlace a está documentación y una novela demo, para ir a cualquiera de ellos solo debes dar clic en el enlace y se abrirá tu navegador web.
Para guardar la partida existen 2 opciones, puede ser desde la pantalla donde se esta reproduciendo la novela, en la parte superior derecha se encuentra el botón de guardar con la imagen de un disquete, al presionarlo se mostrará un mensaje diciendo Guardando. Los datos se guardaran en el primer slot de la pantalla Guardar. La segunda opción es presionar el botón de opciones que se encuentra aun lado del botón guardar y tiene una imagen de engrane, se abrirá la pantalla Guardar y puede guardar el avance de su partida en cualquiera de los slots, al guardar los datos se mostrará la imagen de portada de la novela y la fecha en la que se guardaron los datos.
guardar.mp4
Para cargar una partida primero debe abrir una novela despues de esto en la pantalla donde se esta reproduciendo la novela debe hacer clic en el botón opciones que se encuentra en la parte superior derecha y tiene una imagen de engrane, despues de presionar el botón Cargar y se vera la pantalla con los slots de sus partidas guardadas, finalmente, presione el slot con la partida que desea cargar y comenzará la reproducción de la novela desde el punto guardado.
cargar.mp4
Para eliminarlos los datos guardados de una partida, debes dirigirte a la ventana de Guardar y mantener presionado el slot de la partida que deseas borrar, despues te aparecera un mensaje preguntando si ¿Deseas borrar los datos? presiona Si para eliminar los datos.
eliminadatos.mp4
En la ventana Galeria se mostrarán todas las imágenes guardadas en la carpeta Scenes en forma de carrousel, para cambiar de imagen solo debe deslizar su dedo a la derecha o a la izquierda.
galeri.mp4
En la ventana Preferencias se mostrará la información guardada en Configuración.
En la ventana Acerca de se mostrará la información de los programadores.
Si tiene alguna duda, sugerencia o comentario no dude en enviar un correo a cualquiera de los programadores, el proyecto es open source para la comunidad, si puede ayudar para mejorarlo no dude en contactarnos.
Para compartir tu proyecto con cualquier persona lo primero que debes hacer el comprimir la carpeta de tu proyecto en una archivo con estensión .zip, despues enviar este archivo a la persona que quieras puede ser por mensaje, correo electrónico, bluetooth, etc.
comprimir.mp4
La otra persona deberá tener la aplicación de Alexia VN instalada en su celular. Una vez que la persona reciba el archivo comprimido .zip, deberá colocar dicho archivo dentro de la carperta alexvn y despues descomprimirlo (Esto se puede hacer desde una computadora o utilizando una aplicación como ASTRO para celular), cuando el archivo este descomprimido aparecera una carpeta con el nombre del proyecto.
decompress.mp4
Finalmente, se deben seguir los pasos descritos en Cargar proyectos.
Puede enviar pull request al repositorio de github.
Este proyecto está bajo la licencia GNU General Public License v2 o posterior. Puede leerlo en línea en (v2 o v3).