Storyarn docs
Documentación

Diseño Narrativo

Nodos Subflow

Reutiliza un flujo dentro de otro y ramifica desde sus resultados de salida.

Los nodos Subflow permiten que un flujo llame a otro. Son la herramienta principal para componer sistemas narrativos grandes a partir de piezas pequeñas y reutilizables.

Flujo padre con un nodo Subflow cuyos pines de salida vienen de los nodos de Salida del flujo referenciado

Cómo se ejecutan

Cuando la ejecución llega a un Subflow:

  1. Storyarn entra en el flujo referenciado por su nodo de Entrada.
  2. Ese flujo se ejecuta normalmente.
  3. Si llega a una Salida configurada para volver al llamador, la ejecución vuelve al flujo padre.
  4. El flujo padre continúa desde el pin que coincide con el resultado de salida.

La reproducción y el modo de depuración entran en el flujo referenciado y vuelven al que lo llamó. El modo de depuración muestra la pila de llamadas como una ruta de navegación, para que veas de dónde viene la ejecución y adónde volverá.

Pines de salida

Los pines de salida se generan desde las salidas de retorno del flujo referenciado. Así el flujo padre ve explícitamente los resultados a los que puede reaccionar.

agreed
refused
not_enough_gold
relationship_too_low

Referencias circulares

Storyarn evita referencias circulares. Un flujo no puede llamarse a sí mismo directa o indirectamente mediante una cadena de subflujos.

Cuándo crear un subflow

Usa subflows para conversaciones reutilizables, comprobaciones compartidas, beats repetidos de misión, tutoriales o cualquier fragmento narrativo que necesite estructura interna pero deba poder llamarse desde más de un lugar.