The Battle for Wesnoth Wiki - User contributions [en]

User:Dovolente

2011-04-22T20:09:34Z

Dovolente: /* Wesband */

I'm an English language instructor at a university in the southeastern United States. A long-time fantasy gaming enthusiast, I've enjoyed developing user-made content for many different games, including Wesnoth.

===Dov's MP Maps===
An add-on that includes the following MP scenarios:

* '''Orocia''' - A cooperative 3-player cooperative survival map, inspired by Nosmos's 3-player survival and much-modded since it appeared in 1.4.
* '''The Deep Shrine''' - Another 3-player cooperative survival map, the 'dark side' of Orocia with more of (but not much of) a storyline.
* '''Cutthroat Survival''' - A 3-way free-for-all with some occasional NPC spawns to liven things up.
* '''Elf Chess''' - A 2-player game mod based on chess. Each player starts with 16 units, and gets 2 moves and 2 attacks per turn. The king has only 1 hp, and must be defended at all costs.
* '''Rumble3D''' - A 6-player rumble-style map with 3 separate levels interreachable via teleportation runes.

The '''Wesnoth 1.9''' version contains the above maps and also includes 3 game mods:

* '''Drops Mod''' - Slain enemies will sometimes drop weapons. Weapon power depends on a combination of the slain enemy's strength, the game turn (later is better), and luck. This mod will eventually include dropped rings, scrolls and potions as well. Available for default and heroes MP factions.
* '''XP Mod''' - Spend XP to upgrade a unit's hp, damage, or strikes. Available for default and heroes MP factions.
* '''Settlers Mod''' - A resource collection and management mod. The map begins by removing constructed terrain, so the play is on "virgin" land. You begin with a leader and 3 peasants. Peasants collect resources and build new structures, and your leader can recruit new units. There is also a 'survival' version to help make survival map play more possible.

The game mods are accessed via the "era" selection box and work with standard MP maps and most user-made maps.

See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=16798 Dov's MP Maps forum thread] for further details.

===Wanderlust===
A single-player RPG campaign engine featuring a character customization system, nonlinear play, extended map embellishments through the map editor, and built-in quest and NPC message functions. Nearing completion of alpha development stage in April 2011.

===Wesband===
Wesband aspires to be a rogue-like dungeoncrawl multiplayer campaign for 1-4 players. I developed the basic concept and multiplayer framework, as well as the randomized starting map/towns and randomized dungeon levels. Ken Oh brought his excellent RPG work to the project, and he and others have since enhanced and improved the campaign far beyond its humble beginnings. I no longer participate actively in its development but a remain a big fan of the project. See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=21234&start=15 Wesband forum discussion] for further details.

User:Dovolente

2011-04-22T20:08:32Z

Dovolente:

I'm an English language instructor at a university in the southeastern United States. A long-time fantasy gaming enthusiast, I've enjoyed developing user-made content for many different games, including Wesnoth.

===Dov's MP Maps===
An add-on that includes the following MP scenarios:

* '''Orocia''' - A cooperative 3-player cooperative survival map, inspired by Nosmos's 3-player survival and much-modded since it appeared in 1.4.
* '''The Deep Shrine''' - Another 3-player cooperative survival map, the 'dark side' of Orocia with more of (but not much of) a storyline.
* '''Cutthroat Survival''' - A 3-way free-for-all with some occasional NPC spawns to liven things up.
* '''Elf Chess''' - A 2-player game mod based on chess. Each player starts with 16 units, and gets 2 moves and 2 attacks per turn. The king has only 1 hp, and must be defended at all costs.
* '''Rumble3D''' - A 6-player rumble-style map with 3 separate levels interreachable via teleportation runes.

The '''Wesnoth 1.9''' version contains the above maps and also includes 3 game mods:

* '''Drops Mod''' - Slain enemies will sometimes drop weapons. Weapon power depends on a combination of the slain enemy's strength, the game turn (later is better), and luck. This mod will eventually include dropped rings, scrolls and potions as well. Available for default and heroes MP factions.
* '''XP Mod''' - Spend XP to upgrade a unit's hp, damage, or strikes. Available for default and heroes MP factions.
* '''Settlers Mod''' - A resource collection and management mod. The map begins by removing constructed terrain, so the play is on "virgin" land. You begin with a leader and 3 peasants. Peasants collect resources and build new structures, and your leader can recruit new units. There is also a 'survival' version to help make survival map play more possible.

The game mods are accessed via the "era" selection box and work with standard MP maps and most user-made maps.

See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=16798 Dov's MP Maps forum thread] for further details.

===Wanderlust===
A single-player RPG campaign engine featuring a character customization system, nonlinear play, extended map embellishments through the map editor, and built-in quest and NPC message functions. Nearing completion of alpha development stage in April 2011.

===Wesband===
Wesband aspires to be a rogue-like dungeoncrawl multiplayer campaign for 1-4 players. I developed the basic concept and multiplayer framework, as well as the randomized starting map/towns and randomized dungeon levels. Ken Oh brought his excellent RPG work to the project, and he and others have since enhanced and improved the campaign immensely. I no longer participate actively in its development. See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=21234&start=15 Wesband forum discussion] for further details.

