El repositorio de Stewart Prealpha sigue una estructura deliberada que separa las herramientas externas, los recursos del juego y los sistemas globales en tres carpetas de primer nivel. Esta separación facilita navegar el proyecto, asignar responsabilidades y escalar el contenido sin mezclar distintas capas de la arquitectura.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Stewart-DevTeam-Team/stewart_prealpha/llms.txt
Use this file to discover all available pages before exploring further.
Árbol de directorios
Carpetas principales
addons/
Contiene los plugins y extensiones del editor de Godot. Ningún código de juego vive aquí; solo herramientas que amplían el motor o que se importan desde fuentes externas.
| Addon | Descripción |
|---|---|
state_machine/ | Máquina de estados modular desarrollada para el proyecto |
dialogue_manager/ | Plugin de diálogos por Nathan Hoad |
Pixel Crawler - Free Pack/ | Pack de assets gráficos |
vector_display_2d/ | Herramienta de depuración para visualizar vectores en 2D |
assets/
Agrupa todos los recursos del juego: escenas, scripts de gameplay, sprites, fuentes e interfaces. Está organizada por dominio funcional en lugar de por tipo de archivo.
| Subcarpeta | Contenido |
|---|---|
character/ | Clase base Character, escena del personaje y scripts de estados (Idle, Walk, Run) |
world/ | Escena principal del mundo, tilemaps y el sistema de seguimiento en fila |
dialogues/ | Globo de diálogo y tema visual de las conversaciones |
ui/ | Elementos de interfaz de usuario |
fonts/ | Fuentes tipográficas del proyecto |
autoload/
Contiene los singletons registrados en project.godot y los recursos .tres que consumen. Todo lo que necesita estar disponible globalmente —gestión de escenas, música, banderas de progresión, estadísticas del jugador— vive aquí.
La subcarpeta resources/ almacena tanto los scripts de recurso (AutoloadResource y sus subclases) como los archivos .tres con los datos reales.
Colores de carpetas en el editor
El archivoproject.godot asigna colores a las carpetas principales para facilitar la navegación visual dentro del editor de Godot:
| Carpeta | Color |
|---|---|
addons/ | Morado |
assets/ | Verde |
autoload/ | Azul |
Licencias
El proyecto usa dos licencias según el tipo de contenido:| Componente | Licencia | Archivo |
|---|---|---|
| Código fuente | MIT | LICENSE |
| Assets y elementos creativos | CC BY-NC 4.0 | ASSETS_LICENSE.md |
.gd y archivos de configuración del proyecto. La licencia CC BY-NC 4.0 aplica a los assets gráficos, de audio y otros recursos creativos.
La carpeta
.docs/ contiene documentación interna del equipo, como el changelog de desarrollo. No forma parte del juego exportado ni del repositorio público de documentación.Explora la arquitectura
Máquina de estados
Cómo funciona el addon StateMachine y cómo crear nuevos estados.
Autoloads
Los singletons globales y sus responsabilidades.
Sistema de recursos
La clase AutoloadResource y los tipos concretos: Flags, Playlist y Scenes.