Eventos Blueprint
Crea un evento como un gráfico de nodos y cables que puede ramificarse, repetirse, contar y recordar
El modo Blueprint crea un evento como un gráfico de nodos y cables en lugar de una lista de pasos. Así, un mismo evento puede decidir qué hacer: agradecer de otra forma un regalo grande, sumar hacia una meta o alternar entre dos reacciones.
Entiende cómo se ejecuta un Blueprint
Todo gráfico empieza en el nodo Evento, que se ejecuta cada vez que se activa el disparador. Los cables de ejecución blancos indican qué se ejecuta después. Los cables de datos de color llevan valores: rojo para verdadero o falso, verde para un número y rosa para texto.
VerdaderoReproducir sonido
El disparador, sus reglas, los tiempos de espera y la cola siguen en el evento, así que funcionan igual que en un evento simple. Solo la lista de pasos se convierte en un gráfico, y cada evento tiene uno.
Convierte un evento en Blueprint
En la pestaña Eventos, activa Modo Blueprint junto al encabezado. A partir de ahí, Nuevo evento abre un Blueprint. Los eventos simples y los Blueprint conviven en la lista, y la fila de un Blueprint lleva la etiqueta Blueprint.
Con el modo activado, el editor simple ofrece Abrir como Blueprint para un evento nuevo y Convertir a Blueprint para uno guardado, igual que el menú contextual de una fila simple. La copia se abre sin guardar y ejecuta los mismos pasos.
Vuelve a un evento simple
Haz clic derecho en la fila de un Blueprint y elige Convertir a evento simple. El cambio es inmediato, y el aviso ofrece Deshacer. La opción aparece atenuada cuando el gráfico usa algo que una lista no puede mostrar, como una Rama o una variable; deja el puntero sobre ella para ver por qué.
Muévete por el editor
Un Blueprint se abre a pantalla completa, y el dock y la lista de Eventos se apartan. La cabecera reúne Importar, Exportar, Valores de prueba, Guardar y ejecutar, Guardar y Cancelar, junto a un estado que dice Sin problemas o cuenta los errores y las advertencias.
- Mi Blueprint, a la izquierda, muestra tus Variables y todos los nodos.
- Detalles, a la derecha, edita lo que seleccionas. Selecciona el nodo Evento para cambiar el disparador y sus reglas, y haz clic en Aplicar disparador.
- Resultados de compilación, en la parte inferior, muestra cada problema. Haz clic en uno para ir a su nodo.
Arrastra el borde de un panel lateral para cambiar su tamaño, y haz doble clic en el borde para restablecerlo. En una ventana estrecha, Mi Blueprint se convierte en una tira de iconos y Detalles se desliza desde la derecha.
Añade un nodo
Haz clic en Añadir nodo en la barra de herramientas del lienzo, pulsa Shift+A o haz clic derecho en una zona vacía del lienzo. Escribe en Buscar nodos y pulsa Enter. Si arrastras un cable desde un pin hasta un espacio vacío, la lista muestra solo los nodos que encajan con él y conecta el que elijas.
| Familia | Nodos |
|---|---|
| Control de flujo | Rama, Secuencia, Paralelo, Aleatorio, Retraso, Bucle For, Hacer una vez, Hacer N, Alternar, Switch por texto, Switch por número |
| Datos del disparador | Obtener datos del disparador, Obtener campo del disparador, Tiene rol |
| Matemáticas | Sumar, Restar, Multiplicar, Dividir, Resto, Mín, Máx, Limitar, Redondear, Valor absoluto, Número aleatorio |
| Lógica | Comparar, AND, OR, NOT |
| Texto | Formatear texto, Comparar texto, Unir texto, Cambiar mayúsculas, Longitud del texto, A número |
| Variables | Obtener variable, Establecer variable |
| Acciones | Acción (cualquier paso salvo Esperar y Grupo), Ejecutar otro evento |
| Utilidades | Imprimir, Comentario, Redirección |
Retraso espera de 0 a 600 segundos, y un Bucle For se repite como máximo 100 veces. Un nodo Acción continúa por Después; si su paso falla, sigue por Fallo, siempre que ese pin esté conectado. Algunos pasos toman un valor de un cable, como el Texto que dice una frase hablada.
Conecta los nodos
Arrastra desde un pin de salida hasta un pin de entrada. Una insignia junto al puntero muestra una marca y el pin al que se unirá el cable, o una X con el motivo por el que no puede, como «Este pin admite un número. Usa “A número” para leerlo de un texto».
Un número o un valor verdadero o falso se convierte en texto por sí solo. Una salida de ejecución y una entrada de datos admiten un cable cada una, así que un cable nuevo sustituye al anterior. Mantén pulsada Alt y haz clic en un pin para cortar sus cables.
Guarda valores en variables
Haz clic en Añadir variable en Mi Blueprint y elige su Tipo, su Valor inicial y su Ámbito: Evento para usarla solo en este Blueprint, o Global para compartirla por nombre con todos los eventos Blueprint. Obtener y Establecer añaden un nodo para ella.
Ahora muestra lo que guarda la variable, tal como la dejaron las últimas ejecuciones de este evento. Los valores duran hasta que se cierra la app, y la flecha de restablecer junto a Ahora devuelve uno a su valor inicial.
Prueba un Blueprint
Haz clic en Valores de prueba para elegir lo que el disparador finge llevar, como el nombre de un espectador, un regalo, diamantes o un comentario. Después haz clic en Guardar y ejecutar: Vfinity guarda el evento y lo ejecuta una vez como prueba, igual que el botón de reproducir de su fila.
Cada nodo se ilumina cuando la ejecución pasa por él, y el que falla parpadea en rojo. Un nodo Imprimir escribe en la Consola de depuración. Puedes guardar un Blueprint con errores, pero su fila muestra Corregir el Blueprint mientras quede alguno.
Deshaz y ordena
Deshacer y Rehacer cubren todos los cambios del gráfico, incluido un cambio de disparador que hayas aplicado. Ordenar coloca el gráfico de izquierda a derecha siguiendo sus cables de ejecución. Pulsa C para envolver los nodos seleccionados en un Comentario.
Comparte un evento
Exportar guarda el evento en un archivo con su disparador, su Blueprint y los sonidos y archivos multimedia que usa, y antes guarda tus cambios. En otro PC, empieza un Blueprint nuevo y haz clic en Importar: el evento del archivo sustituye a lo que muestra el editor, y un evento simple llega como un Blueprint que ejecuta los mismos pasos.
Conecta VTube Studio antes de importar: cada acción Disparar un atajo se empareja por nombre con un atajo del modelo cargado, y el aviso nombra los que no encuentra. No se conserva nada hasta que haces clic en Guardar.
Elige qué incluir en el archivo de copia de seguridad.
Versiones anteriores
Las versiones de Vfinity anteriores a la Alpha 0.4.0 no ejecutan eventos Blueprint. Comparte archivos Blueprint solo con quien use la Alpha 0.4.0 o posterior.
Relacionado
Disparadores, reglas y el editor simple.
Todos los pasos que puede ejecutar un nodo Acción.
Todas las teclas que entiende el editor Blueprint.
Las copias de seguridad y los archivos compartidos también guardan eventos Blueprint.