com.IvanMurzak.Godot.MCP.Dialogic 1.1.3

dotnet add package com.IvanMurzak.Godot.MCP.Dialogic --version 1.1.3
                    
NuGet\Install-Package com.IvanMurzak.Godot.MCP.Dialogic -Version 1.1.3
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="com.IvanMurzak.Godot.MCP.Dialogic" Version="1.1.3" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="com.IvanMurzak.Godot.MCP.Dialogic" Version="1.1.3" />
                    
Directory.Packages.props
<PackageReference Include="com.IvanMurzak.Godot.MCP.Dialogic" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add com.IvanMurzak.Godot.MCP.Dialogic --version 1.1.3
                    
#r "nuget: com.IvanMurzak.Godot.MCP.Dialogic, 1.1.3"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package com.IvanMurzak.Godot.MCP.Dialogic@1.1.3
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=com.IvanMurzak.Godot.MCP.Dialogic&version=1.1.3
                    
Install as a Cake Addin
#tool nuget:?package=com.IvanMurzak.Godot.MCP.Dialogic&version=1.1.3
                    
Install as a Cake Tool

Dialogic Tools

RQL module for the Godot Dialogic addon: a dialogic source that lists timelines and characters, creates them and appends timeline text.

Optional Godot-MCP extension, independently versioned as NuGet package com.IvanMurzak.Godot.MCP.Dialogic. Requires a Godot C# project (4.4.0+) with a core godot_mcp addon that has the RQL tools (rql-query / rql-mutate / rql-schema, the release after 0.28.0).

Required prerequisite — Dialogic (install it yourself)

This extension does NOT include the Dialogic addon and does not download or vendor it. You must install Dialogic into your own Godot project separately:

  • Install Dialogic from the Godot Asset Library, or from https://github.com/dialogic-godot/dialogic (tested against 2.0-alpha-18 on Godot 4.4 and 2.0-alpha-20 on Godot 4.5+).
  • Enable it under Project Settings → Plugins (this also registers the Dialogic autoload).

Without Dialogic installed and enabled, dialogic | select installed hint reports false with an install hint, the dialogic lists are empty and its calls fail with that hint (by design).

Dialogic is © Emilio Coppola and contributors, distributed under the MIT License. This extension is not affiliated with, endorsed by, or sponsored by the Dialogic project — it merely provides an RQL module that authors its resources. See the addon's own repository for its licence and terms.

Install

godot-cli install-plugin /path/to/project
godot-cli install-extension com.IvanMurzak.Godot.MCP.Dialogic /path/to/project
godot-cli build /path/to/project

The installer resolves the latest stable version from NuGet; use --version <x.y.z> to request an exact version. Packages contain C# source and build props, compiled against the project's own GodotSharp. Previous NuGet versions remain installable after the repository migration.

RQL

Since 1.0.0 the extension is an RQL module: it adds no MCP tools. Agents create and read Dialogic timelines and characters with the core rql-query / rql-mutate / rql-schema tools, and the module's guide is part of the core godot-rql skill. Dialogic stores dialogue in resource files whose classes are GDScript class_names (the core editor | call CreateResource cannot make them), so the module adds:

  • The dialogic source: installed, hint (how to install the addon when it is missing), the project's files as read-only rows (dialogic.timelines: path name eventCount text resource; dialogic.characters: path name displayName color description resource; res://addons and hidden folders are skipped), and the calls CreateTimeline(path, text?, speaker?) and CreateCharacter(path, displayName, color?, description?) (validated: .dtl / .dch paths, an existing file, a hex color, a display name).
  • AddText(text, speaker?) on a timeline row appends a text line (a timeline is its text).
  • Character writes go through the row's resource (get resource | set props["…"]): the core writes the property and saves the .dch with Dialogic's own saver.

Creating and appending write the files directly and are not undoable (like CreateResource).

dialogic | select installed hint
dialogic | call CreateTimeline("res://e2e_intro.dtl", "Hello from CI", "Narrator")
dialogic | call CreateCharacter("res://e2e_hero.dch", "Hero", "#e91e63", "The brave protagonist.")
dialogic.timelines | where name == "e2e_intro" | call AddText("A second line", "Hero")
dialogic.characters | where name == "e2e_hero" | get resource | set props["description"] = "The bravest hero."
dialogic.timelines | select path eventCount text
dialogic.characters | select path displayName color description

Without the addon the module still loads: dialogic | select installed hint returns false and the install hint, the lists are empty and the calls fail with the hint.

Migrating from 0.x

0.x tool RQL
dialogic-defaults removed: CreateTimeline(path) without text writes the two-line starter; the guide lists typical values ("Narrator", color "#3aa0ff")
dialogic-timeline-create rql-mutate dialogic \| call CreateTimeline("res://intro.dtl", "Hello", "Narrator") (now fails if the file exists)
dialogic-character-create rql-mutate dialogic \| call CreateCharacter("res://hero.dch", "Hero", "#e91e63", "…") (an invalid color now fails instead of falling back)
dialogic-timeline-add-text rql-mutate dialogic.timelines \| where name == "intro" \| call AddText("A second line", "Hero")
dialogic-get rql-query dialogic.timelines \| select path eventCount text / dialogic.characters \| select path displayName color description
Installed: false results dialogic \| select installed hint

Development and releases

See the monorepo test and release guide. This module retains its own package, version, tests and Apache-2.0 license. Releasing another module does not rebuild or republish this package.

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.1.3 60 11/19/2026
1.1.2 327 11/14/2026
1.1.1 390 11/7/2026
1.1.0 164 10/31/2026
1.0.1 150 10/24/2026
1.0.0 161 10/18/2026
0.1.2 146 10/16/2026
0.1.1 154 10/12/2026
0.1.0 465 6/29/2026