OhMyDialogSystem

• Local LLM Inference - Run language models directly in Godot via llama.cpp

  • Async/streaming text generation
  • Chat templates with Jinja2 support
  • Stop sequences & configurable timeouts
  • Sampling parameters (temperature, top-p, top-k, penalties)
  • Windows x64 & Linux x64 binaries included

• Visual Dialogue Editor - Node-based graph editor

  • 13 node types: Start, End, AI Response, Static Response, Player Choice, Condition, Event, Jump, SetVariable, and more
  • Hugging Face model browser with 1-click download
  • Custom inspector panels for each node type
  • GGUF metadata parser for auto-configuration

• Character System - Define unique NPC personalities

  • CharacterIdentity resources with personality traits
  • WorldContext for immersive world settings
  • AIPreset for model configurations and sampling params

• Three Dialogue Modes

  • FREE: Pure AI-driven conversations
  • SCRIPTED: Traditional branching dialogues
  • HYBRID: Mix scripted structure with AI responses

• Persistent Memories - NPCs remember past conversations with semantic search
• Text-to-Speech - Offline voice synthesis with Piper TTS
• Localization - Multi-language prompt templates with TranslationServer
• C# Bindings - Idiomatic async/await API for C# developers
• LoRA Adapters - Fine-tuned personality models

Note: The addon is currently in active development (v0.4.0). Check the Releases page for the latest version.

1. Download the latest release or clone the repository
2. Copy the addons/ohmydialog/ folder to your project's addons/ directory
3. Enable the plugin in Project Settings > Plugins
4. Download a GGUF model using the built-in Model Manager (AI menu in editor)

# Get reference to DialogueManager node
@onready var dialogue_manager: DialogueManager = $DialogueManager

func _ready() -> void:
    # Connect to dialogue signals
    dialogue_manager.npc_response_completed.connect(_on_npc_response)
    dialogue_manager.player_choices_available.connect(_on_choices)
    dialogue_manager.dialogue_ended.connect(_on_dialogue_ended)

func start_conversation() -> void:
    # Load and start a dialogue graph (model loads automatically from StartNode)
    var graph: DialogueGraph = preload("res://dialogues/merchant.tres")
    dialogue_manager.start_dialogue(graph)

func _on_npc_response(text: String) -> void:
    dialogue_ui.show_npc_text(text)

func _on_choices(choices: Array[Dictionary]) -> void:
    dialogue_ui.show_choices(choices)

Full documentation at: lobinuxsoft.github.io/OhMyDialogSystem

addons/ohmydialog/
├── plugin.cfg              # Addon metadata
├── plugin.gd               # Main EditorPlugin
├── gdextension/            # C++ native code (llama.cpp bindings)
├── ai/                     # Model management, GGUF parser, HuggingFace API
├── autoload/               # AIService singleton
├── core/                   # DialogueManager, GraphRunner, NodeExecutors
├── resources/              # Custom Resources (DialogueGraph, CharacterIdentity...)
├── editor/                 # Visual dialogue editor, inspector plugins
├── icons/                  # Editor icons
├── memory/                 # Persistent memory system (coming soon)
├── tts/                    # Text-to-Speech (coming soon)
└── localization/           # Multi-language support (coming soon)

See the Project Board for detailed progress.

If you find this project useful, consider supporting its development:

Contributions are welcome! Please check the Issues for open tasks.

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.