Documentacion Tecnica
Detalles profundos sobre arquitectura, compilacion y sistemas internos.
// Contenido
Architecture
Vision general de la arquitectura del sistema, diagramas de clases y flujos de datos.
Dialogue Nodes
Catalogo visual de nodos del editor. Sistema hibrido grafo + IA.
GDExtension Build
Guia para compilar el addon desde codigo fuente. Requisitos, SCons, plataformas.
Memory System
Diseno del sistema de memorias persistentes y busqueda semantica.
Localization
Integracion con TranslationServer y plantillas de prompts multi-idioma.
Token Report
Consumo de tokens de la configuración Claude. Auto-generado en cada commit.
// Stack Tecnologico
| Componente | Tecnologia | Proposito |
|---|---|---|
| Game Engine | Godot 4.5+ | Motor base del addon |
| Native Bindings | GDExtension + godot-cpp | Exponer C++ a GDScript/C# |
| LLM Inference | llama.cpp | Ejecutar modelos GGUF localmente |
| Text-to-Speech | Piper TTS | Sintesis de voz offline |
| Build System | SCons | Compilacion multiplataforma |
// Estructura del Proyecto
- 📄 plugin.cfg // Metadata del addon
- 📜 plugin.gd // EditorPlugin principal
-
⚙️ gdextension/ // C++ Nativo
- 📁 godot-cpp/
- 📁 thirdparty/ (llama.cpp, piper)
- 📁 src/ (interfaces, register_types)
- 🔧 SConstruct
-
💬 core/ // Logic Core
- 📜 dialogue_manager.gd
- 📜 graph_runner.gd
- 📁 node_executors/
-
📦 resources/ // Custom Resources
- 👤 character_identity.gd
- 🌍 world_context.gd
- 🔷 dialogue_graph.gd
-
🎨 editor/ // Visual Editor
- 📜 dialogue_graph_editor.gd
- 📁 nodes/ (Graph Nodes)
// Principios de Diseno
1. Modularidad
Cada sistema (LLM, TTS, Memory) es independiente y puede usarse por separado.
2. Performance
- Inferencia LLM en thread separado
- Streaming de tokens para UI responsiva
- Cache de audio TTS
- Lazy loading de recursos
3. Extensibilidad
- Nodos de dialogo custom via herencia
- Templates de prompts configurables
- Signals para integracion con sistemas del juego
4. Offline-First
Todo funciona sin conexion a internet. Sin APIs externas, sin telemetria.
// Dependencias
Submodulos
- godot-cpp: 4.3+
- llama.cpp: latest
- piper: latest
Para instrucciones detalladas de compilacion, ver GDExtension Build Guide.