WML for Complete Beginners: Chapter 7 - Revision history

Celtic Minstrel: Use syntax highlighting

2023-01-29T20:39:22Z

Use syntax highlighting

Celtic Minstrel: Nicer index and navigation

2023-01-29T19:10:27Z

Nicer index and navigation

Shiki: improve link

2021-05-20T00:23:38Z

improve link

Greeneyelink: /* Evaluating variables */

2018-06-09T21:45:56Z

‎Evaluating variables

Greeneyelink: /* Evaluating variables */

2018-06-09T21:45:38Z

‎Evaluating variables

Greeneyelink: /* Evaluating variables */

2018-06-09T21:40:46Z

‎Evaluating variables

Greeneyelink: /* Evaluating variables */

2018-06-09T21:35:10Z

‎Evaluating variables

Greeneyelink: /* Manipulating Variables */

2018-06-09T21:33:40Z

‎Manipulating Variables

Greeneyelink: /* Evaluating variables */

2018-06-09T21:30:19Z

‎Evaluating variables

Greeneyelink: /* Evaluating variables */

2018-06-09T21:28:46Z

‎Evaluating variables

@@ Line 11: / Line 11: @@
 ===Creating Variables===
 To create a variable, the following syntax is used:
- [set_variable]
+<syntaxhighlight lang=wml>
-     name=variable_name
+[set_variable]
-     value=variable_value
+    name=variable_name
- [/set_variable]
+    value=variable_value
 This creates a variable and assigns a name and value to it.
@@ Line 33: / Line 35: @@
 Suppose you wanted to have the narrator give a message telling the player the value of the variable "dishes_box". Here's how you would tell the game to do that in WML:
+<syntaxhighlight lang=wml>
- [message]
+[message]
-     speaker=narrator
+    speaker=narrator
-     message= _ "The value of the dishes_box variable is: $dishes_box"
+    message= _ "The value of the dishes_box variable is: $dishes_box"
- [/message]
+[/message]
 By preceding the name of a variable with a dollar sign "$" you are telling the game that you want to substitute the value of that variable. So in-game the narrator would say, "The value of the dishes_box variable is: dishes"
@@ Line 46: / Line 49: @@
 You may have a counter variable to count the number of times an event happens. This variable will start at zero and go up by one every time the event happens. So how would you perform that basic math? It would look like this:
+<syntaxhighlight lang=wml>
-  [set_variable]
+[set_variable]
-      name=counter
+    name=counter
-      add=1
+    add=1
-  [/set_variable]
+[/set_variable]
 Contrary to expectations, arithmetic in WML is not done by the + ; - ; * ; / signs. Instead we use the keys "add" ; "sub" ; "multiply" ; "divide" respectively. So to multiply the existing ( i.e. previously set) variable named "treasure" by 17, you would write:
-  [set_variable]
+<syntaxhighlight lang=wml>
-      name=treasure
+[set_variable]
-      multiply=17
+    name=treasure
-  [/set_variable]
+    multiply=17
 ===Evaluating variables===
 You may have to look at a variable, and then do this or do that depending on the actual value of the variable. In other words: you evaluate a variable in an "if" statement. For instance, you want to check the value of the "has_picked_flower" variable, and then do something depending on it. This is done like this (the conditional statements shall be covered in a later section, now just concentrate on the variable tag):
+<syntaxhighlight lang=wml>
-  [if]
+[if]
-      [variable]
+    [variable]
-          name=has_picked_flower
+        name=has_picked_flower
-          equals=yes
+        equals=yes
-      [/variable]
+    [/variable]
-      [then]
+    [then]
-          # do something
+        # do something
-      [/then]
+    [/then]
-  [/if]
+[/if]
 Here the evaluation most commonly used operator keys may be: "equals" ; "not_equals" ; "less_than" ; "greater_than" ; "greater_than_equal_to" ; "less_than_equal_to". Actually there is more but these shall do for now. For reference visit the [[ConditionalActionsWML|Conditional Actions WML]] page.

@@ Line 1: / Line 1: @@
 ==Chapter 7: Introduction to Variables==
@@ Line 72: / Line 74: @@
 Here the evaluation most commonly used operator keys may be: "equals" ; "not_equals" ; "less_than" ; "greater_than" ; "greater_than_equal_to" ; "less_than_equal_to". Actually there is more but these shall do for now. For reference visit the [[ConditionalActionsWML|Conditional Actions WML]] page.
-Next Chapter:
+{{Navigation|[[WML for Complete Beginners: Chapter 6|'''Chapter 6'''<br>Custom Units]]|[[WML for Complete Beginners: Chapter 8|'''Chapter 8'''<br>Non-scalar Variables]]}}
 [[Category:WML_for_Complete_Beginners]]

@@ Line 70: / Line 70: @@
    [/if]
-Here the evaluation most commonly used operator keys may be: "equals" ; "not_equals" ; "less_than" ; "greater_than" ; "greater_than_equal_to" ; "less_than_equal_to". Actually there is more but these shall do for now. For reference visit the [https://wiki.wesnoth.org/ConditionalActionsWML Conditional Actions WML] page.
+Here the evaluation most commonly used operator keys may be: "equals" ; "not_equals" ; "less_than" ; "greater_than" ; "greater_than_equal_to" ; "less_than_equal_to". Actually there is more but these shall do for now. For reference visit the [[ConditionalActionsWML|Conditional Actions WML]] page.
 Next Chapter:

@@ Line 58: / Line 58: @@
 ===Evaluating variables===
-You may have to look at a variable, and then do this or do that depending on the actual value of the variable. In other words: you evaluate a variable in an "if" statement. For instance, you want to check the value of the "has_picked_flower" variable, and then do something depending on it. This is done like this (the conditional statements shall be covered in a later section, now just concentrate on the variable tag.):
+You may have to look at a variable, and then do this or do that depending on the actual value of the variable. In other words: you evaluate a variable in an "if" statement. For instance, you want to check the value of the "has_picked_flower" variable, and then do something depending on it. This is done like this (the conditional statements shall be covered in a later section, now just concentrate on the variable tag):
    [if]

@@ Line 58: / Line 58: @@
 ===Evaluating variables===
-You may have to look at a variable, and then do this or do that depending on the actual value of the variable. In other words: you evaluate a variable in an "if" statement. For instance, you want to check the value of the "has_picked_flower" variable, and then do something depending on it. This is done like this:
+You may have to look at a variable, and then do this or do that depending on the actual value of the variable. In other words: you evaluate a variable in an "if" statement. For instance, you want to check the value of the "has_picked_flower" variable, and then do something depending on it. This is done like this (the conditional statements shall be covered in a later section, now just concentrate on the variable tag.):
    [if]