Storyarn docs
Documentación

Bienvenida

Flujo de trabajo principal

Cómo se desarrolla un proyecto típico en Storyarn.

Cada equipo usa Storyarn de forma diferente, pero así es como un proyecto típico avanza desde la configuración hasta la entrega.

Configura tu espacio

Crea un espacio de trabajo (workspace) para tu equipo. Cada espacio de trabajo tiene sus propios miembros con acceso basado en roles — los propietarios gestionan todo, los administradores manejan las invitaciones, los miembros crean proyectos y los observadores tienen acceso de solo lectura.

Dentro de un espacio de trabajo, crea un proyecto. Cada proyecto es independiente — con sus propias fichas, flujos, escenas, localización y recursos. Los proyectos también tienen su propia membresía: los propietarios configuran los ajustes, los editores crean contenido y los observadores revisan.

Invita a compañeros de equipo por email. Reciben un enlace con token, lo aceptan, y ya están dentro — con el rol que elegiste.

Panel del espacio de trabajo con la tarjeta del proyecto Veilbreak Demo y el botón New Project

Define tu mundo con Fichas

Empieza con las Fichas (Sheets) — contenedores de datos estructurados para todo el mundo de tu juego. Crea una ficha para cada personaje, objeto, ubicación, facción o misión.

Cada campo en una ficha es un bloque (block). Hay 10 tipos de bloques: texto, texto enriquecido, número, booleano, selección, selección múltiple, fecha, tabla, referencia y galería. Los bloques que admiten valores en tiempo de ejecución se convierten en variables salvo que los marques como constantes; los bloques de referencia y galería no son variables. Las columnas de tabla también admiten fórmulas para calcular valores de celdas.

Las variables siguen el patrón {atajo_de_hoja}.{nombre_de_variable}. Un bloque de Salud en la ficha mc.jaime se convierte en mc.jaime.health. Cambia ese valor una sola vez y cada flujo que lo comprueba ve la actualización de inmediato.

Ficha de personaje de Kael con banner, avatar, campos heredados, bloques numéricos y bloques de selección

Las Tablas son cuadrículas de hoja de cálculo dentro de una ficha — perfectas para inventarios, árboles de habilidades o matrices de relaciones. Cada celda se convierte en su propia variable. Las Fórmulas te permiten calcular valores a partir de otras variables, incluso entre fichas distintas.

Organiza las fichas en una jerarquía de árbol. Usa la herencia de propiedades para propagar bloques de fichas padre a hijas — crea una “Base de Personaje” con salud, nivel y facción, y cada personaje hijo hereda esos campos automáticamente, cada uno con sus propios valores.

Bloque de tabla de ficha para estadísticas de personaje con columnas de base, modificador y total de fórmula

Construye narrativas ramificadas con Flujos

Los Flujos (Flows) son grafos visuales de nodos donde tu historia toma forma. Diez tipos de nodos cubren todo:

  • Diálogo — discurso de personaje con respuestas opcionales del jugador, cada una con sus propias condiciones e instrucciones
  • Condición — ramifica según valores de variables usando un constructor visual (sin código)
  • Instrucción — modifica variables cuando el flujo pasa por el nodo
  • Hub y Salto (Jump) — crea bucles y puntos de convergencia para narrativas no lineales
  • Subflujo (Subflow) — incrusta flujos reutilizables dentro de otros, con una pila de llamadas completa
  • Secuencia (Sequence) — agrupa beats narrativos grandes y permite configurar capas visuales y audio
  • Anotación (Annotation) — deja notas visuales en el lienzo sin afectar a la ejecución
  • Entrada (Entry) y Salida (Exit) — define dónde empiezan y terminan los flujos, con modos de salida para encadenar flujos

Conecta nodos arrastrando entre puertos. Edita el contenido en el panel lateral. Colabora en tiempo real — ve los cursores de tus compañeros y el bloqueo automático previene ediciones conflictivas.

Editor de flujos con un árbol de diálogo de Veilbreak y nodos de diálogo, hub, instrucción, salto, entrada y salida conectados

Prueba sin salir del editor

Aquí es donde Storyarn se destaca. Otras herramientas te obligan a exportar a un motor de juego solo para ver si tu diálogo funciona. Storyarn tiene dos herramientas de prueba integradas:

El Reproductor de Historia es una reproducción cinematográfica a pantalla completa. Experimentas tu flujo exactamente como lo haría un jugador — diapositivas de diálogo con avatares de los personajes, opciones de respuesta numeradas, fondos de escena atenuados detrás del texto. Avanza automáticamente a través de condiciones e instrucciones, y se detiene en las decisiones. Cambia al modo Análisis para ver respuestas ocultas e insignias de condiciones. Navega hacia atrás en el historial para probar caminos diferentes.

