WML for Complete Beginners: Chapter 6 - Revision history

Celtic Minstrel: Use syntax highlighting

2023-01-29T20:37:38Z

Use syntax highlighting

Celtic Minstrel: Nicer index and navigation

2023-01-29T19:07:04Z

Nicer index and navigation

Celtic Minstrel: Nicer index and navigation

2023-01-29T19:06:20Z

Nicer index and navigation

Thvk at 08:12, 3 November 2020

2020-11-03T08:12:32Z

Namhub: /* Attacks */

2018-10-10T07:21:43Z

‎Attacks

Namhub: /* Creating Unit Images */

2018-10-10T07:18:31Z

‎Creating Unit Images

Namhub: I love tabs

2018-10-10T07:17:17Z

I love tabs

Namhub: add attack and complete example

2018-10-10T07:15:52Z

add attack and complete example

Namhub at 07:06, 10 October 2018

2018-10-10T07:06:52Z

Namhub: Talk about how unit images work

2018-10-10T07:00:07Z

Talk about how unit images work

@@ Line 10: / Line 10: @@
 As usual, start with the textdomain and toplevel tag:
- #textdomain wesnoth-my_first_campaign
+[unit_type]
 [/unit_type]
- [unit_type]
+</syntaxhighlight>
 A somewhat minimal set of initial keys might be:
+<syntaxhighlight lang=wml>
- id=
+id=
- name=
+name=
- image=
+image=
- movement=
+movement=
- hitpoints=
+hitpoints=
 "id" and "name" work like usual. "movement" is interesting, because by default a unit will have no movement; quite a boring unit! The same goes for hitpoints; you would have 1 hitpoint if unset.
 Filling these out, you might end up with:
- #textdomain wesnoth-my_first_campaign
+[unit_type]
+    id=My First Unit
- [unit_type]
+    name= _ "My First Unit"
-     id=My First Unit
+    image=
-     name= _ "My First Unit"
+    movement=10
-     image=
+    hitpoints=10
-     movement=10
+[/unit_type]
-     hitpoints=10
+</syntaxhighlight>
 ===Creating Unit Images===
@@ Line 43: / Line 46: @@
 Update your my_first_unit.cfg:
+<syntaxhighlight lang=wml>
- image="units/my_first_art.png"
+image="units/my_first_art.png"
 If you don't have a perfectly sized image, you'll notice your unit looks strange in menus and when placed on the map. You can also play with the SCALE and CROP functions to adjust this:
+<syntaxhighlight lang=wml>
- image="units/my_first_art.png~SCALE_SHARP(72,72)"
+image="units/my_first_art.png~SCALE_SHARP(72,72)"
 This is described in more detail in [[ImagePathFunctionWML]]
@@ Line 55: / Line 60: @@
 You can now add your units to <code>_main.cfg</code>:
+<syntaxhighlight lang=wml>
- [+units]
+[units]
      {~add-ons/my_first_campaign/units}
- [/units]
+[/units]
 You might also want to make this unit recruitable by your human-controlled leader in <code>scenarios/my_first_scenario.cfg</code>:
+<syntaxhighlight lang=wml>
- recruit="Elvish Fighter, My First Unit"
+recruit="Elvish Fighter, My First Unit"
 Try recruiting your first unit!
@@ Line 69: / Line 76: @@
 You will notice quickly that your unit is not able to attack, because we have not assigned it any attacks.
+<syntaxhighlight lang=wml>
- [attack]
+[attack]
-     name=sword
+    name=sword
-     type=blade
+    type=blade
-     range=melee
+    range=melee
-     damage=4
+    damage=4
-     number=1
+    number=1
-     icon=attacks/dagger-human.png
+    icon=attacks/dagger-human.png
- [/attack]
+[/attack]
 This is a simple sword attack, reusing mainline art for the attack icon.
 Your complete unit_type tag should now look like this:
+<syntaxhighlight lang=wml>
- [unit_type]
+[unit_type]
-     id=My First Unit
+    id=My First Unit
-     name= _ "My First Unit"
+    name= _ "My First Unit"
-     image="units/my_first_art.png"
+    image="units/my_first_art.png"
-     movement=10
+    movement=10
-     hitpoints=10
+    hitpoints=10
-−
-     [attack]
+    [attack]
-         name=sword
+        name=sword
-         type=blade
+        type=blade
-         range=melee
+        range=melee
-         damage=4
+        damage=4
-         number=1
+        number=1
-         icon=attacks/sword-human.png
+        icon=attacks/sword-human.png
-     [/attack]
+    [/attack]
- [/unit_type]
+[/unit_type]
 ===Further reading===

@@ Line 108: / Line 108: @@
 After reading more about UnitTypeWML, you might try extending your first unit with advancement options and variations.
-{{Navigation|[[WML for Complete Beginners: Chapter 5]]|[[WML for Complete Beginners: Chapter 7]]}}
+{{Navigation|[[WML for Complete Beginners: Chapter 5|'''Chapter 5'''<br>Events]]|[[WML for Complete Beginners: Chapter 7|'''Chapter 7'''<br>Creating Your First Scenario]]}}
 [[Category:WML_for_Complete_Beginners]]

@@ Line 1: / Line 1: @@
 ==Chapter 6: Building and Including a Custom Unit==
@@ Line 106: / Line 108: @@
 After reading more about UnitTypeWML, you might try extending your first unit with advancement options and variations.
-===Continue===
+{{Navigation|[[WML for Complete Beginners: Chapter 5]]|[[WML for Complete Beginners: Chapter 7]]}}
 [[Category:WML_for_Complete_Beginners]]

@@ Line 102: / Line 102: @@
 * [[UnitTypeWML]] reference for the unit_type tag shown in this article
 * [[SingleUnitWML]]
 After reading more about UnitTypeWML, you might try extending your first unit with advancement options and variations.

@@ Line 77: / Line 77: @@
   [/attack]
-This also uses an icon from mainline art.
+This is a simple sword attack, reusing mainline art for the attack icon.
-Your complete unit file should now look like this:
+Your complete unit_type tag should now look like this:
   [unit_type]

@@ Line 36: / Line 36: @@
   [/unit_type]
-===Creating your Custom Unit's Images===
+===Creating Unit Images===
-Add the images to my_first_campaign/units
+If you were to spawn this unit now, it would look quite strange, because we have not yet assigned an image. [[Creating Unit Art]] describes how to do this in some detail. When you have a reasonably suitable image, you should save this in <code>add-ons/my_first_campaign/images/units</code>.
 ===Including the Custom Unit in your Campaign===