User Tools

Site Tools


dialogue_editor

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
dialogue_editor [2017/07/25 09:05] justindialogue_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^ 
-|{{:wiki:new_resource.png?nolink|}}|New Resource|Opens the [[New Resource dialog]] (with "Dialogue" selected for the resource type).| +|New Resource|Opens the [[New Resource dialog]] (with "Dialogue" selected for the resource type).| 
-|{{:wiki:disk.png?nolink|}}|Save|Saves changes to the dialogue.| +|Save|Saves changes to the dialogue.| 
-|{{:wiki:disk_multiple.png?nolink|}}|Save As|Saves a copy of the dialogue to a new file.|+|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 Graph===== +=====Dialogue Tools===== 
-The Dialogue Graph is the visual workspace where you will build your dialogue. Once you have added nodes to your dialogue, you can click and drag to move them around. To connect two nodes togetherclick and hold on the output connector of one then drag to the input connector of another and release. In order to have a valid dialogue, you need at least one node connected to the Start nodeNodes can be removed from the Dialogue Graph by clicking on their "X" button located in the upper right corner of the node.+The Dialogue Tools panel (located below the [[Game Explorer]]) contains a list of nodes that can be added to your dialogue. A node represents a specific point in the dialogue where an event occursfor example when a character speaks, a message is displayed, a condition is evaluated, or a script is triggered. To add a node to your dialoguedrag and drop an item from the list to the desired location within your dialogue. Selecting an item will display usage information about that node type in the description box below.
  
-{{:wiki:dialogue_graph.png?nolink|}}+{{:dialogue_tools.png?nolink|}} 
 + 
 +=====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 "X" button located in the upper right corner of the node. 
 + 
 +{{:dialogue_tree.png?nolink|}}
  
 =====Node Types===== =====Node Types=====
-There are several different types of nodes that can be added to a dialogue graph. Refer to each section below for an explanation of that node type's purpose and any options that can be set. +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 group> + 
-<WRAP column 58%> +=====NPC Node===== 
-====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. 
-**NPC nodes** are for dialogue spoken by non-player characters (i.e. characters other than the player). Clicking the "Edit" button allows you to enter the text that will be displayed in the game's dialogue box when this node is reached. + 
-\\ +{{:wiki:npc_dialogue_node.png?nolink|}} 
-\\+
 The NPC's default portrait (as defined in the [[Voxel Editor]]) can be overridden for a specific node by selecting an image from the "Portrait" dropdown box. Selecting "None" will cause the portrait to be hidden. The NPC's default portrait (as defined in the [[Voxel Editor]]) can be overridden for a specific node by selecting an image from the "Portrait" dropdown box. Selecting "None" will cause the portrait to be hidden.
-\\ +
-\\+
 The "Speaker" setting is used by the game to determine the name that is displayed for the speaker, along with its text color. Each setting is described in the table below. The "Speaker" setting is used by the game to determine the name that is displayed for the speaker, along with its text color. Each setting is described in the table below.
-</WRAP> +
-<WRAP column> +
-{{:wiki:npc_dialogue_node.png?nolink|}} +
-</WRAP> +
-</WRAP>+
 <WRAP group> <WRAP group>
 <WRAP column 70%> <WRAP column 70%>
Line 45: Line 50:
 </WRAP> </WRAP>
 </WRAP> </WRAP>
-\\ + 
-<WRAP group> +=====Player Node===== 
-<WRAP column 58%> +**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. 
-====Player Node==== +
-**Player nodes** are for dialogue spoken by the player character. Clicking the "Edit" button allows you to enter the text that will be displayed in the game's dialogue box when this node is reached. +
-\\ +
-\\+
 The player's default portrait (as defined in the [[Voxel Editor]]) can be overridden for a specific node by selecting an image from the "Portrait" dropdown box. Selecting "None" will cause the portrait to be hidden. The player's default portrait (as defined in the [[Voxel Editor]]) can be overridden for a specific node by selecting an image from the "Portrait" dropdown box. Selecting "None" will cause the portrait to be hidden.
-</WRAP> +
-<WRAP column>+
 {{:wiki:player_dialogue_node.png?nolink|}} {{:wiki:player_dialogue_node.png?nolink|}}
-</WRAP> +
-</WRAP>+
 <WRAP center round info 100%> <WRAP center round info 100%>
-You can connect more than one "Player" node to the output connector of another node. Doing so will provide the player with a list of responses to choose from and allow the dialogue to be branched based upon the player's response.+You can provide the player with a list of responses to choose from and branch the dialogue based upon the player's response. To do so, either drag and drop a player node from the Dialogue Tools panel onto an existing player node without any subsequent nodes, or click the green branching arrow button on the titlebar of the node.
 </WRAP> </WRAP>
-\\ + 
-<WRAP group> +=====Message Node=====
-<WRAP column 58%> +
-====Message Node====+
 **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. **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. 
-Clicking the "Edit" button 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. +
-</WRAP> +
-<WRAP column>+
 {{:wiki:message_dialogue_node.png?nolink|}} {{:wiki:message_dialogue_node.png?nolink|}}
-</WRAP> + 
-</WRAP> +=====Condition Node===== 
-\\ +**Condition nodes** provide a way of branching the dialogue based on the results of a conditional expression being evaluated. 
-<WRAP group> + 
-<WRAP column 58%> +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 "Then" output connector. Otherwise, it will proceed to the node connected to the "Else" output connector. 
-====Condition Node==== +
-**Condition nodes** provide a way of branching the dialogue based on the results of a conditional expression being evaluated. Clicking the "Edit" button opens the [[Conditional Expression Builder]], allowing you to define the conditional expression that will be evaluated when this node is reached. If the condition is met (i.e. evaluates to true), then the dialogue will proceed to the node connected to the "Then" output connector. Otherwise, it will proceed to the node connected to the "Else" output connector. +
-</WRAP> +
-<WRAP column>+
 {{:wiki:condition_dialogue_node.png?nolink|}} {{:wiki:condition_dialogue_node.png?nolink|}}
-</WRAP> + 
-</WRAP> +=====Script Node=====
-\\ +
-<WRAP group> +
-<WRAP column 58%> +
-====Script Node====+
 **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" or a "Resource" (i.e. an existing script file). If the "Quick Script" option is selected, clicking the "Build" button will open the [[Quick Script Builder]]. **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" or a "Resource" (i.e. an existing script file). If the "Quick Script" option is selected, clicking the "Build" button will open the [[Quick Script Builder]].
-\\ + 
-\\ +The "Pause until complete" checkbox determines whether or not the dialogue will wait for the script to complete before proceeding. For example, if the script includes a timed camera movement and "Pause until complete" is checked, the dialogue will not proceed until the camera movement has finished. 
-The "Pause until complete" checkbox determines whether or not the dialogue will wait for the script to complete before proceeding. For example, if the script includes a timed camera movement and "Pause until complete" is checked, the dialogue will not proceed until the camera movement is finished. +
-</WRAP> +
-<WRAP column>+
 {{:wiki:script_dialogue_node.png?nolink|}} {{:wiki:script_dialogue_node.png?nolink|}}
-</WRAP> + 
-</WRAP>+=====Go To Node===== 
 +**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~~
dialogue_editor.1500998706.txt.gz · Last modified: 2017/07/25 09:05 by justin