ChooseYourDestiny
Creator for making CYOA adventures for Zx Spectrum
Install / Use
/learn @cronomantic/ChooseYourDestinyREADME
ChooseYourDestiny

An environment for creating "Choose Your Own Adventure" stories, gamebooks, interactive stories and option-based adventures for the Spectrum 48k, 128k, +2, and +3.
Using a simple, BASIC-inspired markup language, you can add interactivity and effects, with the ability to place menus and images anywhere on the screen. You can also add sound effects for the beeper based on Shiru's BeepFx player, and melodies for the AY chip using Vortex Tracker or WyzTracker module players.
Thanks to its image and text compression systems, the Spectrum's limited memory can be fully utilized to give your creations greater durability and content.
The system consists of a compiler that transforms the source code and associated resources into a TAP or DSK file, where the interpretable code and compressed text and graphics data are stored, as well as an efficient interpreter to execute them.
More information is available in the Manual and a tutorial to learn step by step. All information can be found in the wiki. To make writing code easier, there is also a highlighter for VSCode.
The credits and license are detailed in the corresponding sections of the manual.
Improvements and contributions are welcome.
Entorno para crear historias de tipo "Elige Tu Propia Aventura", librojuegos y aventuras por opciones para el Spectrum 48k, 128k, +2 y +3.
Mediante un lenguaje sencillo de marcas, inspirado en BASIC, se puede añadir interactividad y efectos, con capacidad para situar menús e imágenes en cualquier punto de la pantalla. También se pueden añadir efectos de sonido para el "beeper" basados en el reproductor BeepFx de Shiru y melodías para el chip AY mediante reproductores de módulos de Vortex Tracker o WyzTracker.
Gracias a sus sistemas de compresión de imágenes y texto, la relativa escasa memoria del Spectrum se puede aprovechar a máximo para dar más durabilidad y contenido a tus creaciones.
El sistema consiste en un compilador que transforma el código fuente y los recursos asociados en un fichero TAP o DSK, donde se almacenan el código intepretable y los datos de texto y gráficos comprimidos, además de un eficiente intérprete para ejecutar los mismos.
Más información en el Manual y dispones de un tutorial para aprender paso a paso. Toda información la podrás obtener en la wiki. Para escribir el código más fácilmente, dispones también de un resaltador para VSCode.
Los créditos y licencia se detallan en las correspondientes secciones del manual.
Mejoras y aportaciones son bienvenidas.
