Dialogues/Conditions - Revision history

Dave: /* Special Variables */

2017-12-02T18:03:47Z

‎Special Variables

Dave: /* Special Variables */

2017-12-02T18:00:58Z

‎Special Variables

Dave: /* Var: Variable Conditions */

2016-12-20T15:46:01Z

‎Var: Variable Conditions

Dave at 12:27, 27 October 2016

2016-10-27T12:27:03Z

Dave at 11:09, 27 October 2016

2016-10-27T11:09:47Z

Dave at 15:32, 6 October 2016

2016-10-06T15:32:56Z

Dave: Created page with "Every dialogue topic and individual dialogue fragment can be qualified with one or more conditions.
For topics, the condition(s) can be specified in a dedicated text box..."

2016-10-06T14:24:05Z

Created page with "Every dialogue topic and individual dialogue fragment can be qualified with one or more conditions. <br/> For topics, the condition(s) can be specified in a dedicated text box..."

New page

Every dialogue topic and individual dialogue fragment can be qualified with one or more conditions. <br/>
For topics, the condition(s) can be specified in a dedicated text box within their template properties. For individual fragments, conditions can be set by double clicking on the nub of their ingoing connection.

==Structure of a Condition==
A condition is a single line of text in the following format:
Type: Expression
where ''Type'' is one of the following:
* '''Chr''': A given character must be present
* '''Var''': A certain variable or expression must be ''true''

If the ''Type:'' part of the condition is omitted, it is assumed to be '''Chr:'''.

===Character Conditions===
For character conditions, ''Expression'' must be the technical name of a hero character. The condition is considered to be fulfilled if the character is part of the hero party and is within range of the character with whom the dialogue was initiated (same requirement as for other dialogue participants).

Some examples for character conditions:
Chr: The_Flute_Player // Valid: Requires the hero The_Flute_Player to be present
The_Flute_Player // Valid: Requires the hero The_Flute_Player to be present, '''Chr:''' is assumed if not specified
Chr: Sentenza_Noria // Invalid: Sentenza_Noria is not a hero, only hero characters can be optional

===Variable Conditions===
For variable conditions, ''Expression'' can be any basic mathematical or logical expression including constants and global variables.

Supported comparison operations for mathematical expressions are:
== // Equals
!= // Unequal
>= // Greater or equal
<= // Less or equal
< // Less
> // Greater

Supported mathematical operations are:
+ // Addition
- // Subtraction
* // Multiplication
/ // Division

Within this expression, you can use both global variables names in the form ''Category''.''VariableName'' or numeric literals like ''0'' or ''-3''.<br/>
'''NOTE''': Operators and operands must always be seperated by space(s) or parentheses.

Some examples for valid mathematical conditions are:
Var: Balthazar.iMonstersKilled >= 20 // Requires Balthazar to have killed at least 20 monsters
Var: Balthazar.iMonstersKilled >= Sentenza_Noria.iMonstersKilled * 2 // Requires Balthazar to have killed twice as many monsters as Sentenza
Var: Balthazar.iMonstersKilled + Sentenza_Noria.iMonstersKilled > 30 // Requires Balthazar and Sentenza to have killed more than 30 monsters between them.

----

In addition to mathematical expressions, logical expressions can be used as well. Both can also be combined in a single expression, with varying degrees of usefulness. <br/>
For logical expressions, you can also use the constants ''true'' and ''false'' for comparisons.

In addition to the same equality and inequality comparisons as for mathematical expressions, logic expressions can use the following operators:
|| // Logic OR, is true if at least one of the two operands is true.
&& // Logic AND, is true if BOTH of the two operands are true.
! // Logic NOT, inverts the value of the right hand operand (e.g. ! true == false)

Some examples for valid logical conditions are:
Var: SomeState.bEpicMonsterKilled // Simply check if SomeState.bEpicMonsterKilled is true.
Var: SomeState.bEpicMonsterKilled == false // Check if SomeState.bEpicMonsterKilled is false.
Var: SomeState.bEpicMonsterKilled && (Balthazar.iMonstersKilled > 10) // Check whether the epic monster was killed AND whether Balthazar has killed more than 10 monsters.

==Multiple Conditions==
You can specify multiple conditions per topic/node, simply separate them by line breaks (i.e. one condition per line).

