Supporters/Backers

SingletonJohn, CarlosITV

---

ZX Story Flow: Visual Choice Adventure Builder

Crea tus propias aventuras conversacionales para el mítico ZX Spectrum de forma visual y sin picar código.

ZX Story Flow (también conocido cariñosamente como Choice-Lee-Plot) es una herramienta web diseñada para autores de ficción interactiva y amantes de lo retro. Olvídate de pelearte con el código BASIC; diseña tu historia mediante nodos, conecta las decisiones visualmente y exporta tu juego listo para ser jugado.

🚀 Características Principales

• 📼 Motor BASIC "Pro": El exportador BASIC más potente para aventuras ZX Spectrum:
  • Fuente Personalizable: Cambia la fuente de los textos para un estilo visual único.
  • Scroll Automático: Si el texto no cabe en pantalla, el motor hace scroll automáticamente.
  • Párrafos Condicionales ($O): Muestra u oculta bloques de texto según el estado de los flags.
  • Variables Dinámicas: Inserta variables en tus textos con la sintaxis <<variable>>.
  • Sistema de Subrutinas Avanzado: Soporte para gosub y go para lógicas modulares.
  • Optimización de Memoria: Renumerado inteligente y compactación de código.
  • Loader 128K: Compatible con modelos 128K / +2 / +2A / +3.
• Editor Visual de Nodos: Crea pantallas y conecta opciones arrastrando cables. Visualiza el flujo de tu aventura de un vistazo.
  • Redimensionado de Nodos: Ajusta el tamaño de cada pantalla y grupo manualmente.
  • Resaltado de Flujo Inteligente: Selecciona un nodo para iluminar sus padres e hijos inmediatos.
  • IDs Únicos: Sistema anti-colisión para nombres automáticos de pantalla.
  • Persistencia de Zoom: El nivel de zoom se guarda junto con tu proyecto.
• Importación desde MuCho: Convierte automáticamente tus aventuras MuCho en un mapa visual de nodos.
• Sistema de Grupos y Referencias: Organiza nodos en grupos coloreados y usa referencias para conectar zonas distantes.
• Modo Avanzado vs Simple: Alterna entre interfaz limpia para escribir o vista técnica detallada.
• Configuración de Colores ZX Spectrum:
  • Control por Pantalla (MuCho 2.0): Cada pantalla tiene su propia combinación de colores y bordes, sin estilos globales rígidos.
  • Control por Zona: Personaliza INK, PAPER, BRIGHT y FLASH para Página, Separador y Opciones.
• Exportación Multi-formato:
  • Cassette .TAP: Archivo ejecutable para emuladores o hardware real.
  • MuCho Engine: Exportación nativa con soporte completo de atributos y colores.
  • CYD (Choose Your Destiny): Motor narrativo web con gestión de cabeceras y elegibilidad de opciones.
• Herramientas Pro:
  • Editor a pantalla completa con simulación CRT.
  • Regla de Escritura Personalizable: Ajusta la guía a 32 o 64 columnas según el modo de pantalla.
  • Nombre de Proyecto Interactivo: Cambia el nombre de tu aventura directamente desde la cabecera.
  • Panel de Ayuda Contextual: Referencia rápida de sintaxis MuCho/CYD integrada.
• Personalización Gráfica: Diseña tus propios caracteres (UDGs) para el separador y el selector mediante una matriz de píxeles integrada.
• Tres Idiomas: Interfaz y exportación en Español, Inglés y Portugués.

---

ZX Story Flow: Visual Choice Adventure Builder (English)

Create your own text adventures for the legendary ZX Spectrum visually, no coding required.

ZX Story Flow is a web-based tool for interactive fiction authors and retro enthusiasts. Stop fighting with BASIC syntax; design your story using nodes, connect decisions visually, and export your game ready to play.

🚀 Key Features

• 📼 "Pro" BASIC Engine: The most powerful BASIC exporter for ZX Spectrum adventures:
  • Custom Font: Change the font used in your adventure's text for a unique visual style.
  • Automatic Scroll: If the text doesn't fit on screen, the engine scrolls automatically.
  • Conditional Paragraphs ($O): Show or hide entire text blocks based on flag states.
  • Dynamic Variables: Insert variables into your text using <<variable>> syntax.
  • Advanced Subroutine System: Support for gosub and go commands for modular logic.
  • Memory Optimization: Smart renumbering and code compaction.
  • 128K Loader: Compatible with 128K / +2 / +2A / +3 models.
• Visual Node Editor: Create screens and connect options by dragging lines.
  • Node Resizing: Manually adjust the size of any screen or group.
  • Smart Flow Highlighting: Select a node to illuminate its immediate parents and children.
  • Unique IDs: Anti-collision system for automatic screen naming.
  • Zoom Persistence: The zoom level is saved along with your project.
• MuCho Import: Automatically convert your text-based MuCho adventures into a visual node map.
• Group & Reference System: Organize nodes in colored groups and use references to jump between distant areas.
• Advanced vs Simple Mode: Toggle between a clean writing interface and an advanced technical view.
• ZX Spectrum Color System:
  • Per-Screen Control (MuCho 2.0): Each screen has its own color and border combination — no more rigid global styles.
  • Per-Zone Customization: Individual INK, PAPER, BRIGHT, and FLASH for Page text, Separators, and Options.