Reproductor de Historia — diapositiva de diálogo con nombre y avatar del personaje, tres opciones de respuesta numeradas y un fondo de escena atenuado detrás

El Modo Depuración es tu inspector paso a paso. Avanza nodo por nodo, observa cómo cambian las variables en tiempo real en el panel de Variables, rastrea la ruta de ejecución completa y establece puntos de interrupción. Ajusta los valores de las variables sobre la marcha y vuelve a ejecutar para probar ramas alternativas. Cuatro pestañas — Consola, Variables, Historial y Ruta — te dan visibilidad completa de lo que tu flujo está haciendo y por qué.

Modo Depuración mostrando la barra de depuración, las pestañas de ejecución y el nodo de flujo seleccionado

Mapea tu mundo con Escenas

Las Escenas (Scenes) son mapas interactivos donde tu mundo se vuelve espacial. Sube una imagen de fondo, dibuja zonas poligonales para áreas, coloca pines para personajes y puntos de interés, añade conexiones entre pines y anota con etiquetas de texto.

Las zonas y los pines no son solo visuales — son interactivos. Adjunta condiciones para ocultar o deshabilitar elementos según el estado del juego. Adjunta instrucciones para modificar variables al hacer clic. Vincúlalos a flujos, fichas u otras escenas.

Haz doble clic en una zona para profundizar — Storyarn extrae el área de la zona de la imagen de fondo, crea una escena hija y te permite seguir haciendo zoom. Construye jerarquías de mundo completas: continente > región > ciudad > edificio > habitación.

Editor de escenas mostrando el mapa de Thyral con zonas coloreadas, pines de personajes, etiquetas y herramientas de escena

Modo Exploración

El Modo Exploración es donde todo cobra sentido. Recorre tu mundo en una vista inmersiva a pantalla completa. Haz clic en zonas para activar flujos que se superponen sobre el mapa atenuado — tu arte, personajes, diálogos, variables y traducciones funcionando en un solo lugar. Navega entre escenas, ejecuta asignaciones de variables y observa cómo las condiciones actualizan la visibilidad de las zonas en tiempo real.

Ninguna otra herramienta de diseño narrativo hace esto.

Modo Exploración mostrando el mapa de escena, pines interactivos y controles del jugador

Gestiona los recursos

Abre Recursos (Assets) desde la barra lateral del proyecto para subir y organizar las imágenes y audios que utiliza tu proyecto. Busca por nombre, filtra por tipo y reutiliza los recursos en fichas, fondos de escenas, secuencias de flujos, diálogos y exportaciones.

Página de Recursos del proyecto con búsqueda, filtros por tipo y tarjetas de imágenes y audios

Al exportar, elige si los recursos se mantienen como referencias, se incrustan en la salida o se empaquetan junto a ella.

Localiza el texto de runtime

Cuando tu contenido esté listo, las herramientas de Localización extraen automáticamente el texto visible para el jugador definido por el contrato de exportación para motores: líneas de diálogo, acotaciones, texto de menú, etiquetas de respuestas y salidas, nombres de fichas activas y valores de variables exportadas de texto o texto enriquecido. Las escenas y los metadatos exclusivos del editor quedan excluidos.

Configura la integración con DeepL para traducción automática como primer paso. Haz seguimiento del progreso por idioma con informes que muestran conteos de palabras por personaje, estado de traducción y progreso de doblaje.

Exporta traducciones como Excel o CSV para traductores profesionales e importa el CSV devuelto desde la misma barra de herramientas. Conserva las columnas ID y Source Hash: el sistema detecta cambios en el texto fuente, rechaza filas obsoletas durante la importación y marca las traducciones existentes para revisión.

Dashboard de localización con progreso de catalán, recuentos de palabras por hablante, progreso de doblaje y desglose de nodos de flujo, bloques y nombres de fichas

Exporta y comparte

Cuando sea hora de publicar, exporta tu proyecto completo o partes individuales:

  • Ink, Yarn, Unity JSON, Godot Dialogic, Unreal CSV, Articy XML — formatos específicos de motores
  • Excel / CSV — datos de localización

Elige cómo manejar los recursos: solo referencias, incrustados (Base64) o empaquetados como ZIP con una carpeta de recursos. La validación previa a la exportación, opcional, detecta referencias rotas, nodos inalcanzables y traducciones faltantes antes de que lleguen a tu motor.

Colabora en tiempo real

A lo largo de todo esto, tu equipo trabaja junto. En el editor de flujos, ve quién está en línea con indicadores de presencia, observa los cursores en vivo mientras tus compañeros trabajan y deja que el bloqueo automático de nodos prevenga ediciones conflictivas. Las notificaciones mantienen a todos informados de los cambios.

Los roles mantienen todo organizado — los editores crean contenido, los observadores revisan sin riesgo de cambios accidentales y los propietarios gestionan los ajustes, el tema y las integraciones del proyecto.