dialogic-godot · coppolaemilio · Feb 19, 2022 · Feb 19, 2022
diff --git a/addons/dialogic/Documentation/Content/Events/Images/Call_Node.PNG b/addons/dialogic/Documentation/Content/Events/Images/Call_Node.PNG
diff --git a/addons/dialogic/Documentation/Content/Events/Images/Event_Change_Timeline.PNG b/addons/dialogic/Documentation/Content/Events/Images/Event_Change_Timeline.PNG
diff --git a/addons/dialogic/Documentation/Content/Events/Images/Event_Character_Join.PNG b/addons/dialogic/Documentation/Content/Events/Images/Event_Character_Join.PNG
diff --git a/addons/dialogic/Documentation/Content/Events/Images/Event_Character_Leave.PNG b/addons/dialogic/Documentation/Content/Events/Images/Event_Character_Leave.PNG
diff --git a/addons/dialogic/Documentation/Content/Events/Images/Event_Character_Update.PNG b/addons/dialogic/Documentation/Content/Events/Images/Event_Character_Update.PNG
diff --git a/addons/dialogic/Documentation/Content/Events/Images/Event_Choice.PNG b/addons/dialogic/Documentation/Content/Events/Images/Event_Choice.PNG
diff --git a/addons/dialogic/Documentation/Content/Events/Images/Event_Choice_Condition.PNG b/addons/dialogic/Documentation/Content/Events/Images/Event_Choice_Condition.PNG
diff --git a/addons/dialogic/Documentation/Content/Events/Images/Event_Close_Dialog.PNG b/addons/dialogic/Documentation/Content/Events/Images/Event_Close_Dialog.PNG
diff --git a/addons/dialogic/Documentation/Content/Events/Images/Event_Condition.PNG b/addons/dialogic/Documentation/Content/Events/Images/Event_Condition.PNG
diff --git a/addons/dialogic/Documentation/Content/Events/Images/Event_Condition_in_use.PNG b/addons/dialogic/Documentation/Content/Events/Images/Event_Condition_in_use.PNG
diff --git a/addons/dialogic/Documentation/Content/Events/Images/Event_Emit_Signal.PNG b/addons/dialogic/Documentation/Content/Events/Images/Event_Emit_Signal.PNG
diff --git a/addons/dialogic/Documentation/Content/Events/Images/Event_End_Branch.PNG b/addons/dialogic/Documentation/Content/Events/Images/Event_End_Branch.PNG
diff --git a/addons/dialogic/Documentation/Content/Events/Images/Event_Question.PNG b/addons/dialogic/Documentation/Content/Events/Images/Event_Question.PNG
diff --git a/addons/dialogic/Documentation/Content/Events/Images/Event_Question_in_use.PNG b/addons/dialogic/Documentation/Content/Events/Images/Event_Question_in_use.PNG
diff --git a/addons/dialogic/Documentation/Content/Events/Images/Event_Set_Theme.PNG b/addons/dialogic/Documentation/Content/Events/Images/Event_Set_Theme.PNG
diff --git a/addons/dialogic/Documentation/Content/Events/Images/Event_Set_Value.PNG b/addons/dialogic/Documentation/Content/Events/Images/Event_Set_Value.PNG
diff --git a/addons/dialogic/Documentation/Content/Events/Images/Event_Set_Value_random.PNG b/addons/dialogic/Documentation/Content/Events/Images/Event_Set_Value_random.PNG
diff --git a/addons/dialogic/Documentation/Content/Events/Images/Event_Wait_Seconds.PNG b/addons/dialogic/Documentation/Content/Events/Images/Event_Wait_Seconds.PNG
diff --git a/addons/dialogic/Documentation/Content/Events/Images/audio_event.png b/addons/dialogic/Documentation/Content/Events/Images/audio_event.png
diff --git a/addons/dialogic/Documentation/Content/Events/Images/text_event_1.png b/addons/dialogic/Documentation/Content/Events/Images/text_event_1.png
diff --git a/addons/dialogic/Documentation/Content/Events/Images/text_event_2.png b/addons/dialogic/Documentation/Content/Events/Images/text_event_2.png
diff --git a/addons/dialogic/Documentation/Content/Reference/001.md b/addons/dialogic/Documentation/Content/Reference/001.md
@@ -42,14 +42,24 @@ Is used to change the current timeline. This way the state of the DialogNode (li
 `@param timeline`
 Same as the one on `start()`, although it cannot load from saves.
 
+
 ### next_event()
 `next_event(discreetly)`
-Is used to immediately play the next event. This way the state of the DialogNode are preserved from the currently active node.
+Is used to immediately play the next event.
 
 `@param discreetly`
 A boolean (default value: false) that determines whether the Passing Audio will be played.
 
 
+### timeline_exists()
+`timeline_exists(timeline)`
+Returns true if a timeline with the given name at the given path exists, otherwise false.
+
+`@param timeline`
+The name/path to check.
+
+
+
 ## Saving and loading
 The Dialogic class provides the following methods for dealing with saving and loading. Learn more about how to use them in the Saving and Loading tutorial.
 

diff --git a/addons/dialogic/Documentation/Content/Reference/Theme.md b/addons/dialogic/Documentation/Content/Reference/Theme.md
@@ -19,6 +19,10 @@ Use this to align the text inside the box.
 ##### Behaviour>Single Portrait Mode
 If you enable this mode, there will always only be one portrait visible. This will be the portrait of the character who is currently speaking.
 
+##### Behaviour>Don't Close After Last Event
+If enabled, the dialog box will not delete itself after the last event. Instead you will need to remove it manualy. Usefull if the box is intergrated into your design and should never vanish.
+
+
 ## Dialog Box
 ### Dialog Box>Visuals
 You may choose either a solid color or a texture for the background of the box. For the texture, you can also change its modulation.
@@ -42,9 +46,16 @@ Sets how long the theme takes to fade in. Fading only happens on dialog load and
 ##### Behaviour>Portraits Dim Color
 Use this to change the modulation of the active character. Set it to white if you do not want any changes. 
 
+##### Behaviour>Portraits Behind Dialog Box
+If you disable this, the portraits will instead be in front of the dialog box.
+
+
 ## Name Label
 The `Name Label` is the section above the text box that displays the name of the character who is currently speaking.
 
+##### Behaviour>Hide name labels
+If this is enabled, the name label will not be shown.
+
 ##### Text>Use character Color
 If you enable this, the name label will always use the color of the currently speaking character. The characters color can be edited in the [Character Editor](./Character.md).
 
@@ -57,9 +68,11 @@ The padding between the texture border and the text.
 ### Name Label>Placement
 Here you can set the alignment of the `Name label` as well as setting some additional offset.
 
+
 ## Choice Buttons
 You can change the look of the buttons four states, although "Disabled" currently does nothing.
 
+
 ## Glossary
 These setting lets you define the appearance of the box that appears when you hover over a glossary entry.
 
@@ -69,6 +82,7 @@ Sets the color of glossary word inside the dialog.
 ##### Behaviour>Show
 If this is disabled, the glossary info box won't be shown and glossary entries won't be colored.
 
+
 ## Audio
 This sections allows you to set audio for your dialogue. Dialogic uses the [RandomAudioPlayer by TimKrief](https://gitlab.com/timkrief/godot-random-audio-stream-player).
 

diff --git a/addons/dialogic/Documentation/Content/Tutorials/Images/ValueInUse.PNG b/addons/dialogic/Documentation/Content/Tutorials/Images/ValueInUse.PNG
diff --git a/addons/dialogic/Documentation/Content/Tutorials/Values.md b/addons/dialogic/Documentation/Content/Tutorials/Values.md
@@ -0,0 +1,19 @@
+# Values
+
+Values are a dialogic resource that allows to store strings and integers and easily reference them with dialogic. 
+
+Once created, a value with a name (e.g. `PlayerName` or `PlayerStrength`) can be added into text events by using square brackets:
+![Value is being used](./Images/ValueInUse.PNG)
+
+It can also be used in conditions (Condition Event, Choice Event).
+
+From outside values can be accessed using the DialogiClass:
+``` 
+func _ready():
+    Dialogic.set_variable('PlayerName', 'John')
+    if Dialogic.get_variable('PlayerStrength') > 10:
+         print("Wow, so strong!")
+```
+
+You can also use the whole path when referencing variables. In text this could look like `[Characters/Player/Name]`, in code like `Dialogic.set_variable('Characters/Player/Name', 'Sally')`.
+