• Multi-format Export:
  • Cassette .TAP: Executable file for emulators or real hardware.
  • MuCho Engine: Native support with full attribute and color compatibility.
  • CYD (Choose Your Destiny): Integration with the web narrative engine, including global code management and option eligibility.
• Professional Tools:
  • Full-screen editor with CRT display simulation.
  • Customizable Writing Ruler: Adjust the column guide to 32 or 64 columns for different screen modes.
  • Interactive Project Name: Rename your adventure directly from the header.
  • Contextual Help Panel: Embedded syntax reference for MuCho and CYD.
• Graphics Customization: Integrated pixel matrix editor to design custom UDGs for selectors and separators.
• Tri-lingual Support: Full UI and export support for English, Spanish, and Portuguese.

---

ZX Story Flow: Visual Choice Adventure Builder (Português)

Crie suas próprias aventuras de texto para o lendário ZX Spectrum visualmente, sem programar.

ZX Story Flow é uma ferramenta web para autores de ficção interativa e amantes do retro. Desenhe sua história com nodos, conecte decisões visualmente e exporte seu jogo pronto para jogar.

🚀 Principais Características

• 📼 Motor BASIC "Pro": O exportador BASIC mais poderoso para aventuras ZX Spectrum:
  • Fonte Personalizável: Altere a fonte dos textos para um estilo visual único.
  • Scroll Automático: Se o texto não couber no ecrã, o motor faz scroll automaticamente.
  • Parágrafos Condicionais ($O): Mostre ou oculte blocos de texto conforme o estado das flags.
  • Variáveis Dinâmicas: Insira variáveis nos textos com a sintaxe <<variável>>.
  • Sistema de Sub-rotinas Avançado: Suporte para gosub e go para lógicas modulares.
  • Otimização de Memória: Renumeração inteligente e compactação de código.
  • Loader 128K: Compatível com modelos 128K / +2 / +2A / +3.
• Editor Visual de Nodos: Crie telas e conecte opções arrastrando linhas.
  • Redimensionamento de Nodos: Ajuste manualmente o tamanho de cada tela ou grupo.
  • Destaque de Fluxo Inteligente: Selecione um nodo para iluminar seus pais e filhos imediatos.
  • IDs Únicos: Sistema automático de nomes sem colisões para cada tela.
  • Persistência de Zoom: O nível de zoom é guardado com o seu projeto.
• Importação do MuCho: Converta automaticamente suas aventuras MuCho em um mapa visual de nodos.
• Sistema de Grupos e Referências: Organize nodos em grupos coloridos e use referências para conectar áreas distantes.
• Modo Avançado vs Simples: Alterne entre interface de escrita limpa ou visão técnica avançada.
• Sistema de Cores ZX Spectrum:
  • Controlo por Ecrã (MuCho 2.0): Cada ecrã tem a sua própria combinação de cores e bordas, sem estilos globais rígidos.
  • Personalização por Zona: Ajuste INK, PAPER, BRIGHT e FLASH para texto, separador e opções.
• Exportação Multi-formato:
  • Cassete .TAP: Arquivo executável para emuladores ou hardware real.
  • MuCho Engine: Suporte nativo com compatibilidade total de cores.
  • CYD (Choose Your Destiny): Integração com o motor narrativo web, incluindo gestão de código global e elegibilidade de opções.
• Ferramentas Profissionais:
  • Editor em ecrã completo com simulação CRT.
  • Régua de Escrita Personalizável: Ajuste a guia para 32 ou 64 colunas conforme o modo de ecrã.
  • Nome de Projeto Interativo: Altere o nome da aventura diretamente no cabeçalho.
  • Painel de Ajuda Contextual: Referência rápida de sintaxe MuCho/CYD integrada.
• Suporte Trilingue: Interface e exportação para Português, Espanhol e Inglês.

---

🙏 Agradecimientos / Acknowledgments / Agradecimentos

Este proyecto no habría sido posible sin el apoyo de la comunidad retro:

• Remy Sharp (txt2bas) - Referencia técnica para tokenización BASIC y formato TAP
• David (Furillo Productions) - Por animarme a mejorar el proyecto y la idea de exportar a MuCho
• Darkside29 (itch.io) - Por sugerir la integración con MuCho y feedback constante
• MuCho Engine (solhsa.com) - Motor de aventuras que inspiró un formato de exportación
• CarlosITV (itch.io) - Testing exhaustivo y reporte de bugs
• SingletonJohn (itch.io) - Testing y verificación de funcionalidades
• ZXMoe (itch.io) - Valiosos consejos sobre BASIC del ZX Spectrum
• Cronomantic (itch.io) - Por el desarrollo del motor CYD y soporte técnico
• CYD Engine (ChooseYourDestiny) - Motor narrativo que expande las posibilidades de exportación
• Nextric (Radical Computers) - Feedback y apoyo de la comunidad
• Ximokom (itch.io) - Testing y reporte de bugs

---

Desarrollado para la comunidad retro. ¡Vuelve a los 80 con un toque moderno!

Developed for the retro community. Back to the 80s with a modern twist!

Desenvolvido para a comunidade retro. De volta aos anos 80 com um toque moderno!