00001 /* 00002 $Id: dialog.dxt,v 1.2 2001/10/15 21:26:52 ksterker Exp $ 00003 00004 Copyright (C) 2001 Kai Sterker 00005 Part of the Adonthell Project http://adonthell.linuxgames.com 00006 00007 This program is free software; you can redistribute it and/or modify 00008 it under the terms of the GNU General Public License. 00009 This program is distributed in the hope that it will be useful, 00010 but WITHOUT ANY WARRANTY. 00011 00012 See the COPYING file for more details. 00013 */ 00014 00015 /*! \page page5 The Dialogue Engine 00016 00017 The dialogue engine is handling conversations between the player and NPCs. 00018 Dialogues themselves are %python scripts that are executed step by step by 00019 the lowlevel dialog class. 00020 00021 Each step results in a number of strings, the speech of the NPC and an optional 00022 list of the player's possible responses. These are displayed in the \link 00023 dialog_screen Dialogue Window \endlink . Once the player has chosen an answer 00024 the next step of the script is executed. 00025 00026 The script itself returns three lists. Possible NPC speeches, the player's possible 00027 responses for each of those speaches and finally a list with the successor of each 00028 choice. The dialogue engine randomly picks one of the NPC speeches and the according 00029 answers. It also makes sure that each piece of dialogue is only used once during the 00030 conversation. More complex operations, such as depending a piece of dialogue on a 00031 certain condition are already handled in the %python script. 00032 00033 For more information you should refer to the Dialogue Editor documentation. 00034 */