Changes for page Mission Director Guide

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

From 31075.1 to 31074.1 From 31191.1 to 31190.1

From version 31190.1

edited by Daniel Turner
on 2023/04/25 11:20

Change comment: There is no comment for this version

To version 31075.1

edited by Daniel Turner
on 2023/04/14 17:13

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -1,3 +1,12 @@
++{{info body="Please note that this is officially-maintained documentation.
++
++To ensure that you can rely on the information having been checked by Egosoft, you will not be able to edit this page."/}}
++
++
++
++(% style="color: rgb(0,0,0);text-decoration: none;" %)
++
++
  (% style="color: rgb(0,0,0);text-decoration: none;" %)The Mission Director (MD) is a subsystem of the game and interprets mission scripts, which are written in an XML-based language. The Mission Director in X Rebirth and X4 is based on the MD in X3: Terran Conflict, with some major changes based on feedback from MD users.
@@ -288,26 +288,17 @@
  (% style="color: rgb(0,0,0);text-decoration: none;" %)Library cues are written like normal cues, they are also defined in a <cues> node, just with the difference that the XML tag is called library instead of cue:
--{{code language="xml"}}
--<library name="LibFoo" checktime="1h" checkinterval="5s">
--  <conditions>
--  [...]
--</library>
--{{/code}}
++{{code}}&lt;library┬áname=&quot;LibFoo&quot;┬áchecktime=&quot;1h&quot;┬ácheckinterval=&quot;5s&quot;&gt;┬á &lt;conditions&gt;┬á [...]&lt;/library&gt;{{/code}}
  (% style="color: rgb(0,0,0);text-decoration: none;" %)Although it is called library, itΓÇÖs basically just a cue that doesnΓÇÖt do anything. You can mix cues and libraries as you want, as root cues or sub-cues - the location within the file is unimportant. All that counts is the library name, which has to be unique within the MD script, like all other cue names.
  (% style="color: rgb(0,0,0);text-decoration: none;" %)To use a library, use the attribute ref:
--{{code language="xml"}}
--<cue name="Foo" ref="LibFoo"/>
--{{/code}}
++{{code}}&lt;cue┬áname=&quot;Foo&quot;┬áref=&quot;LibFoo&quot;/&gt;{{/code}}
  (% style="color: rgb(0,0,0);text-decoration: none;" %)This will create a cue with the name Foo that behaves just like the library cue LibFoo. In this example, LibFoo has to be a library in the same MD script file. To use a library LibFoo from another script, you have to qualify it with the script name, using the (%%)**(% style="color: rgb(0,0,0);text-decoration: none;" %)md(%%)**(% style="color: rgb(0,0,0);text-decoration: none;" %) prefix:
--{{code language="xml"}}
--<cue name="Foo" ref="md.ScriptName.LibFoo"/>
--{{/code}}
++{{code}}&lt;cue┬áname=&quot;Foo&quot;┬áref=&quot;md.ScriptName.LibFoo&quot;/&gt;{{/code}}
  (% style="color: rgb(0,0,0);text-decoration: none;" %)When the ref attribute is provided, all other attributes (except for name) will be ignored and taken from the library cue instead. ((% style="color: rgb(0,0,0);text-decoration: none;" %)By default a library creates its own namespace, as if namespace="static" were specified. See the section about namespaces.(%%))
@@ -315,28 +315,8 @@
  (% style="color: rgb(0,0,0);text-decoration: none;" %)In contrast to X3TC, a cue that references a library also has its own name (Foo in the example above), so other cues can access it in expressions by that name. Sub-cues of Foo cannot be accessed by their name though. Within the library itself, expressions can use all names of cues that belong to the library (the <library> and all sub-cues). They will be translated properly when the library is referenced. Examples:
--{{code language="xml"}}
--<cue name="Foo" ref="LibFoo"/>
--<cue name="Bar" ref="LibFoo"/>
++{{code}}&lt;cue┬áname=&quot;Foo&quot;┬áref=&quot;LibFoo&quot;/&gt;&lt;cue┬áname=&quot;Bar&quot;┬áref=&quot;LibFoo&quot;/&gt;&lt;library┬áname=&quot;LibFoo&quot;&gt;┬á &lt;actions&gt;┬á ┬á &lt;cancel_cue┬ácue=&quot;this&quot;/&gt;┬á┬á┬á ┬á┬á┬á┬á┬á┬á┬á┬á &lt;!-- Cancels the cue referencing LibFoo --&gt;┬á ┬á &lt;cancel_cue┬ácue=&quot;LibFoo&quot;/&gt;┬á┬á┬á ┬á┬á ┬á ┬á &lt;!-- Cancels the cue referencing LibFoo --&gt;┬á ┬á &lt;cancel_cue┬ácue=&quot;Foo&quot;/&gt;┬á┬á┬á ┬á┬á┬á ┬á┬á ┬á┬á &lt;!-- Error, Foo not found in library --&gt;┬á ┬á &lt;cancel_cue┬ácue=&quot;Baz&quot;/&gt;┬á┬á┬á ┬á┬á┬á ┬á┬á ┬á┬á &lt;!-- Cancels Baz in the referencing cue --&gt;┬á ┬á &lt;cancel_cue┬ácue=&quot;md.Script.Foo&quot;/&gt;┬á┬á┬á &lt;!-- Cancels Foo --&gt;┬á ┬á &lt;cancel_cue┬ácue=&quot;md.Script.LibFoo&quot;/&gt;┬á&lt;!-- Error, trying to cancel library --&gt;┬á ┬á &lt;cancel_cue┬ácue=&quot;md.Script.Baz&quot;/&gt;┬á┬á┬á &lt;!-- Error, trying to cancel library sub-cue --&gt;┬á &lt;/actions&gt;┬á &lt;cues&gt;┬á ┬á &lt;cue┬áname=&quot;Baz&quot;&gt; [...]┬á&lt;!-- Sub-cue is created in all cues referencing LibFoo --&gt;┬á &lt;/cues&gt;&lt;/library&gt;{{/code}}
--<library name="LibFoo">
--  <actions>
--    <cancel_cue cue="this"/>
--    <cancel_cue cue="LibFoo"/>
--    <cancel_cue cue="Foo"/>
--    <cancel_cue cue="Baz"/>
--    <cancel_cue cue="md.Script.Foo"/>
--    <cancel_cue cue="md.Script.LibFoo"/>
--    <cancel_cue cue="md.Script.Baz"/>
--  </actions>
--  <cues>
--    <cue name="Baz"> [...]
--  </cues>
--</library>
--{{/code}}
--
--
--
  {{warning body="These examples are definitely <u>not</u> examples of good scripting style."/}}
@@ -357,38 +357,15 @@
  (% style="color: rgb(0,0,0);text-decoration: none;" %)Parameters are defined like this:
--{{code language="xml"}}
--<library name="Lib" onfail="cancel">
--  <params>
--    <param name="foo"/>
--    <param name="bar" default="42"/>
--    <param name="baz" default="player.age"/>
--  </params>
--  [...]
--</library>
--{{/code}}
++{{code}}&lt;library┬áname=&quot;Lib&quot; onfail=&quot;cancel&quot;&gt;┬á &lt;params&gt;┬á┬á┬á &lt;param┬áname=&quot;foo&quot;/&gt;┬á┬á┬á &lt;param┬áname=&quot;bar&quot;┬ádefault=&quot;42&quot;/&gt;┬á┬á┬á &lt;param┬áname=&quot;baz&quot;┬ádefault=&quot;player.age&quot;/&gt;┬á &lt;/params&gt;┬á [...]&lt;/library&gt;{{/code}}
  (% style="color: rgb(0,0,0);text-decoration: none;" %)If a default value is supplied, the parameter is regarded as optional, otherwise itΓÇÖs required. When providing the actual parameters in a referencing cue, note that there is no <params> node:
--{{code language="xml"}}
--<cue name="Foo" ref="Lib">
-- <param name="foo" value="race.argon"/>
-- <param name="bar" value="0"/>
--</cue>
--{{/code}}
++{{code}}&lt;cue┬áname=&quot;Foo&quot;┬áref=&quot;Lib&quot;&gt;┬á&lt;param┬áname=&quot;foo&quot;┬ávalue=&quot;race.argon&quot;/&gt;┬á&lt;param┬áname=&quot;bar&quot;┬ávalue=&quot;0&quot;/&gt;&lt;/cue&gt;{{/code}}
  (% style="color: rgb(0,0,0);text-decoration: none;" %)The values (including default values) can be variable expressions and will be evaluated when the cue is enabled, i.e. when it starts checking the conditions. They will be available to the cue as variables, using the parameter name with a ΓÇÿ$ΓÇÖ prefix. In the example above, the variables $foo, $bar, and $baz would be created.
--{{code language="xml"}}
--<library name="Lib">
--  <params>
--    <param name="foo"/>
--  </params>
--  <actions>
--    <debug_text text="$foo"/>
--  </actions>
--</library>
--{{/code}}
++{{code}}&lt;library┬áname=&quot;Lib&quot;&gt;┬á &lt;params&gt;┬á ┬á &lt;param┬áname=&quot;foo&quot;/&gt;┬á &lt;/params&gt;┬á &lt;actions&gt;┬á ┬á &lt;debug_text┬átext=&quot;$foo&quot;/&gt;┬á &lt;/actions&gt;&lt;/library&gt;{{/code}}
  (% style="color: rgb(0,0,0);text-decoration: none;" %)If your library is supposed to provide a result to the library user, it is recommended to store a predefined variable in the library cue with a standardised name, e.g. $result. The user will be able to read it via CueName.$result. This variable does not have to be defined as a parameter but should be documented in the library.

Changes for page Mission Director Guide

Summary

Details

Navigation

Applications