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
<PackageReference Include="com.IvanMurzak.Godot.MCP.Dialogic" Version="1.1.3" />
<PackageVersion Include="com.IvanMurzak.Godot.MCP.Dialogic" Version="1.1.3" />
<PackageReference Include="com.IvanMurzak.Godot.MCP.Dialogic" />
paket add com.IvanMurzak.Godot.MCP.Dialogic --version 1.1.3
#r "nuget: com.IvanMurzak.Godot.MCP.Dialogic, 1.1.3"
#:package com.IvanMurzak.Godot.MCP.Dialogic@1.1.3
#addin nuget:?package=com.IvanMurzak.Godot.MCP.Dialogic&version=1.1.3
#tool nuget:?package=com.IvanMurzak.Godot.MCP.Dialogic&version=1.1.3
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
Dialogicautoload).
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
dialogicsource: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://addonsand hidden folders are skipped), and the callsCreateTimeline(path, text?, speaker?)andCreateCharacter(path, displayName, color?, description?)(validated:.dtl/.dchpaths, 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.dchwith 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.
Learn more about Target Frameworks and .NET Standard.
-
net8.0
- com.IvanMurzak.McpPlugin (>= 8.25.0)
- com.IvanMurzak.ReflectorNet (>= 5.5.3)
- com.IvanMurzak.Rql (>= 0.5.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.