Changes for page Mission Director Guide

Last modified by Klaus Meyer on 2025/03/31 16:39

From 32953.1 to 32954.1 From 32955.1 to 32956.1

From version 32954.1

edited by Daniel Turner
on 2023/08/22 19:00

Change comment: There is no comment for this version

To version 32955.1

edited by Daniel Turner
on 2023/08/22 19:04

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -1091,7 +1091,15 @@
  Cues can have **<patch>** elements with actions that will be performed when an old savegame is loaded. To control which savegames should be affected, you can add a //**version **//attribute to the <cue> node and a //**sinceversion**// attribute in the patch. When a cue is loaded from a savegame that has an older version than //sinceversion//, the <patch> actions will be performed immediately after loading.
--{{code language="xml"}}<cue [...] version="42"> <conditions> [...] </conditions> <actions> [...] </actions> <patch sinceversion="42">    [patch actions] </patch></cue>{{/code}}
++{{code language="xml"}}
++  <cue [...] version="42">
++    <conditions> [...] </conditions>
++    <actions> [...] </actions>
++    <patch sinceversion="42">
++      [patch actions]
++    </patch>
++  </cue>
++{{/code}}
  The patch actions are only performed if the cue is in a certain state, "complete" by default. Use the //**state**// attribute to change this requirement. For more information, see the XML schema documentation of the <patch> element.
@@ -1117,11 +1117,20 @@
  There are many conditions and conditional actions that require a value comparison, for example the condition <check_value>:
--{{code language="xml"}}<check_value value="$ware == ware.silicon and $amount != 0"/>{{/code}}
++{{code language="xml"}}
++  <check_value value="$ware == ware.silicon and $amount != 0"/>
++{{/code}}
  In the value attribute you specify a boolean expression, and if it is true (that is, not equal to zero), the condition is met. This is a special case: This condition and all other nodes that support a value comparison allows you to specify an upper limit, a lower limit, a number range, or a list of allowed values. Examples:
--{{code language="xml"}}<check_value value="FooCue.state" exact="cuestate.complete"/><check_value value="$foo.count" min="5"/><check_value value="$foo" max="player.age + 1min"/><check_value value="player.money" min="300Cr" max="600Cr"/><check_value value="$method" list="[killmethod.hitbymissile, killmethod.collected]"/><check_value value="$attention" min="attention.visible"/>{{/code}}
++{{code language="xml"}}
++  <check_value value="FooCue.state" exact="cuestate.complete"/>
++  <check_value value="$foo.count" min="5"/>
++  <check_value value="$foo" max="player.age + 1min"/>
++  <check_value value="player.money" min="300Cr" max="600Cr"/>
++  <check_value value="$method" list="[killmethod.hitbymissile, killmethod.collected]"/>
++  <check_value value="$attention" min="attention.visible"/>
++{{/code}}
  {{info}}Values of most enumeration types cannot be compared via ''min'' or ''max'' (also not via lt, gt, etc.). The only data types that can be used with ''min'' and ''max'' are numbers and the enumeration types ''level'' and ''attention'' (see Boolean operators). The ''exact'' attribute can be used with any type, and is equivalent to using the == operator."{{/info}}
@@ -1133,21 +1133,30 @@
  If an action requires a value, e.g. when you set a variable to a value, you can have some randomisation. To specify an exact value, e.g. in <set_value>, you can write this:
--{{code language="xml"}}<set_value name="$race" exact="race.teladi"/>{{/code}}
++{{code language="xml"}}
++  <set_value name="$race" exact="race.teladi"/>
++{{/code}}
  To select a random element from a list, this syntax can be used:
--{{code language="xml"}}<set_value name="$prime" list="[2, 3, 5, 7, 11]"/>{{/code}}
++{{code language="xml"}}
++  <set_value name="$prime" list="[2, 3, 5, 7, 11]"/>
++{{/code}}
  To get a random number within a given range, you can use min/max:
--{{code language="xml"}}<set_value name="$foo" min="-20" max="20"/><set_value name="$timeout" max="20s"/>{{/code}}
++{{code language="xml"}}
++  <set_value name="$foo" min="-20" max="20"/>
++  <set_value name="$timeout" max="20s"/>
++{{/code}}
  min and max have to be compatible number types. Enumeration types are not allowed, not even level and attention. The min attribute is optional and defaults to 0 (of the number type used in max).
  You can select one of 5 different probability distribution profiles for the random range, "flat" being the default (all values in the range are equally likely). If you select another profile, e.g. "increasing" to make higher numbers more likely, you also have to specify a scale value (integer) that is greater or equal to 2. Higher scale values result in higher peaks in the distribution profiles (probable values become even more probable).