User:Dovolente

2011-04-22T20:03:41Z

Dovolente: /* Dov's MP Maps */

I'm an English language instructor at a university in the southeastern United States. A long-time fantasy gaming enthusiast, I've enjoyed developing user-made content for many different games, including Wesnoth.

===Dov's MP Maps===
An add-on that includes the following MP scenarios:

* '''Orocia''' - A cooperative 3-player cooperative survival map, inspired by Nosmos's 3-player survival and much-modded since it appeared in 1.4.
* '''The Deep Shrine''' - Another 3-player cooperative survival map, the 'dark side' of Orocia with more of (but not much of) a storyline.
* '''Cutthroat Survival''' - A 3-way free-for-all with some occasional NPC spawns to liven things up.
* '''Elf Chess''' - A 2-player game mod based on chess. Each player starts with 16 units, and gets 2 moves and 2 attacks per turn. The king has only 1 hp, and must be defended at all costs.
* '''Rumble3D''' - A 6-player rumble-style map with 3 separate levels interreachable via teleportation runes.

The '''Wesnoth 1.9''' version contains the above maps and also includes 3 game mods:

* '''Drops Mod''' - Slain enemies will sometimes drop weapons. Weapon power depends on a combination of the slain enemy's strength, the game turn (later is better), and luck. This mod will eventually include dropped rings, scrolls and potions as well. Available for default and heroes MP factions.
* '''XP Mod''' - Spend XP to upgrade a unit's hp, damage, or strikes. Available for default and heroes MP factions.
* '''Settlers Mod''' - A resource collection and management mod. The map begins by removing constructed terrain, so the play is on "virgin" land. You begin with a leader and 3 peasants. Peasants collect resources and build new structures, and your leader can recruit new units. There is also a 'survival' version to help make survival map play more possible.

The game mods are accessed via the "era" selection box and work with standard MP maps and most user-made maps.

See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=16798 Dov's MP Maps forum thread] for further details.

===XP Era===
A "mod" era which allows players to spend a unit's xp to purchase various stat upgrades. Based on work by itota. See the [http://forums.wesnoth.org/viewtopic.php?f=19&t=31477 XP Era forum thread] for further details.

===Settlers Era===
A multiplayer, "total mod" era which changes the game to a resource-collection game. Players start with a leader and 3 peasants (and in 'survival' mode, 3 military units). The map is converted to a "pre-civilization" stage, removing all built structures and roads. Peasants collect resources depending on their terrain, and can build villages, walls, and towers. The leader can spend resources to recruit more peasants or military units from villages. It is possible to win through conquest or through resource collection. See the [http://forums.wesnoth.org/viewtopic.php?f=19&t=20867 Settlers Era forum thread] for further details.

===Wanderlust===
A single-player campaign system featuring nonlinear play, strong RPG elements, and an extensive, original fantasy setting. Still in concept development stage.

===Wesband===
Wesband aspires to be a rogue-like dungeoncrawl multiplayer campaign for 1-4 players. I developed the basic concept and multiplayer framework, as well as the randomized starting map/towns and randomized dungeon levels. Ken Oh brought his excellent RPG work to the project, and he and others have since enhanced and improved the campaign immensely. I no longer participate actively in its development. See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=21234&start=15 Wesband forum discussion] for further details.

User:Dovolente

2011-01-21T03:36:44Z

Dovolente: /* Wesband */

I'm an English language instructor at a university in the southeastern United States. A long-time fantasy gaming enthusiast, I've enjoyed developing user-made content for many different games, including Wesnoth.

===Dov's MP Maps===
A collection of nonstandard multiplayer maps, including "Elf Chess" and the original versions of the much-modded scenarios "Orocia" and "Deep Shrine". See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=16798 Dov's MP Maps forum thread] for further details.

===XP Era===
A "mod" era which allows players to spend a unit's xp to purchase various stat upgrades. Based on work by itota. See the [http://forums.wesnoth.org/viewtopic.php?f=19&t=31477 XP Era forum thread] for further details.

===Settlers Era===
A multiplayer, "total mod" era which changes the game to a resource-collection game. Players start with a leader and 3 peasants (and in 'survival' mode, 3 military units). The map is converted to a "pre-civilization" stage, removing all built structures and roads. Peasants collect resources depending on their terrain, and can build villages, walls, and towers. The leader can spend resources to recruit more peasants or military units from villages. It is possible to win through conquest or through resource collection. See the [http://forums.wesnoth.org/viewtopic.php?f=19&t=20867 Settlers Era forum thread] for further details.

===Wanderlust===
A single-player campaign system featuring nonlinear play, strong RPG elements, and an extensive, original fantasy setting. Still in concept development stage.

===Wesband===
Wesband aspires to be a rogue-like dungeoncrawl multiplayer campaign for 1-4 players. I developed the basic concept and multiplayer framework, as well as the randomized starting map/towns and randomized dungeon levels. Ken Oh brought his excellent RPG work to the project, and he and others have since enhanced and improved the campaign immensely. I no longer participate actively in its development. See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=21234&start=15 Wesband forum discussion] for further details.

User:Dovolente

2011-01-21T03:33:08Z

Dovolente: /* Wanderlust */

I'm an English language instructor at a university in the southeastern United States. A long-time fantasy gaming enthusiast, I've enjoyed developing user-made content for many different games, including Wesnoth.

===Dov's MP Maps===
A collection of nonstandard multiplayer maps, including "Elf Chess" and the original versions of the much-modded scenarios "Orocia" and "Deep Shrine". See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=16798 Dov's MP Maps forum thread] for further details.

===XP Era===
A "mod" era which allows players to spend a unit's xp to purchase various stat upgrades. Based on work by itota. See the [http://forums.wesnoth.org/viewtopic.php?f=19&t=31477 XP Era forum thread] for further details.

===Settlers Era===
A multiplayer, "total mod" era which changes the game to a resource-collection game. Players start with a leader and 3 peasants (and in 'survival' mode, 3 military units). The map is converted to a "pre-civilization" stage, removing all built structures and roads. Peasants collect resources depending on their terrain, and can build villages, walls, and towers. The leader can spend resources to recruit more peasants or military units from villages. It is possible to win through conquest or through resource collection. See the [http://forums.wesnoth.org/viewtopic.php?f=19&t=20867 Settlers Era forum thread] for further details.

===Wanderlust===
A single-player campaign system featuring nonlinear play, strong RPG elements, and an extensive, original fantasy setting. Still in concept development stage.

===Wesband===
Wesband aspires to be a rogue-like dungeoncrawl multiplayer campaign for 1-4 players. I developed the basic concept and multiplayer framework, as well as the randomized starting map/towns and randomized dungeon levels. Ken Oh brought his excellent RPG work to the project, and he and others have since enhanced and improved the campaign immensely. See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=21234&start=15 Wesband forum discussion] for further details.

DirectActionsWML

2010-12-29T20:51:34Z

Dovolente: /* [modify_unit] */ added forum thread that helped more than this documentation.. :/

{{WML Tags}}
== Direct actions ==

Direct actions are actions that have a direct effect on gameplay. They can be used inside of [[EventWML|events]].

The following tags are actions:

=== [endlevel] ===
Ends the scenario.
* '''result''': before the scenario is over, all events with ''name=result'' are triggered. The message ''result_message'' with the heading ''result_heading'' (see [[LanguageWML]]) are displayed. If ''result=victory'', the player progresses to the next level; if ''result=defeat'', the game returns to the main menu. These last two are rarely used: ''result=continue'' behaves identically to ''result=victory'' except the player's gold is not reduced to 80%, and it does not bring up a "Victory" message or the gold changing message (since it doesn't change); ''result=continue_no_save'' works similarly, except the player is not asked whether to save the game, and is taken directly to the next scenario without any messages. {{DevFeature}}: All values for result=... except victory and defeat are being discarded in favor of modifying '''[endlevel]''' behaviour with single keys.
Unless ''result=defeat'', the following keys can also be used:
* '''bonus''': whether the player should get bonus gold (maximum possible gold that could have been earned by waiting the level out). The default is bonus=yes.
* '''carryover_report''': whether the player should receive a summary of the scenario outcome, the default is carryover_report=yes.
* '''save''': whether a start-of-scenario save should be created for the next scenario, the default is save=yes.
* '''linger_mode''': If ...=yes, the screen is greyed out and there's the possibility to save before advancing to the next scenario, the default is linger_mode=yes.
* '''reveal_map''': (Multiplayer only) (Default is 'yes') If 'no', shroud doesn't disappear when game ended. {{DevFeature1.9}}
* '''next_scenario''': (default specified in '''[scenario]''' tag) the ID of the next scenario that should be played. All units that side 1 controls at this point become available for recall in ''next_scenario''.

When the result is "victory" the following keys can be used:
* '''carryover_percentage''': by default 80% of the gold is carried over to the next scenario, with this key the amount can be changed.
* '''carryover_add''': if true the gold will be added to the starting gold the next scenario, if false the next scenario will start with the amount of the current scenario (after taxes) or the minimum in the next scenario. Default is false.
* '''music''': (default specified in '''[scenario]''' or '''[game_config]''' tags) a comma-separated list of music tracks from which one will be chosen and played once after any events related to the end of level result are executed; by default, victory_music is used on victory, and defeat_music on defeat.
* '''end_text''': Text that is shown centered in a black screen at the end of a campaign. Defaults to "The End". Note that this has cumulative effects over the campaign - it persists even if the endlevel does not trigger the end of the campaign. See also [[CampaignWML]].
* '''end_text_duration''': Delay, in milliseconds, before displaying the game credits at the end of a campaign. In other words, for how much time '''end_text''' is displayed on screen. Defaults to 3500. Note that this has cumulative effects over the campaign - it persists even if the endlevel does not trigger the end of the campaign. See also [[CampaignWML]].

=== [unit] ===
Places a unit on the map. For syntax see [[SingleUnitWML]].
* {{Short Note:Predefined Macro|GENERIC_UNIT}}
* '''to_variable''': spawn directly into a variable instead of on the map.

