From ed58094721218d87e27b65c26e7104a271fe5bff Mon Sep 17 00:00:00 2001 From: Brandon M <119460557+BrandonM-404@users.noreply.github.com> Date: Fri, 22 May 2026 15:41:09 -0400 Subject: [PATCH 1/3] Delete docs/2to3.md --- docs/2to3.md | 10 ---------- 1 file changed, 10 deletions(-) delete mode 100644 docs/2to3.md diff --git a/docs/2to3.md b/docs/2to3.md deleted file mode 100644 index 5ea27bb6..00000000 --- a/docs/2to3.md +++ /dev/null @@ -1,10 +0,0 @@ -# Upgrading from Dialogue Manager 2 to Dialogue Manager 3 - -The upgrade should be mostly seamless but there are a couple of things to watch out for: - -- Dialogue Manager 3 requires Godot 4.3 or above. -- The "include failed responses" setting has been removed and is now the default. Responses that fail their condition check will be included in the responses list and it is now up to the balloon to filter them out. The provided `DialogueResponsesMenu` node has an option to hide failed responses. -- The "create lines for responses with characters" setting is now gone and something your game will have to do manually. -- The built-in `emit` mutation has been removed in favour of emitting signals just like GDScript (ie. `some_signal.emit()`). - -To upgrade from 2.x to 3.x you can remove the `addons/dialogue_manager` directory and then download a fresh copy of Dialogue Manager 3 from either the Asset Library or GitHub. From b80327e04bcdeba46cb03ba1e5f6bbb2d8d770bb Mon Sep 17 00:00:00 2001 From: Brandon M <119460557+BrandonM-404@users.noreply.github.com> Date: Fri, 22 May 2026 15:41:16 -0400 Subject: [PATCH 2/3] Delete docs/3to4.md --- docs/3to4.md | 14 -------------- 1 file changed, 14 deletions(-) delete mode 100644 docs/3to4.md diff --git a/docs/3to4.md b/docs/3to4.md deleted file mode 100644 index c3a3b974..00000000 --- a/docs/3to4.md +++ /dev/null @@ -1,14 +0,0 @@ -# Upgrading from Dialogue Manager 3 to Dialogue Manager 4 - -Godot 4.6 is now the minimum Godot version supported. - -## Breaking changes - -- "Titles" are now called "Cues" to better reflect how they are used. -- Response Conditions are now self-closing (eg. `- Text [if some_condition]` is now `- Text [if some_condition /]`). -- The `translation_key` property of `DialogueLine`s is now `static_id` to better reflect that it's not just for translations. - -## Possible gotchas - -- The bespoke CSV exporter has been removed in favour of Godot's built-in translation template exporter (in **Project Settings > Localisation > Template Generation**) now supporting CSVs. -- The `raw_text` property of `DialogueResource` files has been removed. \ No newline at end of file From 404adddaacc89fd7de8b3570ebe50bfd7094e165 Mon Sep 17 00:00:00 2001 From: Brandon M <119460557+BrandonM-404@users.noreply.github.com> Date: Fri, 22 May 2026 15:43:44 -0400 Subject: [PATCH 3/3] Combine Upgrade Docs One Upgrading_Version, contents match 2to3.md and 3to4.md --- docs/Upgrading_Version.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 docs/Upgrading_Version.md diff --git a/docs/Upgrading_Version.md b/docs/Upgrading_Version.md new file mode 100644 index 00000000..e3c9d2da --- /dev/null +++ b/docs/Upgrading_Version.md @@ -0,0 +1,26 @@ +# Upgrading from Dialogue Manager 2 to Dialogue Manager 3 + +The upgrade should be mostly seamless but there are a couple of things to watch out for: + +- Dialogue Manager 3 requires Godot 4.3 or above. +- The "include failed responses" setting has been removed and is now the default. Responses that fail their condition check will be included in the responses list and it is now up to the balloon to filter them out. The provided `DialogueResponsesMenu` node has an option to hide failed responses. +- The "create lines for responses with characters" setting is now gone and something your game will have to do manually. +- The built-in `emit` mutation has been removed in favour of emitting signals just like GDScript (ie. `some_signal.emit()`). + +To upgrade from 2.x to 3.x you can remove the `addons/dialogue_manager` directory and then download a fresh copy of Dialogue Manager 3 from either the Asset Library or GitHub. + + +# Upgrading from Dialogue Manager 3 to Dialogue Manager 4 + +Godot 4.6 is now the minimum Godot version supported. + +## Breaking changes + +- "Titles" are now called "Cues" to better reflect how they are used. +- Response Conditions are now self-closing (eg. `- Text [if some_condition]` is now `- Text [if some_condition /]`). +- The `translation_key` property of `DialogueLine`s is now `static_id` to better reflect that it's not just for translations. + +## Possible gotchas + +- The bespoke CSV exporter has been removed in favour of Godot's built-in translation template exporter (in **Project Settings > Localisation > Template Generation**) now supporting CSVs. +- The `raw_text` property of `DialogueResource` files has been removed.