Wiki / Home

OhMyDialogSystem

Godot 4.5+ GDExtension Apache 2.0

Sistema de diálogos con IA para Godot que permite crear NPCs inteligentes con personalidades únicas, memorias persistentes y voces sintetizadas. Potenciado por LLMs locales via llama.cpp.

✦

Características Principales

🦙

LLM Local

Inferencia de modelos GGUF directamente en Godot via llama.cpp. Sin dependencias de APIs externas.

🎨

Editor Visual

Editor de grafos de diálogo integrado con nodos de IA, condiciones, eventos y opciones.

🧠

Memorias Persistentes

Los NPCs recuerdan conversaciones previas con búsqueda semántica de memorias relevantes.

🔊

Text-to-Speech

Voces sintetizadas offline con Piper TTS. Cada personaje puede tener su propia voz.

🌐

Localización

Integración con TranslationServer de Godot. Prompts y plantillas en múltiples idiomas.

🔷

Bindings C#

API idiomática de C# con async/await, eventos y documentación XML completa.

✦

Quick Start

# Crear DialogueManager y verificar AIService
var dialogue_manager: DialogueManager

func _ready() -> void:
    # Verificar que hay modelo cargado (via Model Manager)
    var ai_service := AIService.get_singleton()
    if not ai_service or not ai_service.is_model_loaded():
        push_warning("No hay modelo cargado - usar Model Manager primero")

    # Crear y configurar DialogueManager
    dialogue_manager = DialogueManager.new()
    add_child(dialogue_manager)

    # Conectar señales
    dialogue_manager.npc_response_completed.connect(_on_npc_response)
    dialogue_manager.player_choices_available.connect(_on_choices)

func start_conversation() -> void:
    var graph: DialogueGraph = preload("res://dialogues/merchant.tres")
    dialogue_manager.start_dialogue(graph)

ℹ INFO

Para una guía completa de instalación y configuración, visita Quick Start Guide.

✦

Requisitos

Componente	Versión	Notas
Godot Engine	4.5+	Requerido para GDExtension 4.3+
Modelo LLM	GGUF Q4/Q5/Q8	Recomendado: Qwen2.5-0.5B-Instruct (~530MB)
RAM	8GB+	16GB recomendado para modelos grandes
GPU (opcional)	CUDA/Vulkan	Para aceleración de inferencia