Changes for page Mission Director Guide

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

From version 32970.2
edited by Owen Lake
on 2023/10/10 15:34
Change comment: fighting with formatting
To version 32957.1
edited by Daniel Turner
on 2023/08/22 19:09
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -xwiki:XWiki.Owen
1 +xwiki:XWiki.Daniel
Content
... ... @@ -22,7 +22,7 @@
22 22  This functionality is only available if the schema files **md.xsd** and **common.xsd** are in the correct folder. If you are editing the XML in the game folder directly, all is well and the files are loaded from the libraries folder. However, if you are editing in a separate folder, copy those XSD files from the libraries folder directly into the folder where your XML files are located.
23 23  
24 24  {{info}}
25 -Even if your script is free of XSD errors, that does not mean that the script syntax is correct. For example, there are XML elements that require at least one of multiple attributes, but this requirement cannot be reflected in a schema (apart from documentation text). Please notice the XSD documentation of the elements and attributes, e.g. displayed via tooltips in Visual Studio / Visual Web Developer. Please also note additional requirements for MD cue attributes in this guide (see [[Conditions>>doc:||anchor="HConditions" style="outline-width: 0px !important; user-select: auto !important;"]]).
25 +Even if your script is free of XSD errors, that does not mean that the script syntax is correct. For example, there are XML elements that require at least one of multiple attributes, but this requirement cannot be reflected in a schema (apart from documentation text). Please notice the XSD documentation of the elements and attributes, e.g. displayed via tooltips in Visual Studio / Visual Web Developer. Please also note additional requirements for MD cue attributes in this guide (see [[NULL|Conditions]]).
26 26  
27 27  To check for errors, please pay attention to in-game error messages that are produced while your script is imported, and run-time errors while the script runs. The XSD files can help you a lot, but you should not rely on the absence of XSD errors."
28 28  {{/info}}
... ... @@ -84,6 +84,7 @@
84 84  * **Waiting**: Either this is a root cue, or the parent has become active. The cue is checking its conditions and will become active when they are met.
85 85  * **Active**: The cue is about to perform the actions. Child cues have entered the waiting state.
86 86  
87 +
87 87  * **Complete**: The cue has finished performing its actions.
88 88  * **Cancelled**: The cue has been cancelled. This state cannot normally be reached but only if a cue actively cancels itself or another cue. No condition checks or actions are performed in this cue or any sub-(sub-)cue.
89 89  
... ... @@ -155,9 +155,10 @@
155 155  
156 156  * Use //onfail// if the conditions should be checked only once. The possible attribute values are "//cancel//" and "//complete//". If the conditions are met, the cue will activate and perform the cue actions. Otherwise it's a failure and the cue will be cancelled or completed, based on the onfail attribute. Typically //onfail="cancel"// is used to prevent any further action. //onfail="complete"// can be used to continue with the sub-cues even in case of failure (but skipping the current cue actions).
157 157  
159 +
158 158  * With //checkinterval//, you can specify a constant time interval between condition checks. The conditions will be checked regularly forever until they are met, unless the cue's state is changed explicitly by an external event.
159 159  
160 -Additionally, you can use the attribute **checktime** to set the time of the first condition check (also possible in combination with //onfail//). The //checktime// can be an expression with variables and is evaluated when the cue is enabled (when the condition checks would normally start - for root cues that happens at game start, otherwise after the parent cue becomes active).
162 +Additionally, you can use the attribute **checktime** to set the time of the first condition check (also possible in combination with //onfail//). The //checktime// can be an expression with variables and is evaluated when the cue is enabled (when the condition checks would normally start ΓÇô for root cues that happens at game start, otherwise after the parent cue becomes active).
161 161  
162 162  Examples:
163 163  
... ... @@ -217,11 +217,11 @@
217 217  {{/code}}
218 218  
219 219  {{info}}
220 -Messages printed with <debug_text> are usually only visible when the "scripts" debug filter is enabled, see [[Script debug output>>doc:||anchor="HScriptdebugoutput"]]
222 +Messages printed with <debug_text> are usually only visible when the "scripts" debug filter is enabled, see Script debug output
221 221  {{/info}}
222 222  
223 -Script debug output
224 224  
226 +
225 225  Each child action in a <do_any> node can have a //**weight**// attribute, which can be used to control the random selection of an action node. The default weight of a child node is 1.
226 226  
227 227  Also available is **<do_if>**, which completes the enclosed action(s) only if one provided value is non-null or matches another. Directly after a <do_if> node, you can add one or more **<do_elseif>** nodes to perform additional checks only in case the previous conditions were not met. The node **<do_else>** can be used directly after a <do_if> or a <do_elseif>. It is executed only if none of the conditions are met.
... ... @@ -239,6 +239,7 @@
239 239  {{/info}}
240 240  
241 241  
244 +
242 242  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:
243 243  
244 244  {{code language="xml"}}
... ... @@ -289,9 +289,11 @@
289 289  {{/code}}
290 290  
291 291  {{warning}}
292 -These examples are definitely **__not__ **examples of good scripting style.
295 +These examples are definitely <u>not</u> examples of good scripting style.
293 293  {{/warning}}
294 294  
298 +
299 +
295 295  So when writing the library, you don't have to worry about name confusion, just use the names of cues in your library and it will work as expected when the library is used. Names of cues that do not belong to the library will not be available in expressions (see Foo in the example above), however, names of other libraries in the file are available when referencing them in the ref attribute.
296 296  
297 297  Notes:
... ... @@ -326,7 +326,7 @@
326 326  </cue>
327 327  {{/code}}
328 328  
329 -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.
334 +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.
330 330  
331 331  {{code language="xml"}}
332 332  <library name="Lib">
... ... @@ -361,6 +361,8 @@
361 361  This sub-section requires basic knowledge of script expressions.
362 362  {{/info}}
363 363  
369 +
370 +
364 364  In case of instances with sub-instances, you will often want to access a related instance from the current one. Like in the non-instance case, you can simply write the cue name in an expression to reference that cue. However, you should be aware of the pitfalls that are accompanied by this.
365 365  
366 366  When you use a cue name from the same script in an expression, it will always be resolved to some cue - usually a static cue, even if it is still in the disabled state, but it can also be an instance, if it is "related" to the current one.
... ... @@ -396,7 +396,7 @@
396 396  
397 397  * **Conditions with results:** If the instantiating cue has conditions with results, those results are stored in variables - but in the variables of the static cue, not of the instance! So in the <actions> you have to access the variables via the **static **keyword:
398 398  
399 -{{code language="xml"}}<debug_text text="static.$foo"/>{{/code}}
406 +{{code language="xml"}} <debug_text text="static.$foo"/>{{/code}}
400 400  It may even be necessary to copy the variables over to the instance because the static variables can be overwritten by the next condition check:
401 401  {{code language="xml"}}<set_value name="$foo" exact="static.$foo"/>{{/code}}
402 402  
... ... @@ -417,6 +417,8 @@
417 417  Since octal numbers are hardly ever used (usually unknowingly), the parser is will produce a warning if an octal number is encountered."
418 418  {{/info}}
419 419  
427 +
428 +
420 420  You can write string literals by putting the string in single quotes:
421 421  
422 422  * {{code language="xml"}}'Hello world'{{/code}}
... ... @@ -494,10 +494,10 @@
494 494  |true|constant|{{code language="xml"}}null == 0{{/code}}|{{code language="xml"}}true{{/code}}|Integer value 1, useful in Boolean expressions
495 495  |pi|constant|{{code language="xml"}}2 * pi{{/code}}|{{code language="xml"}}6.2831853rad{{/code}}|╧Ç as an angle (same as 180deg)
496 496  |()|delimiter|{{code language="xml"}}(2 + 4) * (6 + 1){{/code}}|{{code language="xml"}}42{{/code}}|Parentheses for arithmetic grouping
497 -|[]|delimiter|{{code language="xml"}}[1, 2, 2+1, 'string']{{/code}}|{{code language="xml"}}[1, 2, 3, 'string']{{/code}}|[[List>>doc:||anchor="HLists" style="outline-width: 0px !important; user-select: auto !important;"]] of values
498 -|table[]|delimiter|{{code language="xml"}}table[$foo='bar', {1+1}=40+2]{{/code}}|{{code language="xml"}}table[$foo='bar', {2}=42]{{/code}}|[[Table>>doc:||anchor="HTables" style="outline-width: 0px !important; user-select: auto !important;"]] of values
506 +|[]|delimiter|{{code language="xml"}}[1, 2, 2+1, 'string']{{/code}}|{{code language="xml"}}[1, 2, 3, 'string']{{/code}}|[[List>>MediaWiki.NULL]] of values
507 +|table[]|delimiter|{{code language="xml"}}table[$foo='bar', {1+1}=40+2]{{/code}}|{{code language="xml"}}table[$foo='bar', {2}=42]{{/code}}|[[Table>>MediaWiki.NULL]] of values
499 499  |{}|delimiter|{{code language="xml"}}{101, 3}{{/code}}|{{code language="xml"}}'Some text'{{/code}}|Text lookup (page ID and text ID) from TextDB
500 -\\(Note: Braces are also used for [[property lookups>>doc:||anchor="HValueproperties" style="outline-width: 0px !important; user-select: auto !important;"]])
509 +\\(Note: Braces are also used for [[property lookups>>MediaWiki.NULL]])
501 501  |+|unary|{{code language="xml"}}+21 * (+2){{/code}}|{{code language="xml"}}42{{/code}}|Denotes positive number (no effect)
502 502  |-|unary|{{code language="xml"}}-(21 * -2){{/code}}|{{code language="xml"}}42{{/code}}|Negates the following number
503 503  |not|unary|{{code language="xml"}}not (21 == 42){{/code}}|{{code language="xml"}}true{{/code}}|Yields true if the following expression is false (equal to zero), false otherwise
... ... @@ -507,7 +507,7 @@
507 507  \\{{code language="xml"}}typeof 'Hello world'{{/code}}|
508 508  {{code language="xml"}}datatype.null{{/code}}
509 509  \\{{code language="xml"}}datatype.integer{{/code}}
510 -\\{{code language="xml"}}datatype.string{{/code}}|Yields the [[data type of the following sub-expression>>||anchor="typeof" style="outline-width: 0px !important; user-select: auto !important;"]]
519 +\\{{code language="xml"}}datatype.string{{/code}}|Yields the [[data type of the following sub-expression>>MediaWiki.NULL]]
511 511  |sin|unary|
512 512  {{code language="xml"}}sin(30deg){{/code}}
513 513  \\{{code language="xml"}}sin(pi){{/code}}|
... ... @@ -517,23 +517,7 @@
517 517  {{code language="xml"}}cos(60deg){{/code}}
518 518  \\{{code language="xml"}}cos(pi){{/code}}|
519 519  {{code language="xml"}}0.5{{/code}}
520 -\\{{code language="xml"}}-1.0{{/code}}|Cosine (function-style, parentheses required)
521 -|tan|unary|
522 -{{code language="xml"}}tan(-45deg){{/code}}
523 -\\{{code language="xml"}}tan(45deg){{/code}}|
524 -{{code language="xml"}}-1.0{{/code}}
525 -\\{{code language="xml"}}1.0{{/code}}|Tangent (function-style, parentheses required)
526 -|asin|unary|
527 -{{code language="xml"}}asin(-0.5f){{/code}}
528 -\\{{code language="xml"}}asin(1){{/code}}|
529 -{{code language="xml"}}-0.523599rad{{/code}}
530 -\\{{code language="xml"}}1.5708rad{{/code}}|Inverse sine (function-style, parentheses required)
531 -|acos|unary|
532 -{{code language="xml"}}acos(0.5f){{/code}}
533 -\\{{code language="xml"}}acos(1.0f){{/code}}|
534 -{{code language="xml"}}asin(2.0944rad){{/code}}
535 -\\{{code language="xml"}}0rad{{/code}}|Inverse cosine (function-style, parentheses required)
536 -|atan|unary| | |Inverse tangent (function-style, parentheses required)
529 +\\{{code language="xml"}}0.0{{/code}}|Cosine (function-style, parentheses required)
537 537  |sqrt|unary|{{code language="xml"}}sqrt(2){{/code}}|{{code language="xml"}}1.414213LF{{/code}}|Square root (function-style, parentheses required)
538 538  |exp|unary|{{code language="xml"}}exp(1){{/code}}|{{code language="xml"}}2.71828LF{{/code}}|Exponential function (function-style, parentheses required)
539 539  |log|unary|{{code language="xml"}}log(8) / log(2){{/code}}|{{code language="xml"}}3.0LF{{/code}}|Natural logarithm (function-style, parentheses required)
... ... @@ -563,14 +563,14 @@
563 563  gt
564 564  \\> (>)|binary|
565 565  {{code language="xml"}}1 gt 3{{/code}}
566 -\\{{code language="xml"}}1 > 3{{/code}}|{{code language="xml"}}false{{/code}}|Greater than
559 +\\{{code language="xml"}}1 < 3{{/code}}|{{code language="xml"}}false{{/code}}|Greater than
567 567  |
568 568  ge
569 569  \\>=|binary|
570 570  {{code language="xml"}}1 ge 3{{/code}}
571 -\\{{code language="xml"}}1 >= 3{{/code}}|{{code language="xml"}}false{{/code}}|Greater than or equal to
564 +\\{{code language="xml"}}1 <= 3{{/code}}|{{code language="xml"}}false{{/code}}|Greater than or equal to
572 572  |(((
573 -
566 += =
574 574  )))|binary|{{code language="xml"}}1 + 1 == 2.0{{/code}}|{{code language="xml"}}true{{/code}}|Equal to
575 575  |~!=|binary|{{code language="xml"}}1 + 1 != 2.0{{/code}}|{{code language="xml"}}false{{/code}}|Not equal to
576 576  |and|binary|{{code language="xml"}}true and false{{/code}}|{{code language="xml"}}false{{/code}}|Logical AND (short-circuit semantics)
... ... @@ -584,6 +584,7 @@
584 584  \\{{code language="xml"}}'T'{{/code}}|Conditional operator ("inline if")
585 585  )))
586 586  
580 +
587 587  === Operator precedence rules ===
588 588  
589 589  You can group sub-expressions using parentheses, but if you don't, the following order of operations is applied, so that 5-1+2*3 == 10 as you would expect. The order is the same as in the table above, but there are operators with the same precedence - these are applied from left to right.
... ... @@ -598,6 +598,7 @@
598 598  * or
599 599  * if/then/else (lowest precedence)
600 600  
595 +
601 601  === Type conversion ===
602 602  
603 603  When a binary arithmetic operator is used on numbers of different types, they will be converted to a suitable output type. The resulting type depends on whether a unit data type is involved (types that are not plain integers or floats). The following cases may occur:
... ... @@ -637,18 +637,22 @@
637 637  * "and" and "or" use short-circuit semantics: The right side of the operation can be skipped if the left side already determines the outcome of the operation
638 638  ** Example:{{code language="xml"}} false and $foo{{/code}} ⟹ {{code language="xml"}}false{{/code}} (the value of $foo is not checked at all)
639 639  * Unlike != and ==, the comparison operators <, <=, >, >= are only supported **for numeric values**, **difficulty levels**, and **attention levels**. Comparing other non-numeric values will result in an error and an undefined result.
640 -* <, <=, >, >= cannot be used in XML directly, so lt, le, gt, ge are provided as alternatives. In some cases you won't have to use them, though - using [[range checks>>doc:||anchor="HValuecomparisons"]] with additional XML attributes can be more readable.
635 +* <, <=, >, >= cannot be used in XML directly, so lt, le, gt, ge are provided as alternatives. In some cases you won't have to use them, though - using [[range checks>>MediaWiki.NULL]] with additional XML attributes can be more readable.
641 641  
642 -== (% id="categorybroken_macroanchorstrings-and-formatting" %)Strings and formatting(%%) ==
643 643  
638 +(% id="categorybroken_macroanchorstrings-and-formatting" %)== Strings and formatting==
639 +
640 +
641 +{{{==}}}
642 +
644 644  You can concatenate string literals using the + operator, but there is also a printf-like formatting syntax, which is easier to use than concatenating lots of small pieces:
645 645  
646 646  * {{code language="xml"}}'The %1 %2 %3 jumps over the %5 %4'.['quick', 'brown', 'fox', 'dog', 'lazy']{{/code}}
647 647  * {{code language="xml"}}'%1 + %2 = %3'.[$a, $b, $a + $b]{{/code}}
648 648  
649 -See also the section about [[value properties>>doc:||anchor="HValueproperties" style="outline-width: 0px !important; user-select: auto !important;"]].
648 +See also the section about [[value properties>>MediaWiki.NULL]].
650 650  
651 -Instead of '%1 %2 %3', you can also use '%s %s %s', which is also compatible with Lua string formatting in the UI system. However, this should only be used if you are sure that the order is the same in all supported languages. If you want to make translators aware that they can change the order of parameters, you should prefer '%1 %2 %3'.
650 +Instead of ΓÇÿ%1 %2 %3', you can also use ΓÇÿ%s %s %s', which is also compatible with Lua string formatting in the UI system. However, this should only be used if you are sure that the order is the same in all supported languages. If you want to make translators aware that they can change the order of parameters, you should prefer '%1 %2 %3'.
652 652  \\To get a percent character in the result string, use '%%' in the format string.
653 653  \\\\\\If you need a more sophisticated method for text substitution, try **<substitute_text>**. See the XML schema documentation for this script action.
654 654  \\**[New as of X Rebirth 4.0]**
... ... @@ -665,14 +665,14 @@
665 665  * "." must be followed by a single digit (0-9). In case of ".0" any fractional digits are discarded (rounding towards zero, not half away from zero).
666 666  
667 667  {{info}}
668 -There are also special methods to [[format money values and time values>>doc:||anchor="HMoneyandtimeformatting" style="outline-width: 0px !important; user-select: auto !important;"]] using the "formatted" property.
667 +There are also special methods to [[NULL|format money values and time values]] using the "formatted" property.
669 669  {{/info}}
670 670  
671 671  == Lists ==
672 672  
673 -Another example for a non-numeric value is a list: It is an ordered collection of other arbitrary values (called array or vector in other languages). It can be constructed within an expression using the [[~[~] syntax>>doc:||anchor="HOperators"]]. It may also be generated by special actions and conditions, and there are actions that can [[insert or remove values>>doc:||anchor="HCreatingandremovingvariables" style="outline-width: 0px !important; user-select: auto !important;"]].
672 +Another example for a non-numeric value is a list: It is an ordered collection of other arbitrary values (called array or vector in other languages). It can be constructed within an expression using the [[~[~] syntax>>MediaWiki.NULL]]. It may also be generated by special actions and conditions, and there are actions that can [[insert or remove values>>MediaWiki.NULL]].
674 674  
675 -A list can contain values of arbitrary data types, even mixed in the same list - so a list can actually contain other lists. However, some of the things that you can do with lists require that all contained elements are of a certain type. The contents of a list can be accessed via properties, see the section about [[value properties>>doc:||anchor="HValueproperties"]]. Lists can be empty, these are written as "[ ]".
674 +A list can contain values of arbitrary data types, even mixed in the same list - so a list can actually contain other lists. However, some of the things that you can do with lists require that all contained elements are of a certain type. The contents of a list can be accessed via properties, see the section about [[value properties>>MediaWiki.NULL]]. Lists can be empty, these are written as "[ ]".
676 676  
677 677  {{info}}
678 678  When accessing a list's elements, the numbering is '''1-based''', so the first element has number 1. This is intuitive but different from 0-based numbering in most programming languages."
... ... @@ -691,7 +691,7 @@
691 691  (% id="categorybroken_macroanchortables" %)
692 692  == Tables ==
693 693  
694 -Tables are associative arrays - they are like lists, but you can assign values to (almost) arbitrary keys, not just to index numbers. A table is constructed within an expression using the [[table~[~] syntax>>doc:||anchor="HOperators" style="outline-width: 0px !important; user-select: auto !important;"]]. See the section about [[value properties>>doc:||anchor="HValueproperties" style="outline-width: 0px !important; user-select: auto !important;"]] for how to access the contents of a table. [[Creating and removing entries>>doc:||anchor="HCreatingandremovingvariables" style="outline-width: 0px !important; user-select: auto !important;"]] works similarly to lists, but instead of inserting, you simply assign a value to a table key. If the key does not exist yet, it will be created.
693 +Tables are associative arrays - they are like lists, but you can assign values to (almost) arbitrary keys, not just to index numbers. A table is constructed within an expression using the [[table~[~] syntax>>MediaWiki.NULL]]. See the section about [[value properties>>MediaWiki.NULL]] for how to access the contents of a table. [[Creating and removing entries>>MediaWiki.NULL]] works similarly to lists, but instead of inserting, you simply assign a value to a table key. If the key does not exist yet, it will be created.
695 695  
696 696  Almost all values are allowed as table keys, but there are a few exceptions:
697 697  
... ... @@ -699,16 +699,19 @@
699 699  * null cannot be used as table key (but the number 0 is valid)
700 700  * Lists, tables, groups and buildplans cannot be used as table keys
701 701  
701 +
702 702  These restrictions only apply to the keys, there are no restrictions for values that you assign to them. For example:
703 703  
704 704  * {{code language="xml"}}table[]{{/code}} ⟹ creates an empty table
705 705  * {{code language="xml"}}table[{0} = null]{{/code}} ⟹ creates a table that maps the number 0 to null
706 706  
707 +
707 707  * {{code language="xml"}}table[{'$foo'} = 'bar']{{/code}} ⟹ a table that maps the string '$foo' to the string 'bar'
708 708  * {{code language="xml"}}table[$foo = 'bar']{{/code}} ⟹ exactly the same, just a shorter notation for string keys
709 709  * {{code language="xml"}}table[foo = 'bar']{{/code}} ⟹ error, 'foo' does not start with a '$'
710 710  * {{code language="xml"}}table[{1} = [], {2} = table[]] {{/code}} ⟹ a table that maps 1 to an empty list and 2 to an empty table
711 711  
713 +
712 712  Just like lists, tables are stored as references, so it's possible that multiple variables reference the same table (see above).
713 713  
714 714  == Value properties ==
... ... @@ -733,6 +733,7 @@
733 733  * {{code language="xml"}}[].{'count'}{{/code}} ⟹ 0
734 734  * {{code language="xml"}}table[{21} = 42].{21}{{/code}} ⟹ 42
735 735  
738 +
736 736  In most cases the property key is a fixed string, like "name" or "class". You can write this like above:
737 737  
738 738  * {{code language="xml"}}[42].{'count'}{{/code}}
... ... @@ -740,6 +740,7 @@
740 740  * {{code language="xml"}}$ship.{'class'}{{/code}}
741 741  * {{code language="xml"}}table[$foo='bar'].{'$foo'}{{/code}}
742 742  
746 +
743 743  But it is easier just to write the property key without braces, which is equivalent:
744 744  
745 745  * {{code language="xml"}}[0].count{{/code}}
... ... @@ -747,6 +747,7 @@
747 747  * {{code language="xml"}}$ship.class{{/code}}
748 748  * {{code language="xml"}}table[$foo='bar'].$foo{{/code}}
749 749  
754 +
750 750  (In this case, $ship is a variable. All variables start with a "$", so they cannot be confused with keywords.)
751 751  
752 752  A list has even more properties:
... ... @@ -780,11 +780,12 @@
780 780  
781 781  * {{code language="xml"}}$table.keys.list{{/code}}: Yields a list of all keys in the table (reliably sorted by key if all keys are numeric)
782 782  
788 +
783 783  * {{code language="xml"}}$table.keys.sorted{{/code}}: Yields a list of all keys in the table, sorted by their associated values (which requires that all values are numeric)
784 784  * {{code language="xml"}}$table.keys.random{{/code}}: A randomly chosen key (which requires that the table is non-empty)
785 785  
786 786  {{info}}
787 -The string formatting syntax that you have seen [[above>>doc:||anchor="HStringsandformatting" style="outline-width: 0px !important; user-select: auto !important;"]] is also based on the property system. You basically pass a list as property key to a string. Braces around the brackets are not required, so 'foo'.[...] is just a convenient alternative notation for 'foo'.{[...]}.
793 +The string formatting syntax that you have seen [[NULL|above]] is also based on the property system. You basically pass a list as property key to a string. Braces around the brackets are not required, so 'foo'.[...] is just a convenient alternative notation for 'foo'.{[...]}.
788 788  {{/info}}
789 789  
790 790  === (% id="lookup-tests-and-suppressing-errors" %)Lookup tests and suppressing errors(%%) ===
... ... @@ -795,6 +795,7 @@
795 795  * {{code language="xml"}}$list.{5}?{{/code}} ⟹ true if $list exists and has the property 5, false otherwise
796 796  * {{code language="xml"}}$table.$key?{{/code}} ⟹ Analogously, true if $table exists and has the string property '$key'
797 797  
804 +
798 798  The question mark can even be applied to variables:
799 799  
800 800  * {{code language="xml"}}$list{{/code}} ⟹ The value stored under the name $list, or an error if there is no such variable
... ... @@ -836,11 +836,11 @@
836 836  |profile|
837 837  profile.flat
838 838  \\profile.increasing
839 -\\profile.bell|Probability distribution profile (see [[random ranges>>doc:||anchor="HRandomranges" style="outline-width: 0px !important; user-select: auto !important;"]])
846 +\\profile.bell|Probability distribution profile (see [[random ranges>>MediaWiki.NULL]])
840 840  |cuestate|
841 841  cuestate.waiting
842 842  \\cuestate.active
843 -\\cuestate.complete|[[Cue states>>||anchor="HCues" style="outline-width: 0px !important; user-select: auto !important;"]]
850 +\\cuestate.complete|[[Cue states>>MediaWiki.NULL]]
844 844  |level|
845 845  level.easy
846 846  \\level.medium
... ... @@ -860,8 +860,6 @@
860 860  \\faction.argongovernment|Factions
861 861  )))
862 862  
863 -{{id name="typeof"/}}
864 -
865 865  {{info}}
866 866  With the ''typeof'' operator you can get the datatype of any expression and compare it with what you expect, for example:
867 867  
... ... @@ -885,9 +885,11 @@
885 885  * player.**money**: The money in the player's account
886 886  * player.**ship**: The ship the player is currently on (not necessarily the player's ship), or null if the player is on a station
887 887  
893 +
888 888  * player.**primaryship**: The player's own ship (but the player is not necessarily on board)
889 889  * player.**entity**: The actual player object
890 890  
897 +
891 891  * player.**zone**, player.**sector**, player.**cluster**, player.**galaxy**: Location of the player entity
892 892  * player.**copilot**: The co-pilot NPC
893 893  
... ... @@ -909,11 +909,12 @@
909 909  === (% id="categorybroken_macroanchormoney-and-time-formatting" %)Money and time formatting(%%) ===
910 910  
911 911  **[New as of X Rebirth 4.0]**
912 -\\Numbers don't have any properties, except for money and time: They have a "**formatted**" property, which allows you to get a custom string representation with more advanced options than the [[generic formatting method>>||anchor="HStringsandformatting" style="outline-width: 0px !important; user-select: auto !important;"]] for numbers.
919 +\\Numbers don't have any properties, except for money and time: They have a "**formatted**" property, which allows you to get a custom string representation with more advanced options than the [[generic formatting method>>MediaWiki.NULL]] for numbers.
913 913  
914 914  * {{code language="xml"}}$money.formatted.{'formatstring'}{{/code}}
915 915  * {{code language="xml"}}$money.formatted.default{{/code}} (using default format string '%s')
916 916  
924 +
917 917  * {{code language="xml"}}$time.formatted.{'formatstring'}{{/code}}
918 918  * {{code language="xml"}}$time.formatted.default{{/code}} (using default format string '%T')
919 919  
... ... @@ -937,6 +937,7 @@
937 937  * %Cr: Localised "Cr" string
938 938  * %%: A % sign
939 939  
948 +
940 940  Examples:
941 941  
942 942  * {{code language="xml"}}(1234Cr).formatted.{'%s'}{{/code}}⟹{{code language="xml"}}'1,234'{{/code}}
... ... @@ -945,7 +945,7 @@
945 945  * {{code language="xml"}}(1234Cr).formatted.{'%1s'}{{/code}}⟹{{code language="xml"}}'1 k'{{/code}} (rounding towards zero)
946 946  * {{code language="xml"}}(1234Cr).formatted.{'%cM'}{{/code}}⟹{{code language="xml"}}'0 M'{{/code}}
947 947  
948 -For documentation of time format strings, see the Lua function ConvertTimeString() in the [[Lua function overview>>doc:X Rebirth Wiki.Modding support.UI Modding support.Lua function overview.WebHome||style="outline-width: 0px !important; user-select: auto !important;"]].
957 +For documentation of time format strings, see the Lua function ConvertTimeString() in the [[MediaWiki.ARCHIVE.XRWIKIModding_supportUI_Modding_supportLua_function_overview]].
949 949  
950 950  Examples:
951 951  
... ... @@ -1088,6 +1088,7 @@
1088 1088   <set_value name="$foo" min="-20" max="20" profile="profile.increasing" scale="4"/>
1089 1089  {{/code}}
1090 1090  
1100 +
1091 1091  = Variables and namespaces =
1092 1092  
1093 1093  As you have seen above, you can easily access variables by writing their name (including $ prefix) in an expression. Namespaces define in which cue the variables are actually stored (and from which cue they are read).
... ... @@ -1142,6 +1142,7 @@
1142 1142  
1143 1143  Removing an entry from a list shifts all following elements down by one. If you want to clear an entry without removing it from the list, just use <set_value> instead.
1144 1144  
1155 +
1145 1145  == Accessing remote variables ==
1146 1146  
1147 1147  You can also read and write variables in other cues by using the variable name as property key: