Logical Conditions

Revision as of 01:09, 27 November 2010 by imported>Clearance (added categories)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

OverviewEdit

Conditions are used in a number of places in the editor to tell the game when certain things should happen. Conditions are simply a list of one or more script functions that specify the circumstances under which a given editor item is valid. Conditions are used in the following editor sections:


The Condition ListEdit

The condition list displays all of the individual Condition Items for this set of Conditions. Right-clicking in the list displays a popup menu which you can use to create New condition items, Duplicate or Delete existing condition items, Copy one or All items in the list, or Paste in items copied from elsewhere.

 


The << and >> buttons are used to move Condition Items up or down in the list, respectively, and the New button can be used to create a new item.


To edit a Condition Item, select it in the list and all of the data for that item will displayed in the controls beneath the list where the data can be altered.


The Condition Function dropdown list is the function to run. See Condition Functions for the complete list of script functions that can be used as conditions.


The Run on Target checkbox is used to indicate that the function should be run on the actor’s current target instead of on the actor themselves. The Player is usually considered a target for conditions in quests. Quest Targets are an exception to this because the Player is considered the Actor for purposes of checking conditions. The same is true for any object not in the possession of the actor checking the condition.


The Function Parameters button opens up another dialog box in which parameters for the currently selected function can be set. This is where the Reference for a GetDistance function or the Faction for a GetFactionRank function is set.


The Comparison dropdown list determines how the return value for the function is compared with the Comparison Value to determine if the condition item is true.


The Comparison Value is normally a text field where a value is entered by hand. However, if the Use Global checkbox is checked, the Value is instead a dropdown list in which a global variable can be selected to use as the Comparison Value instead.


The OR checkbox is used to determine how a Condition Item is evaluated with the ones that follow it. Consecutive ORs are treated like a single block when evaluating and have order preference over AND. For example, the condition items ( A AND B OR C AND D ) are evaluated as ( A AND ( B OR C ) AND D ) and not ( ( A AND B ) OR ( C AND D ) ).