Buildingunits - Revision history

Shiki: /* Using your new unit */

2024-11-08T03:48:23Z

‎Using your new unit

Thvk: /* See Also */

2020-11-03T08:13:19Z

‎See Also

Pentarctagon at 06:52, 16 May 2020

2020-05-16T06:52:55Z

Svenor: Add translations

2019-11-14T10:47:02Z

Add translations

Vultraz at 17:10, 16 March 2014

2014-03-16T17:10:59Z

Vultraz at 14:18, 15 March 2014

2014-03-15T14:18:34Z

Vultraz: /* See Also */

2014-03-13T14:50:06Z

‎See Also

Vultraz: /* Using your new unit */

2014-03-11T19:26:34Z

‎Using your new unit

Neilarmius: /* See Also */

2012-10-09T19:20:16Z

‎See Also

Neilarmius: /* See Also / Advanced_Animation_Tutorial How to code unit animations

2012-10-09T19:19:30Z

@@ Line 27: / Line 27: @@
 == Using your new unit ==
-Custom unit configuration files should be put in your add-on's <i>units</i> directory, and their custom graphics in the <i>images/units</i> directory. Be sure to have the <i>units</i> directory included from your _main.cfg. The include for this directory, however, should be wrapped in a <b>[+units][/units]</b> tag pair. See [[AddonStructure]] for an example.
+Custom unit configuration files should be put in your add-on's <i>units</i> directory, and their custom graphics in the <i>images/units</i> directory. Be sure to have the <i>units</i> directory included from your _main.cfg. The include for this directory, however, should be wrapped in a <b>[units][/units]</b> tag pair. See [[AddonStructure]] for an example.
 All units in this directory will now be accessible in any content loaded under the same <b>#ifdef</b> conditional. You can now allow sides to recruit the unit by listing it in the <b>recruit=</b> key in [side] (see [[SideWML]], place instances of it on the map with their own custom stats via [unit], or anything else you please.

← Older revision		Revision as of 08:13, 3 November 2020
Line 49:		Line 49:
	* [[Advanced_Animation_Tutorial]]		* [[Advanced_Animation_Tutorial]]
	* [[BuildingScenariosIntermediate]]		* [[BuildingScenariosIntermediate]]
		+	* [[BuildingFactions]]

@@ Line 37: / Line 37: @@
 <b>Note:</b> Remember that eras and factions is a construct unique to multiplayer.
-More detailed instructions on factions and eras can be found in [[BuildingFactions]] and [[EraWML]] articles. A faction, if there's only one, must be included in an era. You will not be able to add your units to any era that ships with the game.
+More detailed instructions on factions and eras can be found in the [[EraWML]] article. A faction, if there's only one, must be included in an era. You will not be able to add your units to any era that ships with the game.
 == See Also ==

← Older revision		Revision as of 10:47, 14 November 2019
Line 1:		Line 1:
		+	{{Translations}}
		+
	{{Create}}		{{Create}}
		+
		+	{\| style="float:right; margin-left:1em;"
		+	\|__TOC__
		+	\|}

	When creating custom content, you might want to create a cool new unit. This page will walk you through the creation of a new unit and discuss how you can use it in-game.		When creating custom content, you might want to create a cool new unit. This page will walk you through the creation of a new unit and discuss how you can use it in-game.

@@ Line 1: / Line 1: @@
 {{Create}}
-Making new units is fairly easy.  Unit configuration files are plain text files that you can edit with any editor such as Notepad, TextEdit, gedit, pico, vi, emacs, etc.  You will need to become familiar with [[UnitTypeWML|WML]] in order to make a new unit.  This page contains a more in-depth discussion of Unit WML syntax and will walk you through the creation of a new unit and discuss how you can use it in-game.
+When creating custom content, you might want to create a cool new unit. This page will walk you through the creation of a new unit and discuss how you can use it in-game.
-== Recommended procedure ==
+Before you begin, you should be remember that the <b>[[UnitTypeWML | [unit_type]]]</b> tag will create a new type of unit, while the <b>[[SingleUnitWML | [unit]]]</b> tag allows you to use the unit in your scenario. This article will focus on the use of the former.
-Most of a unit's properties are self-explanatory to anyone who has played Battle for Wesnoth for very long, and the tags in the WML files are brief but descriptive. It is recommended that you try editing by yourself before consulting the guide.  Otherwise, you may find the guide confusing.
+== Creating a new unit ==
 == Using your new unit ==
-If you want to make a faction, follow the instructions in the [[BuildingFactions]] article.  You should create a new era and add your units as one of the factions.  You will not be able to add your units to any era that ships with the game.
+Custom unit configuration files should be put in your add-on's <i>units</i> directory, and their custom graphics in the <i>images/units</i> directory. Be sure to have the <i>units</i> directory included from your _main.cfg. The include for this directory, however, should be wrapped in a <b>[+units][/units]</b> tag pair. See [[AddonStructure]] for an example.
-If you want to make a unit pack, the procedure is easier.  Unit packs are distributed for campaign writers who want to use your units in their campaigns/eras.  They download your unit pack and copy/paste the units and images into their campaign/era.
+All units in this directory will now be accessible in any content loaded under the same <b>#ifdef</b> conditional. You can now allow sides to recruit the unit by listing it in the <b>recruit=</b> key in [side] (see [[SideWML]], place instances of it on the map with their own custom stats via [unit], or anything else you please.
-== Unit WML discussion ==
+=== Multiplayer factions and eras ===
-As of 1.6, unit definitions are enclosed in '''[unit_type]''' tags.
+Another common use of custom units it to group them into a multiplayer faction, and group one or several factions together into an era. A faction is several units that represent a common theme, such as the Loyalists. An era is several factions grouped together, usually under a common theme, but can also be done so for other reasons; an example would be the Default era, which contains all the eras used in multiplayer.
-This section only provides some tips and pointers in making a unit.  Feel free to add pointers of your own.  For the full, current, complete WML reference on what to put in your [unit], see and frequently revisit [[UnitTypeWML|The Unit WML reference page]].
+<b>Note:</b> Remember that eras and factions is a construct unique to multiplayer.
-* See [[BuildingScenariosIntermediate]] for more information on attacks.
+More detailed instructions on factions and eras can be found in [[BuildingFactions]] and [[EraWML]] articles. A faction, if there's only one, must be included in an era. You will not be able to add your units to any era that ships with the game.
 == See Also ==
@@ Line 68: / Line 42: @@
 * [[Team_Color_Shifting]]
 * [[Advanced_Animation_Tutorial]]

@@ Line 7: / Line 7: @@
 == Using your new unit ==
-Any unit in the game's existing data/units/*/ directories (you can't just add a new directory to data/units/) or ''[[EditingWesnoth#Where_is_my_user_data_directory.3F|userdata]]''/data/ will be recognized by the game. If you only want to use it once or twice as a special unit, that's all you need to do. However, just because you made a new unit does NOT mean that it can be recruited. Each scenario and multiplayer era has a specific recruit list. If your unit is not on the list, you can't recruit it. This means you need to modify the ''recruit='' key in the appropriate configuration file. [[BuildingMultiplayer]] describes different ways you do this for multiplayer. To add a unit to a campaign, read about scenarios, sides, and recruit lists in [[BuildingScenarios]].
+Any unit in the game's existing data/units/*/ directories (you can't just add a new directory to data/units/) or ''[[EditingWesnoth#Where_is_my_user_data_directory.3F|userdata]]''/data/ will be recognized by the game. If you only want to use it once or twice as a special unit, that's all you need to do. However, just because you made a new unit does NOT mean that it can be recruited. Each scenario and multiplayer era has a specific recruit list. If your unit is not on the list, you can't recruit it. This means you need to modify the ''recruit='' key in the appropriate configuration file. [[MultiplayerContent]] describes different ways you do this for multiplayer. To add a unit to a campaign, read about scenarios, sides, and recruit lists in [[BuildingScenarios]].
 == Distributing your unit ==

Buildingunits - Revision history

Shiki: /* Using your new unit */

Thvk: /* See Also */

Pentarctagon at 06:52, 16 May 2020

Svenor: Add translations

Vultraz at 17:10, 16 March 2014

Vultraz at 14:18, 15 March 2014

Vultraz: /* See Also */

Vultraz: /* Using your new unit */

Neilarmius: /* See Also */

Neilarmius: /* See Also */ * Advanced_Animation_Tutorial How to code unit animations

Neilarmius: /* See Also / Advanced_Animation_Tutorial How to code unit animations