--{{code language="xml"}}<set_value name="$foo" min="-20" max="20" profile="profile.increasing" scale="4"/>{{/code}}
++{{code language="xml"}}
++  <set_value name="$foo" min="-20" max="20" profile="profile.increasing" scale="4"/>
++{{/code}}
  \\(% id="variables-and-namespaces" %)
@@ -1162,27 +1162,39 @@
  You can create variables with certain actions and conditions, such as the <set_value> action:
--{{code language="xml"}}<set_value name="$foo" exact="$bar + 1" />{{/code}}
++{{code language="xml"}}
++  <set_value name="$foo" exact="$bar + 1" />
++{{/code}}
  <set_value> also exists as a "condition", which can be useful if you want to pass information about the conditions to the actions, that would otherwise be lost - like in a complex <check_any> event condition, where you want to create a variable only if you are in a certain check branch. (Other pseudo-conditions are <remove_value> and <debug_text>.)
  The default operation of <set_value> is "**set**", but there are more: "**add**", "**subtract**", and "**insert**". //add// and //subtract// change the value of an existing variable, which is created as 0 if it didn't exist before. If neither //min//, //max// nor //exact// attribute is provided, an exact value of 1 is assumed.
--{{code language="xml"}}<set_value name="$foo" operation="add" />{{/code}}
++{{code language="xml"}}
++  <set_value name="$foo" operation="add" />
++{{/code}}
  The trick is that <set_value> not only works on variables, but also on list elements and table keys:
--{{code language="xml"}}<set_value name="$list.{1}" exact="42" /><set_value name="$table.$foo" exact="42" />{{/code}}\\
++{{code language="xml"}}
++  <set_value name="$list.{1}" exact="42" />
++  <set_value name="$table.$foo" exact="42" />
++{{/code}}
  The operation //insert// is special, and it only works on lists. It inserts the value at the specified position (note that the position beyond the last element is also valid here):
--{{code language="xml"}}<set_value name="$list.{1}" exact="42" operation="insert" />{{/code}}
++{{code language="xml"}}
++  <set_value name="$list.{1}" exact="42" operation="insert" />
++{{/code}}
  This shifts the positions of all following elements up by one. If min/max/exact are missing, the default value is null for insertions, not 1 like in other cases.
  Appending is easier than that. The following actions are equivalent:
--{{code language="xml"}}<set_value name="$list.{$list.count + 1}" exact="42" operation="insert" /><append_to_list name="$list" exact="42" />{{/code}}
++{{code language="xml"}}
++  <set_value name="$list.{$list.count + 1}" exact="42" operation="insert" />
++  <append_to_list name="$list" exact="42" />
++{{/code}}
  Inserting at a position below 1 or above $list.count + 1 is not possible.
@@ -1225,14 +1225,15 @@
  Consider this case:
  {{code language="xml"}}
--  <cue name="Root">
--  <actions>
--  <set_value name="$foo" />
--  </actions>
--  <cues>
--  <cue name="SubCue"> [...]  </cue>
++<cue name="Root">
++  <actions>
++    <set_value name="$foo" />
++  </actions>
++  <cues>
++    <cue name="SubCue"> [...]
++    </cue>
    </cues>
--  </cue>
++</cue>
  {{/code}}
  When the root cue creates $foo, the variable is stored in the Root cue directly. But SubCue and its descendants will also need access to $foo. Of course they could write "parent.$foo" or "Root.$foo", but since it's very common to have a single location for most variables in the whole cue tree, the easy solution is to write just "$foo" - because variable names are looked up in the **namespace cue**, which is the root by default. Also newly created variables end up in the namespace, and not in "this" cue.
@@ -1253,9 +1253,9 @@
  {{warning}}Although in general the expression "$foo == namespace.$foo" is true, there is one exception: When library parameters are evaluated in the referencing cue, variables are resolved using the parent's namespace. However, the referencing cue creates a new namespace, so the namespace keyword already points to the library, not to the parent's namespace. Example:
  {{code language="xml"}}
--  <cue name="LibRef" ref="Lib">
--  <param name="Param1" value="$foo" /> <!-- $foo from parent namespace -->
++<cue name="LibRef" ref="Lib">
++  <param name="Param1" value="$foo" /> <!-- $foo from parent namespace -->
    <param name="Param2" value="namespace.$foo" /> <!-- LibRef.$foo (error) -->
--  </cue>
++</cue>
  {{/code }}
  {{/warning}}

Changes for page Mission Director Guide

Summary

Details

Navigation

Applications