Adonthell  0.4
dialog.dxt
1 /*
2  $Id: dialog.dxt,v 1.2 2001/10/15 21:26:52 ksterker Exp $
3 
4  Copyright (C) 2001 Kai Sterker
5  Part of the Adonthell Project http://adonthell.linuxgames.com
6 
7  This program is free software; you can redistribute it and/or modify
8  it under the terms of the GNU General Public License.
9  This program is distributed in the hope that it will be useful,
10  but WITHOUT ANY WARRANTY.
11 
12  See the COPYING file for more details.
13 */
14 
15 /*! \page page5 The Dialogue Engine
16 
17 The dialogue engine is handling conversations between the player and NPCs.
18 Dialogues themselves are %python scripts that are executed step by step by
19 the lowlevel dialog class.
20 
21 Each step results in a number of strings, the speech of the NPC and an optional
22 list of the player's possible responses. These are displayed in the \link
23 dialog_screen Dialogue Window \endlink . Once the player has chosen an answer
24 the next step of the script is executed.
25 
26 The script itself returns three lists. Possible NPC speeches, the player's possible
27 responses for each of those speaches and finally a list with the successor of each
28 choice. The dialogue engine randomly picks one of the NPC speeches and the according
29 answers. It also makes sure that each piece of dialogue is only used once during the
30 conversation. More complex operations, such as depending a piece of dialogue on a
31 certain condition are already handled in the %python script.
32 
33 For more information you should refer to the Dialogue Editor documentation.
34 */