=== [recall] ===
Recalls a unit. The unit is recalled free of charge, and is placed near the leader.
* [[StandardUnitFilter]]: the first matching unit will be recalled. If no units match this tag is ignored. Do not use a [filter] tag. If a comma separated list is given, every unit currently considered for recall is checked against all the types (not each single one of the types against all units).
* '''x,y''': the unit is placed here instead of next to the leader.
* '''show''': yes/no, default yes: whether the unit is animated (faded in) or instantly displayed
* '''fire_event''': {{DevFeature1.9}} boolean yes|no (default no); whether any according prerecall or recall events shall be fired. In pre-1.9.3 these events are all automatically fired and it can't be turned off.

=== [teleport] ===
Teleports a unit on map. {{Short Note:Predefined Macro|TELEPORT_UNIT}}
* '''[filter]''': [[StandardUnitFilter]] the first unit matching this filter will be teleported.
* '''x,y''': the position to teleport to.
* '''clear_shroud''': should shroud be cleared on arrival
* '''animate''': should a teleport animation be played (if the unit doesn't have a teleport animation, it will fade out/fade in)
* '''ignore_passability''': {{DevFeature}} normally, units will not be teleported into terrain that is impassable for them. Setting this attribute to "yes" permits it.

(Note: There is also a ability named teleport, see [[AbilitiesWML]].)

=== [terrain_mask] ===
Changes the terrain on the map. See [[TerrainMaskWML]].

=== [terrain] ===
Changes the terrain on the map.
* '''terrain''': the character of the terrain to use. See [[TerrainCodesWML]] to see what letter a type of terrain uses.
* '''x,y''': the position (or range of positions) to change. {{DevFeature1.9}}: [terrain] accepts a [[StandardLocationFilter]]. This [[StandardLocationFilter]]'s terrain= key is used for the new terrain, filtering by terrain can be done with a nested [[StandardLocationFilter]]: [and]terrain=terrain_string_to_be_filtered_for.
* '''layer''': (overlay|base|both, default=both) only change the specified layer.
* '''replace_if_failed''': (default=no) When replacing just one layer failed, try to replace the whole terrain. If '''terrain''' is an overlay only terrain, use the default_base as base layer. If the terrain has no default base, do nothing.

=== [gold] ===
Gives one side gold.
* '''amount''': the amount of gold to give.
* '''side''': (default=1) the number of the side to give the gold to.

=== [unstore_unit] ===
Creates a unit from a game variable, and activates it on the playing field. This must be a specific variable describing a unit, and may not be an array -- to unstore an entire array, iterate over it. The variable is not cleared. See also [[InternalActionsWML#.5Bstore_unit.5D|[store_unit]]], [[ConditionalActionsWML#.5Bwhile.5D|[while]]] and [[InternalActionsWML#.5Bclear_variable.5D|[clear_variable]]]. Note units with a negative amount of hitpoints will be unstored with 1 hitpoint.
* '''variable''': the name of the variable.
* '''find_vacant''': whether the unit should be placed on the nearest vacant tile to its specified location. If this is set to 'no'(default), then any unit on the same tile as the unit being unstored will be destroyed.
* '''text''': (translatable) floating text to display above the unit, such as a damage amount
* '''red''', '''green''', '''blue''': (default=0,0,0) the color to display the text in. Values vary from 0-255. You may find it convenient to use the {COLOR_HARM} or {COLOR_HEAL} macro instead. (Use {COLOR_HARM} or {COLOR_HEAL} instead of the whole red,green,blue= line.)
* '''advance''': (default=true) if true the unit is advanced if it has enough XP. When modifying XP make sure to do it from inside a [[EventWML#Multiplayer_safety|synchronized event]] or it may lead to OOS errors especially when several advancement paths exist. Note that advance and post advance events are called, so infinite loops can happen.
* '''x''' ,'''y''': override unit location, "x,y=recall, recall" will put the unit on the unit's side's recall list.

=== [allow_recruit] ===
Allows a side to recruit units it couldn't previously recruit.
* '''type''': the types of units that the side can now recruit.
* '''side''': (default=1) the number of the side that is being allowed to recruit the units {{DevFeature1.9}} side= can be a comma-separated list

=== [disallow_recruit] ===
Prevents a side from recruiting units it could previously recruit.
* '''type''': the types of units that the side can no longer recruit.
* '''side''': (default=1) the number of the side that may no longer recruit the units. {{DevFeature1.9}} side= can be a comma-separated list

=== [set_recruit] ===
Sets the units a side can recruit.
** '''recruit''': the types of units that the side can now recruit.
** '''side''': (default=1) the number of the side that is having its recruitment set. {{DevFeature1.9}} side= can be a comma-separated list
=== [modify_side] ===
Modifies some details of a given side in the middle of a scenario. '''The following listed properties are the only properties that [modify_side] can affect!'''
* '''side''': (default=1) the number of the side that is to be changed.
* '''income''': the income given at the begining of each turn.
* '''team_name''': the team in which the side plays the scenario.
* '''user_team_name''': a translatable string representing the team's description. This has no effect on alliances. Defaults to ''team_name''.
* '''gold''': the amount of gold the side owns.
* '''village_gold''': the income setting per village for the side.
* '''controller''': the identifier string of the side's controller. Uses the same syntax of the ''controller'' key in the [[SideWML|[side]]] tag.
* '''fog''': a boolean string (yes/no) describing the status of Fog for the side.
* '''shroud''': a boolean string describing the status of Shroud for the side.
* '''hidden''': a boolean string specifying whether side is shown in status table.
* '''[ai]''': replaces a side's AI parameters with the new specified ones. Uses the same syntax described in [[AiWML]].
* '''switch_ai''': {{DevFeature}} replaces a side ai with a new AI from specified file(ignoring those AI parameters above). Path to file follows the usual WML convention.
* '''share_maps''': {{DevFeature}} change the share_maps side attribute. Be sure to use shroud=yes for that side and have it as an ally
* '''share_view''': {{DevFeature}} change the share_view side attribute. Be sure to use fog=yes for that side and have it as an ally

=== [modify_turns] ===
Modifies the turn limit in the middle of a scenario.
* '''value''': the new turn limit.
* '''add''': if used instead of ''value'', specifies the number of turns to add to the current limit (can be negative).
* '''current''': changes the current turn number after applying turn limit modifications, if any. It is possible to change the current turn number to a greater one than the current only; also, it is not possible to change the turn number to exceed the turn limit.

=== [capture_village] ===
Changes the ownership of a village.
* '''side''': the side that takes control of the village. This side needs to have a leader (canrecruit=yes). If the side key is not given, the village will become neutral.
* '''x, y''': the location of the village. Can be a comma-separated list and/or location ranges. {{DevFeature1.9}}: [capture_village] accepts a full SLF; all village locations matching the filter are affected.

=== [kill] ===
Removes all units (including units in a recall list) that match the filter from the game.
* [[StandardUnitFilter]]: Selection criterion; do not use a [filter] tag.
* '''animate''': if 'yes', displays the unit dying (fading away).
* '''fire_event''': if 'yes', triggers any appropriate 'die' events (See [[EventWML]]). Note that any 'last breath' and 'die' events triggered by this are executed immediately, interrupting the current event and thus causing the x1, y1, x2, and y2 variables to be reset for that 'die' event, which in turn causes those variables to be invalid for the remainder of this event. In the stable version, the variable second_unit in each of these die and last breath events is always the same as the variable unit (the dying unit). Note that events are only fired for killed units that have been on the map (as opposed to recall list).
* '''[secondary_unit]''' {{DevFeature1.9}} with a [[StandardUnitFilter]] as argument. Do not use a [filter] tag. Has an effect only if fire_event=yes. The first on-map unit matching the filter becomes second_unit in any fired die and last breath events. If an on-map unit matches and if there are several units killed with a single [kill] tag, second_unit is this same unit for all of them. If no on-map unit matches or [secondary_unit] isn't present, the variable second_unit in each of the die and last breath events is always the same as the variable unit (the dying unit).

=== [move_unit] ===
{{DevFeature1.9}}; works like the MOVE_UNIT macro.
* [[StandardUnitFilter]] as argument; do not use a [filter] tag. All units matching the filter are moved. If the target location is occupied, the nearest free passable location is chosen. All target locations passed (see below) need to be passable hexes for the particular moved units.
* '''to_x''' (unsigned integer): The units are moved to this x coordinate. Can be a comma-separated list, in which case the unit follows this given path during the move.
* '''to_y''' (unsigned integer): The units are moved to this y coordinate. Can be a comma-separated list.
* '''fire_event''' (optional, boolean yes|no, default no): Whether any according moveto events shall be fired. The target location ($x1, $y1 in the event) may not be the same location that the unit was tried to be moved to, if the original target location is occupied or impassable.

=== [modify_ai] ===
Changes the AI for a specified side. See [[Customizing_AI_in_Wesnoth_1.8#.5Bmodify_ai.5D_tag]]

=== [modify_unit] ===
{{DevFeature1.9}}; works similar to the MODIFY_UNIT macro.
* '''[filter]''' with a [[StandardUnitFilter]] as argument. All units matching this filter are modified. Matches on recall list units too.
* Accepts generally the syntax inside of wml unit variables created by [store_unit] which can be viewed in a savefile or by using the :inspect command. Can add traits with immediate effect. Cannot remove things. Subtags with the same name must be written in the correct order to match them with the tag they are supposed to modify.
example usage (see also the test scenario):
[modify_unit]
[filter]
type=Troll Rocklobber
[/filter]
hitpoints=10
[modifications]
[trait]
# first trait is unmodified
[/trait]
{TRAIT_HEALTHY}# second trait is replaced with the healthy trait
[/modifications]
[/modify_unit]

note: The syntax allowed is somehow vage. Just try things and possibly correct/add/modify this documentation. (a [http://forums.wesnoth.org/viewtopic.php?f=21&t=31676& forum thread] discusses some related issues).

=== [petrify] ===
{{DevFeature1.9}}(This tag did never exist until r47553 (from 1.9.3 on), although it was already documented.)

* [[StandardUnitFilter]] as an argument. Do not use a [filter] tag. All units matching this filter are petrified. Recall list units are included.

=== [unpetrify] ===
* [[StandardUnitFilter]] as an argument. {{DevFeature1.9}}: Do not use a [filter] tag. All units matching this filter are unpetrified {{DevFeature1.9}}: recall list units included.

=== [object] ===
Gives some unit an object and removes all items on the tile the unit is on.
* '''id''': (Optional) when the object is picked up, a flag is set for ''id''. The object cannot be picked up if a flag for ''id'' has been set. This means that any object with an id can only be used once, even if first_time_only=no is set for the event. This restriction is per level. In a campaign objects with the same id can be assigned once per level.
* '''[effect]''': one or more effect elements may be listed. See [[EffectWML]] for a description of [effect].
* '''duration''': if 'level', effects only last until the end of the level (note : 'level' is the scenario, so this doesn't mean it last until the unit levels-up).
* '''[filter]''' with a [[StandardUnitFilter]] as argument. The first unit found that matches the filter will be given the object. If no unit matches the filter, then a message is displayed and the object is not removed.
* '''[then]''': a subtag that lets you execute actions if the filter conditions are met. The most common action that should be inside here is a '''[removeitem]''' tag, but you could probably put any tags that otherwise work in a [then] tag.
* '''silent''': whether or not messages should be suppressed. Default is "no".
* '''image''': the displayed image of the object.
* '''name''': (translatable) displayed as a caption of the image.

* '''description''': (translatable) displayed as a message of the image.
* '''cannot_use_message''': (translatable) displayed instead of '''description''' if no unit passes the filter test.
* If you do not supply a filter, the object action will be applied to a unit at the location of the moveto event. Currently this isn't recommended as it is not clear that this will continue working this way. Instead it is better to explicitly include a location filter.
* The object action does not act on units in the recall list. There is a feature request in to allow this, but it is not clear whether or not it will be accepted.

=== [remove_shroud] ===
Removes some shroud from the map for a certain side (only relevant for sides that have shroud=yes).
* '''side''': (default=1) the side for which to remove shroud.
* [[StandardLocationFilter]]: the range of tiles for which shroud should be removed.
=== [place_shroud] ===
Places some shroud on the map for a certain side (only relevant for sides that have shroud=yes).
* '''side''': (default=1) the side for which to place shroud.
* [[StandardLocationFilter]]: the range of tiles on which shroud should be placed.

=== [allow_undo] ===
Allows the player to undo the event that this tag is inside. Has an effect only inside moveto events. If the move is undone, only the position of the unit will be restored; any altered variables or changes to the game will remain changed after the move is undone. It is up to the scenario designer to avoid abusing this command.
* Technically, if '''[allow_undo]''' is inside an '''[event]''' with ''first_time_only=yes'' (the default setting), and the user undoes the event, then the state of the game has changed in this way: the event will not fire a second time, even though the user undid the move the first time.

=== [heal_unit] ===
Heal a unit. The variable '''$heal_amount''' will be set to the exact number of points healed (i.e can be lesser than the parameter '''amount''' if the unit is fully healed).
* '''[filter]''': [[StandardUnitFilter]] the first unit matching the filter will be healed.
* '''[filter_second]''': [[StandardUnitFilter]] all the units matching the filter ''and'' having the ''heals'' ability will have their animation played (if ''animate'' is set to true).
* '''amount''': the maximum points the unit will be healed.
* '''animate''': a boolean which indicate if the healing animations must be played.

=== [harm_unit] ===
{{DevFeature1.9}}Harms every unit matching the filter, for the specific damage amount.
* '''[filter]''': [[StandardUnitFilter]] all matching units will be harmed (required).
* '''amount''': the amount of damage that will be done (required).
* '''alignment''': (default neutral) applies an alignment to the damage, this means that if alignment=chaotic, the damage will be increased at night and reduced at day.
* '''damage_type''': if present, amount will be altered by unit resistance to the damage type specified.
* '''kill''': (default yes) if yes, when an harmed unit goes to or below 0 HP, it is killed; if no its HP are set to 1.
* '''fire_event''': (default no) if yes, when a unit is killed by harming, the corresponding events are fired.
* '''animate''': (default no) if yes, scrolls to each unit before harming it and plays its defense and death animations.
* '''[secondary_attack]''': sets the weapon against which the unit harmed will defend, to allow playing specific defense animations. Takes a weapon filter as argument, see [[FilterWML]].
* '''delay''': if animate=yes, sets the delay (in milliseconds, default 500) between each unit harming.
* '''variable''': if present, the damage caused to the unit, altered by resistances, will be stored in a WML array with the given name, under the "harm_amount" key.
* '''poisoned, slowed, petrified, unhealable''': (default no) if yes, every harmed unit that doesn't already have such status will have it set.

=== [time_area] ===
How a day should progress in a given area. Everywhere not specified in a [time_area] tag is affected by the [time] and [illuminated_time] tags in the [scenario] tag.
* [[StandardLocationFilter]]: the locations to affect.
* [[TimeWML]]: the new schedule.
* '''id''': an unique identifier assigned to a time_area. Optional, unless you want to remove the time_area later. Can be a comma-separated list when removing time_areas, see below.
* '''remove''': (boolean) yes/no value. Indicates whether the specified time_area should be removed. Requires an identifier. If no identifier is used, however, all time_areas are removed.

=== [end_turn] ===
End the current side's turn. {{DevFeature}} The current event is finished before the turn is ended. Also, if the current event (where the tag appears) has been fired by another event, that event (and the complete stack of other possible parent events) is ended before [end_turn] comes into affect. Also, events following the event stack that fired [end_turn] are not omitted (e.g. [end_turn] is used by a side turn event and a turn refresh event does something afterwards).

=== [replace_map] ===

Replaces the entire map.
* '''map''': path to a map file.
* '''expand''': if 'yes', allows the map size to increase. The expansion direction is currently always bottom-right.
* '''shrink''': if 'yes', allows the map size to decrease. If the map size is reduced, any units that would no longer be on the map due to its coordinates no longer existing will be put into the recall list.

=== [replace_schedule] ===
Replace the time of day schedule of the entire scenario. {{DevFeature1.9}}
* [[TimeWML]]: the new schedule.

=== [tunnel] ===

'''THIS TAG ISN'T YET PART OF ANY OFFICIAL WESNOTH RELEASE AND PERHAPS WILL NEVER BE AT THE STATE OF 1.9.2.'''

Create a tunnel between some locations, later usable by units to move from source hex to target hex (using the movement cost of unit on the target terrain). ([http://forums.wesnoth.org/viewtopic.php?f=21&t=14749&p=405667&hilit=tunnel#p405667 source])

* '''id''' identifier for the tunnel, to allow removing (optional).
* '''remove''': (boolean) yes/no value. If yes, removes all defined tunnels with the same ID (then only id= is necessary). (default: no)
* '''bidirectional''': (boolean) if yes, creates also a tunnel in the other direction. (default: yes)
* '''always_visible''': (boolean) if yes, the possible movement of enemies under fog can be seen. (default: no)
* '''[source]''': [[StandardLocationFilter]] the source hex(es) (required).
* '''[target]''': [[StandardLocationFilter]] the target hex(es) (required).
* '''[filter]''': [[StandardUnitFilter]] the units which can use the tunnel (required). Leave empty for "all units".

(Note: The tunnel tag can also be used inside the [[AbilitiesWML|[teleport]]] ability, without remove= and id=).

== Useful Macros ==
There are some predefined macros that you find useful for direct actions. You can find a complete list along with a detailed explanation of how they work [http://www.wesnoth.org/macro-reference.xhtml here].
* '''{MOVE_UNIT}''': Moves a unit to another location in the map and the player sees the movement (unlike [teleport])
* '''{FULL_HEAL}''': Brings a unit to full HP
* '''{LOYAL_UNIT}''': Create a loyal unit
* '''{MODIFY_TERRAIN_MASK}''': Modify an area of terrain

== See Also ==

* [[InternalActionsWML]]
* [[InterfaceActionsWML]]
* [[EventWML]]
* [[ReferenceWML]]

[[Category: WML Reference]]
[[Category: ActionsWML]]

User:Dovolente

2010-12-13T14:07:38Z

Dovolente:

I'm an English language instructor at a university in the southeastern United States. A long-time fantasy gaming enthusiast, I've enjoyed developing user-made content for many different games, including Wesnoth.

===Dov's MP Maps===
A collection of nonstandard multiplayer maps, including "Elf Chess" and the original versions of the much-modded scenarios "Orocia" and "Deep Shrine". See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=16798 Dov's MP Maps forum thread] for further details.

===XP Era===
A "mod" era which allows players to spend a unit's xp to purchase various stat upgrades. Based on work by itota. See the [http://forums.wesnoth.org/viewtopic.php?f=19&t=31477 XP Era forum thread] for further details.

===Settlers Era===
A multiplayer, "total mod" era which changes the game to a resource-collection game. Players start with a leader and 3 peasants (and in 'survival' mode, 3 military units). The map is converted to a "pre-civilization" stage, removing all built structures and roads. Peasants collect resources depending on their terrain, and can build villages, walls, and towers. The leader can spend resources to recruit more peasants or military units from villages. It is possible to win through conquest or through resource collection. See the [http://forums.wesnoth.org/viewtopic.php?f=19&t=20867 Settlers Era forum thread] for further details.

===Dajmara===
A single-player campaign featuring nonlinear play, strong RPG elements, and an extensive, original fantasy setting. Still in early stages of development.

===Wesband===
Wesband aspires to be a rogue-like dungeoncrawl multiplayer campaign for 1-4 players. I developed the basic concept and multiplayer framework, as well as the randomized starting map/towns and randomized dungeon levels. Ken Oh brought his excellent RPG work to the project, and he and others have since enhanced and improved the campaign immensely. See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=21234&start=15 Wesband forum discussion] for further details.

User:Dovolente

2010-12-13T14:05:21Z

Dovolente:

===Dov's MP Maps===
A collection of nonstandard multiplayer maps, including "Elf Chess" and the original versions of the much-modded scenarios "Orocia" and "Deep Shrine". See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=16798 Dov's MP Maps forum thread] for further details.

===XP Era===
A "mod" era which allows players to spend a unit's xp to purchase various stat upgrades. Based on work by itota. See the [http://forums.wesnoth.org/viewtopic.php?f=19&t=31477 XP Era forum thread] for further details.

===Settlers Era===
A multiplayer, "total mod" era which changes the game to a resource-collection game. Players start with a leader and 3 peasants (and in 'survival' mode, 3 military units). The map is converted to a "pre-civilization" stage, removing all built structures and roads. Peasants collect resources depending on their terrain, and can build villages, walls, and towers. The leader can spend resources to recruit more peasants or military units from villages. It is possible to win through conquest or through resource collection. See the [http://forums.wesnoth.org/viewtopic.php?f=19&t=20867 Settlers Era forum thread] for further details.

===Dajmara===
A single-player campaign featuring nonlinear play, strong RPG elements, and an extensive, original fantasy setting. Still in early stages of development.

===Wesband===
Wesband aspires to be a rogue-like dungeoncrawl multiplayer campaign for 1-4 players. I developed the basic concept and multiplayer framework, as well as the randomized starting map/towns and randomized dungeon levels. Ken Oh brought his excellent RPG work to the project, and he and others have since enhanced and improved the campaign immensely. See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=21234&start=15 Wesband forum discussion] for further details.

User:Dovolente

2010-09-21T11:52:56Z

Dovolente:

===Dov's MP Maps===
A collection of nonstandard play maps, including "Elf Chess" and the original versions of the much-modded scenarios "Orocia" and "Deep Shrine". See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=16798 Dov's MP Maps forum thread] for further details.

===XP Era===
A "mod" era which allows players to spend a unit's xp to purchase various stat upgrades. Based on work by itota. See the [http://forums.wesnoth.org/viewtopic.php?f=19&t=31477 XP Era forum thread] for further details.

===Settlers Era===
A "mod" era which changes the game to a resource-collection game. Players start with a leader and 3 peasants. The map is converted to a "pre-civilization" stage, removing all built structures and roads. Peasants collect resources depending on their terrain, and can build villages, walls, and towers. The leader can spend resources to recruit more peasants or military units from villages. It is possible to win through conquest or through resource collection. Available for Wesnoth 1.4 and 1.8 from the add-on server.

===Wesband===
I am no longer involved with development or maintanence, but it continues to be a favorite project. Wesband aspires to be a rogue-like dungeoncrawl campaign for 1-4 players. I developed the basic concept and multiplayer framework, as well as the randomized starting map/towns and randomized dungeon levels. Ken Oh brought his excellent RPG work to the project, and he and others have since enhanced and improved the campaign immensely. See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=21234&start=15 Wesband forum discussion] for further details.

User:Dovolente

2008-05-24T02:12:29Z

Dovolente:

===Dov's MP Maps===
A collection of nonstandard play maps, including the frequently-played survival scenarios "Orocia" and "Deep Shrine", as well as a simple resource management era "Settlers of Catampir". Available on the 1.4 download server. See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=16798 Dov's MP Maps forum thread] for further details.

===Wesband===
A rogue-like dungeoncrawl campaign for 1-3 players, Wesband is being developed in collaboration with others, most notably Ken Oh, who will be using the campaign to showcase his RPG era. Being developed for 1.5, the campaign is still very early in development but features a functioning randomized starting town map and randomized dungeon levels. See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=21234&start=15 Wesband forum discussion] for further details.

User:Dovolente

2008-05-24T02:11:11Z

Dovolente:

===Dov's MP Maps===
A collection of nonstandard play maps, including the frequently-played survival scenarios "Orocia" and "Deep Shrine", as well as a simple resource management era "Settlers of Catampir". Available on the 1.4 download server. See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=16798 Dov's MP Maps forum thread] for further details.

===Wesband===
A rogue-like dungeoncrawl campaign for 1-3 players, Wesband is being developed in collaboration with others, most notably Ken Oh, who will be using the campaign to showcase his RPG era. It is very early in development but currently features a functioning randomized starting town map and randomized dungeon levels. See the [http://www.wesnoth.org/forum/viewtopic.php?f=15&t=21234&start=15 Wesband forum discussion] for further details.

User:Dovolente

2008-04-08T13:20:16Z

Dovolente:

Current Projects:

*Dov's MP Maps - A collection of nonstandard play maps. Available on the 1.4 download server.

*Settler of Catampir Era - A simple resource-collection era inspired by Age of Empires and Settlers of Catan. Peasants automatically collect resources based on the terrain, and build villages, walls, and towers. Leaders recruit new units from the villages.

User:Dovolente

2007-09-14T16:57:22Z

Dovolente:

Current Projects:

*Dov's MP Maps - A collection of nonstandard play maps. Available on the 1.2 download server.

*Settler's Era - An Age-of-Empires-inspired "era" in which peasants automatically collect resources based on the terrain, build villages, walls, and towers, and recruit armies to battle other players