@@ Line 72: / Line 72: @@
 To check the amount of an item present in the hero party's inventory, write:
-   Var: PartyInventory.MyQuestItem > 0
+   Var: PartyInventory.MyQuestItem  // Checks whether MyQuestItem is present in the party inventory at least once
    Var: PartyInventory.Garlic < 50

@@ Line 67: / Line 67: @@
 For example:
    Var: Avatar.Strength >= 8   // Check whether the Avatar has at least 8 points in the attribute Strength
 ==Qst: Quest Conditions==

@@ Line 1: / Line 1: @@
-Every dialogue topic and individual dialogue fragment can be qualified with one or more conditions. <br/>
+Every quest, quest task, dialogue topic and individual dialogue fragment can be qualified with one or more conditions. <br/>
-For topics, the condition(s) can be specified in a dedicated text box within their template properties. For individual fragments, conditions can be set by double clicking on the nub of their ingoing connection.
+For topics, the condition(s) can be specified in a dedicated text box within their template properties. For individual dialogue fragments, quests, and quest tasks, conditions can be set by double clicking on the nub of their ingoing connection.
-==Structure of a Condition==
+=Structure of a Condition=
 A condition is a single line of text in the following format:
    Type: Expression
@@ Line 13: / Line 13: @@
 If the ''Type:'' part of the condition is omitted, it is assumed to be '''Chr:'''.
-===Chr: Character Conditions===
+==Chr: Character Conditions==
 For character conditions, ''Expression'' must be the technical name of a hero character. The condition is considered to be fulfilled if the character is part of the hero party and is within range of the character with whom the dialogue was initiated (same requirement as for other dialogue participants).
@@ Line 21: / Line 21: @@
    Chr: Sentenza_Noria     // Invalid: Sentenza_Noria is not a hero, only hero characters can be optional
-===Var: Variable Conditions===
+==Var: Variable Conditions==
 For variable conditions, ''Expression'' can be any basic mathematical or logical expression including constants and global variables.
@@ Line 61: / Line 61: @@
    Var: SomeState.bEpicMonsterKilled && (Balthazar.iMonstersKilled > 10) // Check whether the epic monster was killed AND whether Balthazar has killed more than 10 monsters.
-===Qst: Quest Conditions===
+==Qst: Quest Conditions==
 For quest conditions, ''Expression'' must match the following format:
    QuestName [[not] RequiredState]
@@ Line 76: / Line 76: @@
    Qst: MyAwesomeQuest not Failed  // Checks that MyAwesomeQuest has not failed (may be either unfinished or completed successfully)
-===Tsk: Quest Task Conditions===
+==Tsk: Quest Task Conditions==
 Quest task conditions are mostly identical to quest conditions, the only difference being that there is a task name specified in addition to the quest name.<br/>
 The required format for ''Expression'' is:
@@ Line 87: / Line 87: @@
    Tsk: MyAwesomeQuest Task_A Failed    // Checks that Task_A in MyAwesomeQuest has failed.
-==Multiple Conditions==
+=Multiple Conditions=
 You can specify multiple conditions per topic/fragment, simply separate them by line breaks (i.e. one condition per line).<br/>
 If multiple conditions are given for a topic/fragment, it will only be available if ALL conditions have been met.

← Older revision		Revision as of 15:32, 6 October 2016
Line 60:		Line 60:

	==Multiple Conditions==		==Multiple Conditions==
−	You can specify multiple conditions per topic/~~node~~, simply separate them by line breaks (i.e. one condition per line).	+	You can specify multiple conditions per topic/fragment, simply separate them by line breaks (i.e. one condition per line).<br/>
		+	If multiple conditions are given for a topic/fragment, it will only be available if ALL conditions have been met.

Dialogues/Conditions - Revision history

Dave: /* Special Variables */

Dave: /* Special Variables */

Dave: /* Var: Variable Conditions */

Dave at 12:27, 27 October 2016

Dave at 11:09, 27 October 2016

Dave at 15:32, 6 October 2016

Dave: Created page with "Every dialogue topic and individual dialogue fragment can be qualified with one or more conditions. For topics, the condition(s) can be specified in a dedicated text box..."

Dave: Created page with "Every dialogue topic and individual dialogue fragment can be qualified with one or more conditions.
For topics, the condition(s) can be specified in a dedicated text box..."