- Please note that this page is under construction**
Creating and editing a dialogue
To begin, open up a level in the editor, or create a new one. Spawn some characters, and make sure they're all on the same team so they don't attack each other.
Then click Top Bar -> Dialogue -> New Dialogue. Your cursor should now have a plus. Click somewhere in the level to spawn the dialogue hotspot.
Double click on the new dialogue hotspot to select it, and click Top Bar -> Dialogue -> Edit Selected. Now you're in the dialogue editor.
Naming the dialogue
Make sure you change the name from #name "Unnamed" to something more specific to that conversation. Like #name "Chat With Villagers" or something. Remember this name, cause you're going to use it later.
Adding participants to the dialogue
Next, change the #participants 1 value from 1, to the number of characters in the conversation. Make sure you include the player, even if they aren't going to talk. Otherwise the character can run around during the dialogue, and it can get confusing.
After that, double click on the small numbered box above the dialogue hotspot. Then hold Alt while you click on a character's spawn box. This makes a line between the two, and binds that character to that dialogue. You have to do this for all characters who will talk, and the player.
Adding lines to the dialogue
Now to customize the dialogue. Where it says say 1 "Name" "Type your dialogue here.", change the name and the text. Something like say 1 "Fritz" "Just going for a jaunt in the park". The number at the beginning refers to the participant number (the numbered box) that is linked to the character who is speaking.
You can add more say lines. Remember to set the right participant number and the right name for each. They can even change names in the middle of the conversation, for example if they've just been introduced to you. You could start by calling them "Green Rabbit", and later change them to "Jonathan".
You can preview what your dialogue does at any time by clicking Dialogue Editor -> Menu Bar -> Edit -> Preview.
Triggering the dialogue
To start the dialogue, the character needs to walk to somewhere in the level. To make that work, you need a Start Dialogue hotspot. There are other ways to trigger a dialogue using the new checkpoints system, but that's far more advanced, so let's just start with this.
Click Top Bar -> Load -> and type Start Dialogue. Click that item, and click in the level to spawn it.
Then double click on the new Start Dialogue hotspot to select it. Click Top Bar -> Windows -> Selected in order to open its properties.
From here, click the arrow to expand the start_dialogue.xml object, and click the arrow to expand Script Params.
On the line where it says Dialogue, double click in the box next to it, where it says Default text. Change the text here to the name you set for the dialogue (Chat With Villagers, in the example at the beginning of this tutorial, or whatever you chose to name it).
Now make sure to move this trigger and resize it to the shape you want. When the player walks inside this trigger, the dialogue will start. Note that it will only do this once, so you must hit the L key to reset the level if you want to trigger the dialogue again.
Other properties in the Script params:
If you want to have to click to activate the dialogue, instead of just having to walk inside the hotspot, then uncheck Automatic.
If you don't want to see the big green dialogue bubble while playing the game, uncheck Visible in game.
Camera work and character positions
While editing the dialogue, there's a camera object that you can move around in the scene. You might not see that camera at first, since it spawns on top of the dialogue hotspot, and might be embedded in the ground. The camera can be spawned from the Load->Utility menu, as well. Don't be afraid to move any of those boxes around. It doesn't matter where you place the dialogue hotspot, so feel free to move it up and out of the way, so you can edit the per-line objects.
To set up the camera for a given line of dialogue, click on the corresponding say line, then select the camera and position it where you want it. There is a preview window that lets you line up your shot perfectly. You can move and resize that window.
You can also move characters to different positions for each line, make them look around, etc, via boxes that can somehow be manipulated.
The camera and character positions can be changed for each line of dialogue, so make sure you set everything up perfectly for each line. Just click on each different line in the editor window, and then move the animation and camera boxes around for that line of the dialogue as desired.
Making it good
Don't be afraid to mess around with the objects in the Dialogue Editor, or even to change, copy, paste the code around. Also make sure to open the existing game's levels in the editor to check out what other hidden features show up in dialogues.
For dialogue work in general, there's also a bunch of tutorials on the internet and YouTube about cinema, camera work, and photography. All of these topics can give you useful information that will apply to making dialogues in games. I suggest you check out (google!) topics like -
The rule of thirds 180 degree rule 30 degree rule Over the shoulder shot
This list of techniques goes on forever, so I suggest getting lost on google for a while, watching videos, etc.
A popular YouTube channel on this topic is "each frame a painting". Check that out too.