This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
dialogue_editor [2017/07/24 11:42] – justin | dialogue_editor [2022/05/10 17:29] (current) – justin | ||
---|---|---|---|
Line 5: | Line 5: | ||
The **Dialogue Editor** is where you will create conversations for your game's characters or narration for scripted sequences and cutscenes. Dialogue can be attached to an NPC from its [[Entity Properties]] dialog in the [[Map Editor]] or triggered from a script using the [[Start Dialogue]] function. | The **Dialogue Editor** is where you will create conversations for your game's characters or narration for scripted sequences and cutscenes. Dialogue can be attached to an NPC from its [[Entity Properties]] dialog in the [[Map Editor]] or triggered from a script using the [[Start Dialogue]] function. | ||
- | =====Toolbar===== | + | =====File Toolbar===== |
- | ^Icon^Function^Description^ | + | ^Function^Description^ |
- | |{{: | + | |New Resource|Opens the [[New Resource dialog]] (with " |
- | |{{: | + | |Save|Saves changes to the dialogue.| |
- | |{{: | + | |Save As|Saves a copy of the dialogue to a new file.| |
+ | |Add Section|Adds a new section to the dialogue. A section can be jumped to using a "Go To" node.| | ||
+ | |Collapse All|Collapses all dialogue nodes that have any child nodes underneath them.| | ||
+ | |Expand All|Expands all dialogue nodes that have any child nodes underneath them.| | ||
+ | |Compact All|Enables compact mode for all dialogue nodes.| | ||
+ | |Decompact All|Disables compact mode for all dialogue nodes.| | ||
- | =====Dialogue | + | =====Dialogue |
- | The Dialogue | + | The Dialogue |
- | {{:wiki:dialogue_graph.png? | + | {{:dialogue_tools.png? |
+ | |||
+ | =====Dialogue Tree===== | ||
+ | The Dialogue Tree is the visual workspace where you will build your dialogue. Nodes can be removed from the dialogue tree by clicking on their " | ||
+ | |||
+ | {{:dialogue_tree.png? | ||
=====Node Types===== | =====Node Types===== | ||
- | <WRAP group> | + | There are several different types of nodes that can be added to a dialogue tree. Refer to each section below for an explanation of that node type's purpose and any options that can be set. |
- | <WRAP column> | + | |
+ | =====NPC Node===== | ||
+ | **NPC nodes** are for dialogue spoken by non-player characters (i.e. characters other than the player). Typing into the main box allows you to enter the text that will be displayed in the game's dialogue box when this node is reached. | ||
{{: | {{: | ||
- | </ | + | |
- | <WRAP column 58%> | + | |
- | **NPC** nodes are for dialogue spoken by non-player characters (i.e. characters other than the player). Click the " | + | |
- | \\ | + | |
- | \\ | + | |
The NPC's default portrait (as defined in the [[Voxel Editor]]) can be overridden for a specific node by selecting an image from the " | The NPC's default portrait (as defined in the [[Voxel Editor]]) can be overridden for a specific node by selecting an image from the " | ||
- | \\ | + | |
- | \\ | + | |
The " | The " | ||
- | </WRAP> | + | |
- | </WRAP> | + | < |
+ | < | ||
^Speaker Setting^Description^ | ^Speaker Setting^Description^ | ||
- | |Initiating NPC|Character from which the dialogue was started determines the speaker' | + | |Initiating NPC|Character from which the dialogue was started determines the speaker name and the text color.| |
- | |Entity ID|Character having the specified entity ID determines the speaker' | + | |Entity ID|Character having the specified entity ID determines the speaker name and the text color.| |
|Custom Name|Speaker name is overridden with the specified text.| | |Custom Name|Speaker name is overridden with the specified text.| | ||
|Custom Name/ | |Custom Name/ | ||
- | \\ | ||
- | <WRAP group> | ||
- | <WRAP column> | ||
- | {{: | ||
- | </ | ||
- | <WRAP column 58%> | ||
- | ====Player==== | ||
- | The player' | ||
- | </ | ||
</ | </ | ||
- | \\ | ||
- | <WRAP group> | ||
<WRAP column> | <WRAP column> | ||
- | {{:wiki:message_dialogue_node.png? | + | {{:wiki:dialogue_speaker_example.png? |
</ | </ | ||
- | <WRAP column 58%> | ||
- | ====Message==== | ||
</ | </ | ||
+ | |||
+ | =====Player Node===== | ||
+ | **Player nodes** are for dialogue spoken by the player character. Typing into the main box allows you to enter the text that will be displayed in the game's dialogue box when this node is reached. | ||
+ | |||
+ | The player' | ||
+ | |||
+ | {{: | ||
+ | |||
+ | <WRAP center round info 100%> | ||
+ | You can provide the player with a list of responses to choose from and branch the dialogue based upon the player' | ||
</ | </ | ||
- | \\ | + | |
- | <WRAP group> | + | =====Message Node===== |
- | <WRAP column> | + | **Message nodes** are used to display any general text that is not spoken by a character, for example to describe an event that is occurring in the scene. |
+ | |||
+ | Typing into the main box allows you to enter the text that will be displayed in the game's dialogue box when this node is reached. This is similar to using the [[Display Message]] function in a script. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | =====Condition Node===== | ||
+ | **Condition nodes** provide a way of branching the dialogue based on the results of a conditional expression being evaluated. | ||
+ | |||
+ | Clicking the wizard button opens the [[Conditional Expression Builder]], allowing you to define the conditional expression that will be evaluated when this node is reached. You can also type an expression directly into the field. If the condition is met (i.e. evaluates to true), then the dialogue will proceed to the node connected to the " | ||
{{: | {{: | ||
- | </ | + | |
- | <WRAP column 58%> | + | =====Script Node===== |
- | ====Condition==== | + | **Script nodes** provide a way to trigger scripts during the dialogue, for example to give an item to the player or move the camera to a different viewpoint. You can choose between either a "Quick Script" |
- | </ | + | |
- | </ | + | The "Pause until complete" |
- | \\ | + | |
- | <WRAP group> | + | |
- | <WRAP column> | + | |
{{: | {{: | ||
- | </ | + | |
- | <WRAP column 58%> | + | =====Go To Node===== |
- | ====Script==== | + | **Go To nodes** allow you to jump to another part of the dialogue. You can either jump to a specific dialogue node or to the start of a section. |
- | </ | + | |
- | </ | + | =====Comment Node===== |
+ | **Comment nodes** allow you to insert comments into your dialogue. These provide a way of keeping notes or commentary about the dialogue and will not be displayed in-game. | ||
~~NOTOC~~ | ~~NOTOC~~ |