The Battle for Wesnoth Wiki - User contributions [en]

MapGeneratorWML

2025-06-06T06:04:42Z

Beetlenaut: Reworded the text at the top to make it current. Removed all the information about the cave generator tags that appeared before the note saying that it was removed.

Map Generator WML is used to create scenarios which are randomly generated. Of course, any scenario may reconfigure itself during a start / prestart event as much as it likes, using randomness, but the Map Generator WML has the following advantages:

* Wesnoth has several built-in map generators which can be configured with options, and these are much better developed than any existing pure WML options.
* Map generation occurs before the scenario is even loaded, something which is not possible for WML events. In an mp game, the map generator code will run only on the host, side-stepping any synchronization issues, and keeping your scenario code as simple as possible.
* For scenarios with "allow_new_game=yes" and which use map generators, the generator may be reconfigured in the mp create screen (assuming that someone has coded a dialog for it). The user can also select to regenerate the map and get instant feedback from the minimap display.

== Scenario vs map generation ==

Every map generator can be used in either '''scenario_generation''' mode or '''map_generation''' mode. In map_generation mode, the generator is only used to replace the map_data of your scenario. In scenario_generation mode, the entire [scenario] tag is replaced.

To select a map generator and mode, in your [scenario] tag you must place '''one of'''
* '''scenario_generation=algorithm'''
* '''map_generation=algorithm'''
where '''algorithm''' is the generator algorithm you want to use. Note that not every algorithm is designed to be use with both of these options.

You must additionally place a [generator] tag in your scenario, which contains the options to the map generator.

The [scenario] tag must leave both '''map_data''' and '''map_file''' unset, or set them to empty strings, otherwise the behavior is implementation defined; the engine might assume that the generator has already been run, and skip running it.

== [generator] ==

The exact things that should be placed in [generator] depend on what algorithm you pick. There are two kinds of generators, '''default''' and '''lua'''
For which key to use and what value, see the section for the generator you want to use.

===The lua generator===
The lua generator type specifies a custom map generator, which you provide via lua scripts.

The following keys are recognized for '''[generator]''' when the lua generator is used:
* '''create_map''' : A lua routine which returns a string containing the new map_data. The entire contents of the '''[generator]''' are passed to the script in a lua table (see [[LuaWML]]), via the argument '''...''' (see http://www.lua.org/pil/5.2.html).
* '''create_scenario''' : The same, but returning a '''[scenario]''' tag for the new scenario, as a lua table.

Any other keys are used only by the lua script.

The following keys of the output [scenario] are specifically watched by the mp create screen:
* '''id'''
* '''name'''
* '''description'''
* '''error_message'''

====Available Lua API====
Most of the usual in-game API, in the table '''wesnoth''', is not available to lua scripts. However the usual standard lua libs are available, and a random number generator object is available from the Rng table. This is an instance of the Mersenne Twister 19937 random number generator from the C++11 standard.

* '''rng = Rng:create()''' : creates a new rng object
* '''rng:seed()''' : seed an rng, expects a string in hexadecimal format
* '''rng:draw()''' : draw a 32-bit random integer from the rng

It is highly recomended NOT to use the math.random function in random map generators, becasue math.random breaks the 'seed' function for random map generators in the editor.

{{DevFeature1.13}} In 1.13.x, this is no longer the case; much of the '''wesnoth''' table is available, including (but not limited to) '''wesnoth.random''' and '''wesnoth.find_path'''. However, there are still many things that are not available. You can open a Lua console to experiment and find out what's allowed by calling '''wesnoth.show_lua_console''' at some point in your map generator script. The '''Rng''' table no longer exists, having been superceded by '''wesnoth.random'''.

===The Default Generator===
The default generator can be used to generate map data for any scenario. The data in this section is inferred from “data/multiplayer/scenarios/Random_Scenario.cfg”, usage in add-on content, and inspection of mapgen.cpp

'''Excerpt from mapgenerator comments:'''

* Basically we generate alot of hills, each hill being centered at a certain point, with a certain radius - being a half sphere. Hills are combined additively to form a bumpy surface. The size of each hill varies randomly from 1-hill_size. We generate 'iterations' hills in total. The range of heights is normalized to 0-1000. 'island_size' controls whether or not the map should tend toward an island shape, and if so, how large the island should be. Hills with centers that are more than 'island_size' away from the center of the map will be inverted (i.e. be valleys). 'island_size' as 0 indicates no island.

To use the default '''[generator]''' your '''[scenario]''' tag must contain one of the following keys:
* '''scenario_generation=default'''
* '''map_generation=default'''
If ‘scenario_generation’ is used, the engine will expect for your entire '''[scenario]''' sub tags to be inside a '''[scenario]''' tag inside '''[generator]'''. Tags outside of this will be ignored. There may be value in this, but at this writing, it’s not clear.
‘map_generation=default’ is simpler and more commonly used. It is also necessary to use this key so that you can regenerate a map in MP game creation.
In its use only generator data is in the '''[generator]''' tag, all other '''[scenario]''' data is placed outside of it. The exception is if you are making an initial MP scenario available in MP game creation, for this a '''[scenario]''' tag must appear inside of '''[generator]''', containing the '''[scenario]''' subtags you want to use. See “data/multiplayer/scenarios/Random_Scenario.cfg” for an example.

The following key/tags are recognized for '''[generator]''' when the default generator is used:
* '''[scenario]''': See [[ScenarioWML]]
* '''name'''
** '''default'''
* '''map_width''','''map_height''': size of the map to generate
* '''iterations''': the number of times an attempt is being made to generate a hill
* '''hill_size''': hills will have a random size between 1 and ''hill_size''
* '''max_lakes''': the number of times an attempt is being made to generate a lake
* '''min_lake_height''': lakes are the starting point of rivers and need to start above a certain height
* '''lake_size''': the size of a lake still randomly generated
* '''river_frequency''': determine how much a river can run uphill and thus generate more rivers

* '''villages''': villages per 1,000 hexes
* '''players''': Number of starting locations for the map.
* '''castle_size''': Number of castle tiles (including the keep), per player.
* '''temperature_iterations''': Same as iterations, but for the temperature map.
* '''temperature_size''': Same as hill_size, but for the temperature map. (Temperature map is generated the same way as a hill map, but is hard coded with a island_size of 0.)
* '''roads''': number of roads the generator will attempt to make
* '''road_windiness''': Use 1 for the road to be made using the cheapest path (based on [road_cost] tags), higher values introduce randomness to make the road wind a bit.
* '''island_size''': Use 1-5 for coastal maps and 6-10 for island maps. Bigger values may crash map generation process. Bigger numbers makes more water (and less land)
* '''default_flatland''': If not specified, is Grassland. If your height tags don't go down to 0, the default_flatland will be used (possibly in other cases as well).
* '''[height]''': list of common terrain types that come in at different heights, from highest to lowest. Good WML will have the range of 1000-0 covered.
** '''height''': the terrain specified below will appear at this height and up.
** '''terrain''': 1 terrain code
* '''[convert]''': used to make terrain conversions. For example, water becomes ice at low temperatures, grass snow, etc. If the terrain is between the min_x and max_x it will be converted. If min_x is not defined it will default to a large negative number. If max_x is not defined it will default to a large positive number
** '''min_height'''
** '''max_height'''
** '''min_temperature'''
** '''max_temperature'''
** '''from''': a comma separated terrains to convert from
** '''to''': The terrain to convert these terrains to
* '''[road_cost]'''
** '''terrain''' 1 terrain code
** '''cost''': how expensive it is the create a road on this terrain, this influences the odds of this terrain getting a road
** '''convert_to_bridge''': a comma separated list of terrains; N/S, then NE/SW, then NW/SE.
** '''convert_to''': 1 terrain code (note using both ''convert_to_bridge'' and ''convert_to'' might result in unwanted results)
* '''[village]''': The conversion of terrains to villages
** '''terrain''': 1 terrain code which will be converted to a village
** '''convert_to''': 1 terrain code for the village
** '''adjacent_liked''': a comma separated terrain list. This list increases the rating for a certain location, every tile around the location will be tested against this list and for every match the rating of the location is increased. The same terrain twice in the list will double the rating increase for that location.
** '''rating''': chance of appearing
* '''[castle]''': the conversion of castles
** '''valid_terrain''': a comma-separated terrain list with terrains which are allowed to be converted to a castle.
** '''min_distance''': all castles generated must be this number of hexes apart from each other
* '''[naming]''': The names used to label landscape features (forests, lakes, etc.). This controls, for example, the "Sal" part of "Sal's Crossing". If this tag is empty, those labels should be suppressed. (Due to a bug, they are not suppressed prior to 1.11.1.) The predefined macro VILLAGE_NAMES is one option for the contents of this tag. If that macro is not used, this tag takes one key.
** {{DevFeature1.13|5}}
*** The new [[Context-free grammar|Context-free grammar name]] (CFG) generator is now supported
*** '''male_names''' is now deprecated. Use '''base_names''' for the Markov-chain based or '''base_name_generator''' for the CFG generator instead
*** It is now possible to have generator-specific overrides of the default naming rules which are defined in "data/english.cfg". You may override the following naming rules by adding them to the [naming] tag of your generator instance:
{| class="wikitable"
!Key
!Supported variables
|-
|bridge_name_generator=
|$base
|-
|road_name_generator=
|$base
|-
|river_name_generator=
|$base
|-
|forest_name_generator=
|$base
|-
|lake_name_generator=
|$base
|-
|mountain_name_generator=
|$base
|-
|swamp_name_generator=
|$base
|}

* '''[village_naming]''': The names used to label villages. This controls, for example, the "Fox" part of "Foxham". If this tag is empty, those labels should be suppressed. (Due to a bug, they are not suppressed prior to 1.11.1.) The predefined macro VILLAGE_NAMES is one option for the contents of this tag. If that macro is not used, this tag takes one key. The village naming depends on the adjacent landscape features, e.g. a village near a forest with the name "Rock Forest" may be named "Rockwood".
** '''male_names'''
** {{DevFeature1.13|5}}
*** The new [[Context-free grammar|Context-free grammar name]] (CFG) generator is now supported
*** '''male_names''' is now deprecated. Use '''base_names''' for the Markov-chain based or '''base_name_generator''' for the CFG generator instead
*** It is now possible to have generator-specific overrides of the default village naming rules which are defined in "data/english.cfg". You may override the following village naming rules by adding them to the [village_naming] tag of your generator instance:
{| class="wikitable"
!Key
!Supported variables
|-
|name_generator=
|$base
|-
|lake_name_generator=
|$base, $lake
|-
|river_name_generator=
|$base, $river
|-
|bridge_name_generator=
|$base, $river, $bridge
|-
|grassland_name_generator=
|$base
|-
|forest_name_generator=
|$base, $forest
|-
|hill_name_generator=
|$base
|-
|mountain_name_generator=
|$base, $mountain
|-
|mountain_anon_name_generator=
|$base
|-
|road_name_generator=
|$base, $road
|-
|swamp_name_generator=
|$base, $swamp
|}

===The Cave Generator===
The cave generator generates a system of chambers and passages similar to the levels in dungeon crawling games like Rogue.

{{DevFeature1.13|6}}
The cave map generator has been moved to Lua, so '''scenario_generation=cave''' and '''map_generation=cave''' are no longer supported. Use one of the following setups instead:
* Map generation:
:<syntaxhighlight lang=wml>
map_generation=lua
[generator]
create_map = << return wesnoth.require("cave_map_generator").generate_map(...) >>
# ... other stuff ...
[/generator]
</syntaxhighlight>

* Scenario generation:
:<syntaxhighlight lang=wml>
scenario_generation=lua
[generator]
create_scenario = << return wesnoth.require("cave_map_generator").generate_scenario(...) >>
# ... other stuff ...
[/generator]
</syntaxhighlight>

The [generator] supports the same syntax if using '''scenario_generation''', but has the following differences when using '''map_generation''':
* '''[items]''' is not supported. Use one or multiple '''[item_location]''' instead. This will generate starting locations or other special locations in the map data with the given id; '''place_castle = yes''' can be set in '''[item_location]''' to make the generator create a castle at this location.
* '''[settings]''' is not supported - '[event]s' and '[side]s' now go directly in '''[scenario]'''

== Infrastructure ==

* The default generator settings are loaded from a scenario file under data/multiplayer/scenarios.
* mapgen_dialog overwrites these values if necessary.
* The create_map / create_scenario function is called by one of the following
** multiplayer_create_engine.cpp:394
** context_manager.cpp:648
** map_create.cpp:56
* A map buffer is written to res["map_data"]
* the config res is passed to the calling function.

== See Also ==

* [[LuaMapGenerator]]
* [[TerrainCodesWML]]
* [[ScenarioWML]]
* [[ReferenceWML]]

[[Category: WML Reference]]

Template:WML Tags

2023-05-05T10:13:50Z

Beetlenaut: Alphabatizes "achievements" correctly.

{| class="reference-sidebar"
|-
|
[[{{SERVER}}{{localurl:Template:WML Tags|action=edit}} edit]]'''WML Tags'''
|-
|''A:''
[[AbilitiesWML|abilities]],
[[CreditsWML#.5Babout.5D|about]],
[[AchievementsWML|achievement]],
[[AchievementsWML|achievement_group]],
[[Creating_Custom_AIs#Behavior_Candidate_Actions|add_ai_behavior]],
[[SingleUnitWML|advance]],
[[AdvancedPreferenceWML|advanced_preference]],
[[UnitTypeWML|advancefrom]],
[[UnitTypeWML#After_max_level_advancement_.28AMLA.29|advancement]],
[[StatisticalScenarioWML#The_.5Bteam.5D_tag|advances]],
[[AbilitiesWML#Common_keys_and_tags_for_every_ability|affect_adjacent]],
[[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Top-level_Elements|ai]],
[[StandardSideFilter|allied_with]],
[[DirectActionsWML#.5Ballow_end_turn.5D|allow_end_turn]],
[[DirectActionsWML#.5Ballow_extra_recruit.5D|allow_extra_recruit]],
[[DirectActionsWML#.5Ballow_recruit.5D|allow_recruit]],
[[DirectActionsWML#.5Ballow_undo.5D|allow_undo]],
[[ConditionalActionsWML#Meta-Condition_Tags|and]],
[[InterfaceActionsWML#.5Banimate_unit.5D|animate]],
[[InterfaceActionsWML#.5Banimate_unit.5D|animate_unit]],
[[AnimationWML|animation]],
[[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Aspects|aspect]],
attack ([[ReplayWML|replay]], [[UnitTypeWML#Attacks|weapon]]),
[[AnimationWML|attack_anim]],
attacks ([[AbilitiesWML#The_.5Bspecials.5D_tag|special]], [[StatisticalScenarioWML#The_.5Bteam.5D_tag|stats]]),
[[AiWML#List_of_AI_Aspects|avoid]];
|-
|''B:''
[[UnitTypeWML#Other_tags|base_unit]],
[[IntroWML#.5Bbackground_layer.5D|background_layer]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|berserk]],
[[BinaryPathWML|binary_path]],
[[InternalActionsWML#Flow_control_actions|break]],
[[EditorWML#The_.5Bbrush.5D_tag|brush]];
|-
|''C:''
[[CampaignWML#The_.5Bcampaign.5D_tag|campaign]],
[[DirectActionsWML#.5Bcancel_action.5D|cancel_action]],
[[Wesnoth_AI_Framework#The_.5Bcandidate_action.5D_Tag|candidate_action]],
[[DirectActionsWML#.5Bcapture_village.5D|capture_village]],
[[ConditionalActionsWML#.5Bswitch.5D|case]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|chance_to_hit]],
[[InterfaceActionsWML#.5Bchange_theme.5D|change_theme]],
[[InterfaceActionsWML#.5Bchat.5D|chat]],
[[OptionWML|checkbox]],
[[OptionWML|choice]],
[[ReplayWML|choose]],
[[PersistenceWML|clear_global_variable]],
[[InterfaceActionsWML#.5Bclear_menu_item.5D|clear_menu_item]],
[[InternalActionsWML#.5Bclear_variable.5D|clear_variable]],
[[InterfaceActionsWML#.5Bcolor_adjust.5D|color_adjust]],
[[GameConfigWML#Color_Palettes|color_palette]],
[[GameConfigWML#Color_Palettes|color_range]],
command ([[ConditionalActionsWML#.5Bcommand.5D|action]], [[ReplayWML|replay]]),
[[InternalActionsWML#Flow_control_actions|continue]],
[[CreditsWML#.5Bcredits_group.5D|credits_group]],
[[AiWML#The_.5Bgoal.5D_Tag|criteria]];
|-
|''D:''
[[AbilitiesWML#The_.5Bspecials.5D_tag|damage]],
[[AnimationWML#death|death]],
[[StatisticalScenarioWML#The_.5Bteam.5D_tag|deaths]],
[[AnimationWML#default|default]],
[[AnimationWML#defend|defend]],
[[StatisticalScenarioWML#The_.5Bteam.5D_tag|defends]],
[[UnitsWML#.5Bmovetype.5D|defense]],
[[InterfaceActionsWML#.5Bdelay.5D|delay]],
[[InterfaceActionsWML#.5Bdeprecated_message.5D|deprecated_message]],
[[ReplayWML|destination]],
[[CampaignWML|difficulty]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|disable]],
[[DirectActionsWML#.5Bdisallow_end_turn.5D|disallow_end_turn]],
[[DirectActionsWML#.5Bdisallow_extra_recruit.5D|disallow_extra_recruit]],
[[DirectActionsWML#.5Bdisallow_recruit.5D|disallow_recruit]],
[[ConditionalActionsWML#.5Bwhile.5D|do]],
[[DirectActionsWML#.5Bdo_command.5D|do_command]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|drains]],
[[AnimationWML#draw_weapon_anim|draw_weapon_anim]];
|-
|''E:''
[[EditorWML#The_.5Beditor_group.5D_tag|editor_group]],
[[EditorWML#The_.5Beditor_music.5D_tag|editor_music]],
[[EditorWML#The_.5Beditor_times.5D_tag|editor_times]],
[[EffectWML|effect]],
else ([[ConditionalActionsWML#.5Bif.5D|action]], [[AnimationWML#.5Bif.5D_and_.5Belse.5D|animation]]), [[ConditionalActionsWML#.5Bif.5D|elseif]],
[[DirectActionsWML#.5Bendlevel.5D|endlevel]],
end_turn ([[DirectActionsWML#.5Bend_turn.5D|action]], [[ReplayWML|replay]]),
[[StandardSideFilter|enemy_of]],
[[Wesnoth_AI_Framework#Available_Engines|engine]],
entry ([[CreditsWML#.5Bentry.5D|credits]], [[OptionWML|options]]),
[[EraWML|era]],
[[EventWML|event]],
[[AnimationWML#Simplified_animation_blocks|extra_anim]];
|-
|''F:''
[[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Aspects|facet]],
[[InterfaceActionsWML#.5Banimate_unit.5D|facing]],
[[InterfaceActionsWML#.5Bmove_units_fake.5D|fake_unit]],
[[ConditionalActionsWML#.5Bfalse.5D|false]],
[[PblWML#.5Bfeedback.5D|feedback]],
[[UnitTypeWML#Other_tags|female]],
filter ([[FilterWML|concept]], [[EventWML#.5Bfilter.5D|event]]),
[[StandardUnitFilter|filter_adjacent]],
[[StandardLocationFilter|filter_adjacent_location]],
[[FilterWML#Filtering_Weapons|filter_attack]],
[[AbilitiesWML#Common_keys_and_tags_for_every_weapon_special|filter_attacker]],
[[AbilitiesWML#Common_keys_and_tags_for_every_ability|filter_base_value]],
[[EventWML#.5Bfilter_condition.5D|filter_condition]],
[[AbilitiesWML#Common_keys_and_tags_for_every_weapon_special|filter_defender]],
[[AiWML#Filtering_Combat_with_the_.27attacks.27_Aspect|filter_enemy]],
[[StandardLocationFilter|filter_location]],
[[AbilitiesWML#Common_keys_and_tags_for_every_weapon_special|filter_opponent]],
[[AiWML#Filtering_Combat_with_the_.27attacks.27_Aspect|filter_own]],
[[StandardLocationFilter|filter_owner]],
[[StandardLocationFilter|filter_radius]],
[[SingleUnitWML|filter_recall]],
[[StandardUnitFilter|filter_second]],
[[FilterWML#Filtering_Weapons|filter_second_attack]],
[[AbilitiesWML|filter_self]],
[[StandardSideFilter|filter_side]],
[[AbilitiesWML|filter_student]],
[[FilterWML#Filtering_Vision|filter_vision]],
[[AbilitiesWML#Common_keys_and_tags_for_every_weapon_special|filter_weapon]],
[[FilterWML#Filtering_on_WML_data|filter_wml]],
[[InternalActionsWML#.5Bfind_path.5D|find_path]],
[[InternalActionsWML#.5Bfire_event.5D|fire_event]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|firststrike]],
[[InterfaceActionsWML#.5Bfloating_text.5D|floating_text]],
[[ConditionalActionsWML#.5Bfound_item.5D|found_item]],
[[ConditionalActionsWML#.5Bfor.5D|for]],
[[ConditionalActionsWML#.5Bforeach.5D|foreach]],
[[AnimationWML#Frames|frame]];
|-
|''G:''
[[GameConfigWML|game_config]],
[[PersistenceWML|get_global_variable]],
[[AiWML#The_.5Bgoal.5D_Tag|goal]],
[[DirectActionsWML#.5Bgold.5D|gold]],
[[InterfaceActionsWML#.5Bobjectives.5D|gold_carryover]];
|-
|''H:''
[[DirectActionsWML#.5Bharm_unit.5D|harm_unit]],
[[StandardSideFilter|has_ally]],
[[StandardUnitFilter|has_attack]],
[[StandardSideFilter|has_unit]],
[[ConditionalActionsWML#.5Bhas_achievement.5D|has_achievement]],
[[ConditionalActionsWML#.5Bhave_location.5D|have_location]],
[[ConditionalActionsWML#.5Bhave_unit.5D|have_unit]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|heal_on_hit]],
[[DirectActionsWML#.5Bheal_unit.5D|heal_unit]],
[[AnimationWML#healed|healed_anim]],
[[AnimationWML#healing|healing_anim]],
[[AbilitiesWML|heals]],
[[UnitsWML#.5Bhide_help.5D|hide_help]],
[[InterfaceActionsWML#.5Bhide_unit.5D|hide_unit]],
[[AbilitiesWML|hides]];
|-
|''I:''
[[AnimationWML#idling|idle_anim]],
if ([[ConditionalActionsWML#.5Bif.5D|action]], [[AnimationWML#.5Bif.5D_and_.5Belse.5D|animation]], [[IntroWML|intro]]),
[[AbilitiesWML|illuminates]],
image ([[IntroWML#.5Bimage.5D|intro]], [[TerrainGraphicsWML|terrain]]),
[[ReplayWML|init_side]],
[[InternalActionsWML#.5Binsert_tag.5D|insert_tag]],
[[InterfaceActionsWML#.5Binspect.5D|inspect]],
[[InterfaceActionsWML#.5Bitem.5D|item]],
[[EditorWML#The_.5Bitem_group.5D_tag|item_group]];
|-
|''J:''
[[UnitsWML#.5Bmovetype.5D|jamming_costs]],
[[InternalActionsWML#.5Bset_variable.5D|join]];
|-
|''K:''
[[DirectActionsWML#.5Bkill.5D|kill]],
[[StatisticalScenarioWML|killed]];
|-
|''L:''
[[InterfaceActionsWML#.5Blabel.5D|label]],
[[LanguageWML|language]],
[[SideWML|leader]],
[[AiWML#List_of_AI_Aspects|leader_goal]],
[[AbilitiesWML|leadership]],
[[AnimationWML#leading|leading_anim]],
[[AnimationWML#levelin|levelin_anim]],
[[AnimationWML#levelout|levelout_anim]],
[[DirectActionsWML#.5Blift_fog.5D|lift_fog]],
[[AI_Recruitment#Aspect_recruitment_instructions|limit]],
[[InternalActionsWML#.5Bset_variables.5D|literal]],
[[AddonsWML|load_resource]],
[[LocaleWML|locale]],
[[InterfaceActionsWML#.5Block_view.5D|lock_view]],
[[LuaWML|lua]];
|-
|''M:''
[[UnitTypeWML#Other_tags|male]],
[[SavefileWML|menu_item]],
[[InterfaceActionsWML#.5Bmessage.5D|message]],
[[Micro AIs|micro_ai]],
[[AnimationWML#The_content_of_a_frame|missile_frame]],
[[ModificationWML|modification]],
[[SingleUnitWML|modifications]],
[[DirectActionsWML#.5Bmodify_ai.5D|modify_ai]],
[[DirectActionsWML#.5Bmodify_side.5D|modify_side]],
[[DirectActionsWML#.5Bmodify_turns.5D|modify_turns]],
[[DirectActionsWML#.5Bmodify_unit.5D|modify_unit]],
[[AddonsWML|modify_unit_type]],
[[ReplayWML|move]],
[[DirectActionsWML#.5Bmove_unit.5D|move_unit]],
[[InterfaceActionsWML#.5Bmove_unit_fake.5D|move_unit_fake]],
[[InterfaceActionsWML#.5Bmove_units_fake.5D|move_units_fake]],
[[AnimationWML#movement|movement_anim]],
[[UnitsWML#.5Bmovetype.5D|movement costs]],
[[UnitsWML#.5Bmovetype.5D|movetype]],
[[ScenarioWML|multiplayer]],
[[EraWML#Defining_Factions|multiplayer_side]],
[[MusicListWML#.5Bmusic.5D|music]];
|-
|''N:''
[[ConditionalActionsWML#Meta-Condition_Tags|not]],
[[InterfaceActionsWML#.5Bobjectives.5D|note]];
|-
|''O:''
[[DirectActionsWML#.5Bobject.5D|object]],
[[InterfaceActionsWML#.5Bobjectives.5D|objective]],
[[InterfaceActionsWML#.5Bobjectives.5D|objectives]],
[[DirectActionsWML#.5Bon_undo.5D|on_undo]],
[[InterfaceActionsWML#.5Bopen_help.5D|open_help]],
[[InterfaceActionsWML#.5Bmessage.5D|option]],
[[OptionWML|options]],
[[ConditionalActionsWML#Meta-Condition_Tags|or]];
|-
|''P:''
[[IntroWML|part]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|petrifies]],
[[DirectActionsWML#.5Bpetrify.5D|petrify]],
[[DirectActionsWML#.5Bplace_shroud.5D|place_shroud]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|plague]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|poison]],
[[UnitTypeWML#Other_tags|portrait]],
[[AnimationWML#post_movement|post_movement_anim]],
[[AnimationWML#pre_movement|pre_movement_anim]],
[[InternalActionsWML#.5Bfire_event.5D|primary_attack]],
[[InternalActionsWML#.5Bfire_event.5D|primary_unit]],
[[InterfaceActionsWML#.5Bprint.5D|print]],
[[DirectActionsWML#.5Bprogress_achievement.5D|progress_achievement]],
[[DirectActionsWML#.5Bput_to_recall_list.5D|put_to_recall_list]];
|-
|''R:''
[[UnitsWML#.5Brace.5D|race]],
[[InternalActionsWML#.5Brandom_placement.5D|random_placement]],
recall ([[DirectActionsWML#.5Brecall.5D|action]], [[ReplayWML|replay]]),
[[StatisticalScenarioWML|recalls]],
[[ReplayWML|recruit]],
[[AnimationWML#recruited|recruit_anim]],
[[AnimationWML#recruiting|recruiting_anim]],
[[StatisticalScenarioWML|recruits]],
[[InterfaceActionsWML#.5Bredraw.5D|redraw]],
[[AbilitiesWML|regenerate]],
[[InternalActionsWML#.5Bremove_event.5D|remove_event]],
[[InterfaceActionsWML#.5Bremove_item.5D|remove_item]],
[[DirectActionsWML#.5Bremove_object.5D|remove_object]],
[[DirectActionsWML#.5Bremove_shroud.5D|remove_shroud]],
[[InterfaceActionsWML#.5Bremove_sound_source.5D|remove_sound_source]],
[[DirectActionsWML#.5Bremove_time_area.5D|remove_time_area]],
[[DirectActionsWML#.5Bremove_trait.5D|remove_trait]],
[[InterfaceActionsWML#.5Bremove_unit_overlay.5D|remove_unit_overlay]],
[[ConditionalActionsWML#.5Brepeat.5D|repeat]],
[[DirectActionsWML#.5Breplace_map.5D|replace_map]],
[[DirectActionsWML#.5Breplace_schedule.5D|replace_schedule]],
[[ReplayWML|replay]],
[[SavefileWML|replay_start]],
[[DirectActionsWML#.5Breset_fog.5D|reset_fog]],
resistance ([[AbilitiesWML|ability]], [[UnitsWML#.5Bmovetype.5D|unit]]),
[[UnitsWML#.5Bresistance_defaults.5D|resistance_defaults]],
[[ModificationWML#The_.5Bresource.5D_toplevel_tag|resource]],
[[InternalActionsWML#Flow_control_actions|return]],
[[InternalActionsWML#.5Brole.5D|role]],
[[TerrainMaskWML|rule]];
|-
|''S:''
[[SavefileWML|save]],
[[ScenarioWML|scenario]],
[[InterfaceActionsWML#.5Bscreen_fade.5D|screen_fade]],
[[InterfaceActionsWML#.5Bscroll.5D|scroll]],
[[InterfaceActionsWML#.5Bscroll_to.5D|scroll_to]],
[[InterfaceActionsWML#.5Bscroll_to_unit.5D|scroll_to_unit]],
[[InternalActionsWML#.5Bfire_event.5D|secondary_attack]],
[[InternalActionsWML#.5Bfire_event.5D|secondary_unit]],
[[HelpWML|section]],
[[InterfaceActionsWML#.5Bselect_unit.5D|select_unit]],
[[ReplayWML|sequence]],
[[DirectActionsWML#.5Bset_achievement.5D|set_achievement]],
[[DirectActionsWML#.5Bset_extra_recruit.5D|set_extra_recruit]],
[[PersistenceWML|set_global_variable]],
[[InterfaceActionsWML#.5Bset_menu_item.5D|set_menu_item]],
[[DirectActionsWML#.5Bset_recruit.5D|set_recruit]],
[[EffectWML|set_specials]],
[[InternalActionsWML#.5Bset_variable.5D|set_variable]],
[[InternalActionsWML#.5Bset_variables.5D|set_variables]],
[[AnimationWML#sheath_weapon|sheath_weapon_anim]],
show_if ([[InterfaceActionsWML#.5Bmessage.5D|message]],
[[InterfaceActionsWML#.5Bobjectives.5D|objective]],
[[InterfaceActionsWML#.5Bset_menu_item.5D|set_menu_item]]),
[[InterfaceActionsWML#.5Bshow_objectives.5D|show_objectives]],
[[SideWML|side]],
[[AbilitiesWML|skirmisher]],
[[OptionWML|slider]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|slow]],
[[SavefileWML|snapshot]],
[[InterfaceActionsWML#.5Bsound.5D|sound]],
[[InterfaceActionsWML#.5Bsound_source.5D|sound_source]],
source ([[ReplayWML|replay]], [[DirectActionsWML#.5Btunnel.5D|teleport]]),
[[UnitTypeWML#Other_tags|special_note]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|specials]],
[[InternalActionsWML#.5Bset_variables.5D|split]],
[[Wesnoth_AI_Framework#Available_Stages|stage]],
[[AnimationWML#standing|standing_anim]],
[[StatisticalScenarioWML#The_.5Bstatistics.5D_tag|statistics]],
[[SingleUnitWML|status]],
[[InternalActionsWML#.5Bstore_gold.5D|store_gold]],
[[InternalActionsWML#.5Bstore_items.5D|store_items]],
[[InternalActionsWML#.5Bstore_locations.5D|store_locations]],
[[InternalActionsWML#.5Bstore_map_dimensions.5D|store_map_dimensions]],
[[InternalActionsWML#.5Bstore_reachable_locations.5D|store_reachable_locations]],
[[InternalActionsWML#.5Bstore_relative_direction.5D|store_relative_direction]],
[[InternalActionsWML#.5Bstore_side.5D|store_side]],
[[InternalActionsWML#.5Bstore_starting_location.5D|store_starting_location]],
[[InternalActionsWML#.5Bstore_time_of_day.5D|store_time_of_day]],
[[InternalActionsWML#.5Bstore_turns.5D|store_turns]],
[[InternalActionsWML#.5Bstore_unit.5D|store_unit]],
[[InternalActionsWML#.5Bstore_unit_defense.5D|store_unit_defense]],
[[InternalActionsWML#.5Bstore_unit_defense_on.5D|store_unit_defense_on]],
[[InternalActionsWML#.5Bstore_unit_type.5D|store_unit_type]],
[[InternalActionsWML#.5Bstore_unit_type_ids.5D|store_unit_type_ids]],
[[InternalActionsWML#.5Bstore_villages.5D|store_villages]],
[[IntroWML|story]],
[[AbilitiesWML#The_.5Bspecials.5D_tag|swarm]],
[[ConditionalActionsWML#.5Bswitch.5D|switch]],
[[InternalActionsWML#.5Bsync_variable.5D|sync_variable]];
|-
|''T:''
[[DirectActionsWML#.5Btunnel.5D|target]],
[[StatisticalScenarioWML#The_.5Bteam.5D_tag|team]],
teleport ([[AbilitiesWML|ability]], [[DirectActionsWML#.5Bteleport.5D|action]]),
[[AnimationWML#pre_teleport|teleport_anim]],
[[DirectActionsWML#.5Bterrain.5D|terrain]],
[[UnitsWML#.5Bterrain_defaults.5D|terrain_defaults]],
[[TerrainGraphicsWML|terrain_graphics]],
[[TerrainMaskWML|terrain_mask]],
[[TerrainWML|terrain_type]],
[[ScenarioWML#Test_scenario|test]],
[[InterfaceActionsWML#.5Btest_condition.5D|test_condition]],
[[InterfaceActionsWML#.5Bmessage.5D|text_input]],
[[GettextForWesnothDevelopers#The_textdomain_declaration|textdomain]],
[[ThemeWML|theme]],
[[ConditionalActionsWML#.5Bif.5D|then]],
[[TerrainGraphicsWML|tile]],
[[TimeWML|time]],
[[DirectActionsWML#.5Btime_area.5D|time_area]],
[[HelpWML|topic]],
[[HelpWML|toplevel]],
[[UnitsWML#.5Btrait.5D|trait]],
[[DirectActionsWML#.5Btransform_unit.5D|transform_unit]],
[[InternalActionsWML#.5Bfind_path.5D|traveler]],
[[ConditionalActionsWML#.5Btrue.5D|true]],
[[DirectActionsWML#.5Btunnel.5D|tunnel]];
|-
|''U:''
[[InterfaceActionsWML#.5Bunhide_unit.5D|unhide_unit]],
[[SingleUnitWML|unit]],
[[InterfaceActionsWML#.5Bunit_overlay.5D|unit_overlay]],
[[UnitTypeWML|unit_type]],
[[InternalActionsWML#.5Bunit_worth.5D|unit_worth]],
[[UnitsWML|units]],
[[InterfaceActionsWML#.5Bunlock_view.5D|unlock_view]],
[[DirectActionsWML#.5Bunpetrify.5D|unpetrify]],
[[DirectActionsWML#.5Bunstore_unit.5D|unstore_unit]],
[[InternalActionsWML#.5Bunsynced.5D|unsynced]];
|-
| ''V:''
[[InternalActionsWML#.5Bset_variables.5D|value]],
[[ConditionalActionsWML#.5Bvariable.5D|variable]],
[[VariablesWML#The_.5Bvariables.5D_tag|variables]],
[[TerrainGraphicsWML|variant]],
[[UnitTypeWML#Other_tags|variation]],
[[AnimationWML#victory|victory_anim]],
[[SideWML|village]],
[[UnitsWML#.5Bmovetype.5D|vision_costs]],
[[InterfaceActionsWML#.5Bvolume.5D|volume]];
|-
| ''W:''
[[ConditionalActionsWML#.5Bwhile.5D|while]],
[[InterfaceActionsWML#.5Bwml_message.5D|wml_message]],
[[SchemaWML|wml_schema]];
|-
| ''Z:''
[[InterfaceActionsWML#.5Bzoom.5D|zoom]];
|}<includeonly>[[Category:WML Reference]]</includeonly><noinclude>A box with all the WML tags, each one linking to the page and section they are described in. This box should be included in each of the WML reference pages.</noinclude>

AbilitiesWML

2023-03-15T18:22:58Z

Beetlenaut: /* Extra keys used by the [leadership] ability */

{{WML Tags}}
== Abilities and their effects ==

There are two types of abilities: ones that apply to units (called ''abilities'') and ones that only apply when using a particular attack (called ''specials'' or ''weapon specials''). A unit may have multiple abilities and an attack can have multiple specials.

Each ability or special defines an effect based on one to three units. Most abilities apply to a single unit, and '''[filter_self]''' can be used to determine when the ability is active. Weapon specials apply to two units, which can be filtered either as "attacker" and "defender" (with the obvious meaning) or as "self" and "other" – the unit that possesses the special, and that unit's opponent. When filtering on the "other" unit, you use '''[filter_second]'''.

Leadership-style abilities are a more complex case, as they involve three units. Like a weapon special, there is an attacker and defender, but there is also a third unit that could be referred to as the "teacher". The "teacher" is the unit that possesses the ability, so it is referred to as "self" in the ability. A leadership ability works by temporarily granting a weapon special to either the attacker or the defender. The unit that benefits from this is referred to as the "student", while the unit that does not benefit is simply the "other" unit. When filtering on the "other" unit, you use '''[filter_second]'''.

== The ''[abilities]'' tag ==

The following tags are used to describe an ability in WML:

* '''[heals]''': modifies the hitpoints of a unit at the beginning of the healer's turn
* '''[regenerate]''': modifies the hitpoints of a unit at the beginning of the unit's turn
* '''[resistance]''': modifies the resistance of a unit to damage
* '''[leadership]''': modifies the damage of a unit
* '''[skirmisher]''': negates enemy zones of control
* '''[illuminates]''': modifies the time of day adjacent to the affected units
* '''[teleport]''': allows the unit to teleport
* '''[hides]''': renders the unit invisible to enemies
* {{DevFeature1.15|0}} A tag matching a [[#The_.5Bspecials.5D_tag|weapon special tag]], [damage] for example, will confer that weapon special to units based on the given conditions. Most weapon specials are supported; however, '''plagues''', '''heal_on_hit''', and '''swarm''' are not.
Any other tag is valid (for example '''[dummy]'''), but will result in an ability that does nothing but report it's there. These tags still use the same common keys and tags as every other ability. '''Note:''' a dummy ability must have an id for the name and description to display.

=== Available formula variables in Abilities and Weapon Specials ===

{{DevFeature1.15|?}} When using formulas in abilities and weapon specials, the following formula variables are available:
* '''self''': (unit) the unit that has the ability
* '''student''': (unit) for leadership-like abilities this is the unit that is adjacent to the unit that has the ability.
* '''attacker''': (unit) for attack-related abilities and weapon specials, this is the attacking unit during the attack.
* '''defender''': (unit) for attack-related abilities and weapon specials, this is the defending unit during the attack.
* '''other''': (unit) the unit whose stats get modified from the ability. For abilities without 'apply_to=opponent' this is always the same as 'student'.

=== Common keys and tags for every ability ===

{{DevFeature1.13|?}} All keys inside any ability that expects a numeric value will also accept formulas using
[[Wesnoth Formula Language]]. In order to use a formula in these keys, you must enclose it in parentheses. However, do not precede those parentheses with a dollar sign like <code>$(...)</code>, since that will erase the <tt>self</tt> variable.

* '''name''': the (translatable) name of the ability. If omitted, the ability will be a hidden ability.
* '''female_name''': the (translatable) name of the ability when possessed by a female unit. Defaults to ''name'' if not specified.
* '''name_inactive''': the (translatable) name of the ability when inactive. Defaults to ''name'' if not specified; if the ability is supposed to be not displayed when inactive, you must explicitly set ''name_inactive'' to an empty string (nothing after the equals sign).
* '''female_name_inactive''': the (translatable) name of the ability when inactive and possessed by a female unit. Defaults to ''name_inactive'' if not specified.
* '''description''': the (translatable) description of the ability.
* '''description_inactive''': the (translatable) description of the ability when inactive. Defaults to ''description'' if not specified.
* '''special_note''' {{DevFeature1.15|14}} Translatable string, which will be displayed in the unit’s help. See also [[UnitTypeWML#Special_Notes]].
* '''affect_self''': if equal to 'yes' (default), the ability will affect the unit that has it.
* '''affect_allies''': if equal to 'yes', the ability will affect units from the same and allied sides in the specified adjacent hexes. If set to 'no' it will not affect own or allied sides. If not set (default) it will affect units on the same side but not from allied sides.
* '''affect_enemies''': if equal to 'yes' (default is 'no'), the ability will affect enemies in the specified adjacent hexes.
* '''cumulative''': if set to 'yes', this ability will be cumulative with the base value for this ability. ''Beware of the bug with cumulative leadership in 1.16 https://github.com/wesnoth/wesnoth/issues/6466 , more info see below, in "Extra keys used by the ''leadership'' ability" section''.
* '''id''': this ability will not be cumulative with other abilities using this id. Must be present if cumulative is anything other than 'yes'.
* '''[filter]''': [[StandardUnitFilter]] If the unit owning the ability does not match this filter, the ability will be inactive.
* '''[affect_adjacent]''': an adjacent unit that does not match this filter will not receive its effects. There can be multiple [affect_adjacent] tags in a single ability; a unit needs to match any one of these to receive the effects. The side requirement of matching units is defined by the '''affect_allies''' and '''affect_enemies''' keys. If there are no [affect_adjacent] tags, then no adjacent units will receive the effects.
** '''adjacent''': a comma separated list of any combination of these directions: '''n''','''ne''','''se''','''s''','''sw''','''nw'''. (See [[StandardLocationFilter#Directions|notes]])
** '''[filter]''': a [[StandardUnitFilter]]. {{DevFeature1.13|2}} The variable $other_unit refers to the unit owning the ability.
* '''[filter_self]''': if the owner of the ability does not match this filter, it will not receive the effects of the ability. [filter_self] takes a [[StandardUnitFilter]] as argument.
* '''[filter_adjacent]''': if an adjacent unit does not match this filter, the ability will not be active and no-one will receive its affects. Takes extra keys ''adjacent'', ''count'', ''is_enemy'', just like in a [[StandardUnitFilter]], with the one difference that, in the absence of a specified ''count'', all listed directions must match (so, with two directiones eg ''adjacent=n,s'', the default is ''count=2''). In fact, it's really a shorthand for a [filter_adjacent] nested within [filter]. The variables $this_unit and {{DevFeature1.13|2}} $other_unit both work as you'd expect. Multiple [filter_adjacent] can be provided, all of which must pass for the ability to activate.
* '''[filter_adjacent_location]''': like [filter_adjacent], but filters on locations instead of units. This is a shorthand for [filter][filter_location][filter_adjacent_location].
* '''[filter_base_value]''': filters on the value before any modifications; uses the keys '''equals''', '''not_equals''', etc. If several keys are used all have to match.

=== Extra keys used by the ''[heals]'' ability ===

* '''value''': the amount healed.
* '''poison''': can be one of ''slowed'',''cured''. ''slowed'' means poison will not take effect for adjacent units (it's not related to the weapon special "slows").

=== Extra keys used by the ''[regenerate]'' ability ===

* '''value''': the amount healed.
* '''poison''': can be one of ''slowed'',''cured''.

=== Extra keys and tags used by the ''[resistance]'' ability ===

* '''value''': set resistance to this value.
* '''max_value''': maximum resistance value. This value '''must''' be set in order for [resistance] to function.
* '''add''': adds to resistance.
* '''sub''': subtracts from resistance.
* '''multiply''': multiplies resistance value.
* '''divide''': divides resistance value.
* '''apply_to''': a list of damage types; if left out, the ability applies to all types.
* '''active_on''': one of 'defense' or 'offense'; if left out, the ability is active on both.
These keys affect the actual resistance (e.g. -20%), not the damage modifier normally used in [resistance] (e.g. 120).
* '''[filter_weapon]''': {{DevFeature1.15|0}} If present, the resistance ability only takes effect when the owner of the ability uses a matching weapon.
* '''[filter_second_weapon]''': {{DevFeature1.15|0}} If present, the resistance ability only takes effect when the opponent uses a matching weapon.

=== Extra keys used by the ''[leadership]'' ability ===

* '''value''': the percentage bonus to damage.
* '''add''': the cumulative percentage bonus to damage.
* '''sub''': the cumulative percentage bonus subtracted to damage.
''Note:'' cumulative leadership with '''cumulative=yes''' and '''value=''' doesn't work in 1.16 (but fixed in 1.17.12 and later). To work around use '''add=''' or '''sub=''' key (it doesn't require cumulative) (https://github.com/wesnoth/wesnoth/issues/6466 ). If you want each instance of a ''[leadership]'' with the same id to be added you will be able to reuse '''cumulative=yes''' in 1.17.12 and later, otherwise, if you want to add the value of another ''[leadership]'' only once even with the same id in several copies, use '''add'''.
* '''[filter_weapon]''': {{DevFeature1.15|0}} If present, the leadership ability only takes effect when the owner of the ability uses a matching weapon.
* '''[filter_second_weapon]''': {{DevFeature1.15|0}} If present, the leadership ability only takes effect when the opponent uses a matching weapon.

=== Extra keys used by the ''[illuminates]'' ability ===

Because this ability changes the terrain instead of units on it, affect_self, affect_allies, affect_enemies and [filter_adjacent] have no effect.
* '''value''': the percentage bonus to lawful units. Units with '''alignment=lawful''' do +''value'' % damage when under the influence of a unit with this ability. Units with '''alignment=chaotic''' do -''value'' % damage. Units with '''alignment=neutral''' are unaffected by this ability. Units with '''alignment=liminal''' do -(abs(''value'')) % damage. ''value'' can be a negative number; this is useful if you want to give Chaotic units an advantage instead of Lawful ones.
* '''max_value''': the maximum percentage bonus given.
* '''min_value''': the minimum percentage bonus given.

=== Extra keys used by the ''[hides]'' ability ===

* '''alert''': the displayed text when the unit is discovered. Default "Ambushed!".

=== Extra tags used by the ''[teleport]'' ability ===

* '''[tunnel]''' - a [[DirectActionsWML#.5Btunnel.5D|tunnel tag]] (without the remove key) defining the tunneling source and target hexes, and maybe other conditions. (It automatically applies only to the unit with the ability.) You may use $teleport_unit inside the tunnel tag for filtering purposes.

=== Extra tags and keys used by weapon special abilities ===

* '''[filter_student]''': {{DevFeature1.15|0}} If present, only the unit matching this filter, either the possessor of the ability if affect_self=yes, or an adjacent unit matching '''[filter_adjacent]''' will be affected. Work like '''[filter_self]''' of specific weapon special.
* '''overwrite_specials''': {{DevFeature1.15|13}} If present, allows a special abilities weapon with a numerical value to impose its value and ignore values of abilities or specials of the same type. If '''overwrite_specials=one_side''', the specials and abilities used by the opponent of the unit affected by the ability with this key and applied to it will not be affected. If '''overwrite_specials=both_sides''', all non-key-carrying abilities and all specials of the same type affecting the recipient unit will be affected, even if used by the opponent (used in the macro FORCE_CHANCE_TO_HIT).
* Other keys and tags appropriate to the specific weapon special.

=== Macros for common abilities ===

[https://www.wesnoth.org/macro-reference.html#file:abilities.cfg macro reference]
* ABILITY_AMBUSH
* ABILITY_CURES
* ABILITY_HEALS
* ABILITY_ILLUMINATES
* ABILITY_LEADERSHIP_LEVEL_1 to ABILITY_LEADERSHIP_LEVEL_5
* {{DevFeature1.13|2}} ABILITY_LEADERSHIP (replaces the above leadership macros, which are now deprecated)
* ABILITY_NIGHTSTALK
* ABILITY_REGENERATES
* ABILITY_SKIRMISHER
* ABILITY_STEADFAST
* ABILITY_SUBMERGE
* ABILITY_TELEPORT

== The ''[specials]'' tag ==

The '''[specials]''' tag goes inside the '''[attack]''' tag. It can contain the following tags:

* '''[attacks]''': modifies the number of attacks of a weapon
* '''[berserk]''': pushes the attack for more than one combat round
* '''[chance_to_hit]''': modifies the chance to hit of a weapon
* '''[damage]''': modifies the damage of a weapon
* '''[disable]''': disables the weapon
* '''[drains]''': heals the attacker half of the damage dealt
* '''[firststrike]''': forces the weapon to always strike first
* '''[heal_on_hit]''': heals the attacker when an attack connects
* '''[petrifies]''': turns the target to stone
* '''[plague]''': when used to kill an enemy, a friendly unit takes its place
* '''[poison]''': poisons the target
* '''[slow]''': slows the target
* '''[swarm]''': number of strikes decreases as the unit loses hitpoints
Any other tag is valid, but will result in a special that does nothing but report it is there.

=== Common keys and tags for every weapon special ===

{{DevFeature1.13|?}} All keys inside any weapon special that expects a numeric value will also accept formulas using [[Wesnoth Formula Language]]. In order to use a formula in these keys, you must enclose it in parentheses.

* '''name''': the (translatable) name of the special. If omitted, the special will be hidden from the player.
* '''name_inactive''': the (translatable) name of the special when inactive. Defaults to ''name'' if not specified; if the special is supposed to be not displayed when inactive, you must explicitly set ''name_inactive'' to an empty string (nothing after the equals sign).
* '''description''': the (translatable) description of the special.
* '''description_inactive''': the (translatable) description of the special when inactive. Defaults to ''description'' if not specified.
* '''special_note''' {{DevFeature1.15|14}} Translatable string, which will be displayed in the unit’s help. See also [[UnitTypeWML#Special_Notes]].
* '''id''': this ability will not be cumulative with other specials using this id.
* '''active_on''': one of '''defense''' or '''offense'''; if left out, the special is active on both.
* '''apply_to''': one of '''self''','''opponent''','''attacker''','''defender''','''both''' (default: ''self''). Determines who the effects of this special are applied to.
* '''[filter_adjacent]''': if an adjacent unit does not match this filter, the special will not be active and no-one will receive its effects. Takes extra keys ''adjacent'', ''count'', ''is_enemy'', just like in a [[StandardUnitFilter]]. In fact, it's really a shorthand for a [filter_adjacent] nested within [filter_self], with the one difference that, in the absence of a specified ''count'', all listed directions must match (so, with two directiones eg ''adjacent=n,s'', the default is ''count=2''). The variables $this_unit and {{DevFeature1.13|2}} $other_unit both work as you'd expect. Multiple [filter_adjacent] can be provided, all of which must pass for the ability to activate.
* '''[filter_adjacent_location]''': like [filter_adjacent], but filters on locations instead of units. This is a shorthand for [filter_self][filter_location][filter_adjacent_location].
* '''[filter_self]''': the special will only be active if the owner matches this [[StandardUnitFilter]] (SUF).
** '''[filter_weapon]''': a [[FilterWML#Filtering_Weapons|standard weapon filter]], including special=.
** '''$other_unit''': {{DevFeature1.13|2}} The special variable $other_unit refers to the opponent.
* '''[filter_opponent]''': the special will only be active if the opponent matches this SUF.
** '''[filter_weapon]''': a [[FilterWML#Filtering_Weapons|standard weapon filter]], including special=.
** '''$other_unit''': {{DevFeature1.13|2}} The special variable $other_unit refers to the unit that owns the weapon.
* '''[filter_attacker]''': the special will only be active if the attacker matches this SUF.
** '''[filter_weapon]''': a [[FilterWML#Filtering_Weapons|standard weapon filter]], including special=.
** '''$other_unit''': {{DevFeature1.13|2}} The special variable $other_unit refers to the defender.
* '''[filter_defender]''' the special will only be active if the defender matches this SUF.
** '''[filter_weapon]''': a [[FilterWML#Filtering_Weapons|standard weapon filter]], including special=.
** '''$other_unit''': {{DevFeature1.13|2}} The special variable $other_unit refers to the attacker.

=== Common keys and tags for specials with a value ===

The '''[damage]''', '''[attacks]''', and '''[chance_to_hit]''' specials take values that specify how those specials modify their respective base values. The '''[drains]''' special takes a value specifying the percentage of damage drained (default 50) and '''[heal_on_hit]''' takes the amount to heal (default 0; negative values will harm the attacker, but not kill).

* '''value''': the value to be used.
* '''add''': the number to add to the base value.
* '''sub''': the number to subtract from the base value.
* '''multiply''': this multiplies the base value.
* '''divide''': this divides the base value.
* '''cumulative''': if set to 'yes', this special will be cumulative with the base value.
* '''backstab''': if set to 'yes', this special will only apply to the attacker, and only when there is an enemy on the target's opposite side (i.e. when the standard backstab special applies). {{DevFeature1.13|2}} This is now deprecated. The same functionality can be achieved with a [filter_adjacent] in [filter_opponent]; see the implementation of the default backstab special for details.
* '''[filter_base_value]''': filters on the value before any modifications; uses the keys '''equals''', '''not_equals''', '''less_than''', '''greater_than''', '''less_than_equal_to''', '''greater_than_equal_to'''.

=== Extra keys used by the ''[berserk]'' special ===

* '''value''': the maximum number of combat rounds (default 1).
* '''cumulative''': if set to 'yes', this special will be cumulative with other active berserk specials (on the current combatant, not with an opponent's berserk).

=== Extra keys used by the ''[plague]'' special ===

* '''type''': the unit type to be spawned on kill.

=== Extra keys used by the ''[swarm]'' special ===

* '''swarm_attacks_max''': the maximum number of attacks for the swarm. Defaults to the base number of attacks modified by any applicable [attacks] specials. If this is specified, then the base number of attacks is ignored.
* '''swarm_attacks_min''': the minimum number of attacks for the swarm. Defaults to zero. This can be set higher than swarm_attacks_max to cause a unit to gain attacks as health decreases.
The ratio of the unit's current to maximum hit points will be used to scale the number of attacks between these two values.

Prior to version 1.11, a [swarm] special will cause [attacks] specials to be ignored. In 1.11 and later, [attacks] specials are applied before [swarm].

=== Macros for common weapon specials ===

* WEAPON_SPECIAL_BACKSTAB
* WEAPON_SPECIAL_BERSERK
* WEAPON_SPECIAL_CHARGE
* WEAPON_SPECIAL_DRAIN
* WEAPON_SPECIAL_FIRSTSTRIKE
* WEAPON_SPECIAL_MAGICAL
* WEAPON_SPECIAL_MARKSMAN
* WEAPON_SPECIAL_PLAGUE
* WEAPON_SPECIAL_PLAGUE_TYPE TYPE
* WEAPON_SPECIAL_POISON
* WEAPON_SPECIAL_SLOW
* WEAPON_SPECIAL_STONE
* WEAPON_SPECIAL_SWARM

== See Also ==

* [[UnitTypeWML]]
* [[SingleUnitWML]]
* [[ReferenceWML]]

[[Category:WML Reference]]

CampaignWML

2022-09-13T18:27:05Z

Beetlenaut: /* The [campaign] Tag */

{{WML Tags}}



This page describes how the campaign is displayed in the "Campaign" menu, and how it starts.

==The [campaign] Tag==

The following keys and tags are recognized in '''[campaign]''' tags:
* '''id''': the internal campaign identifier used to classify saved games
* '''icon''': the image displayed in the campaign selection menu
* '''name''': (translatable) name displayed in the campaign selection menu
* '''abbrev''': (translatable) abbreviation used as a prefix for savefile names made from this campaign
* '''image''': the image shown in the information pane when this campaign is selected in the campaign selection menu (typically a transparent, 350×350 pixels portrait)
* '''background''': {{DevFeature1.15|9}} the image used as a backdrop for the Campaigns menu (typically a high resolution image intended for displaying fullscreen in story screens). If blank or unspecified, a stock story background from core is used.
* '''description''': (translatable) text shown in the information pane when this campaign is selected in the campaign selection menu
* '''description_alignment''': {{DevFeature1.13|3}} The text alignment of the description. Choose between "left" (default), "center", or "right".
* '''type''': campaign's type to specify if it should be visible in singleplayer, multiplayer or both. Possible values are "sp", "mp" and "hybrid". Defaults to "sp".
* '''define'''='''''CAMPAIGN_SYMBOL''''' when this campaign is started, the preprocessor symbol '''''CAMPAIGN_SYMBOL''''' will be defined. See '''#ifdef''' in [[PreprocessorRef]] for how this can be used to isolate parts of the campaign file from other campaigns. Only the tags '''[campaign]''' and '''[binary_path]''' (see [[BinaryPathWML]]) should go outside of '''#ifdef ''CAMPAIGN_SYMBOL'''''. This symbol will be defined ''before'' any .cfg is preprocessed. Important note: starting with 1.7.13, [binary_path] does no longer need to be outside of the '''#ifdef ''CAMPAIGN_SYMBOL''''' block to make custom binary data available, which could easily cause overwrites. E.g. icon=data/add-ons/whatever/something.png is supposed to work. This seems to have been a bug since at least BfW 1.0 which means that practically all available examples of user made add-ons are wrong in this aspect.
* '''extra_defines''': a comma(''',''') separated list of preprocessor symbols. Those symbols will be defined ''before'' any .cfg is preprocessed. (In the past, this tag was used to define common optional advancements, but that use is deprecated. There are now macros to add those advancements defined in [https://www.wesnoth.org/macro-reference.html#file:optional_unit_advancements.cfg data/core/macros/optional_unit_advancements.cfg].)
* '''difficulties''': a comma(''',''') separated list of preprocessor symbols, exactly one of which will be stored depending on the difficulty setting chosen when the campaign is started. The symbols '''EASY''', '''NORMAL''', and '''HARD''' are usually used, and there are several macros in utils.cfg (see [https://www.wesnoth.org/macro-reference.html#file:utils.cfg| Macro Reference]) which check for these values to set WML keys to different values depending on difficulty. If you use different difficulty symbols, you may need to define your own versions of these macros. {{DevFeature1.13|2}} This key has been deprecated in favor of [difficulty] define=.
* '''difficulty_descriptions''': the menu of difficulties; this is a list of descriptions (see [[DescriptionWML]]) that correspond to different difficulty levels. Since each description is a menu option for a difficulty level, this must provide the same number of descriptions as there are levels in the ''difficulties'' list. {{DevFeature1.13|2}} This key has been deprecated in favor of [difficulty] define=
* '''[difficulty]''': {{DevFeature1.13|2}} specifies a single campaign difficulty. The following keys are accepted:
** '''define''': the preprocessor symbol defined when this difficulty is selected. Uses the same format as an entry in the old ''difficulties'' list.
** '''image''': the image to display for this difficulty in the selection menu
** '''label''': a flavor label describing this difficulty. Displayed second after the image
** '''description''': a description of the difficulty, usually along the lines of "Beginner" or "Challenging". Displayed third after the image.
** '''default''': whether this is the difficulty which will be selected by default when the difficulty selection menu is displayed.
** '''auto_markup''': {{DevFeature1.15|0}} By default, the description is shown in small, gray text within parentheses. Setting '''auto_markup=no''' disables these, so no markup will be applied implicitly. Any markup in '''description''' will be honored regardless of this setting.
* '''allow_difficulty_change''': Allows difficulty switching during an ongoing campaign. Default:yes
* '''first_scenario''': the ID of the first scenario in the campaign; see ''id'' in [[ScenarioWML]]
* '''[options]''': {{DevFeature1.13|1}} Allows configuration options to be displayed to the user, see [[OptionWML]]
* '''rank''': a number that determines the order of campaigns in the campaign selection menu. Lower ''rank'' campaigns appear earlier, with unranked campaigns at the end. Currently the mainline campaigns use multiples of 10 from 0 to 399, with 0-99 for Novice campaigns, 100-199 for Intermediate campaigns, and 200-399 for Expert campaigns; if you specify this, it should not be less than 400. (Note: This replaces an older convention that topped out at 50.) {{DevFeature1.14|6}} a number that determines the order of campaigns in the campaign selection menu. Lower rank campaigns appear earlier, with unranked campaigns at the end. Currently the mainline campaigns use multiples of 5 from 0 to 249, with 0-49 for Rookie campaigns, 50-99 for Novice campaigns, 100-149 for Intermediate campaigns, 150-199 for Hard campaigns, and 200-249 for Expert campaigns; if you specify this, it should not be less than 300.
* '''start_year''': a string that determines the order of campaigns when the campaign selection menu is sorted by date. The date needs a year number and an epoch, for example '''20 BW''', '''20 YW''', '''20 BF''' or '''20 AF'''. In Wesnoth 1.14, this is the only place in which this date-parsing is used.
* '''end_year''': a string that helps determine the order of campaigns when two campaigns have the same '''start_year'''. Ignored if '''start_year''' is not set.
* '''year''': shortcut for specifying both '''start_year''' and '''end_year''', for campaigns that happen inside a single calendar year. Ignored if '''start_year''' is given.
* '''[about]''': inserts your own credits into the game's list of credits. See [[CreditsWML]] for syntax.
* '''end_credits''': Whether to display the credits screen at the end of the campaign. Defaults to ''yes''.
* '''end_text''': (translatable) Text that is shown centered in a black screen at the end of a campaign. Defaults to "The End".
* '''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. {{DevFeature1.15|6}} This value is capped at 5000 (5 seconds).
* '''[event]''': {{DevFeature1.13|2}} events placed here will be automatically inserted into all scenarios of the campaign.
* '''[modify_unit_type]''': {{DevFeature1.15|2}} Applies minor modifications to existing unit types when this campaign is active. See entry in [[ModificationWML]] for list of possible attributes.
The following keys are additionally recognized in multiplayer:
* '''min_players''': Minimum number of players which the campaign supports. This only serves to inform users when choosing a campaign. Defaults to 2.
* '''max_players''': Maximum number of players which the campaign supports. This only serves to inform users when choosing a campaign. Defaults to either '''min_players''' or 2, whichever is higher.
* '''allow_era_choice''': Whether to allow era selection (when set to ''yes'') or hide it and use a default one when creating a game (when set to ''no''). Defaults to ''yes''.
* '''require_campaign''': Whether clients are required to have this campaign installed beforehand to be allowed join a game using this campaign. Possible values 'yes' (the default) and 'no'.

== See Also ==

* [[PreprocessorRef]]
* [[ScenarioWML]]
* [[ReferenceWML]]
* [[PblWML]]

[[Category: WML Reference]]

CampaignWML

2022-09-13T18:16:36Z

Beetlenaut: /* Removed key */

{{WML Tags}}



This page describes how the campaign is displayed in the "Campaign" menu, and how it starts.

==The [campaign] Tag==

The following keys and tags are recognized in '''[campaign]''' tags:
* '''id''': the internal campaign identifier used to classify saved games
* '''icon''': the image displayed in the campaign selection menu
* '''name''': (translatable) name displayed in the campaign selection menu
* '''abbrev''': (translatable) abbreviation used as a prefix for savefile names made from this campaign
* '''image''': the image shown in the information pane when this campaign is selected in the campaign selection menu (typically a transparent, 350×350 pixels portrait)
* '''background''': {{DevFeature1.15|9}} the image used as a backdrop for the Campaigns menu (typically a high resolution image intended for displaying fullscreen in story screens). If blank or unspecified, a stock story background from core is used.
* '''description''': (translatable) text shown in the information pane when this campaign is selected in the campaign selection menu
* '''description_alignment''': {{DevFeature1.13|3}} The text alignment of the description. Choose between "left" (default), "center", or "right".
* '''type''': campaign's type to specify if it should be visible in singleplayer, multiplayer or both. Possible values are "sp", "mp" and "hybrid". Defaults to "sp".
* '''define'''='''''CAMPAIGN_SYMBOL''''' when this campaign is started, the preprocessor symbol '''''CAMPAIGN_SYMBOL''''' will be defined. See '''#ifdef''' in [[PreprocessorRef]] for how this can be used to isolate parts of the campaign file from other campaigns. Only the tags '''[campaign]''' and '''[binary_path]''' (see [[BinaryPathWML]]) should go outside of '''#ifdef ''CAMPAIGN_SYMBOL'''''. This symbol will be defined ''before'' any .cfg is preprocessed. Important note: starting with 1.7.13, [binary_path] does no longer need to be outside of the '''#ifdef ''CAMPAIGN_SYMBOL''''' block to make custom binary data available, which could easily cause overwrites. E.g. icon=data/add-ons/whatever/something.png is supposed to work. This seems to have been a bug since at least BfW 1.0 which means that practically all available examples of user made add-ons are wrong in this aspect.
* '''difficulties''': a comma(''',''') separated list of preprocessor symbols, exactly one of which will be stored depending on the difficulty setting chosen when the campaign is started. The symbols '''EASY''', '''NORMAL''', and '''HARD''' are usually used, and there are several macros in utils.cfg (see [https://www.wesnoth.org/macro-reference.html#file:utils.cfg| Macro Reference]) which check for these values to set WML keys to different values depending on difficulty. If you use different difficulty symbols, you may need to define your own versions of these macros. {{DevFeature1.13|2}} This key has been deprecated in favor of [difficulty] define=.
* '''difficulty_descriptions''': the menu of difficulties; this is a list of descriptions (see [[DescriptionWML]]) that correspond to different difficulty levels. Since each description is a menu option for a difficulty level, this must provide the same number of descriptions as there are levels in the ''difficulties'' list. {{DevFeature1.13|2}} This key has been deprecated in favor of [difficulty] define=
* '''[difficulty]''': {{DevFeature1.13|2}} specifies a single campaign difficulty. The following keys are accepted:
** '''define''': the preprocessor symbol defined when this difficulty is selected. Uses the same format as an entry in the old ''difficulties'' list.
** '''image''': the image to display for this difficulty in the selection menu
** '''label''': a flavor label describing this difficulty. Displayed second after the image
** '''description''': a description of the difficulty, usually along the lines of "Beginner" or "Challenging". Displayed third after the image.
** '''default''': whether this is the difficulty which will be selected by default when the difficulty selection menu is displayed.
** '''auto_markup''': {{DevFeature1.15|0}} By default, the description is shown in small, gray text within parentheses. Setting '''auto_markup=no''' disables these, so no markup will be applied implicitly. Any markup in '''description''' will be honored regardless of this setting.
* '''allow_difficulty_change''': Allows difficulty switching during an ongoing campaign. Default:yes
* '''first_scenario''': the ID of the first scenario in the campaign; see ''id'' in [[ScenarioWML]]
* '''[options]''': {{DevFeature1.13|1}} Allows configuration options to be displayed to the user, see [[OptionWML]]
* '''rank''': a number that determines the order of campaigns in the campaign selection menu. Lower ''rank'' campaigns appear earlier, with unranked campaigns at the end. Currently the mainline campaigns use multiples of 10 from 0 to 399, with 0-99 for Novice campaigns, 100-199 for Intermediate campaigns, and 200-399 for Expert campaigns; if you specify this, it should not be less than 400. (Note: This replaces an older convention that topped out at 50.) {{DevFeature1.14|6}} a number that determines the order of campaigns in the campaign selection menu. Lower rank campaigns appear earlier, with unranked campaigns at the end. Currently the mainline campaigns use multiples of 5 from 0 to 249, with 0-49 for Rookie campaigns, 50-99 for Novice campaigns, 100-149 for Intermediate campaigns, 150-199 for Hard campaigns, and 200-249 for Expert campaigns; if you specify this, it should not be less than 300.
* '''start_year''': a string that determines the order of campaigns when the campaign selection menu is sorted by date. The date needs a year number and an epoch, for example '''20 BW''', '''20 YW''', '''20 BF''' or '''20 AF'''. In Wesnoth 1.14, this is the only place in which this date-parsing is used.
* '''end_year''': a string that helps determine the order of campaigns when two campaigns have the same '''start_year'''. Ignored if '''start_year''' is not set.
* '''year''': shortcut for specifying both '''start_year''' and '''end_year''', for campaigns that happen inside a single calendar year. Ignored if '''start_year''' is given.
* '''[about]''': inserts your own credits into the game's list of credits. See [[CreditsWML]] for syntax.
* '''end_credits''': Whether to display the credits screen at the end of the campaign. Defaults to ''yes''.
* '''end_text''': (translatable) Text that is shown centered in a black screen at the end of a campaign. Defaults to "The End".
* '''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. {{DevFeature1.15|6}} This value is capped at 5000 (5 seconds).
* '''[event]''': {{DevFeature1.13|2}} events placed here will be automatically inserted into all scenarios of the campaign.
* '''[modify_unit_type]''': {{DevFeature1.15|2}} Applies minor modifications to existing unit types when this campaign is active. See entry in [[ModificationWML]] for list of possible attributes. There are some macros that use this tag to enable common advancements. See [https://www.wesnoth.org/macro-reference.html#file:optional_unit_advancements.cfg data/core/macros/optional_unit_advancements.cfg] for a list.

The following keys are additionally recognized in multiplayer:
* '''min_players''': Minimum number of players which the campaign supports. This only serves to inform users when choosing a campaign. Defaults to 2.
* '''max_players''': Maximum number of players which the campaign supports. This only serves to inform users when choosing a campaign. Defaults to either '''min_players''' or 2, whichever is higher.
* '''allow_era_choice''': Whether to allow era selection (when set to ''yes'') or hide it and use a default one when creating a game (when set to ''no''). Defaults to ''yes''.
* '''require_campaign''': Whether clients are required to have this campaign installed beforehand to be allowed join a game using this campaign. Possible values 'yes' (the default) and 'no'.

== See Also ==

* [[PreprocessorRef]]
* [[ScenarioWML]]
* [[ReferenceWML]]
* [[PblWML]]

[[Category: WML Reference]]

CampaignWML

2022-09-12T14:28:31Z

Beetlenaut: /* The [campaign] Tag */

{{WML Tags}}



This page describes how the campaign is displayed in the "Campaign" menu, and how it starts.

==The [campaign] Tag==

The following keys and tags are recognized in '''[campaign]''' tags:
* '''id''': the internal campaign identifier used to classify saved games
* '''icon''': the image displayed in the campaign selection menu
* '''name''': (translatable) name displayed in the campaign selection menu
* '''abbrev''': (translatable) abbreviation used as a prefix for savefile names made from this campaign
* '''image''': the image shown in the information pane when this campaign is selected in the campaign selection menu (typically a transparent, 350×350 pixels portrait)
* '''background''': {{DevFeature1.15|9}} the image used as a backdrop for the Campaigns menu (typically a high resolution image intended for displaying fullscreen in story screens). If blank or unspecified, a stock story background from core is used.
* '''description''': (translatable) text shown in the information pane when this campaign is selected in the campaign selection menu
* '''description_alignment''': {{DevFeature1.13|3}} The text alignment of the description. Choose between "left" (default), "center", or "right".
* '''type''': campaign's type to specify if it should be visible in singleplayer, multiplayer or both. Possible values are "sp", "mp" and "hybrid". Defaults to "sp".
* '''define'''='''''CAMPAIGN_SYMBOL''''' when this campaign is started, the preprocessor symbol '''''CAMPAIGN_SYMBOL''''' will be defined. See '''#ifdef''' in [[PreprocessorRef]] for how this can be used to isolate parts of the campaign file from other campaigns. Only the tags '''[campaign]''' and '''[binary_path]''' (see [[BinaryPathWML]]) should go outside of '''#ifdef ''CAMPAIGN_SYMBOL'''''. This symbol will be defined ''before'' any .cfg is preprocessed. Important note: starting with 1.7.13, [binary_path] does no longer need to be outside of the '''#ifdef ''CAMPAIGN_SYMBOL''''' block to make custom binary data available, which could easily cause overwrites. E.g. icon=data/add-ons/whatever/something.png is supposed to work. This seems to have been a bug since at least BfW 1.0 which means that practically all available examples of user made add-ons are wrong in this aspect.
* '''difficulties''': a comma(''',''') separated list of preprocessor symbols, exactly one of which will be stored depending on the difficulty setting chosen when the campaign is started. The symbols '''EASY''', '''NORMAL''', and '''HARD''' are usually used, and there are several macros in utils.cfg (see [https://www.wesnoth.org/macro-reference.html#file:utils.cfg| Macro Reference]) which check for these values to set WML keys to different values depending on difficulty. If you use different difficulty symbols, you may need to define your own versions of these macros. {{DevFeature1.13|2}} This key has been deprecated in favor of [difficulty] define=.
* '''difficulty_descriptions''': the menu of difficulties; this is a list of descriptions (see [[DescriptionWML]]) that correspond to different difficulty levels. Since each description is a menu option for a difficulty level, this must provide the same number of descriptions as there are levels in the ''difficulties'' list. {{DevFeature1.13|2}} This key has been deprecated in favor of [difficulty] define=
* '''[difficulty]''': {{DevFeature1.13|2}} specifies a single campaign difficulty. The following keys are accepted:
** '''define''': the preprocessor symbol defined when this difficulty is selected. Uses the same format as an entry in the old ''difficulties'' list.
** '''image''': the image to display for this difficulty in the selection menu
** '''label''': a flavor label describing this difficulty. Displayed second after the image
** '''description''': a description of the difficulty, usually along the lines of "Beginner" or "Challenging". Displayed third after the image.
** '''default''': whether this is the difficulty which will be selected by default when the difficulty selection menu is displayed.
** '''auto_markup''': {{DevFeature1.15|0}} By default, the description is shown in small, gray text within parentheses. Setting '''auto_markup=no''' disables these, so no markup will be applied implicitly. Any markup in '''description''' will be honored regardless of this setting.
* '''allow_difficulty_change''': Allows difficulty switching during an ongoing campaign. Default:yes
* '''first_scenario''': the ID of the first scenario in the campaign; see ''id'' in [[ScenarioWML]]
* '''[options]''': {{DevFeature1.13|1}} Allows configuration options to be displayed to the user, see [[OptionWML]]
* '''rank''': a number that determines the order of campaigns in the campaign selection menu. Lower ''rank'' campaigns appear earlier, with unranked campaigns at the end. Currently the mainline campaigns use multiples of 10 from 0 to 399, with 0-99 for Novice campaigns, 100-199 for Intermediate campaigns, and 200-399 for Expert campaigns; if you specify this, it should not be less than 400. (Note: This replaces an older convention that topped out at 50.) {{DevFeature1.14|6}} a number that determines the order of campaigns in the campaign selection menu. Lower rank campaigns appear earlier, with unranked campaigns at the end. Currently the mainline campaigns use multiples of 5 from 0 to 249, with 0-49 for Rookie campaigns, 50-99 for Novice campaigns, 100-149 for Intermediate campaigns, 150-199 for Hard campaigns, and 200-249 for Expert campaigns; if you specify this, it should not be less than 300.
* '''start_year''': a string that determines the order of campaigns when the campaign selection menu is sorted by date. The date needs a year number and an epoch, for example '''20 BW''', '''20 YW''', '''20 BF''' or '''20 AF'''. In Wesnoth 1.14, this is the only place in which this date-parsing is used.
* '''end_year''': a string that helps determine the order of campaigns when two campaigns have the same '''start_year'''. Ignored if '''start_year''' is not set.
* '''year''': shortcut for specifying both '''start_year''' and '''end_year''', for campaigns that happen inside a single calendar year. Ignored if '''start_year''' is given.
* '''[about]''': inserts your own credits into the game's list of credits. See [[CreditsWML]] for syntax.
* '''end_credits''': Whether to display the credits screen at the end of the campaign. Defaults to ''yes''.
* '''end_text''': (translatable) Text that is shown centered in a black screen at the end of a campaign. Defaults to "The End".
* '''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. {{DevFeature1.15|6}} This value is capped at 5000 (5 seconds).
* '''[event]''': {{DevFeature1.13|2}} events placed here will be automatically inserted into all scenarios of the campaign.
* '''[modify_unit_type]''': {{DevFeature1.15|2}} Applies minor modifications to existing unit types when this campaign is active. See entry in [[ModificationWML]] for list of possible attributes. There are some macros that use this tag to enable common advancements. See [https://www.wesnoth.org/macro-reference.html#file:optional_unit_advancements.cfg data/core/macros/optional_unit_advancements.cfg] for a list.

The following keys are additionally recognized in multiplayer:
* '''min_players''': Minimum number of players which the campaign supports. This only serves to inform users when choosing a campaign. Defaults to 2.
* '''max_players''': Maximum number of players which the campaign supports. This only serves to inform users when choosing a campaign. Defaults to either '''min_players''' or 2, whichever is higher.
* '''allow_era_choice''': Whether to allow era selection (when set to ''yes'') or hide it and use a default one when creating a game (when set to ''no''). Defaults to ''yes''.
* '''require_campaign''': Whether clients are required to have this campaign installed beforehand to be allowed join a game using this campaign. Possible values 'yes' (the default) and 'no'.

== Removed key ==

This doesn't work any more. The documentation is left here as an aid to porting old code.

* '''extra_defines''': (replaced by macros using '''[modify_unit_type]''') a comma(''',''') separated list of preprocessor symbols. Those symbols will be defined ''before'' any .cfg is preprocessed. Currently supported extra_defines are:
<ul>
;ENABLE_ARMAGEDDON_DRAKE
:allows the advancement ''Inferno Drake'' -> ''Armageddon Drake''
;ENABLE_DWARVISH_ARCANISTER
:allows the advancement ''Dwarvish Runemaster'' -> ''Dwarvish Arcanister''
;ENABLE_DWARVISH_RUNESMITH
:allows the advancement ''Dwarvish Fighter'' -> ''Dwarvish Runesmith''
;DISABLE_GRAND_MARSHAL
:disallows the advancement ''General'' -> ''Grand Marshal''
;ENABLE_ANCIENT_LICH
:allows the advancement ''Lich'' -> ''Ancient Lich''
;ENABLE_DEATH_KNIGHT
:allows the advancement ''Revenant'' -> ''Death Knight'
;ENABLE_TROLL_SHAMAN
:allows the advancement ''Troll Whelp'' -> ''Troll Shaman''
;ENABLE_WOLF_ADVANCEMENT
:allows the advancements ''Wolf'' -> ''Great Wolf'' -> ''Direwolf''
;ENABLE_NIGHTBLADE {{DevFeature1.13|0}}
:allows the advancement ''Orcish Slayer'' -> ''Orcish Nightblade''
;ENABLE_PARAGON {{DevFeature1.15|1}}
:allows the advancement ''Dune Blademaster'' -> ''Dune Paragon''
;ENABLE_WOSE_SHAMAN {{DevFeature1.15|1}}
:allows the advancement ''Wose'' -> ''Wose Shaman''
</ul>

== See Also ==

* [[PreprocessorRef]]
* [[ScenarioWML]]
* [[ReferenceWML]]
* [[PblWML]]

[[Category: WML Reference]]

InternalActionsWML

2021-06-22T05:01:54Z

Beetlenaut: /* [store_side] */

{{WML Tags}}

Part of [[ActionWML]], Internal actions are actions that WML uses internally that do not directly affect game play (or, at least, are not readily apparent to the player). For example, storing a variable is an internal action.

== Variable Actions ==

These actions are focused, in one way or another, on [[VariablesWML|variables]]. Creating them, modifying them, capturing game data to them, you name it, these actions are all about the variables.

=== [set_variable] ===

The '''[set_variable]''' tag is used to create and manipulate WML variables. The [http://www.wesnoth.org/macro-reference.xhtml#VARIABLE VARIABLE] macro is a quick syntactic shortcut for simple variable creation and the [http://www.wesnoth.org/macro-reference.xhtml#VARIABLE_OP VARIABLE_OP] macro is a quick syntactic shortcut for performing simple mathematical operations on variables.

* '''name''': the name of the variable to manipulate

* '''value''': set the variable to the given value (can be numeric or string).Use literal for no substitution. (see [[VariablesWML]])

* '''literal''': set the variable to the given value (can be numeric or string). This does not interpret any dollar signs.

* '''to_variable''': set the variable to the value of the given variable, e.g. 'to_variable=temp' would be equivalent to 'value=$temp'.

* '''add''': add the given amount to the variable.

* '''sub''': subtract the given amount from the variable.

* '''multiply''': multiply the variable by the given number. The result is a float. To negate a number, multiply by -1. If you negate 0, the result is a floating-point negative zero -0. To display -0 as 0, use a second tag with add=0; it will flip -0 to 0 but not affect other numbers.

* '''divide''': divide the variable by the given number. The result is a float. Wesnoth 1.9 and later no longer uses integer division. Use a second tag with round=floor if you relied on this.

* '''modulo''': returns the remainder of a division.

* '''abs''': Returns the absolute value of the variable.

* '''root''': Use '''root=square''' to calculate the square root. {{DevFeature1.15|0}} Also supports '''root=cube''' and arbitrary integer roots.

* '''power''': Raise the variable to some power.

* '''rand''': the variable will be randomly set. You may provide a comma separated list of possibilities, e.g. 'rand=Bob,Bill,Bella'. You may provide a range of numbers (integers), e.g. 'rand=3..5'. You may combine these, e.g. 'rand=100,1..9', in which case there would be 1/10th chance of getting 100, just like for each of 1 to 9. If a number or item is repeated, it is sampled more frequently as appropriate. See [[MultiplayerContent]] for more info on the MP case. Using rand= will automatically result in the current action being non undoable. Ignoring possible [allow_undo].

* '''time=stamp''': Retrieves a timestamp in milliseconds since wesnoth was started, can be used as timing aid. Don't try to use this as random value in MP since it will cause an OOS.

* '''string_length''': Retrieves the length in characters of the string passed as this attribute's value; such string is parsed and variable substitution applied automatically (see [[VariablesWML]] for details).

* '''[join]''' joins an array of strings to create a textual list
** '''variable''': name of the array
** '''key''': the key of each array element(array[$i].foo) in which the strings are stored
** '''separator''': separator to connect the elements
** '''remove_empty''': whether to ignore empty elements

* '''ipart''': Assigns the integer part (the part to the left of the decimal point) of the referenced variable.

* '''fpart''': Assigns the decimal part (the part to the right of the decimal point) of the referenced variable.

* '''round''': Rounds the variable to the specified number of digits of precision. Negative precision works as expected (rounding 19517 to -2 = 19500). Special values:
**'''round=ceil''': Rounds upward to the nearest integer.
**'''round=floor''': Rounds down to the nearest integer.
**'''round=trunc''': {{DevFeature1.15|0}} Rounds towards zero; this is the same operation as '''ipart''', but operating on the value already contained in the variable rather than the value assigned to the key.

* '''min''', '''max''': {{DevFeature1.15|9}} Specify a comma-separated list of numbers; either the smallest or largest number in the list will be assigned to the variable.

* '''reverse=yes''': {{DevFeature1.15|9}} Reverses the string value of the variable. For example, "delfador" becomes "rodafled".

* '''formula''': Calculate the new value of the variable from a [[Wesnoth_Formula_Language|WFL]] formula operating on the old value. This is similar to using the '''$(...)''' syntax but avoids the possibility of WFL syntax errors if a referenced variable is empty.

=== [set_variables] ===

Manipulates a WML array or container

* '''name''': the name of the array or container to manipulate

* '''mode''': one of the following values:
** ''replace'': will clean the array '''name''' and replace it with given data
** ''append'': will append given data to the current array
** ''merge'': will merge in the given data into '''name'''. Attributes in '''[value]''' will overwrite any existing already in '''name'''. Tags in '''[value]''' modify the corresponding tag of the original value of '''name''', so for example the first '''[attack]''' tag in '''[value]''' would modify the first '''[attack]''' tag of '''name''' rather than appending a new '''[attack]''' tag. A few special syntaxes are supported:
*** ''__remove=yes'': When used in a subtag, causes the corresponding subtag in '''name''' to be deleted rather than merged. Deletion happens after any other subtags have been merged.
*** ''add_to_xxx'': Adds its integer value to the integer value of '''xxx''' in '''name''', and sets '''xxx''' in '''name''' to the result. {{DevFeature1.13|8}} Now adds as real numbers rather than integers.
*** ''concat_to_xxx'': {{DevFeature1.13|8}} Similar to '''add_to_xxx''', but does string concatenation instead of numerical addition.
** ''insert'': will insert the given data at the index specified in the '''name''' attribute, such as name=my_array[1]. The default index is zero, which will insert to the front of the array. '''Note:''' if an invalid index is used, empty containers will be created before the insertion is performed. In other words, do not attempt to insert at an index greater than (or equal to) the array's current length. This limitation may be removed in future versions.

* '''to_variable''': data will be set to the given array

* '''[value]''': the WML inside the [value] tags will be stored in data, variables will be interpolated directly, use $| in order to escape the $ sign, you can store arrays of WML by supplying multiple [value] tags. ([[#Using_.5Bset_variables.5D_to_Create_Arrays_of_WML|See Example]])

* '''[literal]''': same as '''[value]''', but variables will not be substituted, '''[literal]''' and '''[value]''' can not be used in the same [set_variables] tag, i.e. you can not create arrays by piling a mix of '''[value]''' and '''[literal]''' tags

*'''[split]''' splits a textual list into an array which will then be set to data
** '''list''': textual list to split
** '''key''': the key of each array element(array[$i].foo) in which the strings are stored
** '''separator''': separator to separate the elements
** '''remove_empty''': whether to ignore empty elements

{{DevFeature1.13|4}} You can now mix '''[value]''', '''[literal]''', and '''[split]''' in the same '''[set_variables]''' tag. They will be processed in order of appearance. Multiple instances of [split] are also supported now.

=== Capturing Game Data ===

These actions capture different bits of game data and store them to variables so they can be examined and/or manipulated.

==== [store_gold] ====

Stores a side's gold into a variable.

* '''[[StandardSideFilter]]''': The first matching side's gold will be stored in the variable "variable".
* '''variable''': (default='gold') the name of the variable to store the gold in

==== [store_locations] ====

Stores a series of locations that pass certain criteria into an array. Each member of the array has members 'x' and 'y' (the position) and 'terrain' (the terrain type) and 'owner_side' (villages only). The array will include any unreachable border hexes, if applicable.

* [[StandardLocationFilter]]: a location or location range which specifies the locations to store. By default, all locations on the map are stored.

* '''variable''': the name of the variable (array) into which to store the locations.

* '''mode''': {{DevFeature1.13|0}} defaults to ''always_clear'', which clears the variable, whether or not a match is found. If mode is set to ''replace'', the variable will not be cleared, and locations which match the filter will overwrite existing elements at the start of the array, leaving any additional elements intact if the original array contained more elements than there are locations matching the filter. If mode is set to ''append'', the variable will not be cleared, and locations which match the filter will be added to the array after the existing elements.

==== [store_reachable_locations] ====

Stores locations reachable by the given units. Can store either the movement, attack or vision ranges.

* '''[filter]''': a [[StandardUnitFilter]]. The locations reachable by any of the matching units will be stored.
* '''[filter_location]''': (optional) a [[StandardLocationFilter]]. Only locations which also match this filter will be stored.
* '''range''': possible values ''movement'' (default), ''attack'', ''vision''. If ''movement'', stores the locations within the movement range of the unit, taking Zone of Control into account. If ''attack'', stores the attack range (movement range + 1 hex). See note below for ''vision''.
* '''moves''': possible values ''current'' (default), ''max''. For ''movement'' and ''attack'', specifies whether to use the current or maximum movement points when calculating the range. Ignored for ''vision''.
* '''viewing_side''': If left unset then fog and shroud are ignored, hidden ambushers are not ignored, and the real reach of the units is stored. If set to a non-zero number, then the area stored for each unit matching the SUF is based on the information visible to that unit's side; it doesn't matter which non-zero number is given. Ignored completely for ''vision''.
* '''variable''': the name of the variable (array) into which to store the locations.

In 1.14 and before, the ''vision'' range is calculated as max movement range ignoring ZoC + 1 hex.

{{DevFeature1.15|12}} ''vision'' uses the same calculations as the fog and shroud, and handles:
* units with vision costs different to movement costs
* units whose vision points aren't the same as their max movement points
* jamming by enemy units

==== [store_map_dimensions] ====

Stores the map dimensions in a variable.

* '''variable''': the name of the variable where the values will be saved into. If it is skipped, a variable 'map_size' is used, and its contents overridden, if they existed already. The result is a container variable, with members ''width'' and ''height''.

==== [store_side] ====

Stores information about a certain side in a variable.

'''Keys:'''
* '''[[StandardSideFilter]]''': All matching sides are stored. (An array is created if several sides match - access it with side[2].team_name and so on.)
* '''variable''': the name of the variable to store the information in (default: "side")
* '''mode''':{{DevFeature1.13|0}} defaults to ''always_clear'', which clears the variable, whether or not a match is found. If mode is set to ''replace'', the variable will not be cleared, and sides which match the filter will overwrite existing elements at the start of the array, leaving any additional elements intact if the original array contained more elements than there are sides matching the filter. If mode is set to ''append'', the variable will not be cleared, and sides which match the filter will be added to the array after the existing elements.
'''Result'''

Variable will contain following members:
* '''color''': Team color used for ellipses, sprites, and flags. Will be one of the id's found in data/core/team-colors.cfg
* '''controller''': Indicates type of player that control this side. ''Note: In networked multiplayer, the controller attribute may not be the same on all clients. Be very careful or you have OOS errors.''
** '''human''': Human player
** '''ai''': If players assigns "Computer Player" to "Player/Type" in game lobby
** '''null''': If players assigns "Empty" to "Player/Type" in game lobby
* '''fog''': Indicates whether this side is affected by fog of war.
* '''gold''': The amount of gold the side has.
* '''hidden''': (boolean) If 'yes', side is not shown in status table.
* '''income''': Income for this side (base income + all village income. AKA gross income. Note that this is different from the [side] income key).
* '''name''': Name of player.
* '''recruit''': A comma-separated list of unit types that can be recruited by this side.
* '''shroud''': Whether this side is affected by shroud.
* '''side''': The $side_number of the side belonging to this container
* '''team_name''': String representing the team's description.
* '''user_team_name''': Translated string representing the team's description.
* '''village_gold''': The amount of gold given to this side per village it controls per turn.
* '''scroll_to_leader''': (boolean) Whether the game view scrolls to the side leader at the start of their turn.
* '''flag''': Flag animation for villages owned by this side (see [[SideWML|[side]]]). Unless previously specified in [side] or changed with WML (see [[DirectActionsWML#.5Bmodify_side.5D|[modify_side]]]), this value may be empty for the default flag animation.
* '''flag_icon''': Flag icon for the status bar for this side (see [[SideWML|[side]]]). Unless previously specified in [side] or changed with WML (see [[DirectActionsWML#.5Bmodify_side.5D|[modify_side]]]), this value may be empty for the default flag icon.
* '''village_support''': The number of unit levels this side is able to support (does not pay upkeep on) per village it controls.
* '''defeat_condition''': {{DevFeature1.13|7}} When the side will be considered defeated. See description at [[SideWML]], [[ScenarioWML#Scenario_End_Conditions]]
* '''faction''': {{DevFeature1.13|7}} id of the selected faction, string (multiplayer-only)
* '''faction_name''': {{DevFeature1.13|7}} Name of the selected faction, string (multiplayer-only)
* '''num_units''' {{DevFeature1.13|7}}: The number of units the side currently has on the map.
* '''num_villages''' {{DevFeature1.13|7}}: The number of villages the side currently controls.
* '''total_upkeep''' {{DevFeature1.13|7}}: The number of unit levels the side is currently supporting.
* '''expenses''' {{DevFeature1.13|7}}: The amount of gold the side is currently spending to support units.
* '''net_income''' {{DevFeature1.13|7}}: The income the side gains per turn after expenses.
* '''base_income''' {{DevFeature1.13|8}}: The income the side gains per turn (same as [side] income key)

* {{DevFeature1.13|7}} All other keys and tags of the side that are contained in [[LuaWML:Sides#wesnoth.sides|wesnoth.sides]] .__cfg

==== [store_starting_location] ====

Stores the starting location of a side's leader in a variable. The variable is a composite type which will have members 'x', 'y', 'terrain' and 'owner_side' (villages only)

* [[StandardSideFilter]]: The starting locations of all matching sides will be stored. If multiple sides are matched, a WML array will be created.
* '''variable''': (default='location'): the name of the variable to store the location in
* '''mode''':{{DevFeature1.13|0}} defaults to ''always_clear'', which clears the variable, whether or not a match is found. If mode is set to ''replace'', the variable will not be cleared, and the starting locations of the sides which match the filter will overwrite existing elements at the start of the array, leaving any additional elements intact if the original array contained more elements than there are locations matching the filter. If mode is set to ''append'', the variable will not be cleared, and the starting locations of the matching sides will be added to the array after the existing elements.

==== [store_time_of_day] ====

Stores time of day information from the current scenario into a WML variable container.

* '''x, y''': Location to store the time for. [[DirectActionsWML#.5Btime_area.5D|Time areas]] matter; illumination does not. If this is omitted, the global (location-independent) time is stored.

* '''variable''': (default='time_of_day') name of the container on which to store the information. The container will be filled with the same attributes found on [[TimeWML]].

* '''turn''': (defaults to the current turn number) changes the turn number for which time of day information should be retrieved.

==== [store_turns] ====

Stores the turn limit (the maximum number of turns). If there is no limit, this stores ''-1''.

* '''variable''': (default='turns') the name of the variable in which to store the turn limit.

==== [store_unit] ====

Stores details about units into a [[VariablesWML#Container|container]] variable. When a unit is stored, all keys and tags in the unit definition may be manipulated, including some others, with [[InternalActionsWML#.5Bset_variable.5D|[set_variable]]]. A sample '''list of these tags and keys''' can be found at [[InternalActionsWMLUnitTags]].

If you have a doubt about what keys are valid or what the valid value range is for each key, code a [store_unit] event, save the game, and examine what keys are in the file (or just examine the '''[unit]''' tag(s) in any save file). One can also use the [[CommandMode|:inspect]] command or the [[InterfaceActionsWML#.5Binspect.5D|[inspect]]] tag to open a game-state inspector dialog, which can be used to view unit properties.

Common usage is to manipulate a unit by using '''[store_unit]''' to store it into a variable, followed by manipulation of the variable, and then [[DirectActionsWML#.5Bunstore_unit.5D|[unstore_unit]]] to re-create the unit with the modified variables.

''Note: stored units also exist on the field, and modifying the stored variable will not automatically change the stats of the units. You need to use [unstore_unit]. See also [[DirectActionsWML#.5Bunstore_unit.5D|[unstore_unit]]] and [[ConditionalActionsWML#.5Bforeach.5D|[foreach]]].

* '''[filter]''' with a [[StandardUnitFilter]] as argument. All units matching this filter will be stored. If there are multiple units, they will be stored into an array of variables. The units will be stored in order of their internal ''underlying_id'' attribute, which is usually in creation order (but you normally should not depend on the order).

* '''variable''': the name of the variable into which to store the unit(s)

* '''mode''': defaults to ''always_clear'', which clears the variable, whether or not a match is found. If mode is set to ''replace'', the variable will not be cleared, and units which match the filter will overwrite existing elements at the start of the array, leaving any additional elements intact if the original array contained more elements than there are units matching the filter. If mode is set to ''append'', the variable will not be cleared, and units which match the filter will be added to the array after the existing elements.

* '''kill''': if 'yes' the units that are stored will be removed from play. This is useful for instance to remove access to a player's recall list, with the intent to restore the recall list later.

==== [store_unit_defense] ====

{{DevFeature1.13|9}}

{{DevFeature1.15|7}} Fixed, was broken in 1.15.3

Stores in a variable the defense of a unit on a particular terrain. If terrain or location is not specified, the terrain on which the unit currently stands is used. (Note: it is a WML defense, so the higher it is, the weaker unit's defense is. A footpad on castle has 70% defense, so this function stores the value 30.)

* StandardUnitFilter
* '''loc_x''', '''loc_y''': x and y of a valid map location. The terrain on this location will be used for the defense calculation.
* '''terrain''': The terrain code for which unit defense should be calculated. If '''terrain''' is specified, '''loc_x''' and '''loc_y''' are ignored.
* '''variable''': the name of the variable into which to store the defense. default: "terrain_defense"

==== [store_unit_defense_on] ====

{{DevFeature1.15|7}} Similar to [store_unit_defense], but stores the same number that would be shown in the UI. For example, a footpad on castle has 70% defense, so this stores the value 70.

Takes the same attributes as [store_unit_defense], and defaults to storing the value in "terrain_defense".

==== [store_unit_type] ====

Stores a unit type definition into a variable.

* '''type''': (required) the defined ID of the unit type, for example "Goblin Knight". Do not use a translation mark or it will not work correctly for different languages. A comma-separated list of IDs may also be used to store an array of unit types.

* '''variable''': the name of the variable into which to store the unit type information (default "unit_type")

* '''mode''':{{DevFeature1.13|0}} defaults to ''always_clear'', which clears the variable. If mode is set to ''replace'', the variable will not be cleared, and the unit type will overwrite the existing element at the start of the array, leaving any additional elements intact if the original array contained more elements. If mode is set to ''append'', the variable will not be cleared, and the unit type will be added to the array after the existing elements.

==== [store_unit_type_ids] ====

* '''variable''': the name of the variable into which to store a comma-separated list of all unit type IDs including all from all loaded addons

==== [store_villages] ====

Stores a series of locations of villages that pass certain criteria into an array. Each member of the result array will have members 'x' and 'y' (the position) and 'terrain' (the terrain type) and 'owner_side'.

Note: This differs from using [store_locations] only in that the hexes considered for match are restricted to those with villages (those whose terrain type has its 'gives_income' flag set to true), in the same way that use of either the 'owner_side' key or the '[filter_owner]' will. In fact, if either of these are present, [store_villages] and [store_locations] will behave identically.

* '''variable''': the name of the variable (array) into which to store the locations (default: "location")
* '''[[StandardLocationFilter]]''' tags and keys as arguments

==== [store_items] ====

Stores current items in the scenario into an array. Each entry has at least members x and y and can have all of the other keys listed in the documentation of [[InterfaceActionsWML#.5Bitem.5D|[item]]] (depending on what was set during creating the item).

*'''variable''': name of the wml variable array to use (default "items")
*'''[[StandardLocationFilter]]''' keys as arguments: only items on locations matching this [[StandardLocationFilter]] will be stored
*'''item_name''': {{DevFeature1.15|0}} if given, only items created with a matching '''[item]name=''' will be stored. As of 1.15.0, this does not support comma-separated lists.

==== [store_relative_direction] ====

{{DevFeature1.13|0}}

Gets the relative direction from one hex to another. This is an interface to the function wesnoth uses to decide how a unit will face while it is moving / attacking / defending.

* '''[source]''' x and y must describe a map location
* '''[destination]''' similar
* '''variable''' name of the variable to store string result in (one of 'n', 'nw', 'ne', 's', 'sw', 'se')
* '''mode''' optional. 0 is the default setting corresponding to default wesnoth implementation used in animations. 1 is an alternate "radially symmetric" mode. The default mode breaks ties in the direction of south, since this makes more units face the player directly on screen. The radially symmetric mode breaks ties in the direction of counter-clockwise, and might be more appropriate in some cases.

==== [find_path] ====

A WML interface to the pathfinder. Calculates the path between a unit and a location and returns the result in a WML variable, that contains also an array for every step of the path (including the starting hex).

*'''[traveler]''': [[StandardUnitFilter]], only the first matching unit will be used for calculation
*'''[destination]''': [[StandardLocationFilter]]
*'''variable''': the variable name where the result will be stored, if no value is supplied 'path' will be used as default name. Each step will be stored in a [step] array inside that variable.
*'''allow_multiple_turns''': default no, if yes also moves that require more than one turn will be calculated.
*'''check_visibility''': default no, if yes the path will not be computed if some hexes are not visible due to shroud.
*'''check_teleport''': default yes; if no, teleport won't be taken in account while computing path.
*'''check_zoc''': default yes; if no, unit ZOCs won't be considered while calculating the path.
*'''nearest_by''': {{DevFeature1.15|2}} possible values "movement_cost" (default), "steps", "hexes"; if the [destination] SLF matches multiple hexes, the one that would need the least movement points to reach may not be the one that's closest as measured by '''hexes''', or closest as measured by steps, from the starting point. This option chooses which measurement to prefer.

More detail about multiple destinations and the return structure is on [[FindPathExplanation]] (moved out of this page because it has an image in it).

This is the structure of the variable returned by [find_path]:
[path]
hexes = non-zero if a path was successfully found.
if the path is calculated to an impassable hex, or the move requires multiple turns
and allow_multiple_turns is no, its value will be 0.
from_x, from_y = location of the unit
to_x, to_y = destination
movement_cost = total movement cost required by unit to reach that hex
required_turns = total turns required by unit to reach that hex
[step]
x, y = location of the step
terrain = terrain of the step
movement_cost = movement cost required by unit to reach that hex
required_turns = turns required by unit to reach that hex
[/step]
[/path]

==== [unit_worth] ====
Takes only an inline [[StandardUnitFilter]] (only the first matching unit will be used for calculation) and outputs the following variables:
*''cost'', the current unit cost;
*''next_cost'', the cost of the most expensive advancement;
*''health'', the health of the unit in percentage;
*''experience'', current experience in percentage;
*''unit_worth'', how much the unit is worth.

Mainly used for internal AI checks, but one could in theory just do anything with it.

[event]
name=moveto
[unit_worth]
x,y=$x1,$y1
[/unit_worth]
[message]
id=$unit.id
message=_"I cost $cost gold, with $health|% of my hitpoints and $experience|% on the way to cost $next_cost|.
I am estimated to be worth $unit_worth"
[/message]
[clear_variable]
name=cost,next_cost,health,experience,unit_worth
[/clear_variable]
[/event]

=== [clear_variable] ===

This will delete the given variable. This tag can delete a scalar or an entire array; it can also delete one container at an array index. The macro [http://www.wesnoth.org/macro-reference.xhtml#CLEAR_VARIABLE CLEAR_VARIABLE] is a shortcut for this tag.

This action is good to use to clean up the set of variables; for example, a well-behaved scenario will delete any variables that should not be kept for the next scenario before the end of the scenario. One can also clear tags and variables of stored units; for example, one can remove [trait]s and [object]s.

* '''name''': the name of the variable to clear. This can also be a comma-separated list of multiple variable names.
** If a name ends with an array index, then it deletes that one container, and shifts the indexes of all subsequent containers. For example, <code>{CLEAR_VARIABLE my_awesome_array[2]}</code> deletes <code>my_awesome_array[2]</code>, but then moves <code>my_awesome_array[3]</code> to <code>my_awesome_array[2]</code>, moves <code>my_awesome_array[4]</code> to <code>my_awesome_array[3]</code>, and so on until the end of the array.
** Note that <code>{CLEAR_VARIABLE my_awesome_array}</code> deletes the entire array, but <code>{CLEAR_VARIABLE my_awesome_array[0]}</code> deletes only the first container.

=== [sync_variable] ===

{{DevFeature1.13|0}}

Sets one or multiple variables to the same value as on all clients and also on replays, it uses the value from the currently active side.
* '''name''' the name of the variable to synchonize this can be a comma seperated list.

== Other Internal Actions ==

Believe it or not, there are some internal actions that are not focused primarily on variables. They are all grouped here.

=== [fire_event] ===

Trigger a WML event (used often for [[EventWML#Custom_events|custom events]])

* '''name''': the name of event to trigger
** ''(Optional)'' {{DevFeature1.13|6}}

* '''id''': ''(Optional)'' the id of a single event to trigger {{DevFeature1.13|6}}

* '''[primary_unit]''': ''(Optional)'' Primary unit for the event. Will never match on a recall list unit. The first unit matching the filter will be chosen.
**[[StandardUnitFilter]] as argument. Do not use a [filter] tag.

* '''[secondary_unit]''': ''(Optional)'' Same as '''[primary_unit]''' except for the secondary unit.
**[[StandardUnitFilter]] as argument. Do not use a [filter] tag.

* '''[primary_attack]''': Information passed to the primary attack filter and $weapon variable on the new event.

* '''[secondary_attack]''': Information passed to the second attack filter and $second_weapon variable on the new event.

=== [remove_event] ===
{{DevFeature1.13|0}} Removes the event with the specified id.

* '''id''': the id of the event to remove. May be a comma separated list.

=== [insert_tag] ===

Inserts a variable as WML. In other words, the value of the passed [[VariablesWML#Container|container variable]] will be injected into the game as if they had been written out in WML form. ([[#.5Binsert_tag.5D_Example|See Example]]).

Tag insertion is a special case in that it can be used in places where other ActionWML cannot be used. The basic rule is that anywhere that $variable syntax works, tag insertion will also work. In practice this means pretty much everywhere except directly within top-level scenario tags.

*'''name''': The ["name"] to be given to the tag. This must be a tag which would be valid at the place where [insert_tag] is used, for anything to happen. (For example, if used as ActionWML, it should be a [[ActionWML]] tag name, and it may be a recognized subtag such as "option" when used within a [message]).

*'''variable''': Name of the container variable which will have its value inserted into the tag. If the container variable is a WML array, [insert_tag] will insert a different tag for each of its elements.

=== [role] ===

Tries to find a unit to assign a role to. This is useful if you want to choose a non-major character to say some things during the game. Once a role is assigned, you can use '''role=''' in a unit filter to identify the unit with that role (See [[FilterWML]]). However, there is no guarantee that roles will ever be assigned. You can use '''[have_unit]''' (see [[ConditionalActionsWML#Condition_Tags|Condition Tags]]) to see whether a role was assigned. This tag uses a [[StandardUnitFilter]] (without [filter]) with the modification to order the search by type, mark only the first unit found with the role, and the role attribute is not used in the search. If for some reason you want to search for units that have or don't have existing roles, you can use one or more [not] filters. The will check recall lists in addition to units on the map. In normal use, you will probably want to include a ''side'' attribute to force the unit to be on a particular side.

* '''role''': the value to store as the unit's role. This role is not used in the [[StandardUnitFilter]] when doing the search for the unit to assign this role to.

* '''type''': a comma-separated list of possible types the unit can be. If any types are given, then units will be searched by type in the order listed. If no type is given, then no particular order with respect to type is guaranteed.

* '''search_recall_list''': {{DevFeature1.13|5}} whether to consider units on the recall list when assigning the role. Can be either yes or no, defaults to yes. {{DevFeature1.13|6}} If set to 'only', then units on the map are not considered when assigning the role - only units on the recall list can receive it.

* '''[else]''' {{DevFeature1.13|5}} ActionWML to execute if the game is unable to find a unit to assign the role to. For example, this could be used to create a new unit satisfying the role.

* '''[auto_recall]''' {{DevFeature1.13|6}} If present, and the role is assigned to a unit on the recall list, then that unit is recalled. Supports all unique keys of [[DirectActionsWML#.5Brecall.5D|[recall]]], but no [[StandardUnitFilter]].

* [[StandardUnitFilter]], do not use a [filter] sub-tag. SUF's role= and type= keys are not used: if you want to use them, use a nested SUF wrapped inside a [and] tag.

=== [random_placement] ===
{{DevFeature1.13|2}}

Selects randomly a given number of locations from a given set of locations and exectutes the given code for each of those locations.

* '''[filter_location]''': a [[StandardLocationFilter]].
* '''[command]''': contains ActionWml that is executed for each of the locations.
* '''num_items''': the number of locations that should be selected. There are several ways of specifying this:
** An integer, giving the exact number of locations to use. (Variable substitution is supported too.)
** {{DevFeature1.15|0}} A percentage, meaning that fraction of the total available spaces.
** {{DevFeature1.15|0}} A [[Wesnoth_Formula_Language|WFL]] formula. It has access to one variable, ''size'', which is the total number of available spaces. In order to identify it as a WFL formula, the entire expression must be enclosed in parentheses. (Do not use a '''$''', as that will cause it to see ''size'' as zero.)
** A Lua expression. As with a WFL expression, it can access the ''size'' variable. {{DevFeature1.15|0}} This is now deprecated.
* '''variable''': The name of the variable that contains the current location during the execution of [command]. This is a container with the attributes x, y, n and terrain.
* '''min_distance''': The minimum distance of 2 chosen locations, a value less than 0 means that the same locations can be chosen more than one time.
* '''allow_less''': If yes, the tag will not show an error in case there were less than num_items locations available.

=== Flow control actions ===

{{DevFeature1.13|2}}

There are three actions that alter the flow of execution. They are '''[break]''', '''[continue]''', and '''[return]'''. All of them take no arguments.

* '''[break]''': The nearest enclosing loop immediately stops executing, and control continues with the next action after the end of that loop. If there is no enclosing loop, this is equivalent to '''[return]'''.
* '''[continue]''': The nearest enclosing loop immediately stops executing, and control continues at the beginning of that loop, with any iteration variables updated for the next iteration. If there is no enclosing loop, this is an error.
* '''[return]''': Control immediately returns to the Wesnoth engine. This completely exits the current event, including any nested events, such that the [message] will not be displayed in the below example. No further WML actions are executed in this context. Any separate, subsequent events will be run as usual.
<syntaxhighlight lang=wml>
[event]
name=moveto
[fire_event]
name=return_please
[/fire_event]
[message]
message="Made it back"
[/message]
[/event]
[event]
name=return_please
[return][/return]
[/event]
</syntaxhighlight>

=== [unsynced] ===

{{DevFeature1.13|?}}

Runs the contained actionwml in a unsynced context, that means actions performed inside [unsynced] are not synced over the network. for example
<syntaxhighlight lang=wml>
[event]
name=moveto
{VARIABLE_OP message rand "Hi,Hello,How are you?"}
[message]
message = $message
[/message]
{CLEAR_VARIABLE message}
[allow_undo]
[/allow_undo]
[/event]
</syntaxhighlight>
will print the same message to all clients, but also disallow undoing (regardless of [allow_undo]) for that moveto becasue it requests a synced random seed form the server. However this code
<syntaxhighlight lang=wml>
[event]
name=moveto
[unsynced]
{VARIABLE_OP message rand "Hi,Hello,How are you?"}
[message]
message = $message
[/message]
{CLEAR_VARIABLE message}
[unsynced]
[allow_undo]
[/allow_undo]
[/event]
</syntaxhighlight>
will not prevent undoing, but might print a different message for each client in a multiplayer game (or during a sp replay), so `[unsynced]` should not be used for actions that actually change the gamestate otherwise you'll get OOS

== Examples ==

=== Using [set_variables] to Create Arrays of WML ===

<syntaxhighlight lang=wml>
[set_variables]
name=arr
mode=replace
[value]
foo=bar
[/value]
[value]
foo=more
[/value]
[/set_variables]
{DEBUG_MSG $arr[0].foo}
{DEBUG_MSG $arr[1].foo}
</syntaxhighlight>

This will produce two output messages, first one saying '''bar''' and next one saying '''more'''.

=== [insert_tag] Example ===

<syntaxhighlight lang=wml>
[event]
name=moveto

[set_variable]
name=temp.speaker
value=Konrad
[/set_variable]

[set_variable]
name=temp.message
value= _ "Yo Kalenz!"
[/set_variable]

[insert_tag]
name=message
variable=temp
[/insert_tag]
[/event]
</syntaxhighlight>

This is effectively identical to:

<syntaxhighlight lang=wml>
[event]
name=moveto

[message]
speaker=Konrad
message= _ "Yo Kalenz!"
[/message]
[/event]
</syntaxhighlight>

== See Also ==
* [[VariablesWML]]
* [[ActionWML]]
** [[ConditionalWML]]
** [[DirectActionsWML]]
** [[InterfaceActionsWML]]
* [[EventWML]]
* [[ReferenceWML]]

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

SideWML

2020-08-09T02:35:28Z

Beetlenaut: Undo revision 65870 by Beetlenaut (talk)

{{WML Tags}}
== the [side] tag ==

The [side] tag is used to describe a side in a particular scenario.

The following keys are recognized:

* '''side''': a number. The leader of this side is placed on the tile represented by this number (see [[BuildingMaps]]). When defining sides, they must be defined in order since the side number is checked against the number of sides seen so far. Currently, the Multiplayer server rejects entering a scenario with more than 9 sides, even if those extra sides are AI sides. {{DevFeature1.13|2}} The server doesn't limit the number of sides anymore.

* '''controller''' (required): how moves for this side should be inputted.
** '''ai''': the Wesnoth AI makes this side's moves.
** '''human''': a player controls this side's moves.
** '''null''': the side doesn't get a turn to move and doesn't have a leader generated from the contents of the [side] tag. (It still can get units from [unit] tags in the [side] tag.) Events that would usually occur on the side's turn will not take place. This includes healing (ability, villages and rest) and ''side turn'' events.
** '''a number''': gives this side's control to a side with '''side''' matching the number (multiplayer only). {{DevFeature1.13|2}} using a number is deprecated, use previous_save_id= instead.
** Note: in multiplayer, when reading the side's data with ''[store_side]'', the value may differ between clients and using it for conditional actions may cause OOS. Discussion in https://r.wesnoth.org/p643343

* '''no_leader''': if `no' (default), then keys describing a unit which will begin on the side's keep will be the remainder of the '''[side]''' tag, See [[SingleUnitWML]]. Note that if the keys '''x''', '''y''' are included, the leader will begin there regardless of keep location. If this side has a recall list from a previous level, then the recall list will be searched for a leader (using ''canrecruit=yes'') and if one is found it will be used instead of the one described in the '''[side]''' tag. Typical keys used for defining the leader unit are ''type'' (mandatory), ''id'', ''name'' and ''unrenamable=yes'', see [[SingleUnitWML]].

* '''recruit''': a list of unit types. At the beginning of the scenario, the side gains recruitment of these units. {{DevFeature1.13|?}} in multiplayer, unless you specify ''faction=Custom'', this will be overwritten by the recruit list from the faction.

* '''gold''': the starting gold for this side. Default: 100. (If gold is carried over from a previous scenario, this value is the minimum starting gold.)

* '''income''': the base income for this side. Default: 0. This is added to ''base_income'', '''[game_config]''' to determine the side's base income. (see [[GameConfigWML]]).

* '''hidden''': if `yes', side is not shown in status table.

* '''fog''': if `yes', this side cannot see any tiles it is not within vision of, except at the start. Please note that the AI currently ignores the fog.

* '''fog_data''': describes the area which this team has de-fogged, using the same format as shroud_data. (This is not particularly useful when defining a side, though, as the game will recalculate fog as turns begin and end.) It is used in saved games.

* '''[fog_override]''' With keys x= and y=, this records the hexes that have been cleared (multiturn) with {{tag|DirectActionsWML|lift_fog}}.

* '''shroud''': if `yes', this side cannot see any tiles it has not moved within sight of. Please note that the AI currently ignores the shroud. NOTE: with shroud=no, this team *ignores* shroud, so it is not possible to modify it using place_shroud and remove_shroud tags. If you want to do so, use "shroud=yes" and place_shroud/remove_shroud tags.

* '''shroud_data''': describes the area which this team has de-shrouded. An example:
|
|00011111000
:This would leave the first column on the map unaltered and would change the second column for 11 tiles. A '0' means: shrouded, '1' means unshrouded. You can either call an external file using {@filename} (see [[PreprocessorRef]]) or place the data in quotes. For making an external file see [[ShroudDataWML]].

* '''persistent''': whether the side exists in any other scenarios. If `yes', then ''save_id'' (see below) is used to identify the side in other scenarios. Defaults to `yes' for sides with a human controller, and `no' for ai controlled sides.

* '''save_id''': defaults to the leader's ''id'' if available, 'Unknown' otherwise. The ID of the side with respect to the previous and next scenarios. Used to carry over the side's recall list (including the side's leader), recruitment list, and starting gold from scenario to scenario. Also used for the side's displayed name in the victory gold-calculation dialog.

* '''previous_save_id''': {{DevFeature1.13|2}} defaults to ''save_id''. Only used in mp games, specially mp campaigns. This attribute specifies which user should play this side by default. For example if a side has previous_save_id="Konrad" then the side will be assigned to that player who played the side with the save_id="Konrad" in the previous level. If used in the first scenario, multiple sides with the same ''previous_side_id'' will be assigned to the same player.

* '''team_name''': a non translatable string representing the team's description. Sides with the same team_name are allied. Default ''side''. ''team_name'' is now a comma-separated list of teams that the side is on.

* '''user_team_name''': a translatable string representing the team's description. This has no effect on alliances. Default ''team_name''.

* '''current_player''': a translatable string representing the player's or leader's name. Defaults to the leader's id; if the side's leader is a human player in multiplayer, the default is the player's username. {{DevFeature1.13|0}} This field is now always the player name (mp server nick) it impossible to change it with wml/lua. {{DevFeature1.13|5}} You can use ''side_name'' instead to specify the name for the side (which is then used in new turn dialogs, statisitc dialogs etc.)

* '''side_name''': {{DevFeature1.13|5}} a translatable string representing the name of the side, used for example in the new turn dialog. Defaults to ''name'' if the side was inside a '''[scenario]''' and to the player's name if the side was inside a '''[multiplayer]'''.

* '''color''': May be either a numeric color index or a color name (e.g. 'blue', 'purple', 'orange', etc.). The numeric form is deprecated. The default list of numbers and corresponding colors can be found in data/core/team_colors.cfg.

* '''flag''': a custom flag animation to use instead of the default one to mark captured villages. An automatic side-coloring is applied.
** Example animation that has three frames and loops every 750ms: ''flag=misc/myflag-[1~3].png:750''

* '''flag_icon''': a custom flag icon to indicate the side playing in the statusbar (a size of 24x16 is recommended). An automatic side-coloring is applied.

* '''village_gold''': the amount of gold given to this side per village it controls per turn. Default specified in ''village_income'', '''[game_config]''' ([[GameConfigWML]]).

* '''village_support''': the number of unit levels this side is able to support (does not pay upkeep on) per village it controls. Default specified in ''village_support'', '''[game_config]''' ([[GameConfigWML]]).

* '''recall_cost''': the amount of gold it costs to recall a unit. Default specified in ''recall_cost'', '''[game_config]''' ([[GameConfigWML]]). {{DevFeature1.15|0}} Units are now recalled for AI sides even if the recall_cost is larger than the unit's worth (essentially its cost, plus potentially a bonus for experience points). In 1.14 and earlier, units were not recalled by the AI in this case even if this was the only recall/recruit action possible to the AI.

* '''share_maps''': whether sides allied with this side see all terrains that this side sees, if they are on shroud. {{DevFeature1.13|1}} This has been deprecated in favor of share_vision (see below).

* '''share_view''': whether sides allied with this side see the units that this side sees, if they are on FoW (fog). {{DevFeature1.13|1}} This has been deprecated in favor of share_vision (see below).

* '''share_vision''': {{DevFeature1.13|1}} all/shroud/none. If ''all'', both shroud and fog view will be shared by this side. If ''shroud'', only shroud view will be shared. If ''none'', the view is not shared.

* '''scroll_to_leader''': optional. If `no', scroll to the leader is not performed on the start of each turn. (default: yes)

* '''suppress_end_turn_confirmation''': If "yes", then the player will not be asked to confirm ending their turn even if they have not done anything. This is provided for some (probably few) user-made scenarios in which players often skip their turns. (default: no)

* '''[ai]''' if '''controller=ai''', gives parameters to the AI. See [[AiWML]].

* '''[village]''' describes a village the side begins in control of.
** ''x'', ''y'' the location of the village. If the pair of coordinates is not a village or is duplicated in another '''[village]''' tag, behaviour is undefined. Recent game engine or wmllint should warn about these.

* '''[unit]''' describes a unit which begins on the side. See [[SingleUnitWML]]. If the side has a recall list and the unit is not given a location, it will start on the recall list. Note that the ''side'' attribute under '''[unit]''' will be ignored, as the side will come from the ''side'' attribute of '''[side]'''.

* '''[leader]''' same as '''[unit]''' except that ''canrecruit'' will default to yes and current position to the side starting location if not specified.

* '''defeat_condition''' Specifies when a side is considered ''defeated'' this is checked ''for all sides'', after every player action and at the beginning of every turn.
** '''no_leader_left''': (default) The side is considered defeated if it has no units with canrecruit=yes
** '''no_units_left''': The side is defeated as soon as it has no units left.
** '''never''': The side is never considered defeated.
** '''always''': The side is always considered defeated.

: For the meaning and significance of ''defeated'', see [[ScenarioWML#Scenario_End_Conditions]]

The following keys are multiplayer only:

* '''allow_player''': if false then this side will not be allowed to be modified and will be hidden during game creation. False also prevents this side from being included in shuffle sides. Defaults to yes.

* '''disallow_observers''': prevents observers from seeing this side turn. (default: no)

* '''disallow_shuffle''': {{DevFeature1.13|0}} do not shuffle this side if the "shuffle sides" option is used. (Usually all playable sides are shuffled.) (default: no)

* '''chose_random''': {{DevFeature1.13|0}} indicates if a side chose a random faction during creation

* '''controller_lock''': if true then this side's controller ("Player/Type") modification is limited. It is bound to the '''controller''' attribute in [[SideWML]].

* '''team_lock''': if true then this side's team is not allowed to be modified.

* '''color_lock''': if true then this side's color is not allowed to be modified.

* '''gold_lock''': if true then this side's gold is not allowed to be modified.

* '''income_lock''': if true then this side's income is not allowed to be modified.

* '''faction_lock''': if true then this side's faction is not allowed to be modified.

* '''leader_lock''': if true then this side's leader (type or gender) is not allowed to be modified.

* '''faction''': if a valid faction id is provided then this side's faction will default to it. {{DevFeature1.13|?}} if this key isn't included in the ''[side]'' then a random faction will be chosen, and the side's recruit list set from the faction. To use a custom ''recruit'' list, you must also specify ''faction=Custom''.

* '''faction_from_recruit''': if true then this side will be locked to the faction that matches the recruits better.

N.B. the ''lock'' attributes use [[ScenarioWML]] '''force_lock_settings''' as their default value. I.e. if no value to ''lock'' was set, it will take '''force_lock_settings''' value.

== See Also ==
* [[EraWML]]
* [[ScenarioWML]]
* [[ReferenceWML]]

[[Category: WML Reference]]

SideWML

2020-08-09T02:33:41Z

Beetlenaut: inputted->input

{{WML Tags}}
== the [side] tag ==

The [side] tag is used to describe a side in a particular scenario.

The following keys are recognized:

* '''side''': a number. The leader of this side is placed on the tile represented by this number (see [[BuildingMaps]]). When defining sides, they must be defined in order since the side number is checked against the number of sides seen so far. Currently, the Multiplayer server rejects entering a scenario with more than 9 sides, even if those extra sides are AI sides. {{DevFeature1.13|2}} The server doesn't limit the number of sides anymore.

* '''controller''' (required): how moves for this side should be input.
** '''ai''': the Wesnoth AI makes this side's moves.
** '''human''': a player controls this side's moves.
** '''null''': the side doesn't get a turn to move and doesn't have a leader generated from the contents of the [side] tag. (It still can get units from [unit] tags in the [side] tag.) Events that would usually occur on the side's turn will not take place. This includes healing (ability, villages and rest) and ''side turn'' events.
** '''a number''': gives this side's control to a side with '''side''' matching the number (multiplayer only). {{DevFeature1.13|2}} using a number is deprecated, use previous_save_id= instead.
** Note: in multiplayer, when reading the side's data with ''[store_side]'', the value may differ between clients and using it for conditional actions may cause OOS. Discussion in https://r.wesnoth.org/p643343

* '''no_leader''': if `no' (default), then keys describing a unit which will begin on the side's keep will be the remainder of the '''[side]''' tag, See [[SingleUnitWML]]. Note that if the keys '''x''', '''y''' are included, the leader will begin there regardless of keep location. If this side has a recall list from a previous level, then the recall list will be searched for a leader (using ''canrecruit=yes'') and if one is found it will be used instead of the one described in the '''[side]''' tag. Typical keys used for defining the leader unit are ''type'' (mandatory), ''id'', ''name'' and ''unrenamable=yes'', see [[SingleUnitWML]].

* '''recruit''': a list of unit types. At the beginning of the scenario, the side gains recruitment of these units. {{DevFeature1.13|?}} in multiplayer, unless you specify ''faction=Custom'', this will be overwritten by the recruit list from the faction.

* '''gold''': the starting gold for this side. Default: 100. (If gold is carried over from a previous scenario, this value is the minimum starting gold.)

* '''income''': the base income for this side. Default: 0. This is added to ''base_income'', '''[game_config]''' to determine the side's base income. (see [[GameConfigWML]]).

* '''hidden''': if `yes', side is not shown in status table.

* '''fog''': if `yes', this side cannot see any tiles it is not within vision of, except at the start. Please note that the AI currently ignores the fog.

* '''fog_data''': describes the area which this team has de-fogged, using the same format as shroud_data. (This is not particularly useful when defining a side, though, as the game will recalculate fog as turns begin and end.) It is used in saved games.

* '''[fog_override]''' With keys x= and y=, this records the hexes that have been cleared (multiturn) with {{tag|DirectActionsWML|lift_fog}}.

* '''shroud''': if `yes', this side cannot see any tiles it has not moved within sight of. Please note that the AI currently ignores the shroud. NOTE: with shroud=no, this team *ignores* shroud, so it is not possible to modify it using place_shroud and remove_shroud tags. If you want to do so, use "shroud=yes" and place_shroud/remove_shroud tags.

* '''shroud_data''': describes the area which this team has de-shrouded. An example:
|
|00011111000
:This would leave the first column on the map unaltered and would change the second column for 11 tiles. A '0' means: shrouded, '1' means unshrouded. You can either call an external file using {@filename} (see [[PreprocessorRef]]) or place the data in quotes. For making an external file see [[ShroudDataWML]].

* '''persistent''': whether the side exists in any other scenarios. If `yes', then ''save_id'' (see below) is used to identify the side in other scenarios. Defaults to `yes' for sides with a human controller, and `no' for ai controlled sides.

* '''save_id''': defaults to the leader's ''id'' if available, 'Unknown' otherwise. The ID of the side with respect to the previous and next scenarios. Used to carry over the side's recall list (including the side's leader), recruitment list, and starting gold from scenario to scenario. Also used for the side's displayed name in the victory gold-calculation dialog.

* '''previous_save_id''': {{DevFeature1.13|2}} defaults to ''save_id''. Only used in mp games, specially mp campaigns. This attribute specifies which user should play this side by default. For example if a side has previous_save_id="Konrad" then the side will be assigned to that player who played the side with the save_id="Konrad" in the previous level. If used in the first scenario, multiple sides with the same ''previous_side_id'' will be assigned to the same player.

* '''team_name''': a non translatable string representing the team's description. Sides with the same team_name are allied. Default ''side''. ''team_name'' is now a comma-separated list of teams that the side is on.

* '''user_team_name''': a translatable string representing the team's description. This has no effect on alliances. Default ''team_name''.

* '''current_player''': a translatable string representing the player's or leader's name. Defaults to the leader's id; if the side's leader is a human player in multiplayer, the default is the player's username. {{DevFeature1.13|0}} This field is now always the player name (mp server nick) it impossible to change it with wml/lua. {{DevFeature1.13|5}} You can use ''side_name'' instead to specify the name for the side (which is then used in new turn dialogs, statisitc dialogs etc.)

* '''side_name''': {{DevFeature1.13|5}} a translatable string representing the name of the side, used for example in the new turn dialog. Defaults to ''name'' if the side was inside a '''[scenario]''' and to the player's name if the side was inside a '''[multiplayer]'''.

* '''color''': May be either a numeric color index or a color name (e.g. 'blue', 'purple', 'orange', etc.). The numeric form is deprecated. The default list of numbers and corresponding colors can be found in data/core/team_colors.cfg.

* '''flag''': a custom flag animation to use instead of the default one to mark captured villages. An automatic side-coloring is applied.
** Example animation that has three frames and loops every 750ms: ''flag=misc/myflag-[1~3].png:750''

* '''flag_icon''': a custom flag icon to indicate the side playing in the statusbar (a size of 24x16 is recommended). An automatic side-coloring is applied.

* '''village_gold''': the amount of gold given to this side per village it controls per turn. Default specified in ''village_income'', '''[game_config]''' ([[GameConfigWML]]).

* '''village_support''': the number of unit levels this side is able to support (does not pay upkeep on) per village it controls. Default specified in ''village_support'', '''[game_config]''' ([[GameConfigWML]]).

* '''recall_cost''': the amount of gold it costs to recall a unit. Default specified in ''recall_cost'', '''[game_config]''' ([[GameConfigWML]]). {{DevFeature1.15|0}} Units are now recalled for AI sides even if the recall_cost is larger than the unit's worth (essentially its cost, plus potentially a bonus for experience points). In 1.14 and earlier, units were not recalled by the AI in this case even if this was the only recall/recruit action possible to the AI.

* '''share_maps''': whether sides allied with this side see all terrains that this side sees, if they are on shroud. {{DevFeature1.13|1}} This has been deprecated in favor of share_vision (see below).

* '''share_view''': whether sides allied with this side see the units that this side sees, if they are on FoW (fog). {{DevFeature1.13|1}} This has been deprecated in favor of share_vision (see below).

* '''share_vision''': {{DevFeature1.13|1}} all/shroud/none. If ''all'', both shroud and fog view will be shared by this side. If ''shroud'', only shroud view will be shared. If ''none'', the view is not shared.

* '''scroll_to_leader''': optional. If `no', scroll to the leader is not performed on the start of each turn. (default: yes)

* '''suppress_end_turn_confirmation''': If "yes", then the player will not be asked to confirm ending their turn even if they have not done anything. This is provided for some (probably few) user-made scenarios in which players often skip their turns. (default: no)

* '''[ai]''' if '''controller=ai''', gives parameters to the AI. See [[AiWML]].

* '''[village]''' describes a village the side begins in control of.
** ''x'', ''y'' the location of the village. If the pair of coordinates is not a village or is duplicated in another '''[village]''' tag, behaviour is undefined. Recent game engine or wmllint should warn about these.

* '''[unit]''' describes a unit which begins on the side. See [[SingleUnitWML]]. If the side has a recall list and the unit is not given a location, it will start on the recall list. Note that the ''side'' attribute under '''[unit]''' will be ignored, as the side will come from the ''side'' attribute of '''[side]'''.

* '''[leader]''' same as '''[unit]''' except that ''canrecruit'' will default to yes and current position to the side starting location if not specified.

* '''defeat_condition''' Specifies when a side is considered ''defeated'' this is checked ''for all sides'', after every player action and at the beginning of every turn.
** '''no_leader_left''': (default) The side is considered defeated if it has no units with canrecruit=yes
** '''no_units_left''': The side is defeated as soon as it has no units left.
** '''never''': The side is never considered defeated.
** '''always''': The side is always considered defeated.

: For the meaning and significance of ''defeated'', see [[ScenarioWML#Scenario_End_Conditions]]

The following keys are multiplayer only:

* '''allow_player''': if false then this side will not be allowed to be modified and will be hidden during game creation. False also prevents this side from being included in shuffle sides. Defaults to yes.

* '''disallow_observers''': prevents observers from seeing this side turn. (default: no)

* '''disallow_shuffle''': {{DevFeature1.13|0}} do not shuffle this side if the "shuffle sides" option is used. (Usually all playable sides are shuffled.) (default: no)

* '''chose_random''': {{DevFeature1.13|0}} indicates if a side chose a random faction during creation

* '''controller_lock''': if true then this side's controller ("Player/Type") modification is limited. It is bound to the '''controller''' attribute in [[SideWML]].

* '''team_lock''': if true then this side's team is not allowed to be modified.

* '''color_lock''': if true then this side's color is not allowed to be modified.

* '''gold_lock''': if true then this side's gold is not allowed to be modified.

* '''income_lock''': if true then this side's income is not allowed to be modified.

* '''faction_lock''': if true then this side's faction is not allowed to be modified.

* '''leader_lock''': if true then this side's leader (type or gender) is not allowed to be modified.

* '''faction''': if a valid faction id is provided then this side's faction will default to it. {{DevFeature1.13|?}} if this key isn't included in the ''[side]'' then a random faction will be chosen, and the side's recruit list set from the faction. To use a custom ''recruit'' list, you must also specify ''faction=Custom''.

* '''faction_from_recruit''': if true then this side will be locked to the faction that matches the recruits better.

N.B. the ''lock'' attributes use [[ScenarioWML]] '''force_lock_settings''' as their default value. I.e. if no value to ''lock'' was set, it will take '''force_lock_settings''' value.

== See Also ==
* [[EraWML]]
* [[ScenarioWML]]
* [[ReferenceWML]]

[[Category: WML Reference]]

TheRiseOfWesnoth

2020-06-25T07:51:03Z

Beetlenaut: /* Overall Campaign Strategy */

==Overall Campaign Strategy==

(At the moment, most of the walkthrough takes the perspective of the Lord (Challenging) difficult setting.)

Over the course of this campaign, you will need to level up to some:

* Healers: White Mages/Mages of Light (at least four)
* Undead vanquishers: Paladins (two)
* Mobile strikers: Silver Mages (at least one, preferably more), Grand Knights (several), Fugitives (one or more helps)
* Damage sinks: Royal Guards, Iron Maulers, Highwaymen, Halberdiers, Level-3 Burin, and again Grand Knights
* Leaders: Level-3 Haldric, Level-3 Lady Outlaw, and much later, Level-3 Commander Aethyr.
* Ranged attackers: Great Mages (can use several in the last scenario), Longbowmen/Master Bowmen (two), Trapper/Huntsman (one is helpful)

A Mage of Light, one Paladin, and five Grand Knights make a perfect assault team!

Although Horsemen are key for the first three or four scenarios, it's important not to be too reliant on horse units through the middle part of the campaign, as there are many hard levels underground, in swamps, in water, or against Saurians; use XP from the scenario ''The Vanguard'' to level-up at least two Paladins and two-or-more Grand Knights.

Don't overlook Pikemen/Halberdiers, which are useful in many levels; pierce attacks work well against Drakes and against the Dragon, and they are handy for defensive roles - especially repelling Wolf Riders. They are not as useful against the Undead, though, and don't get that +1 MP Royal Guard speed bonus.

Due to many Undead opponents, you will want to recruit many Thugs at times, and get a few leveled up - preferably the quick ones, which will be more useful in underground levels. Footpads help too, once leveled up. Due to swamps, you will sometimes be spamming Poachers, which - upon reaching Level 3 - gain the marksmanship trait (or Rangers are good too, for swamps and forest.) These, plus Lady Outlaw, provide a better range of tactics in other levels too: some decent chaotic troops form an ideal reserve, since you can attack with your lawful troops at dawn, and by nightfall when you need to heal them, use some chaotic troops to either continue the attack or to shield your healing lawful units.

Here are some recommended units to have obtained by specific scenarios:

2. The Fall - 1 Knight 
3. A Harrowing Escape - 1 White Mage, 2 Knights, plus about-to-level troops 
4a. The Midlands - avoid this Scenario, prefer The Swamp of Eden instead 
4b. The Swamp of Eden - Level-2 Haldric, Level-2 Lady Outlaw, 2 Knights, 2 Shocktroopers 
6. Temple of the Deep - Level-3 Haldric, Level-3 Burin, 1-2 Mages of Light or several Outlaws / quick Bandits 
8. Clearwater Port - Level-3 Lady Outlaw, 3 White Mages / Mages of Light, 3 Iron Maulers / Royal Guards / Halberdiers 
12. A Final Spring - 1-2 Silver Mages 
14. Rough Landing - the 3 loyal Mermen from the previous scenario, ''Peoples in Decline'' 
17a. The Dragon - up to 4 White Mages / Mages of Light 
17d. Cursed Island - 1 Paladin 
19. The Vanguard - 4 Knights/Lancers/Grand Knights, 2 Paladins (or about-to-level Knights) 
20. Return of the Fleet - 1 Mermen Entangler, 1 Merman Triton with Storm Trident, Level-3 Commander Aethyr desirable 
22. The Rise of Wesnoth - 2 Paladins, 3 Royal Guards, 4 Mages of Light

Because the campaign is long and you won't be able to recall all your Level-3's in the final scenario, it pays to create some "uber-units". An example is a quick, resilient Silver Mage that has been AMLA advanced a few times.

[Mal Shubertal]: Some scenarios, such as Swamp of Esten, are nearly impossible on Lord difficulty with just the base starting gold, so you need to focus on not just winning the earlier scenarios, but beating them FAST for maximum early finish bonus, otherwise you will find yourself stuck later on. This means you can't always "play it safe", for example by waiting for the wesfolk to attack you across the river in the first scenario, because this wastes precious turns of your units just sitting around. On the plus side, this creates a positive feedback loop: starting a scenario with a lot of gold lets you pursue more aggressive strategies, finish faster, start the next scenario with even more gold, etc.

[beetlenaut]: In my opinion, Silver Mages are the best units to have in TRoW. Keeping the above comments about gold in mind, using them to get and protect villages can make the whole campaign easier. There are also many scenarios on huge maps with multiple fronts where they can save the day. It is sometimes possible to flit them to an island to assassinate an enemy leader too. I recruit several mages on almost every scenario and feed them kills. I don't stop getting Silver Mages until I have six of them about halfway through. Since you also need White Mages and can use Arch/Great ones, more than half my recall list will be mages throughout this whole campaign. (In fact, they are so useful that it is possible to beat the campaign on hard recruiting ''only'' mages, although that is obscenely difficult.)

== Scenarios ==

=== A Summer of Storms ===

* Objective: Defeat the enemy leader - a Wesfolk Outcast (Level-2)
* Lose if: Prince Haldric or King Eldaric die or time runs out.
* Turns: ??/28/??
* Starting Units: Prince Haldric, King Eldaric (who can't recruit)
* Initial Gold: ???/100/???

This is a relatively easy scenario, so gear your recruitment and strategy with an eye towards gathering XP.

'''Recruitment:'''

* Your faction is Loyalists, but you can't recruit the heavier units (Heavy Infantry, Cavalryman).
* For the first round, recruit 2-3 Horsemen and the rest can be all Spearmen or a mix of Spearmen and Bowmen as you see fit.
* Then, you should probably recruit Bowmen and more Spearmen.

Whatever Bowmen you can get advanced will be useful later on for fighting the many trolls, grunts, and riders you will encounter. Note, however, that you will not have any healers until you level up at least one mage to White Mage status, and the sooner you can do that the better. Red mages will also prove very useful in subsequent scenarios, so consider recruiting at least two mages.

'''Strategy:'''

The Wesfolk are an Outlaw faction, recruiting Poachers, Thugs and Footpads.

On Medium or Easy difficulty, you can barely fail. Your initial keep-full of recruits (5 units) and another 2 at most are all you need. Just make sure not to advance head-on onto the initial attack, since if you do, you'll meet the majority of the enemy units during the first night, which can get hairy. Stay your advance a bit, and they'll come rushing down - without even ganging up on you properly. If you recruited 3 Horsemen, send one to tag villages; and send one of your later recruits (a Spearman/Bowman, preferably a quick one) to tag villages in the mountains. However - don't get too much in the way of enemy tagging, since you want their leader to have money for recruiting your "sparring partners" for gathering XP. If you recruited a Mage, s/he will drink up a lot the enemy XP, otherwise there'll be plenty for the Bowmen and some for the Horsemen and Haldric himself.

Don't forget to send Haldric out after making your last recruit.

On Hard, you'll need to put in a bit of thought. Players have used at least three strategies with success...

* '''Over the bridge''': Send the horsemen with the king over the bridge, and the others should follow or start going over the mountain, to avoid being attacked from behind. Send subsequent Spearmen and Bowmen on the "over-the-bridge" road, and when the Prince and final troops have just about caught up, march on the enemy camp.
* '''Hide in the swamp''': Proceed much like the above, but send the king with 3 Horsemen to capture the nearest houses, then retreat into the swamp area until you have your lawful bonus to kill off troops during the day. To hold them back, you can use a Spearman and a Mage (to level him.)
* '''Sandbagging''': On the hardest difficulty level, the initial enemy assault will only be easy to handle by entrenching your troops behind the river. Use the king to block the bridge initially, while Spearmen handle the shoreline just north and Horsemen carefully flag villages across the river. Run the king around, lending his leadership as you massacre the stupid enemy troops that have jumped like lemmings into the water.

For all these options, you will also need to send a squad north into the mountains and around into the flank of the enemy. A quick Spearman, a quick Bowman, and one other unit, possibly a quick Mage, should be more than sufficient.

When you see that the fronts are under control, stop recruiting and send prince Haldric and your Mages over the bridge on a quest for XP, assisted by the leadership of the king, and converge on the enemy camp.

[Mal Shubertal]: For the "over the bridge" strategy on Hard, spearmen are key, purely because they are cheap, have high hp, and are not vulnerable to pierce like horsemen. Your first engagement with the enemy will be at night, so the main goal is to just survive: hold the 2 villages just west of the river, pick off weak units like foot pads if possible, prevent any of your units getting surrounded, rotate out your wounded units, and hold out until morning. Sometimes the right choice will be to just position a spearman to block a hole in your line, but not attack, to preserve hp and increase the chance to survive. Also recruit a horseman to tag all the villages in the southwest for income, then rush back to reinforce your front. By morning, that income will have added up, with Haldric sending an increasing stream of reinforcements, and you'll be ready to counterattack. Also recruit one or 2 mages, and start carefully feeding one xp to build your first healer. Instead of diverting resources sending units to the north, you can just ignore it at first to focus on the heavy fighting to the west. Eventually the units the opponent sent to the northern villages will come down to attack haldric in his keep, but by that time you will be able to recruit him plenty of body guards and get him some xp while your main force with the king takes out the wesfolk leader.

===The Fall===

* Objective: Defeat the Wesfolk Outcast Leader (same one from the last level)
* Lose if: Prince Haldric, King Eldaric or Wesfolk Leader die or time runs out.
* Turns: ??/24/??
* Starting Units: Prince Haldric, King Eldaric
* Initial Gold: ???/100/???

You are back in the same valley you were fighting in last scenario; it's fall, so the Northern parts have some snow, and King Eldaric has placed some one-hex fort pairs on the road due North-West. He also manned the upper pair of hexes with his personal guard - a troupe of three Heavy Infantrymen (Shock Troopers on Easy).

... but the more menacing change is three enemy leaders: Two Orcs, a Warlord (L3) and a Warrior (L2), in the Northwest and Northeast respectively, and your old friend the Wesfolk Leader woman in the Southwest: You (Haldric and Eldaric) are planning to evacuate South to avoid an Orcish overrun - and she's conveniently just in the way. Each Orc is about as rich as you, on Medium, and possibly richer on Hard; and Ms. roadblock has quite a bit of gold as well.

'''Recruitment:'''

* Recall or recruit Spearmen and Bowmen to man the lines.
* Horsemen/Knights are desirable, because you probably do not yet have a White Mage, and the villages are widely spaced.
* Recalling or recruiting Mages for XP gathering is highly advisable for future scenarios.

'''Strategy:'''

This scenario may seem a little scary at first: Not a lot of money, only a few veterans, and an attack from three fronts without a lot of barriers. Not like the walk in park we had in Summer... but - it's not actually as hard as it looks: You're not trying to stand your ground and defeat all of your assailants - you're just clearing a path for retreat; that is, your only real enemy for this scenario is highway girl. And remember: The Orcs and the Wesfolk are not ganging up on you; the NW Orc Leader's forces will attack engage the Wesfolk on contact, and will, in fact, direct some units in the SW leader's direction (more, if you're not in the way).

There are three basic approaches to take out our Checkpoint Charlotte:

# '''Brute force''': Raise a large army and march West. Use part of your force to hold off the NW Orc leader's forces coming South through the pass; use the rest to break through the Wesfolk defense and kill the leader. This strategy requires a lot of troops but it can bring you plenty of experience and can bring a quick victory; but on Hard, it might be beyond your reach (or the reach of your funds).
# '''Leave the dirty work to the Orcs''': Wait around your keep, defending your bank of the river so the Orcs coming down from the Northwest don't get any ideas (and escorting Eldaric's private guard of HI to safety). The NW Orcs will fight the Wesfolk; when the outlaws forces are nearly spent, seize a moment of opportunity when the road to the Wesfolk leader is mostly clear. Then, take a strike force of a Knight and a few more units across the two bridges. Your timing should allow for quick dispatching of the odd enemy unit along the way (hopefully, these should be wounded or separated from their comrades), clearing a path for a Knight of yours to arrive at the SW keep and attack the Wesfolk leader. This strategy is risky, because Orcs will be present by this time around the Wesfolk leader, and might kill the leader before you do - you don't want that happening.
# '''Assassination''': Send a squad through the southern mountains to the Outlaw leader's keep. Two Mages and three Spearmen might be enough. If not, add a Knight, Horseman, or the King - but be careful with these supporting units, as they cannot traverse mountains, and may get pinned down on the narrow passage by the Wesfolk. The stretch of road from the pass due South to the keep should be clear, and the recruits fighting the Orcs.

Even if you manage to fend off the Orcs, you shouldn't delay your victory to collect more XP. Unlike the first level, here you are unlikely to have control of most of the villages, and the following scenario (''A Harrowing Escape'') is quite a handful (at least on Hard difficulty). On Hard, aim for a carryover of almost 150 gold (i.e. finish the level with close to 375 gold). It is also important you have a Mage leveled up to a White Mage, or almost at the point of leveling. Near-leveling L1 units will also come in handy for their low initial upkeep (relative to L2 recalls), so that you'll squeeze a little more oomph from less starting gold. Steer XP collection accordingly.

Once you've brought the Wesfolk leader's HP reaches zero, she will beg for mercy again, offering to aid you going forward. If you accept, she comes back as a loyal unit already in the next scenario, also enabling recruitment of outlaw units; and - she cannot be killed in the next couple of scenarios (instead, she disappears when she goes to zero HP, and comes back the next scenario); this is quite valuable. If you say no and try to kill her, you will find she gets away anyway - but you will get 200 gold that she leaves behind. If you're not finishing early enough to have enough gold for the next level, you might have no choice but to decline her offer and take the gold... alas, such is the brutal reality of forward-thinking leadership!

Note: Try and keep Eldaric's personal guard alive. These HI/Shock Troopers are loyal, and quite useful in some future scenarios (not the next one). To save them from certain Orcish death, don't let them delay the Orcish advance and move them South right away.

[Mal Shubertal]: For the "brute force" strategy, spearmen are again key for cheap cost and durability. So is having a big gold carryover from last scenario. The goals are a big early finish bonus and leveling up at least 1 healer if not 2, as well as haldric and whoever else. Recruit a huge swarm of spearmen to overwhelm the wesfolk. Recruit just the one or 2 mages you are crafting into healers, and maybe a horseman that you want to level up. Send the HI running south immediately. Use the spearmen like the fodder they are to press toward the wesfolk keep at any cost. Attack thugs at night, stand in bad terrain to attack enemies on good terrain, send spearmen into positions where they will be surrounded, etc. Use the king's leadership to maximize damage and expect huge casualties. Grab some xp for your "real" units when you can during the carnage. Engage the orcs as little as possible and give them space to engage with the wesfolk around your western flank. You should finish early enough that you can show mercy to the wesfolk leader, as her units will be invaluable later.

===A Harrowing Escape===

* Objective: Defeat all enemy leaders (two Orcish Warlords in the SE)
* Lose if: Prince Haldric dies or time runs out.
* Turns: ??/45/??
* Starting Units: Prince Haldric, Outlaw Lady
* Initial Gold: ???/100/???

'''Layout:'''

A narrow(ish) level, mostly mountains with a pass of decent width (3-abreast at the narrowest, usually 5, sometimes a bit more). The pass is strewn with villages - pretty close together. There's also a creek a mysterious cavern-style dwelling to the west of your starting point (wink wink, nudge nudge). No fog of war.

The enemy leaders have 140 starting gold (on medium), each with a 3-recruit keep on both sides of the Southwest of the level.

This scenario plays quite differently on the lower difficulty levels, calling for different strategies.

'''Medium (& Easy?) Difficulty:'''

''Recruitment:''

Two rounds of recruitment (5 units each) will be quite sufficient, especially with the Outlaw Lady and the extra Steelclad (see below) - two new loyal units you get for free. Speaking of Loyals, consider recalling Eldaric's Loyal Heavy Infantry in the first turn: No upkeep!. Don't skew your recruitment too much for fighting on the mountains - Wolf Riders will zero in on your units on the pass soon enough, anyway; but a Footpad+Mage, or a Footpad+the Steelclad make a decent combination for chasing the odd wounded enemy. Definitely recall a White Mage, or an L1 Mage about to level-up, for this level - despite the villages along your way. You can manage without one, but - healing on the battlefield without the need to recycle troops is a great benefit when you're low on units and not recruiting again; especially if you've recalled the super-slow HI units. The White Mage will also deal with Orcish Assassins' poison. Don't get tempted to get more than one or two Horsemen/Knights - their mobility is not that useful. An interesting use they do have is as bait for units with ranged attacks: They are tempted to attack them despite a low chance for a kill, since they can't retaliate.

''Strategy:''

The timing of initial recruitment is meaningful: Recruit or recall your loyals and L1 units earlier, and your L2 units on turn 2 - even if they're slower. That means less of a gold penality on the first turn. Also, it means you can recruit a Footpad on turn 1 to go get the Steelclad (see below). Speaking of turn 2, by this time you'll have an initial notion of the Orcs' recruitment slant (mainly, more Grunts or more Wolf Riders), guiding your final choice of recruitment/recall.

Your enemies will recruit a typical mixed Orcish L1 force: Wolf riders, Grunts, Orcish Archers, Orcish Assassins, and a few Goblins. The proportions may vary, and so may their course of attack: Some units may or may not go up the stream; some Wolf Riders may or may not go over the mountains.

At any rate, Wolf Riders will reach the middle of the level by turn 6 - which as when you might reach the same area. So, don't push forward as fast as possible, except with your mounted units for village capture, and taking care not to over-expose them. Even with support nearby and with a Knight holed up in a village, you don't want to get into a night battle.

A little below the halfway point there's a choke point with two fortified hexes. That is a great spot for your Heavy Infantrymen; and they can be supported from behind by your leader(s), if they've leveled. Others like the Steelclad or even Lady Outlaw to man those posts.

At this point, if it seems the more Eastern enemy is coming up the river, consider sending some units over the mountains to deter that effort.

Once the initial Orcish attack is broken, you can leisurely proceed along the path, dispatching the occasional nuisance (but watching for the daily cycle, so as not to put yourself in the range of two Grunts at night etc.) Remember to let your leaders support your L1 units.

'''Hard Difficulty:'''

''Recruitment:''

To beat this scenario on the hardest difficulty level, you need some Level-2 (or better yet, about-to-level level 1) units already and decent starting gold. It has been beaten on hard with as little as 158 starting gold, 200 is still difficult, and 250+ makes it relatively easy. You can stretch your gold a bit by not going negative on upkeep and waiting until you can't wait any longer to do one last round of recruiting, recalling mostly Level-2's. For timing your final recruitment, watch the wolves that are likely trying to flank through the mountains south of your keep. Another requirement for beating this scenario is a White Mage (or two.) If need be, you must promote a Mage (or two) tout de suite, as you will be dealing with severe damage and assassins, while only having easy access to 2 or 3 villages initially. Horsemen and Knights are useful for dissipating damage by serving as meat shields against blades and then running off to remote villages to heal. Quick Horsemen are especially nice, as they can transfer between two strategically placed villages in one turn, for healing on the go. Horsemen, Knights, and Swordsmen are useful for swatting assassins. If you can recruit outlaws, a couple of Footpads are nice for village grabbing. Thieves are also good because they are cheap, the Grunts are fond of attacking them, and they often survive on 70% defense.

'' Strategy:''

Near the start of combat, it's crucial to kill the first waves quickly: the wolves and assassins. More important than terrain is avoiding getting flanked, so mobility of individual units is key; if you climb up deep into the mountains, you will have a harder time with mobility than staying on or near the valley floor. Additionally, many of your units cannot go on mountain hexes, so it's easier to maintain your lines if everyone stays close to the valley. It's easier to make a stand at the keep and northern river bank, but this approach can be too costly in terms of time.

You can lure out the roadside guard Warriors one at a time by putting a unit within attack range of one (and out of range of the other.) They mostly come at night. Mostly. That is, the Warriors might not bite bait put out during the day.

'''Surprises and secrets:'''

* There is Dwarf Steelclad (L2) in the village at 8,5. It's not far from your camp, so send either a Footpad or Lady Outlaw there (a Footpad takes less time - if you want to invest in recruiting one). The Dwarf recluse will joins you because "It has been a long time since he felt the satisfying crunch of Orcs under his Axe."

* After you kill the first orc leader, an Orcish Slayer and two Assassins will pop out of nowhere - at the South patch of woods, just to the left of the river. So - you would be wise not to have any wounded units stuck without movement points at that point. Also, the other leader will get an infusion of gold and start recruiting on all available hexes, so if you can sit on some of those hexes first, it will help keep the situation from getting out of control.

'''Notes:'''

* If you haven't leveled Haldric from L1 up to L2, try to get that done.

* Lady Outlaw has a rare and somewhat odd ability, "distract", which allows adjacent allied units to ignore enemy ZOCs. You're not likely to find yourself surrounded in this scenario, but that could happen later. Another feature of this sneaky lady is that she cannot be permanently killed (at least not yet), so when desperate times call for desperate measures, you can move her into a suicidal position.

* Lady Outlaw allows you to recruit outlaw types. On Hard especially, Thugs can be useful as meat shields and to provide strong attacks at night when your lawful forces are crippled.

* It helps that there are two enemy sides as opposed to a twice as strong single enemy side. If one of your units could be attacked by three enemies, but one of these hexes is currently blocked by the other side, the currently moving enemy decides to attack units which it (they) is (are) actually less likely to kill than that one. AIs don't cooperate, that is.

* If you are stuck on this scenario, you may need to replay one or both of the previous scenarios and/or choose to "kill" Lady Outlaw in the previous scenario so you get her gold.

* Heads up: it would be wise to have at least 1 White Mage before going to the scenario ''The Swamp of Esten''.

[Mal Shubertal]: starting this level with a big gold bonus and the lady outlaw creates the possibility for a much more aggressive start, earlier finish, and bigger gold bonus for the next scenario. Recall your HI, and recruit some poachers, send them south and send the lady outlaw to get the dwarf. Then recruit more poachers, your white mage(s), and whoever else you can afford. The first poachers should bait out the first roadside guard warrior right around dusk. Then your other poachers can surround it, kill it, and do the same with it's partner. By this point, your slow HI and other support troops will have caught up, and you can set up a defensive line using the villages and forests in that area (poachers have 60% defense in forests!). Meanwhile, the dwarf and lady outlaw will be catching up through the mountains. This is where healers are crucial. The dwarf and HI's have great armor against blades and can chew up grunts and wolves easily, especially by day, but poison and attrition will take them down without support. Use poachers to hold the line at night and if the others need time to heal. Focus on leveling your white mages and HI's, since they will be critical against the undead in the next scenario. After the main assault is broken, march everyone south, but send a foot pad or the lady outlaw to tag all the villages behind you before catching up, to maximize your income. The orc leaders never move or attack, so you can just block all their castle tiles to stop their recruitment and beat on them with impunity. Time it so that you finish off both on the same turn, to avoid the recruitment surge and reinforcements.

===Diverging Campaign Path===

At the conclusion of [[#HarrowingEscape|A Harrowing Escape]], Haldric has made it through a pass in the Broken Mountains, and must decide whether to proceed due Southeast, along a river going into the Swamp of Esten, or Southwest towards the hilly Midlands region of the isle (see the [https://raw.githubusercontent.com/wesnoth/wesnoth/master/data/campaigns/The_Rise_Of_Wesnoth/images/maps/green_isle.png map]). As you can probably guess, Orcs like hills, not swamps, so if you go to the Midlands you'll be seeing a lot of them up close; this will likely cost you several good units, if not worse. The swamp is much easier, plus, you'll find a Loyal White Mage in there. So, the choice is a no-brainer, unless you want more of a challenge.

====The Midlands====

Orcs again. But you chose that way. This scenario may appear impossible, but with a lot of gold and a little strategy, it can be beat.

Recruitment...
* You are given plenty of time, so use it wisely. The enemies send lots of orcs, mostly weak ones. So recruit and recall everything you can.
* Recall any White Mages you have. You'll need them.
* Bowmen are good for the wolf units you will be facing.
* The rest depends on your strategy.

Strategy...
* The "Fast Assault" option: use an assassination team. If you go west, only your Knights and Horsemen will arrive and fight at daytime. So go south. Take the bridge and defend against the enemy closing in from the west. Take out Yellow with a fast assault team (they should take a healer along), but be careful about the leader. Your main force moves west, takes and holds the second bridge, and takes out Blue. Your assault team stays in the south and goes for the last enemy leader - they won't face any serious resistance. The enemy moves north to support Blue. The HI guarding the bridge might gain a level or die, but hopefully not the latter, as they are loyal units in a long campaign. With this approach, you can finish early (around 25 turns) and keep your losses low.
* The "Dark Assault" option: use Footpads. If you chose to work with the the outlaws in the last round, then this works well. Footpads are cheap. And they are fast. And they have good defensive abilities. Plus they fight well in the dark and in the forest. So recruit lots of Footpads-pawns and quickly dispatch them to the upper west and south, followed by more powerful units: Mages, Horsemen, etc. For the time being, leave the middle enemy alone. To the upper west, send several Footpads into the forest and capture the village and set up a defensive line. This cuts down the enemy's gold and increases yours. Don't attack at first, just defend, until more of your slow higher powered units arrive. The strategy here is to pick off the orcs, and send the Horsemen to capture villages. While this is going, to the south you send your Footpads to capture any villages you can and, more importantly, put a Footpad on the hex that is adjacent to the bridge, thereby stopping easy advancement of their greater numbered troops. A White Mage, a couple Trappers and some Bowmen would make a good escort. Probably sending a Thief or two would be good too, to help dispatch any enemy that infiltrate the villages north of the river. one enemy got into one of the villages on the north of river, and it took a lot to dislodge him. The intention is to engage the enemy so that they are fighting from the river squares, at a huge disadvantage.

====The Swamp Of Esten====

This scenario is not hard if you are conservative and don't send important units off alone.

Recruitment...
# First round, recall 1-2 quick Knights (or Paladins, if you have them), recruit 1-2 Horsemen, and recall your loyal Shocktroopers or whatever they are now.
# Next round, recruit/recall Mages to kill Scorpions (and Bats) and at least one White Mage to deal with poison, plus maybe a Poacher or Trapper or two, as they are good in swamp (and you would like a Huntsman eventually, for its markmanship.)
# A little Thug spam can come next, but you don't need a full third round of recruitment. Then send Prince Haldric off to lend his leadership.

Strategy...
# Head to the northeastern leader first. Try to kill Dark Adepts with Burin or horse units before they have a chance to attack you. As you close in on the leader, hover your mouse over him to watch where he can go, as at night his ranged attack is nasty and can be followed up by waves of kamikaze Walking Corpses, which can take out a Knight.
# After you have killed the northeastern leader and eliminated troops there, you can either send your whole army back across the ford and south or split your army into two halves, sending one part to each leader. If you have lost several units but have lots of turns left, it's probably safer to stick together. This is not a simple mop-up operation, as powerful undead can take out some of your valuable units if you're not careful. On hard, Shadows are a threat at night.

Spoiler...

* Searching the temples is a good idea. Some have gold. There is a free loyal White Mage hiding in (a random) one of the temples - visit the temple close to the keep ASAP, and if not there, try rushing a horse unit or Lady Outlaw to the temple at 19,5. However, some of the temples contain undead, so keep extra troops nearby when you enter one.

[Mal Shubertal]: With enough starting gold, you can divide your forces from the start and finish this level much faster for a big early finish bonus. The northern leader sends zombies, bats, and adepts, while the southern leaders send level 2 undead units, much tougher. So send your HI/shock troopers and Burin south, your knights east, one white mage with each group, one leader with each group, and some thugs/mages with both. Mages are fragile, but with leadership and illumination they are incredibly effective against undead and especially against scorpions, which have very good impact defense against your thugs and HI. Focus more of your forces south, since that is the tougher fighting. Once the northern and southwestern leaders are dead, converge on the remaining leader from both sides.

===The Oldwood===

* Objective: Defeat both enemy leaders
* Lose if: Haldric or Wose leader die or time runs out.
* Turns: ??/32/??
* Starting Units: Prince Haldric, Lady Outlaw, Sir Ruddry, Burin the Dwarf, Minister Edren
* Initial Gold: ???/250/???

'''Layout:'''

In this forest-and-swamp map, the Orcish invaders are about to stumble upon a Wose castle (of sorts), and will try to dispose of the woses. You're given a chance to prove yourself as an ally to Woses by helping them defend against the Orcs. There are two Orc Warlord (L3) leaders, in NE and South castles; your keep is to the NW; and the Wose castle is at the center of the level. Narrow flat paths connect the different castles - but the South castle only connects to your NW keep; to get from it to the Woses directly, one must cross some forest, a 1-hex stream and a swampy area.

'''Recruitment:'''

The Orcs will recruit effectively against Woses: Goblin Pillagers and Crossbowmen, with fire damage; and the Wose leader is rather poor. Still, you should be able to manage this level with three rounds of recruitment on Hard; on Medium, three rounds will make this pretty easy, and two rounds will be a bit of a challenge but quite possible with L2 recalls.

* At least two White Mages/Mages of Light - since you'll be fighting on multiple fronts.
* For muscle, recall some loyal Heavy Infantry and recruit/recall some Thugs/Bandits.
* For firepower, recall Trappers and Longbowmen or recruit Poachers and Bowmen (and Red Mages if you have them). Recruiting L1 mages is probably too much of a gamble here, and XP is not very manageable with your ally around.
* Resilient Spearmen or Pikemen should do well as defenders of the Wose castle. Quick Spearmen might be less-unuseful for flanking in the swamp or forest. Alternatively, you can use HIs as defenders.
* One or two Footpad scouts will be effective scouts (unlike Horsemen).

'''Splitting of Forces:'''

Your forces will be fighting in three mostly-distinct areas:

* North of the Wose castle and due Northeast
* The path South from your keep towards the Southern Orc leader's castle.
* The Wose castle and immediately South of it.

... and your first tactical choice will be how to split your recruits among these areas. Consider making it:

* 3-5 units - to the Wose castle
* 4-8 units + Wesfolk Lady - past the Wose castle and Northeast
* Other units + Haldric - due South

'''The Wose Castle'''

On Medium, and if you don't actively avoid conflict - the NE forces will come up against your units and the Wose leader's on the path to the castle, not thec castle itself (and a good thing too, since it's only 4 hexes + the keep. On Hard they might bypass you and hit the castle from the East or SE. Beyond that - it's South leader units coming over the stream.

* If you send a White Mage or Mage of Light to the Wose castle, it will heal not just your units, but also the Woses. And - any adjacent Wose will recuperate up to 16 HP per turn: While healing effects aren't cumulative within the same turn, your healing and Woses' regeneration occur on _different_ turns: +8 your healing, +8 wose regeneration. A poisoned Wose will be cured and gain 8 HP.

'''The Northeast'''

Your task is to block the initial attack. You don't have to rush for the NE leader (there are lots of turns), nor are you strongly limited by time-of-day - since you have both Lawful, Chaotic and Neutral units (Mage, Burin). Some enemy units may be roaming far from the path; if you have a Footpad scout, you can tell where they're going, and either lure them towards the path, harass them, or perhaps send Ruddry back on the path to meet them where they're going (if you can spare him in the fighting).

'''The South'''

At least on Medium, you'll encounter limited resistance here. But exactly for this reason you _should_ try to push forward - to attract attention, and possibly divert some Pillagers or Archers away from the Wose castle. If that doesn't happen, consider sending a few units with better mobility to either attract them or at least squeeze them.

'''Looking forward'''

* The next scenario takes place in underground catacombs. It's a tough one - so you need to groom your roster accordingly. Two Mages of Light would make it a whole lot easier. Failing that, make sure an level up your Fearless Loyal HI into a Shock Trooper, alongside some Chaotic units. Bandits/Highwaymen and Fugitives are especially nice (as are Outlaws on Medium). Quick units of almost any type (except horse-mounted ones) will be helpful, if leveled and possessing high HP (>50).

* The temple to the SE of the Wose castle is the entrance to the catacombs; you can't go in there before next scenario, so don't bother visiting it.

[Mal Shubertal]: Poachers shine on this map. The area south of the wose keep is swampy, and poachers both move better and have better defense in swamps than any other human or orc unit. The biggest challenge on this map is the wose leader, who is suicidally aggressive. He will jump far out of his keep to attack a goblin pillager or crossbowman, only to get immediately killed by powerful fire attacks the next turn. The only reliable way that I could find to protect him was to keep the fighting entirely out of his reach as much as possible, which means basically fighting on 3 fronts: south of his keep, north of his keep, and far south at the southern orc leader. This is only possible if you have at least 3 healers (counting Minister Edren). The southern assassination squad should be the healer plus fast units like knights and outlaws and Lady Outlaw (this will let them catch back up to the main battle once they're done). The south of keep group should be a healer and mostly poachers. The northern group is whatever you have left. Once the 2 southern groups finish their jobs, they will reinforce the northern group and finish. Note that you do not need to do all your recruiting at your starting keep. If haldric stands near the wose keep, their leader will helpfully move out of the way to let haldric use it.

===Temple in the Deep===

You will be facing undead underground. This is a difficult situation that will prove much easier with proper recruitment. Then the strategy will be fairly straightforward.

Recruitment...

* All in all, what you need is a small elite force. Two rounds of recalls is enough, if you didn't lose Burin in a prior scenario.
# First round, recall your loyal Shocktroopers / Iron Maulers, though their slow movement will prove frustrating. Also on the first round, recall a fast "tank" and someone to grab the holy water.
# Second round, recall any Mages of Light you might already have, and a total of at least two White Mages or Mages of Light, preferably quick. For the rest of your recruitment, what you need are high movement (6+ MP) non-horse units with high hitpoints (>50 HP). It helps if they are chaotic (or at least neutral) and/or have ranged or impact attacks. Put all the requirements together and it points to Fugitives. Outlaws and quick Arch Mages are worth recalling too. Fill out the rest with other high HP units. Note that horse units are too sluggish in caves and should not be recalled/recruited unless you have a compelling reason.
# Third round (optional), you can add a unit or two for a safety margin.

Strategy...

# There are two ways north, but they will meet up together. First thing you will see are Tentacles. You can either ignore the Tentacles for the most part or use them for XP. Your main initial objective is to find a good place to make a stand against the nasty wave of undead coming from the north. The chokepoints and southern shoreline offer good defensive locations. Watch out for the enemy's Bone Shooters, Revenants and Deathblades, as they could easily mess up a Level-3 unit.
# Once the flow of baddies as tapered off, gradually progress northwards. Once you get into the final chamber, the boss should be a piece of cake, although his ranged attack is devastating, so try to attack him with melee units. Be careful if he has recruits around, as their combined damage can take down one of your Level-3's. Note that the Ruby can only be picked up by Haldric.

Hints...

* Holy water: The best choice for the Holy Water is a quick Bandit, who should level quickly. A quick Highwayman could be used, but won't benefit much from the XP.

* XP: Use this level to get experience. The early-finish bonus is tiny. The Tentacles are perfect for leveling up units. Keep Burin away from the water at this stage, or he'll kill all tentacles as they attack, depriving those who could benefit from the XP.

Spoilers...

* Your killed units will be turned into Walking Corpses (or Soulless on hard.) Therefore, spam is not helpful. A Mage or Thug can be okay, if used with great care, but mostly you need to recall leveled troops here.

===Return to Oldwood===

Plot only.

===Clearwater Port===

* '''Objective''': Wait for 1st/2nd/3d ship arrives, then have Haldric board it.
* '''Alternative Objective''': Defeat all enemy leaders.
* '''Lose if''': Haldric, Jessene or Town Commander Aethyr die, or time runs out.
* '''Turns''': ??/32/?? ; first ship arrives at turn ??/12/??.
* '''Starting Units''': Prince Haldric, Lady Jessene, Sir Ruddry, Burin the Dwarf, Minister Edren
* '''Initial Gold''': ???/250/???

This scenario is easy if you take the first ship out, more challenging for the second and third ships, and very difficult (on hard) if you want to take out all three leaders.

'''Layout:'''

The town and port of Clearwater lies on a stretch of land extending eastwards, between the seashore going East, North-East then North (at the Eastern edge of the level), and a wide river cross the level from West to East. The middle of the river is deep; it has a bridge over it at the West of the level and 1-hex shallow-water narrowing at the western edge, as it reaches the sea. There's also a small island, due South-by-SouthWest, from the center of town, with shallow water linking it to several areas on the coastline.

The terrain is mixed flat and frozen, with some hills and forested areas outside of town. Since winter has set in, there are some (not fully continuous) ice shelves along the coast. There are also lots of village hexes in this level - 41 (!) in total.

ClearWater Port is mostly walled-off from the land side, but its West-facing wall can be flanked on an ice shelf from the South, and in shallow water from the North. Also, the middle of the wall has a one-hex gap. There are 11 villages in town.

'''Recruitment:'''

# Your loyals, two to three healers and plenty of spearmen is all you need, if you stick to the walls and play defensively.
# Recruit slowly at start to stretch your gold with initial income.
# It's a good scenario for leveling troops, so add a few other (sturdy, non-mage) units for diversity and to make your recall list more varied.

'''Strategy:'''

The enemy leaders have an enormous influx of Gold: About +40 between them all at each turn, after upkeep costs; you see, they each have a base incoming of 10 (on Medium difficult). That means they churn out lots and lots of units. They also group them together, for daily - or rather nightly - attacks. So don't be tempted to believe that because you've had a lot of quality kills some day, and have leveled up a few units, you can go on the offensive; play defensively and conservatively.

You will be defending the Western town wall, mostly, for the duration of this scenario; so:

* Man the wall hexes with Spearmen and some healthy veterans.
* Use illumination and leadership to maximum effect. Two Mages of Light should do well enough, and you have two leaders, plus Commander Aethyr who stays put in his fort (covering two wall hexes).
* Note which hexes are more exposed (number of adjacent outer hexes + terrain) and consider both their unit assignment and the aura effects on them. Rotate wounded units from the higher-exposure wall hexes quicker than from other hexes.
* On Hard difficulty, or if you've started with little money - prepare to defend against occasional breaches, i.e. don't keep vulnerable units too exposed even behind the wall lines.
* Soften opponents with your veterans, feed kills to recruits. But - don't jeopardize your defenses for a little more XP.

''Your ally:''
Commander Aethyr is an idiot. He recruits L1 Mages and sends them off on suicide attacks. He clearly doesn't need his villages; your conscience should not bother you occupying all his villages. In the first few turns of the scenario, though - when it's still day, it may makes sense to support those troops somewhat, with your veterans, before solidifying your defense line.

''Defending the Eastern crossing:''
The Northern leader will send units both down the bridge and to the wall, but also east, to cross the river at its mouth. You need a force of several units, one of which will need to be rotated every turn for a fully-healed replacement, and a healer to be surrounded by them. Which units? It'll have to be our trusted Spearmen. While Footpads might do some more damage when defending, they don't have the necessary HP. The healer can be a White Mage; a Mage of Light is not necessary here. Make sure to position your Spearmen to block the enemy at the one-hex choke point. Your attackers will likely be Slayers, with an occasional Assassin or Grunt on Medium. 4 Spearmen should probably be enough, maybe 5.

''Finishing the scenario:''
Stay in town to help the defenses, and only take the third boat (and note you won't get an early finish bonus otherwise). You could try to defeat all leaders, but - this is more difficult than it looks. You might be thinking "eh, what are another bunch of Orcish Warlords? They're a dime a dozen". But with their unit production numbers, your advance against them will be slow, and will only be able to begin late. And while the two Eastern leaders are manageable - getting troops North by the bridge will take you many turns, or many deaths, or probably both. And for a walk around the level to the Eastern river crossing, at the mouth, takes a quick Spearman 13 or 14 turns. So you can probably only get to the North leader by splitting your forces when you start the attack.

===Fallen Lich Point===

* '''Objective''': Defeat the Lich-Lord Caror, then have Haldric enter the sewer.
* '''Alternative Objective''': Defeat all enemy leaders (including the Lich).
* '''Lose if''': Haldric or Jessene or die or time runs out.
* '''Turns''': ??/36/??
* '''Starting Units''': Prince Haldric, Lady Jessene, Sir Ruddry, Burin the Dwarf, Minister Edren
* '''Initial Gold''': ???/250/???

This is a high variance scenario. On Hard difficulty, it may be easy or hard, depending on events beyond your control; on Medium difficulty, it will likely be easy or manageable.

'''Layout:'''

* Almost all of the level is snowed, including the rivers. There are some flatlands, hills and forested areas, and some mountains on the North edge of the level (you won't go there).
* The level is higher than it is narrower. Your castle is to the East; two Orcish Warlords are based in the NE and NW; and there's the "Fallen Lich" himself, Lich-Lord Caror, petrified in a castle surrounded by mountains to the South.
* There are snow-free roads connecting the four leaders' keeps: You, the Orcs and the Lich. However - these roads are of width 1, and much of them is surrounded by flat frozen land, so that moving more than 1-abreast is both slow and dangerous.
* Between the two Orcs' keeps is the entrance to the Southbay sewers. And - it is where a group of Yeti arrive to harass the Orcs.
* There are lots of villages - 32 in all - scattered mostly uniformly. That means most of them are at some distance from the roads.

'''Strategy: Make a choice'''

The Yeti are fearsome creatures: 200 HP and up to 64 points of impact damage (with the Orcs having no special resistance) per attack. However, their hits are 32x2; and their choice of where to move is also not very intelligent, it seems. So their fate vs. the Orcs, or the time before they're defeated, is a matter of chance.

So, you face a choice: Go for the Lich, with fewer forces, or soldier up and go for the Orcs. On Medium difficulty, the second alternative is quite attractive and should probably be considered the default.

'''Lich first'''

The Orcs, will be busy enough with the Yetis not to send a raiding party after your forces - so you can walk with a big group south and kill the Lich-Lord. Move Haldric to the stone monument to de-petrify the Lich; it may help to post some units around the undead before doing so. Use several mages to make a hole or two in the ring of undead, and then push in a burly fighter or two and/or Paladin to kill the Lich.

* Recruit fairly lightly initially, as you will likely have a chance to use the Lich's keep to recruit again.
* All advancements of Mages are good; and even L1 Mages are an option (albeit an expensive one).
* Because of the mountains around "lichland" and the frozen ground everywhere else, additional horse units are not advisable; though perhaps a single Paladin might come in handy (e.g. to go into the castle.
* Some Thugs or a Bandit or Highwayman will provide a little extra undead bashing power.
* Footpads will help with village flagging - but can also defend mountain hexes well enough against the undead, for a turn or two, until their HP drops to a dangerous level.

After defeating the Lich and his forces, it probably won't make much sense trying to defeat both Orc leaders; instead, escort Haldric up road to the sewer entrance - you only have to cut through between the two of them, not overrun anybody. Still, if they've lost enough units, and you have enough left, and some money to recruit, you could still mount an attack.

'''Note:''' When dealing with the Lich, be aware that he has money; if you let him vacate any of his encampment tiles, or if you kill any of his units but do not occupy their tiles, he will be able to recruit. (This is not necessarily all bad, as it can mean more experience, but depending on the strength of your force you may want to be careful.)

'''Orcs first'''

Recruitment and recall for this strategy choice:

* A good number of Footpads.
* Outlaws and Fugitives.
* All L2-and-higher Mage advancements are good.
* A small number of Bandits, Thugs or Highwaymen.
* Quick Pikemen.
* Huntsmen, if you have them.

On Medium, you'll want at least a half-dozen Footpads; and 2-2.5 castle-fulls of recruitment overall.

Send one or two Footpads to flag villages to the Southwest (around the Lich's castle).

A group of Footpads will move up, off the road, to flank the NE leader from the East. Send them with Jessene and your Outlaws and Fugitives - with a Silver Mage or two ready to teleport in as this party captures villages. Be flexible with this force - you can use it not just to get to the leader, but also to deny him much of his income (reducing his ability to recruit), as well as to draw his units away from the units coming up the road, and into frozen territory where you can easily gang up on individual enemy units. This is especially useful with Wolf-based units, since they can't defend against your sling attacks; but with almost any unit you can probably have a nice defensive advantage.

The rest of the recruits travel on the road. They'll actually have about the same speed as Footpads, i.e. will meet enemy units late at around Second Watch of the first night - on the road due North. Don't sacrifice anyone, but do try to lure them south - as that will get them mostly surrounded by your forces, especially if they haven't managed to stay on the road. Be careful to steer clear of the Yeti, if they're somehow still alive and near the fork in the road!

The eastern flankers don't need to move in on the leader immediately. Time it so that you can be supported by the other part of your force arriving from the fork in the road, just as you are either engaging the leader or about to do so. Try to pick off his more careless units, though.

Now, you won't need your whole force which has come up the road to support the eastern Footpads. You can have a few units cautiously proceed West. Once the NE leader is down, send reinforcements to assist them. You should not have much trouble finishing off the NW leader, so when you're nearly there you can already send units due south.

Finally, follow the same instructions as above regarding the Lich's castle. But this time - you'll have more units, and can take your time (if you've flagged all the villages) setting things up.

===Sewer of Southbay===

This is a swampy underground scenario, but with attention to recruitment, it's not very difficult.

Recruitment...
* As always underground, you want non-horse units with 6+ MP.
* Recall White Mages / Mages of Light, at least two, three is probably the optimal number.
* There are quite a few villages in this cave, so an expensive force is supportable, though not necessary. Some players recruit a large and spammy force, while others go with small and elite:
** Option 1, "Large and spammy" recruitment: Recruit four each of Mages, Thugs, and Poachers. Yes, Poachers normally stink, but here they really shine in a swamp that is permanently dark, underground. If you recruit four Poachers, you could finish with three Trappers and a Huntsman - or you could finish with four dead Poachers. The Thugs are especially likely to die, as they will be facing off against Red Mages, but somebody has to do it.
** Option 2, "Small and elite" recruitment: Recall something like one Red Mage, one Arch Mage, one Silver Mage, 2 two Royal Guards/Highwaymen/etc, and a Trapper or Huntsman, plus three regular Mages and a Poacher.
* A Rogue (or Assassin) can be very handy as a damage dealer, who is able to break through bottlenecks.

Strategy...
# After leaving your initial chamber, you will be in a large swamp room with three entrances, through which will be a flood of bad guys. Use two Poachers and a Thug or similar to blockade the southeast, a small elite group to block the north, and then a mix of fighters and mages to handle the west entrance. Give each group a White Mage or Mage of Light, as well as at least one regular Mage. Try to keep the Mages of Light away from your chaotic forces on the front lines, though. Use the leadership of Haldric and Lady Jessene - and Mage of Light illumination or lack thereof - to get the most from each attack.
# When the initial battle has died down, you have two options:
## If you have enough forces, you can divide into two groups and attack both brothers simultanously, east and west.
## Otherwise, do them one after the other, and then look for the exit.

Spoilers...
* Danger: there is a Giant Spider at the exit. You may wish to keep one or two cannon fodder units in order to be able to save your advanced units. It is best to use ranged attacks against the spider, so leveled mages are good here.
* Heads up: the next scenario is a lot easier with a lot of gold, especially on the hardest difficulty level.

===Southbay in Winter===

Plot only.

===A Final Spring===

Clockwise, starting at the bottom:
* the southern orcs (purple) will recruit the usual orcish units, and with a few going west between the mountains and the coast, while the bulk will come through the plains south of the swamp, arriving at the keep early in the night. This one is the most conventional enemy, once his host is defeated you can march a comparatively small strike force to his keep and finish him off.
* The waterlogged orc to the west (black) will recruit mostly Naga and a few Bats, which will harrass you from the sea and try to seize the villages on your peninsula. He only has a small keep, so he can keep recruiting, two units per turn, seemingly forever.
* The northern orcs (green) are farthest away; they also have lots of villages they can capture. Hence it will be some time until they reach you, and not in full force at first. With any luck (and strong enough units) you'll have fought down the bulk of the southern orcs by then.
* Finally, a number of level-2 skeletons (including Chocobones) will appear behind the swamp in the east on turn 4 (first dusk). Those will join the black team; starting behind the swamp and with a few villages to grab, they won't knock on your door before daybreak.

Spoiler:
On turn five, a few mermen will appear near the lighthouse and join you; you'll also be able to recruit mermen from then on. That's your ticket to fighting back the Naga, see to it that you still have some money left at the time.

Recruitment/Strategy:
# several Trappers/Rangers/Huntsmen to sally forth and occupy the hills and forest south of the town. Your ally will sally forth to meet the enemy in the usual fashion; if you can lend a hand and soften up the enemy, King Addroran's troops will finish them off easily. In doing so, they'll happily expose themselves to counterattack -- your Trappers (etc.) have a rather good melee attack and probably won't be targeted as long as there's weaker and more accessible allied units nearby. Don't fret about the missed XP, there will be plenty more before this is over. For now, you want to dispose of the bad guys ASAP before they pile up on the doorstep.
# you probably don't need dedicated undead-killers beyond the Mages you bring anyway. But if you want to employ your loyal Shock Troopers, recruit them no later than turn 2 or they won't get there in time.
# Mages: seeing as there will be fighting all over the place, three healers will be barely sufficient. A few fireball-throwers will also come in handy, if only in order to deal with the evasive Orcish Assassins / Slayers. A Silver Mage or two will be especially useful, as they can teleport all over the place and help with each of the commanders in turn (especially the one on the island, that would take forever to get to otherwise).
# by turn 3, some chaff to occupy the coastal villages so the Naga can't just waltz in. Level-1 units or even peasants will do.
# the worst fighting will be over by daybreak; you'll still want a few lawful units to carry on the battle during the day. One keep of knights and level-2 lawful infantry should suffice. Recruit these on turn 4.
# starting on turn five, you can recruit mermen. Those can not only deal with the Naga infestation, but also tackle the northern orcs as they try to cross the bay. Two keeps worth is not too many.

Strategy is broken into three fronts...
# First order is to help your ally with the first waves of attackers, as described above. You can't stop King Addroran from throwing away his troops, but you can help them to have some effect before they perish.
# Next, fending off the Naga. A few cheap units in coastal villages at first, mermen later. Mermen vs Naga at sea will be slow fighting: both have excellent terrain defense, so there will be no obvious progress for a good long while. You should use a Mage of Light to support them, this really makes a difference during the night.
# Also, the bay/river to the north. The Mermen can be very efficient here, enjoying high terrain defense while being close enough to the coast that Lady Jessene and Haldric can provide Leadership wherever needed; again, you also want a Mage of Light if available.

For the landlubbers, don't bring too many rookies: this scenario is best used to direct experience to your level-2 units, partially advancing them outright or getting them to a point where you can expect them to level up at a good point in their next battle.

For the Merfolk, try to advance all they loyal ones, and a few more besides. Directing XP to particular units will be easier for those mermen defending the bridge, but those fighting the Naga will inevitably get some XP as well. Eventually you'll have to cross the bridge with ground troops and take the fight to the enemy, though.

===Peoples in Decline===

This is a potentially bloody scenario. The Drakes are barely impeded by the difficult terrain and can run circles around you, making it hard to move damaged units into a safe position. On the upside, most drakes have little terrain defense even in forest and mountains, and are positively vulnerable to spears and arrows.

Strategy...
Using Trappers (or their upgrades) and Merfolk, try to lure the enemy into the swamps or over the sea, fight down their troops, then storm their keeps. Be prepared to suffer some losses: it's better to deliberately sacrifice some units of your choosing than struggling to keep everyone alive.

Spoiler...
* There's a Storm Trident in the middle of the bay. There's no particular hurry to pick it up for using it in this battle: the trident does fire damage, which isn't very useful against drakes. Just don't forget to retrieve it for later use.

Picking it up will summon a level-3 Sea Serpent on the next turn, be sure that you're ready for it.

Lord Typhon will depart in a few scenarios, so better give the trident to another fighter. Preferably a "quick" one, who can become a Hoplite and still keep up with his mates when he gets to Level-3.

===Rough Landing===

You will be fighting Nagas and Vampire Bats, primarily. This is a scenario that may be frustrating on the easier difficulty levels, though on hard it is just par for the course. Good recruitment and strategy will save you from getting slaughtered.

Recruitment...
* You are probably going to go negative on gold and be unable to rectify that with the paultry early finish bonus, so you might as will go very negative and be resigned to start the next scenario with minimum gold.
* Recruit/recall many Mermen and 1 or 2 White Mages or Mages of Light. A few Peasants can be useful to pad out your force, distract the enemy, and protect villages from stray Bats. A Silver Mage can be useful for island hopping but is not essential. Thieves/Assassins are blade vulnerable, and Nagas only use blades, so it's probably best not to recall them.

Strategy...
# Knock out the southeastern leader in a blitz. It's important to get that out of the way, because a wave of Nagas is advancing at light speed from the north.
# Next, hurriedly set up a line in the water alongside your fortress island. Your fortress troops can anchor one flank, while Burin the Dwarf can go to the island to the northeast to anchor the other end of your line. Nobody messes with Burin. Move Lady Jessene behind the lines to lend her support to the Mermen. Your loyal Mage of Light will be able to move back and forth more (to lend illumination) if kept in the fortress area.
# Finally, once the enemy assault wave has been broken, advance northward to kill the final two leaders in a straightforward mop-up operation. Just be careful not leave isolated units where they can get swarmed.

Hints/Spoilers...
* Try to level up the mermen; they can be useful in another scenario later.
* Beware of Sea Serpents. Three of them will appear, one on each of the three turns following your first kill of an enemy unit. Make sure to kill them at once. The Storm Trident from the previous scenario and the Ruby of Fire will come in handy against the Serpents.

===A New Land===

This is an odd scenario: as soon as anyone gets killed, the elvish high council will step in an end the bloodshed. Your "early finish bonus" becomes a "late finish" bonus: you're supposed to drag this out for as long as possible without anyone being killed.

Recruitment...
* the strongest units you have, that can deal both melee and ranged damage.
* Rangers are best, followed by Javelineers and level-3 Bowmen.
* you need six of these at the very least, preferably more, plus healers to back them up. If you don't have that many elite troops on your roster, or cannot afford to recall as many, it may be better to do nothing: keep your starting money, and slay the first person to reach you.

Strategy...
Place Javelineers on the keep, Mermen in the water, and Rangers in the forest. All backed up by healers. Have a few reserves you can swap in when things get tough. Haldric also makes a good front-line unit; Javelineers should stay near him for the leadership.

Note that no enemy unit will attack you when there's even a remote risk that they might die. So having the strongest possible fighters, both melee and ranged, will deter the most attackers. If your line looks fierce enough, some level-1 units will not attack you at all. All others will cease attacking as soon as they've taken enough damage that their death becomes a possibility. At which point, they will wander of in search of a village for healing; once all nearby villages are occupied, your attackers may even stand around dumbfounded.

Place your troops where they enjoy a good terrain defense, that is, the keep and the forest. The purpose is to reduce the damage taken and last for as long as possible. After the first round of attacks, you'll always have a few near-dead opponents standing in front of your lines, allowing you to end the scenario quickly.

You need eight tough guys to fully seal off a corner of the map, plus two mermen, and four healers. However, the enemy doesn't know or understand your plan: if your front doesn't extend all the way to the edge of the map, they will not deliberately try to outflank you. To the AI, a ''small'' gap of one or two tiles will look like a trap. So six land warriors to hold the line will do for a long time. Only after the attackers start to pile up against your formation will they eventually start to flow around.

Be sure to keep the villages behind you occupied at all times, however, or wounded enemies seeking a village to heal in may actually try to get there. Sir Ruddry and Burin, having no other use, will do nicely.

Spoiler...
* this the last chance you have to recruit Mermen, as their king leaves. You've probably got plenty on your roster from the previous scenarios, which will stay with you and can be recalled later. But if you think you need more, this is your last chance.
* the late finish bonus is 50/turn, so if your upkeep is less than that, you're in the good. Even if you don't have or cannot afford enough troops for a full defense, trying to hold the keep for a few turns will be worthwhile.

===The Ka'lian===

Story, with your choice of four battles next. You have to beat them all in whatever order. The amount of gold you have should be the factor in deciding when you choose to play Cursed Isle (the undead problem).

===Diverging Campaign Path===

All four scenarios have to be beaten, but in whatever order you choose.

====The Dragon====

This scenario is not as difficult as it looks, though your recruitment and strategy need to be tailored to fight the Saurian Skirmishers and other foes you will face here.

Recruitment...
* Saurians use piercing attacks mostly, so it's better to use units resistant to pierce. Pikemen and Halberdiers have 40% pierce resistance. Javelineers are ideal as Saurians use ranged attacks a lot.
* You may wish to bench some or all of your loyal Iron Maulers. They are ineffective against the 70% impact resistant Mudcrawlers, while also vulnerable to the ranged attacks of both Mudcrawlers and Saurians.
* Consider adopting a force of all units with ranged attacks, save for horse and thief units, which can be kept behind the lines when not in use. It is amusing when Saurian Augers are forced to tap your units with their little staffs.
* Healers are a necessity to deal with the heavy damage your units will be sustaining. Depending on the strategy you adopt, you will want 2-4 healers. Mages of Light rock here, as they can easily do front line duty in pairs and their illumination blinds the Saurians, reducing their damage.
* You need something to clean up mud. Versus level 0 Mudcrawlers, Horsemen and their advancements can charge with no counterattack, and likewise Thieves and their advancements can backstab with no counterattack. Mages can be used as well on the fire vulnerable mud.
* Merman shine on this map once you get them into the swamp / water hexes. They are more mobile than anything but silver mages. The storm trident makes short work of even high-level saurians and the dragon is weak to the pierce damage of your tridents and javelins. An Entangler's slow ability will help tame the dragon even further.

Strategy...
* Players have used many different strategies with success:
** "Hedgehog" strategy: Fighting Saurians requires a disciplined formation. If you're used to stringing out troops to move them into position as they get there, that won't work after Turn 2 or 3. You can use a "healing hedgehog" of ten troops--two white mages next to each other and eight troops completely encircling them. If someone gets badly injured, move them to the inside and put a white mage on one of the long edges, fighting as you go. If you're trying for the big bonus, you'll need two hedgehogs. Try to keep reserves back a bit in cities. If the terrain favorably protects you, or the wounded is a fast unit, you can try moving wounded back to cities too. Once the main wave of Saurians is broken, you can string non-wounded troops out a bit in the rush for the leaders.
** "Triangular Hedgehog" strategy: Switching wounded units to the inside of the hedgehog can be a problem if you are surrounded. ZOC prevents you from creating an open hex to move the inner unit into. You can fix this by creating a triangle with three hexes inside, instead of the standard two of the hedgehog. If you do this on your castle, only three units are in grasslands. If you set it right, you can make most of the hexes adjacent to your triangle be grassland as well, forcing the Saurians into a bad defensive position. In terms of unit positioning, the simplest way is to fill two inner spaces with Mages of Light, a but a better tactic is to put one of the mages on an edge, thereby ensuring that all but one of your units are healing. The remaining unit can either be a Merman Hoplite, (prefereably resilient and carrying a Storm Trident) or Lady Jessene, since she has excellent defense and is chaotic and therefore benefits by not being in the Mages' light.
** "Giant Hedgehog" strategy: Recruit a lot of units, and then move the whole army as one big bulk. Keep healers in the middle (about four), rotate stronger units outwards, and make sure you leave no gaps. The Saurians will slip through the tiniest gap and kill your weak units. Head first for the east or west leader, but steer for good terrain, because your force will soon be swarmed. But then by turn 10, there should be many few Saurians alive.
** "Standard Line" strategy: Form a line from the west board edge diagonally up towards your keep across the two villages just in front of the forest. You will probably wish to bend upwards at the forest, rather than running the line all the way to the keep. Whenever the Saurians have a small number of troops at your line and you have enough strength to kill them all, you can advance your whole line one hex south, allowing you to get additional attacks on them from non-frontline troops. Once you advance a unit to the first water hex at west board edge, the west leader will probably come out to greet it, so be ready to fry him with Haldric's ruby. After killing the leader, back up into good terrain to prepare to meet the dragon.
** "Wake the Dragon" strategy: Prematurely wake the dragon (see spoiler below) and back up your troops to north of your keep. When the dragon comes, kill him. The scenario can be over on turn 7. There is no early finish bonus for this, but you can recruit lightly so that you still have gold at the end and will carry-over 40%, if you need it for your next scenario.
* With all these strategies, the Saurians may hold back for quite a while. This is okay, as the Dragon will eventually appear and come to you. Kill it. Then you are given a choice of whether to end the scenario or to try to kill all the enemy leaders before time runs out. You can choose to finish the remaining Saurians for a nice bonus.

Spoilers...
* The dragon will awake on turn 15 or when you move a unit down around the road north of the mountains. If you wish to wake the dragon prematurely, you can recruit a Horseman on turn 1 and run him down. It's a suicide mission for him, however.
* If you have a fast non-horse unit in position, rush it to the mountain cave after the Dragon leaves to grab the 200 in gold, though that's nothing compared to the Hero bonus for defeating all the Saurian leaders. So focus on killing all of them first.

====Lizard Beach====

This is a scenario versus Saurians, Giant Scorpions, and Mudcrawlers, where good recruiting and strategy will save you from massive bloodshed.

Recruiting...
* Mermen are helpful for the swamp and water areas.
* Bench some or all of your loyal Iron Maulers, veterans from ''The Fall.'' They are laughably ineffective against the impact resistant Mudcrawlers - and laughably vulnerable to their ranged attacks.
* Thieves, Horsemen, and their advancements are good for mud cleanup, though you must keep them out of range of Saurian skirmishers. Swordsmen and Royal Guards are also good, though overkill.
* Recall a lot of fairly high HP units, preferably with strong non-impact ranged and melee attacks.
* Mages are good. Mages of Light are especially useful, since they can do front line duty. Lots of healing may be necessary, about 3 healers are good, so White Mages can be used too. Raw recruit Mages can be used as well, for disposal of Giant Scorpions and the occasional Saurian Skirmisher that wanders too far. At least one Silver Mage is highly desirable, along with a speedy unit (e.g., Fugitive, Footpad, or Horseman) to capture villages for the Silver Mage to use north of the river.
* [fredbobsmith2] An alternative strategy that works surprisingly well is to simply use a very mage-heavy army. Recall most or all of your high-level mages, throw in a few peasants, and spend the rest of your gold on recruiting mages. Victory will come with shocking ease.

Strategy...
* General strategy: as Saurians have skirmishers and a lot of movement, be sure to protect your wounded units well. Because of the Saurians unnerving ability to concentrate their fire on one unit, be sure to keep several healers around and try to keep your line straight so only two can mob one guy. Hedgehog tactic also seems to work well.
* Opening strategy: here are some specific strategies that players have used with success in the early part of the scenario:
# "Mermen in center" strategy: Recall 2-4 Mermen, 1-2 Trappers/Huntsmen, and a lot of high HP troops, then form a line. Initially, you can either form a north-south line around the lake area with one flank at the south board edge, or, if you want to be conservative, you can do a diagonal line in the southeast corner, with both flanks tied to board edges. You'll need the Mermen to handle the lake area, and Trappers/Huntsmen/Mermen for the swamp areas. Keep troops in reserve, so that when a few Saurians meet your line, you can advance your whole line over them. Do not be too conservative/defensive on hard, as your time is limited.
# "Mermen on flank" strategy: Recall several decent land melee units & then 4-5 Level-2 Mermen on rounds 2-3. Most of your force forms a line of battle near your keep, Mermen on the north flank in the river, land units extending south, flanks bent back with strongest units at the corners - then let the Saurians break on it. Once their first wave has broken, the rest of their troops come in drips and are no problem, so now you can split up and wipe out the stragglers and claim villages; any L2 units you start with should level up. After you defeat the main force from the south send just one or two guys north to capture towns so your Silver Mages can teleport into the fray.
# "Mermen feint" strategy: Recall most of your Mermen from before and send them along the river towards the sea. This will harry the saurian troops coming down from the north, allowing your main force to advance on the southern enemy undisturbed. Beware, though as your mermen will encounter the Saurians at night time (giving you -25% and them +25%), so try to minimize conflict until dawn, just get in their way.
# "No Mermen" strategy: On your first two turns recall two keeps of strong, fast veterans like mounted units (not Paladins though; they're pretty ineffective against saurians), Outlaws/Assassins, and Silver Magi along with some other veterans, preferably with a lot of HP: if all goes well (at least on easy and medium) that may be all you need. Dash them across the swamp directly west of your keep, south of the sands, and form a line with strong units at the ends. They'll flank you, but you're stronger than them and you can use your slower units to crush the flanking saurians in a hammer and anvil. The first wave of southern Saurians should get itself killed before the northern Saurians arrive in force. Once the northern Saurians arrive, take them out with your slower units while your quicker ones go for the southern leader.
# "Sacrificial lamb" strategy: In addition to a couple mages, 2 healers, and some other fighters, recruit a castle-full of peasants to draw the Saurians out onto open ground. Surround a single peasant on 5 sides, with 2 healers behind him. Build your formation around that.
* Closing strategy: The enemy's onslaught tapers out after their initial wave, so the final push for the southern leader should be quick and clean. Taking out the northern leader is harder, because all of your units will be stuck south of the marshes and the river. If you want to go for a quick win, just march forth with Silver Mages, Mermen, and anyone who's close enough to be a help. If you don't want to lose any of your better units, patience may be the key.

Spoilers...
* When one of your units gets as far west as the second bridge, a wave of Nagas will arrive out at sea. You may wish to delay going that far until the second watch, so that the Nagas will make contact with your forces during the day.
* Killing one leader gives more gold to the other, so when you've defeated pretty much all the southern leader's forces, just plant a Level-3 or two in his keep and leave him alive; kill them both in the same turn.

====The Troll Hole====

Cave terrain again, but this time the cave is so riddled with holes that there's barely any sense of individual corridors. There's plenty of short narrow passages which prevent both you and your opponents from ganging up on on each other, while on the other hand the trolls can just walk around a blocked choke point and come at you through the neighboring hole. So fighting is mostly one-on-one, though may have several such fights going on at any given time.

The map is roughly symmetrical, a keep in each of the four corners. Two random keeps will be home to the trolls, the other two will be occupied by a Giant Spider each. The spiders will only attack if you get too close.

You designated opponents will be level-1 and -2 trolls, under level-3 commanders. They don't have that much starting gold, but sufficient income to keep recruiting about one Troll Cub per turn, or a level-2 every other turn, very much until you're right on their doorstep. In order to win this, you have to be able and slay the trolls quicker than they're coming.

Recruitment...
* as usual in the caves, give preference to units that can move 3 tiles on cave terrain.
* also as usual by now, this is no place for level-1 units. You can carefully level up one or two rookies, but the bulk of your host has to be tougher than that. It's more an opportunity to level up your chaotic units, and, especially, your mages.
* Spellcasters will do a lot of damage to Trolls, and in the 1-on-1 situation so common on this map, any level-2 or better mage will be certain survive the counterattack. You'll need level-3 Magi to press forward and carry the battle to the enemy's keeps, though.
* You'll want two teams of two healers each in any event. However, Trolls are susceptible to arcane damage, so your White Mages can play a very active role (and quickly level up if so desired). Mages of Light will be especially nice, with their illumination blinding the trolls and a half-decent melee attack to fight back with.
* You can arguably fight this battle on mages alone. However, you'll need at least two keeps worth of units to plug all the holes and prevent the trolls from outflanking you. The supporters' main qualification will be to have enough hitpoints to survice a troll attack; being able to fight back is very desirable. Bandits or Swordsmen will be best, depending on whether you back them by a light source. Trappers and Outlaws will make do in the dark, Pikemen are a distant third, and lawful bowmen should sit this out: Mages can play the same game much better.

The general strategy is to move into whatever direction the trolls are coming from, and fight your way, upstream so to speak, until you get to the enemy keep.

You may start doing so right away, or first await the initial onslaught in the island you're starting on. With you on the ground and the enemy in the water, the terrain is in your favor... but the spacious cavern also allows two or even three trolls to gang up against one of yours. Then again, you can make good use of your loyal mermen and possibly even Sir Ruddry. Neither of which will be any good later when you carry the fight to the enemy, but hey, they're loyal and demand no upkeep.

If you want to explore the map and steal villages, you better do so in force. The spiders will lunge at anyone who happens to get in their range; and besides, there's several unflagged villages at the beginning of the scenario, and your opponents will seize them. This means that trolls, even level-2 ones, may show up in unexpected places.

====Cursed Isle====

You will be fighting undead, mostly of the incorporeal and ghoulish lineages. Victory comes surprisingly easily.

Recruitment...
* Recruit lightly, certainly no more than two castles of troops. You could use 1-3 Paladins, 1-2 Mages, and 1-2 White Mages / Mages of Light.
* Recall your loyal Merman Triton or similar and have him pick up the holy water.

Strategy...
* This can be the first or last quest you choose. If you can wait, do it last, as you will come out of it with a lot of gold, which you will need for the first scenario after the quests, ''The Vanguard''.
* Keep a very tight formation for the first night, as Shadows will hit hard and you don't want to get backstabbed or swarmed. By dawn, it should be smooth sailing.
* If you get anywhere near the enemy leaders' keeps, expect to get rushed by a leader.

Spoiler...
* In one of the three temples there is a Vampire Lady. All you really need is a Paladin or three to rush the temples. Kill her. Game over, you win. One of the other temples has some gold; grab that first.

===A Spy In The Woods===

Plot only.

===The Vanguard===

The map's most striking feature is a natural defensive line, where presumably an underground river has carved a line of sinkholes. The two closest keeps are Orcs, the one in the north holds a Troll. All will be spawning mostly level-2 units. Their average recruit will cost about 20-22 gold, check their gold at the beginning of the scenario and you'll have an idea of how many units you'll have to expect.
The terrain funnels you northward, where you will encounter the northern orcs at nightfall, coming at you in full force. The orcs from the west will start showing up during the night. They are distracted by several un-occupied villages, so they'll be a bit more stretched out. The trolls won't arrive until daybreak.
Whenever one of the enemy commanders has lost half of his units, some undead will join his team: one level-3 skeleton, plus two or four Chocobones depending on difficulty. This happens three times over the course of the battle, once for every enemy commander.
This scenario will be fairly easy, regardless of difficulty level, if you can afford at least three keeps worth of troops.

Recruitment / Strategy:
* Knights recalled on the first turn can encounter the Orcs in your north still in full daylight, and possibly wreck havoc among them before nightfall. The success of this strategy largely depends on what kind of units the orc is sending your way, but in any event don't bother with half-measures: either send 4+ strong riders on turn 1, or don't worry about trying it at all. Follow up with more lawful units and Mages of Light, using only a few chaotic ones to harrass and delay the orcs coming from the west.

* Alternatively, recall your toughest chaotic units from the get-go, and prepare to fight down the first orcish host in the woods to your north, with only a Knight or two to deal with any Wolf Riders getting ahead of the main host.

* You want to bring at least one Paladin (Sir Ruddry probably qualifies) and between that and your healers, you don't need much of a dedicated undead-killing force. If you have loyal Shock Troopers, by all means bring them on -- they'd be useful in any event. Otherwise, a pair of Bandits or a second Paladin will do nicely.

* If you want to seize the villages across the mountains to your west, be prepared to encounter a Goblin Knight or Pillager trying to do the same (you will meet whatever fast unit the western orc happened to recruit on his first turn. It may only be a "quick" archer, but a level-2 wolf is quite likely).

* Beware the Chocobones. Their double damage from charge means they can take out Commander Aethyr at night just by hitting 2 for 2, and they will certainly try if they get the opportunity. They will also keep their distance and refuse to attack until you present them with a target the AI considers worthwhile. Effectively you have to throw them a peasant, or a strong unit that will survive badly wounded and effectively be out of the battle for several turns.

* A Silver Mage or two can come in really handy, Teleporting all over the map to dislodge wolves from the mountains or lend a hand with the undead as needed.

This scenario is an excellent opportunity to train some Knights, as well as a few other lawful fighters. But keep in mind that the campaign is coming to a close and you can only recall so many units in the last battles: if you think you already have enough quality units, it's better to use those (and maybe get an AMLA or two) than to build up an ever bigger roster of troops you can't (or won't) recall.

===Return of the Fleet===

Welcome to the "kitchen sink" defense. You've made it this far; now the enemy will launch a desperate defense, throwing a little bit of everything at you. The orcs in the north deploy the usual orcish fare, but can also recruit trolls. The undead commander will only recruit bats and skeletons (quality depending on difficulty, there may be Chocobones on Hard). During the first night, the Lich-Lord will make another appearance, casting fog of war upon the battlefield and deploy a number of Chocobones on the undead island (they're under command of the orcs, though).
When you get too close to the isle in the river mouth, you'll trigger cuttlefish to the west of that isle. Getting too close to the swamps where the river starts will summon level-2 saurians. It looks dire but the effect is mostly psychological.

Wolf riders may reach you during the night, the bulk of the orc army won't arrive until daybreak (unless you push forward to meet them, which you shouldn't). The skeletons, too, will be held up by the water. So you've got a lot of time to set up positions near the beach and in the wood.

* First turn, recall Mermen to assassinate the undead leader; 2 Entanglers/Netcasters and the Triton with the Storm Trident. It will be morning until they even reach the sea, but they'll still arrive in time to help with any (possibly many) skeletons still in the water. Later they can deal with the Draug in his keep. A Silver Mage's assistance will help but isn't strictly necessary.
* also send a few undead-bashers to the beach. Two or three units holding the beach at any time will do nicely; Burin and the loyal Shock Troopers are best, mostly because they're armored against arrows. If you don't have those, a number of Outlaws/Fugitives will be the next best choice, though you'll need more of them due to the damage taken.
* the cuttlefish (1, 2 or 4 of them depending on difficulty) will keep your mermen occupied for several turns and in need of healing afterwards. It's probably best to trigger them very early (a rider seizing the village at 20,22 will do): the cuttlefish are so aggressive that they will get out onto dry land in order to attack an Iron Mauler in broad daylight. That way, you can have them finished off before any skeletons reach you, and long before your mermen are even in the water.
* add another two or (at most) three keeps of mixed troops. You've fought enough orcs and trolls by know that you should know what suits the purpose. You probably want a few chaotic units to hold up the assault late at night, then rush the enemy with lawfuls at daybreak. Cavalry will once more work well, just keep in mind that you'll face a task force of quality saurians later on -- you also want some units that are not quite as prone to piercing damage.
* talking about which: getting within 10 hexes or less from 34,15 will touch off the Saurians. With careful navigation the encounter can be avoided for the whole scenario, but it's probably better to trigger them at a time of your choosing and get it over with. Saurians aren't very tough, their strength comes from being hard to hit and their skirmishing ability. But on normal and easy, they're not very numerous. If you can lure them out into open terrain, you can probably overwhelm them in a single turn, even at night.

Try to finish this scenario quickly. Make use of veterans, by this point you should really have enough of them. Don't worry about running into negative funds in the mean time: there's enough villages to ensure a hefty early finish bonus. Just don't dawdle, you want to get out of this with at least 200, better 300 gold carried over.

===Rise of Wesnoth===

It's the final battle: be patient, recall everybody - the early finish bonus doesn't mean anything. Also, loyal units are no better than other units after your recruitment is finished.

Recruitment...
* You will need at least 300 starting gold, maybe more like 400 on the hardest difficulty level, so if need be, replay the previous scenario.
* To stretch your money, start with loyal Iron Maulers and some ready-to-level level 1's and Level-2's. Finally, recall as many Level-3's as possible.
* Healers: 3-6 Mages of Light / White Mages. Your few chaotic units will appreciate a White Mage.
* Horse units: 2-4 Paladins, 3-4 Knights / Grand Knights.
* Horse escorts: about 3 speedy units, like Royal Guards, Fugitives, and Silver Mages.
* Tanks: at least 6 high HP units, such as Royal Guards, Highwayman, Master Bowmen, and the loyal Iron Maulers.
* Mages: at least 3 high level Mages aside from your basic healers, so Arch Mages, Great Mages, and Silver Mages. Additional Mages of Light can be substituted.
* Some Mermen might be useful here, but surprisingly, they're not really necessary.

Strategy...
* You can either send everybody west initially and then split for the two bridges or you can split initially, with mounted units racing to the west and then south, while the main army heads due south.
* With your mounted units, race forwards by day and backwards by night.
* Along with the mounted units should go some escorts, speedy foot units intended to kill things like Goblin Impalers, which make even Grand Knights nervous. They would also benefit from a quick Mage of Light.
* Meanwhile, with your tanks and the rest of your healers and support units, form a line or hedgehog.
* Maintain awareness of the overall battlefield.
* Kill all but one of the orc leaders (not all!).
* Don't forget to sacrifice Aethyr to Jevyan. Jevyan probably won't come out to play, so march Aethyr up to Jevyan and use a crossbow attack.
* Paladins, great mages, mages of light, silver mages are all suitable units to kill Jevyan himself, make sure you have them in sufficient numbers with your southern army. Congratulations! Enjoy the ending!

Spoilers...
* When one of your units is within 8 hexes of a bridge, but you have no units within 2 hexes of the bridge, and there are no units on the bridge, then a Cuttle Fish will appear and destroy the bridge. This is usually disadvantageous. Not only does it leave you with a Cuttle Fish to fight, but it slows your progress south and the bad guys progress north. At least on the hardest difficulty level, it's hard to kill all the spam in time, so you don't want to impede their advance by removing the bridge.
* When any of your units is killed, it becomes a Walking Corpse (or a Soulless on hard.)
* After the first orc leader is killed, then some gold goes to mister Lich. It's 40, 80, or 120 gold, for easy, medium, and hard, respectively. The lich also will receive some gold once you kill his Familiar.

== See Also ==

* [[MainlineCampaigns]]

[[Category:Campaigns - The Rise of Wesnoth]]
[[Category:Campaigns - Walkthroughs]]

SingleUnitWML

2020-05-04T18:48:09Z

Beetlenaut: /* Unit Data */

{{WML Tags}}
The '''[unit]''' tag describes a single unit on the map or in memory, for example Konrad.
It is different from the [unit_type] in [units], which describes a class of units. However it takes many of the same keys and thus can generally override the inherited properties from the associated [unit_type].

[unit] can be used inside [side] ([[SideWML]]) for units present at start of the scenario, or as [[DirectActionsWML]] for units created during the game. (It is also used in save-files.)

This contains keys and tags which describe the unit's [[#Unit Data|persistent data]], as well as certain [[#Unit State|state variables]] which will also persist with the unit but will change frequently as gameplay progresses. Finally, there are some keys to set certain [[#Creation Options|one-time options]] for how the unit will be initially created, which will ''not'' persist beyond initial creation.

== Unit Data ==
The following keys and tags describe the unit itself, and will persist with the unit (though some may change automatically when the unit advances):
* '''type''': the ID of the unit's unit type. This key is mandatory. See [[UnitTypeWML]].

* '''variation''': the [variation] of the [unit_type] as which the unit will appear.

* '''parent_type''': overrides '''type''' if this is present. This is likely of little use to WML authors; it is automatically generated when needed by the game (to keep track of some [unit_type][variation]s).

* '''side''': the side that the unit is on. It has to be an existing side, even if the unit is created in a variable. Defaults to 1, except when the [unit] tag appears inside a [side], in which case the unit always belongs to that side, and this key is ignored.

* '''id''': a unique identifier for the unit. This is (usually) not displayed to the player, but is to be used only for identifying and filtering units. If not specified, a random one will be generated for the unit to ensure that each unit has a unique '''id''' attribute (as will happen when a unit is recruited normally). In older versions, the '''description''' attribute specified a unique ID. (The one instance when an id is displayed to the player is when the leader's id is used as the default for a [[SideWML|side]]'s '''current_player''' attribute.) Note: While it IS technically possible to create multiple units with the same ID, doing so may produce unpredictable results in many cases. WML should therefore be structured in such a way that no two units in existence ever end up with the same ID.

* '''gender''': can be set to male or female to designate the gender of the unit. Default is male (unless [[#random_gender|'''random_gender''']] is set to "yes"), but if the unit has only a female variant it will be female.

* '''name''': the user-visible name of the unit. Note that the player may use the "rename unit" action to change this (unless '''unrenamable''' is also set).

* '''unrenamable''': if 'yes', the user-visible name of the unit cannot be changed by the player (which is only possible when the unit is on the player's side anyway).

* '''canrecruit''': a special key for leaders.
** '''no''': default. Unit cannot recruit.
** '''yes''': unit can recruit.
: Normally when a team controls no units with '''canrecruit=yes''', that team loses. However, even if your team has lost you continue to play with whatever units you still have until the scenario is over. Usually scenarios end when only one team is left with a leader that can recruit, but special victory conditions can be set up in campaigns. Normally you want to set the leader of a side with '''canrecruit=yes'''. If you don't want the leader to recruit, it is usually better to just not give him any unit types to recruit, than to make a special victory condition. Units with '''canrecruit=yes''' are exempt from upkeep costs. So that leaders do not need to be given the ''loyal'' trait.
: More than one unit with '''canrecruit=yes''' for the same side (see [[SideWML]]) are allowed in single player, if the side is human-controlled.

* '''extra_recruit''': a list of unit types which this unit can recruit in addition to the ones given by its [side]recruit= (only relevant for units with '''canrecruit=yes''').

* '''[filter_recall]''' A leader can only recall those units which pass the SUF. (Meaningful only if canrecruit=yes.)
**'''[[StandardUnitFilter]]''' tags and keys

* '''level''': the unit's current level. Defaults to the level of the [unit_type] described by [[#type|'''type''']]. This is generally not set manually.

* '''upkeep''': the amount of upkeep the unit will require each turn.
** '''loyal''': no upkeep cost. Can be changed by the effect 'loyal' (see [[EffectWML]])
** '''free''': synonymous with "loyal".
** '''full''': unit costs ''level'' upkeep (see [[UnitTypeWML]]).
** An integer can be used to set the upkeep cost to that number.
** The default is "full".
** Leaders (units with '''canrecruit=yes''') never pay upkeep no matter what upkeep is set to.
** Normally you don't want to muck with this value. If you want to give a side units without upkeep costs, give those units the 'loyal' trait.

* {{DevFeature1.13|0}} '''recall_cost''': the recall cost of this unit. Overrides the values specified by the unit's type ([[UnitTypeWML|[unit_type]]]), its side ([[SideWML|[side]]]), and the global [[GameConfigWML|[game_config]]] value. A value of -1 is equivalent to not specifying this attribute. {{DevFeature1.15|0}} Units are now recalled for AI sides even if the recall_cost is larger than the unit's worth (essentially its cost, plus potentially a bonus for experience points). In 1.14 and earlier, units were not recalled by the AI in this case even if this was the only recall/recruit action possible to the AI.

* '''overlays''': a comma-separated list of images that are overlayed on the unit.
** {{DevFeature1.15|0}} This key is supported when creating a unit from WML, but will be empty when writing the unit back to WML; the overlays will instead be stored as [modifications].

* '''max_hitpoints''': The maximum hitpoints the unit has when at full health. Default is the max HP set for the [unit_type] described by [[#type|'''type''']].

* '''max_experience''': The experience the unit needs to advance. Default is the experience required for the [unit_type] described by [[#type|'''type''']].

* '''max_moves''': The maximum number of movement points the unit has. Default is the number of movement specified for the [unit_type] described by [[#type|'''type''']].

* '''vision''': The the number of vision points to calculate the unit's sight range. Default is the number of vision points specified for the [unit_type] described by [[#type|'''type''']].

* '''jamming''': {{DevFeature1.15|0}} The number of jamming points for the unit. Default is the number of jamming points specified for the [unit_type] described by [[#type|'''type''']].

* '''max_attacks''': The number of attacks the unit can have per turn. Default is the number of attacks specified for the [unit_type] described by [[#type|'''type''']].

* '''profile''': sets a portrait image for this unit. Default is the portrait image set for the [unit_type] described by [[#type|'''type''']]. When the unit advances, if the value of profile is different from the unit-type portrait, that value is preserved. If the profile field is empty or the same as the unit-type portrait, the level-advance changes the unit portrait to the default for the new level and type. See [[UnitTypeWML]] for the rules used for locating files.
** If "unit_image" is given instead of a filename, uses the unit's base image as the portrait (in the same manner that unit types without portraits do by default).

* '''small_profile''': sets a small portrait image for this unit. See the '''profile''' attribute above for advancement and special values. As with [[UnitTypeWML]], the location heuristic of the '''profile''' attribute is disabled when the '''small_profile''' attribute is provided.

* '''role''': used in standard unit filter ([[FilterWML]]). Can be set using [role] (see [[InternalActionsWML]]).

* '''[variables]''' a set of variables that will be stored when this unit is stored (See [store_unit], [[InternalActionsWML]]). The attribute '''variable'''='''value''' means that when the unit is stored in the array ''unit'', the variable '''unit'''.variables.''variable'' will have the value ''value'' (See [[VariablesWML]]). The subnode '''mods''' is special as it is deleted on every unit rebuild (for example when the unit advances or when an [object] is removed). This makes it possible to implement [effect]s that change variables, as those will also be reapplied whenever the unit is reset. (so in particular if your effect changes the variables mods.<whatever> [remove_object] will work properly for those objects.) For example the following code will define a apply_to=moves_on_recruits effect that gives units with that effect full movement when recruited

<syntaxhighlight lang='lua'>
function wesnoth.effects.move_on_recruit(u, cfg)
-- maybe better use a status than a variable ?
u.variables["mods.move_on_recruit"] = true
end
on_event("recruit,recall", function(ec)
local unit = wesnoth.get_unit(ec.x1, ec.y1)
if unit and unit.variables["mods.move_on_recruit"] then
unit.attacks_left = 1
unit.moves = unit.max_moves
end
end)
</syntaxhighlight>
And since we used the mods subtable, [remove_object] will work properly for objects that give this effect.

* '''[modifications]''' changes that have been made to the unit.
** '''[trait]''' a trait the unit has. Same format as [[UnitsWML#.5Btrait.5D|[trait], UnitsWML]].
** '''[object]''' an object the unit has. Same format as [[DirectActionsWML#.5Bobject.5D|[object], DirectActionsWML]].
** '''[advance]''' an advancement that has already been applied to the unit. Same format as [[UnitTypeWML#After max level advancement (AMLA)|AMLA [advancement], UnitTypeWML]]. These are automatically added as the unit has AMLA advancements applied to it, but can also be specified manually to indicate that the unit already has a particular advancement applied, or to disable certain advancements (by ID). {{DevFeature1.13|2}} In 1.13.2 and later this has been renamed to [advancement], to match the UnitTypeWML tag of the same name.

* '''[event]''' The event is copied from this unit's WML description into the scenario. The event is carried along with the unit (even during advancement) and inserted into a scenario whenever this unit is first included. A [unit][event] requires a non-empty id= attribute.

* '''unit_description''': overrides the unit type description for this unit. Note that this will be reset when the unit advances. To avoid this, one can either set up a ''post_advance'' [[EventWML|event]] to override the default description after promotion, or use an [object] with a profile [[EffectWML|effect]] to change the unit description.

* '''hp_bar_scaling''': Overrides the attribute in [[GameConfigWML]] (and the [unit_type], if present).

* '''xp_bar_scaling''': Overrides the attribute in [[GameConfigWML]] (and the [unit_type], if present).

* '''ai_special''': causes the unit to act differently
** "guardian" the unit will not move, except to attack something in the turn it moves (so, it only can move if an enemy unit gets within range of it). Does the same as '''[status] guardian = 'yes''''.

* '''[ai]''' This affects how the computer will control this unit (currently only used by [[FormulaAI]]).
** '''formula''': if set, the unit will execute this code during the "unit_formulas" stage, assuming that the "unit_formulas" stage has been enabled for this side
** '''priority''', '''loop_formula''', '''[vars]''': see the [[FormulaAI]] documentation for details

* '''traits_description''': the description of the unit's traits which is displayed. However if it is not specified explicitly, the unit's actual traits' names will be used instead, so it is normally not necessary to set this.

*'''alignment''': one of lawful/neutral/chaotic/liminal (See [[TimeWML]]). Default is the alignment of the [unit_type] described by [[#type|'''type''']]. This is generally not set manually.

*'''advances_to''': comma-separated list of unit types to which this unit can advance. Will override the default provided by the [unit_type]. This is generally not set manually.

*'''race''': See {{tag|UnitsWML|race}}. Will override the default provided by the [unit_type]. This is generally not set manually.

*'''undead_variation''': Will override the default provided by the [unit_type]. This is generally not set manually.

*'''usage''': Will override the default provided by the [unit_type]. This is generally not set manually.

*'''zoc''': whether the unit has a zone of control. Will override the default provided by the [unit_type]. This is generally not set manually.

*'''[movement_costs]''', '''[vision_costs]''', '''[defense]''', and '''[resistance]''': Can be used to modify [[UnitsWML#.5Bmovetype.5D|existing values]].

*'''[attack]''': Takes the same syntax as [[UnitTypeWML#Attacks|[unit_type][attack]]]. By default, the attacks from the [unit_type] will be included. '''Note:''' using this tag will replace ''all'' [attack] tags with the new one.

*'''hidden''': Implementation detail of [[InterfaceActionsWML#%5Bhide_unit%5D|[hide_unit]]]. This should not be set manually.

== Unit State ==
The following keys and tags describe the current state of the unit, and will change regularly as gameplay progresses:
* '''x''', '''y''': the location of the unit. By default (unless modified by [[#placement|'''placement''']] below) if a location isn't provided and the side the unit will belong to has a recall list, the unit will be created on the recall list. The recall list can also be explicitly specified as the location with "recall,recall".

* '''location_id''': {{DevFeature1.13|8}} the location of the unit, referencing one of the special locations defined by the map. This overrides '''x''' and '''y''' if present but otherwise has the same effect and can be modified by the placement options.

* '''facing''': which way the unit is facing (this only affects how the unit is displayed).
** Possible values are '''se''', '''s''', '''sw''', '''nw''', '''n''', '''ne'''. Note that some unit types may not have distinct animations for each direction.

* '''goto_x''':, '''goto_y''': the unit's current movement destination. Default is 0,0 i.e. the unit is not on a course.

* '''hitpoints''': the HP of the unit. Default [[#max_hitpoints|'''max_hitpoints''']].

* '''experience''': the XP of the unit. Default is 0.

* '''moves''': number of movement points the unit has left. Default is [[#max_moves|'''max_moves''']].
: '''Note:''' Do not assume that moves=max_moves on turns when the unit doesn't move. The wesnoth AIs sometimes manipulate the moves variable during its turn, for internal reasons.

* '''resting''': whether the unit has not moved yet this turn. Used to decide whether to give the unit rest healing. Note that this can be true even if moves is not equal to max_moves.

* '''attacks_left''': number of attacks the unit has left. Default is '''max_attacks'''.

* '''[status]''' the status of the unit. This affects different features of the unit, for example whether the unit loses health each turn. Default for all keys is 'no', but this can be changed by the scenario or by special abilities (see [[AbilitiesWML]]). The Status Table displays the status of each unit using the three images '''misc/poisoned.png''', '''misc/slowed.png''' and '''misc/petrified.png'''; other keys do not appear in the Status Table.
** '''poisoned''': if 'yes', the unit loses 8 HP each turn. See also ''heals'', ''cures'', [[AbilitiesWML]].
** '''slowed''': if 'yes', the unit has 50% of its normal movement and does half damage. When the controller of the unit's turn is over, '''slowed''' is set to 'no'.
** '''petrified''': if 'yes', the unit cannot move, attack, or be attacked.
** '''uncovered''': if 'yes', the unit has performed an action (e.g. attacking) that causes it to no longer be hidden until the next turn.
** '''guardian''': if 'yes', the unit will not move, except to attack something in the turn it moves (so, it only can move if an enemy unit gets within range of it). Does the same as '''ai_special = "guardian"'''.
** '''unhealable''': if set to 'yes', the unit cannot be healed. This includes the healing by resting.
** '''unpoisonable''': A status, which is often set using traits.
** '''undrainable''': A status, which is often set using traits.
** '''unplagueable''': A status, which is often set using traits.
** '''not_living''': Deprecated, this is automatically set when all three above are set and vice versa.
** '''invulnerable''': {{DevFeature1.13|6}} if 'yes', attacks can't hit the unit.
** One can add other keys to [status], but they must have boolean values, and they will not do anything meaningful on their own (but can be checked from events and acted upon accordingly). For example, a scenario can set unit.status.''my_custom_key'' to 'yes' or 'no'.

* '''invulnerable''': {{DevFeature1.13|6}} a shorthand to set the ''invulnerable'' status. Useful in [[CommandMode]] for debugging purposes. It's recommended to use [status] in written code instead.

== Creation Options ==
In addition to the unit's persistent data itself, there are several options for controlling how the unit will be created, as follows:
* '''placement''': How the unit should be placed: can be one value or a comma-separated list of values. Default value is 'map,leader' for a leader given directly in [side], "" otherwise. By default, 'map,recall' is implicitly appended to the end of the list.
** '''map''': If x,y (or location_id) are explicitly given and point to a valid on-map location - try to place the unit at the nearest free location to there, never overwriting existing units. Successful if x,y (or location_id) are given and a valid on-map vacant location near it can be found.
** '''leader''': Try to place unit near the leader, if leader is not present or is in recall list - try to place unit near the start location for this side. Successful if a valid on-map vacant location can be found near leader or near start location.
** '''recall''': Place unit on recall list. Always successful.
** '''map_overwrite''': If x,y are explicitly given and point to a valid on-map location - try to place unit at this location, if there was a unit there - overwriting it, without firing events. {{DevFeature1.13|8}} Deprecated, use placement=map and overwrite=yes instead.
** '''map_passable''': If x,y are explicitly given and point to a valid on-map location - try to place unit at this location; if the hex is of an impassable terrain for the unit being placed, or is already occupied by another unit, the new unit will be placed in the nearest vacant hex. {{DevFeature1.13|8}} Deprecated, use placement=map and passable=yes instead.
** '''leader_passable''': Similar to "leader", with the additional restriction that the selected location is not impassable for the unit being placed. {{DevFeature1.13|8}} Deprecated, use placement=leader and passable=yes instead.
* '''passable''': {{DevFeature1.13|8}} (default=no) If yes, and the specified location is of an impassable terrain for the unit being placed, the new unit will be placed in the nearest hex that is of a passable terrain for it.
* '''overwrite''': {{DevFeature1.13|8}} (default=no) If yes, always place the unit at the exact specified location, overwriting the existing unit if there is one. Generally you don't want to use this together with placement=leader.

* '''generate_name''': (default=yes) will generate a new '''name''' if there isn't one specified for the unit, as if the unit were a freshly-recruited one.
* '''random_traits''': "no" will prevent random trait generation for units. You should only need to set this for placed nonleaders in multiplayer games or if you want to give the unit fewer traits than it would normally get for its unit type. When generating traits for a unit, first traits the unit has already been given are excluded. Then "musthave" traits (undead, mechanical) for the unit type are given. Then for leaders ('''canrecruit=yes''') traits that are not available to "any" (currently that's all of them to avoid a multiplayer OOS issue, but later will be restricted based on multiplayer play balance issues) are removed from consideration. Then traits are added randomly until the maximum allowed for the unit type is reached or there are no more available traits. Random traits can now be used in MP games but only when spawned in an event, so not for leaders and other units in the [side] definition.

* '''random_gender''': "yes" will cause the gender of the unit with male and female variations to be male 50% of the time, female 50% of the time. If the unit has only one gender variant it will always be given the correct one.

* '''to_variable''': (only for [event][unit]) creates the unit into the given variable instead of placing it on the map.

* '''animate''': whether to display the recruitment animation for this unit as if it were being recruited/recalled. Defaults to "no". Irrelevant when the [unit] tag appears inside a [side].

== See Also ==

* [[UnitTypeWML]]
* [[InternalActionsWMLUnitTags]]
* [[ReferenceWML]]

[[Category:WML Reference]]

DirectActionsWML

2018-04-08T03:20:39Z

Beetlenaut: The explanation for "id" was outdated.

{{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. If ''result=victory'', the player progresses to the next level (i.e., the next scenario in single player); if ''result=defeat'', the game returns to the main menu.

When the result is "victory" the following keys can 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. {{DevFeature1.13|2}} Alternatively, a number, defining the bonus percentage (1.0 meaning full).
* '''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. Do not confuse this with saving of replays for the current scenario.
* '''replay_save''': whether a replay save for the current scenario is allowed, the default is replay_save=yes. If yes, the player's settings in preferences will be used to determine if a replay is saved. If no, will override and not save a replay.
* '''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.
* '''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''.
* '''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 yes the gold will be added to the starting gold the next scenario, if no the next scenario will start with the amount of the current scenario (after taxes) or the minimum in the next scenario. Default is no.
* '''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_credits''': Whether to display the credits screen at the end of a single-player campaign. Defaults to ''yes''. 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''': (translatable) 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]].
* <strike>'''[next_scenario_settings]''': Any tags or attribute children of this optional argument to [endlevel] are merged into the scenario/multiplayer tag of the *next* scenario. This allows you to e.g. reconfigure the [side] tags or settings, just before load. </strike> This feature was removed in 1.11.17, it might be redesigned and reintroduced.
* <strike>'''[next_scenario_append]''': Any tags of this optional argument are appended at high level to the next scenario. This is most appropriate for [event] tags, although you may find other uses. Example test scenario for these features: https://gna.org/support/download.php?file_id=20119 </strike> This feature was removed in 1.11.17, it might be redesigned and reintroduced.
* '''[result]''' {{DevFeature1.13|0}} Allows specification of a side specific result, this is for competitive multiplayer scenarios/campaigns where it might happen that one player wins but another player loses. The following attributes are accepted and have the same effect as in '''[endlevel]''':
** '''result'''
** '''bonus'''
** '''carryover_percentage'''
** '''carryover_add'''

And there is also
** '''side''' The number of the side for which these results should apply.

=== [unit] ===
Creates a unit (either on the map, on a recall list, or into a variable for later use.) For syntax see [[SingleUnitWML]].
* {{Short Note:Predefined Macro|GENERIC_UNIT}}

=== [recall] ===
Recalls a unit taking into account any [http://wiki.wesnoth.org/SingleUnitWML filter_recall] of the leader. The unit is recalled free of charge, and is placed near its leader, e.g., if multiple leaders are present, near the first found which would be able to normally recall it.

If neither a valid map location is provided nor a leader on the map would be able to recall it, the tag is ignored.

* [[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''': boolean yes|no (default no); whether any according prerecall or recall events shall be fired.
* '''check_passability''': (boolean yes|no, default yes): If yes, checks for terrain passability when placing the unit (a nearby passable hex is chosen).

=== [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 hex to teleport to. If that hex is occupied, the closest unoccupied hex will be used instead.
* '''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)
* '''check_passability''': (boolean yes|no, default yes): normally, units will not be teleported into terrain that is impassable for them. Setting this attribute to "no" 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.
* [[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.

If you want to remove the overlays from a terrain and leave only the base, use:
layer=overlay
terrain="^"

Note: When a hex changes from a village terrain to a non-village terrain, and a team owned that village it loses that village. When a hex changes from a non-village terrain to a village terrain and there is a unit on that hex it does not automatically capture the village. The reason for not capturing villages it that there are too many choices to make; should a unit lose its movement points, should capture events be fired. It is easier to do this as wanted by the author in WML.

=== [gold] ===
Gives sides gold.
* '''amount''': the amount of gold to give.
* '''side''': (default=1) the number of the side to give the gold to. Can be a comma-separated list of sides. note: Default side=1 for empty side= is deprecated.
* [[StandardSideFilter]] tags and keys; default for empty side= is all sides, as usual in a SSF.

=== [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]]].
* '''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.
* '''check_passability''': (boolean yes|no, default yes): If yes, checks for terrain passability when placing the unit. This key has no effect if find_vacant=no (no check performed then). Before 1.9 this key is always "no".
* '''text''': (translatable) floating text to display above the unit, such as a damage amount
* '''male_text''', '''female_text''': {{DevFeature1.13|2}} (translatable) gender-specific versions of the above
* '''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=yes) if yes 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.
* '''fire_event''': (boolean yes|no, default no) Whether any advance/post advance events shall be fired if an advancement takes place, no effect otherwise.
* '''animate''': (boolean yes|no, default yes) Whether "levelout" and "levelin" (or fade to white and back) animations shall be played if an advancement takes place, no effect otherwise.
* '''x''' ,'''y''': override unit location, "x,y=recall,recall" will put the unit on the unit's side's recall list.
Units can be unstored with negative (or zero) hit points. This can be useful if modifying a unit in its last_breath event (as the unit's death is already the next step), but tends to look wrong in other cases. In particular, it is possible to have units with negative hit points in play. Such units are aberrations, subject to unusual behavior as the game compensates for them. (For example, such units are currently automatically hit–and killed–in combat.) The details of the unusual behavior are subject to change between stable releases without warning.

=== [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. This can be a comma-separated list note: Default side=1 for empty side= is deprecated.
* [[StandardSideFilter]] tags and keys; default for empty side= is all sides, as usual in a SSF.

=== [allow_extra_recruit] ===
Allows a leader to recruit units it couldn't previously recruit.
These types add to the types the leader can recruit because of [side]recruit=.
* '''extra_recruit''': the types of units that the unit can now recruit.
* '''[[StandardUnitFilter]]''': All units matching this filter are modified. Does not match on recall list units.

=== [disallow_recruit] ===
Prevents a side from recruiting units it could previously recruit.
* '''type''': the types of units that the side can no longer recruit. {{DevFeature1.13|0}} If omitted, all recruits for matching sides will be disallowed.
* '''side''': (default=1) the number of the side that may no longer recruit the units. This can be a comma-separated list note: Default side=1 for empty side= is deprecated.
* [[StandardSideFilter]] tags and keys; default for empty side= is all sides, as usual in a SSF.

=== [disallow_extra_recruit] ===
Prevents a leader from recruiting units it could previously recruit.
* '''extra_recruit''': the types of units that the side can no longer recruit.
* '''[[StandardUnitFilter]]''': All units matching this filter are modified. Does not match on recall list units.

=== [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. This can be a comma-separated list. note: Default side=1 for empty side= is deprecated.
* [[StandardSideFilter]] tags and keys; default for empty side= is all sides, as usual in a SSF.

=== [set_extra_recruit] ===
Sets the units a leader can recruit.
* '''extra_recruit''': the types of units that the leader can now recruit.
* '''[[StandardUnitFilter]]''': All units matching this filter are modified. Does not match on recall list units.

=== [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. note: Default side=1 for empty side= is deprecated.
* '''[filter_side]''' with a [[StandardSideFilter]] as argument
* '''income''': the income given at the begining of each turn.
* '''recruit''': a list of unit types, replacing the side's current recruitment list.
* '''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.
* '''color''': a team color range specification, name (e.g. "red", "blue"), or number (e.g. "1", "2") for this side. The default color range names, numbers, and definitions can be found in data/core/team_colors.cfg.
* '''[ai]''': sets/changes AI parameters for the side. Only parameters that are specified in the tag are changed, this does not reset others to their default values. Uses the same syntax as described in [[AiWML]]. Note that [modify_side][ai] works for all simple AI parameters and some, but not all, of the composite ones. If in doubt, use [http://wiki.wesnoth.org/AiWML#Adding_and_Deleting_Aspects_with_the_.5Bmodify_ai.5D_Tag [modify_ai]] instead, which always works.
* '''switch_ai''': replaces a side ai with a new AI from specified file(ignoring those AI parameters above). Path to file follows the usual WML convention.
* '''reset_maps''': If set to "yes", then the shroud is spread to all hexes, covering the parts of the map that had already been explored by the side, including hexes currently seen. (Seen hexes will be cleared at the end of most events; they can also be manually cleared with {{tag|InterfaceActionsWML|redraw}}.) This is only effective if shroud is on, but this is evaluated after shroud= (and before shroud_data=).
* '''reset_view''': If set to "yes", then the fog of war is spread to all hexes, covering the parts of the map that had already been seen this turn by the side, including hexes currently seen, excluding hexes affected by multi-turn {{tag|DirectActionsWML|lift_fog}}. (Seen hexes will be cleared at the end of most events; they can also be manually cleared with {{tag|InterfaceActionsWML|redraw}}.) This is only effective if fog is on, but this is evaluated after fog=.
* '''share_maps''': change the share_maps side attribute. Be sure to use shroud=yes for that side and have it as an ally
* '''share_view''': change the share_view side attribute. Be sure to use fog=yes for that side and have it as an ally
* '''shroud_data''': changes to the side's shroud, using the same format as when defining the [side].
* '''suppress_end_turn_confirmation''': Boolean value controlling whether or not a player is asked for confirmation when skipping a turn.
* '''scroll_to_leader''': Boolean value controlling whether or not the game view scrolls to the side leader at the start of their turn when present.
* '''flag''': Flag animation for villages owned by this side (see [[SideWML|[side]]]).
* '''flag_icon''': Flag icon used for this side in the status bar (see [[SideWML|[side]]]).
* '''village_support''': The number of unit levels this side is able to support (does not pay upkeep on) per village it controls.
* '''defeat_condition''' {{DevFeature1.13|0}}: When the side is considered defeated (see [[SideWML|[side]]]).

=== [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 not possible to change the turn number to exceed the turn limit (1 <= current turns <= max turns).

=== [allow_end_turn] ===
Allows human players to end their turn through the user interface if they were previously affected by the '''[disallow_end_turn]''' action. This action doesn't take any arguments.

=== [disallow_end_turn] ===
Disallows human players to end their turn through the user interface. This action doesn't take any arguments.

=== [capture_village] ===
Changes the ownership of a village.
* [[StandardLocationFilter]]: all village locations matching the filter are affected.
* '''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 (unless [filter_side] is present, in which case that side fiter decides, see below).
* '''[filter_side]''' with [[StandardSideFilter]] tags and keys as arguments; if both this tag and inline side= are present it's an error. Otherwise, the first matching side gets ownership (or the village becomes neutral if none match).
* '''fire_event''' (boolean yes|no, default: no): Whether any capture events shall be fired.

=== [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). {{DevFeature1.13|8}} If '''[secondary_unit]''' is given, also plays the victory animation of that unit.
* '''fire_event''': if 'yes', triggers any appropriate 'die' events (See [[EventWML]]). Note that events are only fired for killed units that have been on the map (as opposed to recall list).
* '''[secondary_unit]''' with a [[StandardUnitFilter]] as argument. Do not use a [filter] tag. Has an effect only if fire_event=yes ({{DevFeature1.13|8}} or if it has a victory animation and animate=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).
* '''[primary_attack]''', '''[secondary_attack]''' {{DevFeature1.13|8}} The attacks to use for matching the animation. Useful for example on the wose, whose death animation depends on the damage type it was killed by.

=== [move_unit] ===
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 location is chosen.
* '''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.
* '''check_passability''' (boolean yes|no, default yes): Whether the terrain the unit is moved to should be checked for suiting the unit. (If it does not, a nearby suitable hex is chosen.)
* '''force_scroll''': Whether to scroll the map or not even when [[InterfaceActionsWML#.5Block_view.5D|[lock_view]]] is in effect or ''Follow Unit Actions'' is disabled in ''Advanced Preferences''. Defaults to using [[InterfaceActionsWML#.5Bmove_unit_fake.5D|[move_unit_fake]]]'s default value.

=== [modify_ai] ===
Changes AI objects (aspects, goals, candidate actions or stages) for a specified side. See [[Modifying_AI_Components#The_.5Bmodify_ai.5D_Tag|Modifying AI Components]] for full description.

* '''action''' (string): Takes values 'add', 'change', 'delete' or 'try_delete' to do just that for the AI object.
* '''path''' (string): Describes which AI object is to be modified.
* '''[facet]''', '''[goal]''', '''[candidate_action]''' or '''[stage]''': Details about the AI object to be modified.
* [[StandardSideFilter]] tags and keys; default for empty side= is all sides, as usual in a SSF.

=== [modify_unit] ===
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.
* '''[object]''', '''[trait]''', {{DevFeature1.13|5}} '''[advancement]''' - The given modifications will be immediately applied to all units matching the filter.
** '''delayed_variable_substitution''' {{DevFeature1.13|5}} (boolean yes|no, default no): If set to "yes", the wml block contained in this [object], [trait], or [advancement] is not variable-substituted at execution time of the event containing this [modify_unit]. You need this for any effect that uses variable substitution or when using [effect][filter] with a $this_unit. {{DevFeature1.13|9}} This is no longer needed when adding ABILITY_TELEPORT, ABILITY_LEADERSHIP or SPECIAL_BACKSTAB.
* '''[effect]''' {{DevFeature1.13|6}} Applies the effect directly to the unit.
* Accepts generally the syntax inside of wml unit variables created by [store_unit] which can be viewed in a savefile or by using the [[CommandMode|inspect command]]. Cannot remove things or add/alter unit animations. Subtags with the same name must be written in the correct order to match them with the tag they are supposed to modify. Note that keys will be processed in arbitrary order, which may cause problems if you use formulas that depend on other formulas. To work around this you may need to use the tag twice with the same filter.
example usage (see also the test scenario):
<syntaxhighlight lang='wml'>
[modify_unit]
[filter]
x,y=38,6
[/filter]
hitpoints=10
{TRAIT_HEALTHY}
[/modify_unit]
</syntaxhighlight>

The unit which is currently modified is accessible via $this_unit, e.g. hitpoints = "$($this_unit.hitpoints / 2)" to set the hitpoints of all units to half of their particular maxima. This this_unit variable is independent from the this_unit variable available in the SUF used to determine which units to modify (first all matching units are gathered, and then all those are modified).

=== [transform_unit] ===
Transforms every unit on the map matching the filter to the given unit type. Keeps intact hit points, experience and status. If the unit is transformed to a non-living type (undead or mechanical), it will be also unpoisoned. Hit points will be changed if necessary to respect the transformed unit's maximum hit points.
* [[StandardUnitFilter]]: do not use a [filter] tag.
* '''transform_to''': the unit type in which all the units matching the filter will be transformed. If missing, the units will follow their normal advancement.

=== [petrify] ===

* [[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. Do not use a [filter] tag. All units matching this filter are unpetrified. Recall list units are included.

=== [object] ===
Gives some unit an object which modifies their stats in some way.
* '''id''': (Optional) allows the item to be removed later. By default, an object with a defined ID can only be picked up once per scenario, even if it is removed later or first_time_only=no is set for the event. You can remove this restriction by setting take_only_once=no. For filtering objects, it might be simpler to use a custom key such as item_id.
* '''take_only_once''': (default yes) {{DevFeature1.13|6}} If set to "no", the object's ID does not prevent it from being taken more than once.
* '''delayed_variable_substitution''' (boolean yes|no, default no): If set to "yes", the wml block contained in this [object] is not variable-substituted at execution time of the event where this [object] is within. You need this for any effect that uses variable substitution or when using [effect][filter] with a $this_unit. {{DevFeature1.13|9}} This is no longer needed when adding ABILITY_TELEPORT, ABILITY_LEADERSHIP or SPECIAL_BACKSTAB.
* '''[effect]''': one or more effect elements may be listed. See [[EffectWML]] for a description of [effect].
* '''duration''':
**if 'scenario', 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).
**if 'forever' or not set, effects never wear off.
** if 'turn', effects only last until the start of the unit's next turn (when the unit refreshes movement and attacks). (Like other start-of-turn behavior, objects with a duration of "turn" won't expire before turn 2.)
** {{DevFeature1.13|1}} if 'turn end' or 'turn_end', effects only last until the end of the unit's next turn (exactly like the slowed status).
* '''[filter]''' with a [[StandardUnitFilter]] as argument. The first unit found that matches the filter will be given the object. Only on-map units are considered. If no unit matches or no [filter] is supplied, it is tried to apply the object to the unit at the $x1,$y1 location of the event where this [object] is in. The case of no unit being at that spot is handled in the same way as no unit matching a given filter ([else] commands executed, cannot_use_message displayed)
* '''[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 '''[remove_item]''' tag, but you could probably put any tags that otherwise work in a [then] tag.
* '''[else]''': a subtag that lets you execute actions if the filter conditions are *not* met.
* '''silent''': whether or not messages should be suppressed. Default is "no". {{DevFeature1.13|2}} If no description is provided, this defaults to yes, but can still be overridden.
* '''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.

=== [remove_object] ===

{{DevFeature1.13|6}}

Removes an object from matching units.

* [[StandardUnitFilter]]: All units matching the filter have matching objects removed
* '''object_id''': The id of the object to be removed.

=== [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. This can be a comma-separated list of sides. note: Default side=1 for empty side= is deprecated.
* '''[filter_side]''' with a [[StandardSideFilter]] as argument
* [[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. This can be a comma-separated list. note: Default side=1 for empty side= is deprecated.
* '''[filter_side]''' with a [[StandardSideFilter]] as argument
* [[StandardLocationFilter]]: the range of tiles on which shroud should be placed

=== [lift_fog] ===
Lifts the fog of war from parts of the map for a certain side (only relevant for sides that have fog=yes), allowing a player to witness what occurs there even if that player has no units within vision range.
* '''[filter_side]''' with a [[StandardSideFilter]] indicating which sides should be affected.
* [[StandardLocationFilter]]: the tiles from which fog should be lifted.
* '''multiturn''': ''yes/no, default:no''. The default (not multiturn) causes fog to be removed in the same way that normal vision works; the cleared tiles will remain cleared until fog is recalculated (which normally happens when a side ends its turn). When multiturn is set to "yes", the cleared tiles remain clear until {{tag||reset_fog}} cancels the clearing. This allows tiles to remain clear for multiple turns, or to be refogged before the end of the current turn (without also refogging all tiles). Multiturn lifted fog is not shared with allies (even when share_view=yes).

=== [reset_fog] ===
The primary use of this tag is to remove multiturn lifted fog (created by {{tag||lift_fog}}), which causes the fog to reset to what it would have been had WML not interfered. (That is, hexes that a side's units could not see at any point this turn will be re-fogged, while seen hexes remain defogged.)
* '''[filter_side]''' with a [[StandardSideFilter]] indicating which sides should be affected.
* [[StandardLocationFilter]]: the fog reset will be restricted to these tiles.
* '''reset_view''': ''yes/no, default: no'' If set to "yes", then in addition to removing multiturn fog, the side's current view is canceled (independent of the SLF). This means that all hexes will become fogged for the side unless multiturn fog exists outside the tiles selected by the SLF. Normally, one would want the currently seen hexes to become clear of fog; this is done automatically at the end of many events, and it can be done manually with {{tag|InterfaceActionsWML|redraw}}.
Omitting both the SSF and the SLF would cancel all earlier uses of [lift_fog].
Additionally setting reset_view="yes" would cause the side's entire map to be fogged (unless an ally keeps hexes clear by sharing its view).

=== [allow_undo] ===
Normally when an event with a handler fires, the player's undo stack is cleared, preventing all actions performed so far from being undone. Including this tag in the event handler prevents the stack from being cleared for this reason, allowing the player to undo actions. (However, the stack might still be cleared for other reasons, such as fog being cleared or combat occurring.) In the common cases, this means '''[allow_undo]''' allows the current action to be undone even though an event was handled. There is a less common case, though — specifically when handling a menu item, where there is no current action — and in this case, '''[allow_undo]''' means merely that earlier actions can still be undone.
* Using this tag in a menu item has an additional side effect in 1.11. Starting with version 1.11.1, executing a WML menu item normally counts as doing something as far as the "you have not started your turn yet" dialog is concerned. However, a menu item whose handler includes '''[allow_undo]''' will not count.

The types of actions that can be undone are movement, recruitment, recalling, and dismissing a unit from the recall list. If an action is undone, only the position (or existence) of the involved unit will be restored; any altered variables or changes to the game will remain changed after the action 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 action the first time.

Due to a bug in 1.12 (https://gna.org/bugs/?23323) '''[allow_undo]''' should not be used in events that use one of the following things because it might cause OOS:
* [message] with [option]s
* [get_global_variable]
* wesnoth.synchronize_choice

While in 1.13 using '''[allow_undo]''' together with those things won't give you a guaranteed OOS, there are some non-obvious situations where it will, for example assume the following event:

[event]
name="moveto"
[message]
message = "message"
[option]
message = "option 1"
[command]
[/command]
[/option]
[option]
message = "option 2"
[command]
[/command]
[/option]
[/message]
[allow_undo]
[/allow_undo]
[/event]

It will cause OOS when the message is undone: since the event is already executed (erased) on one client only , the clients will disagree about how many choices happen during the next moveto action.

=== [on_undo] ===
{{DevFeature1.13|2}}
Contains commands to execute when the player undoes the action which triggered the parent event.
*'''delayed_variable_substitution''' {{DevFeature1.13|5}}: ''yes/no, default no (always no before 1.13.5)'' As in [[EventWML]], specifies whether to perform variable substitution when the parent event is run, or when the contents are run. If delayed substitution is used, [[SyntaxWML#Automatically_Stored_Variables|automatically stored variables]] from the parent event context are available, but may occasionally have unexpected values. (In particular, $unit.x and $unit.y may not have the expected value when undoing a move event, though $x1 and $y1 should be correct.)

Note:
It is not clear where whether the actionwml in [on_undo] in exceuted before or after the action is undone. Also, specially for enter/leave_hex events the units position when executing the [on_undo] code is usually different than when executing the original event. The reccomended way to wokr around these issues is to refer to the unit by is instead of position and store all other needed information variables as 'upvalues'. You can also move the actual undo code to an external event. For example
[event]
name="undo_blah"
first_time_only=no
[store_unit]
id="$moved_unit_id"
[/store_unit]
... do undo stuff stuff
[/event]

...
... in some other event
[on_undo]
# store ''upvalues
{VARIABLE moved_unit_id $unit.id}
# call actual undo handler
[fire_event]
name = "undo_blah"
[/fire_event]
[on_undo]

=== [on_redo] ===
{{DevFeature1.13|2}}
Same as [on_undo], except executes the commands on redo. Note that the parent event is not triggered again on a redo.

{{DevFeature1.13|8}} [on_redo] is deprecated and has no effect anymore.

Note that [on_redo] is not guaranteed to be called when redoing an action, the engine might also decide to just fire the original events again.

=== [cancel_action] ===
Although Wesnoth 1.12 does not have this tag, it is the default behavior of {{tag|EventWML|enter_hex}}/{{tag|EventWML|leave_hex}} events in that version.

{{DevFeature1.13|9}} In this version, [cancel_action] is recognised, but has no effect (a bug).

{{DevFeature1.13|11}}
In an {{tag|EventWML|enter_hex}}/{{tag|EventWML|leave_hex}} event, interrupt the movement, leaving the unit where it is. This is intended to be used with an event that gives the player new information, to let the player choose whether to change their plans. For example, if the player has commanded a unit to move from (1,1) to (3,3) and attack a unit on (4,4); then a [cancel_action] inside an [enter_hex] event on (2,2) would make the unit stop on (2,2). A [cancel_action] inside an [enter_hex] on (3,3) would let the player choose whether to attack.

=== [heal_unit] ===
Heal a unit. The variable '''$heal_amount''' will be set to the exact number of points healed (i.e can be less than the parameter '''amount''' if the unit is fully healed). $heal_amount contains only the number of hitpoints the first unit that was found got healed.
* '''[filter]''': [[StandardUnitFilter]] All matching on-map units are healed. If no filter is supplied, it is tried to take the unit at $x1, $y1.
* '''[filter_second]''': [[StandardUnitFilter]] all the units matching the filter ''and'' having the ''heals'' ability will have their animation played (if ''animate'' is set to yes) for each of the units healed.
* '''amount''': (integer, default full) the maximum points the unit(s) will be healed. Can't set below 1 or above max_hitpoints. If "full", sets hitpoints to max_hitpoints. Before 1.9 the default is 0.
* '''animate''': a boolean which indicate if the healing animations must be played. (default no)
* '''moves''': (integer, default 0) The maximum current movement points the units will be "healed". Can't set below 0 or above max_moves. If "full", sets moves to max_moves.
* '''restore_attacks''': (boolean, default no) Whether the units' attacks_left should be reset to their max_attacks (usually 1).
* '''restore_statuses''': (boolean, default yes) Whether standard statuses should be reset to "no". This affects poisoned, slowed, petrified and unhealable. Before 1.9 this is always "no".

=== [harm_unit] ===
Harms every unit matching the filter, for the specific damage amount.
* '''[filter]''': [[StandardUnitFilter]] all matching units will be harmed (required).
* '''[filter_second]''': [[StandardUnitFilter]] if present, the first matching unit will attack all the units matching the filter above.
* '''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 a 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. If yes, also the corresponding advance and post advance events are fired.
* '''animate''': (default no) if yes, scrolls to each unit before harming it and plays its defense (or attack, if it's the harmer) and death animations. Special values supported, other than the usual yes and no, are "attacker", that means only the harmer will be animated, and "defender", that means only the harmed units will be animated. If the supplied value is yes, attacker or defender also advancement animations are played.
* '''[primary_attack], [secondary_attack]''': these set the weapon against which the harmed units will defend, and that the harming unit will use to attack, respectively (notice this is the opposite of '''[filter]''' and '''[filter_second]''' above). This allows for playing specific defense and attack animations. Both tags are expected to contain a [[FilterWML#Filtering_Weapons|Standard Weapon Filter]].
* '''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.
* '''experience''': if yes, and there is a harmer, experience will be attributed like in regular combat.
* '''resistance_multiplier''': the harmed unit's resistance is multiplied by the supplied value; this means that a value lower than 1 increases it, and a value greater than 1 decreases it. Default value is 1, that means no modification.

=== [time_area] ===
How a day should progress in a given area. Everywhere not specified in a [time_area] tag is affected by the [time] tags in the [scenario] tag.
* [[StandardLocationFilter]]: the locations to affect. ''note: only for [event][time_area]s - at scenario toplevel [time_area] does not support [[StandardLocationFilter]], only location ranges''
* '''[time]''': one or more tags describing the new schedule, see [[TimeWML]].
* '''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.
* '''current_time''': The time slot number (starting with zero) active at the creation of the area.

''Example:'' (caves in parts of a map)
[time_area]
x=1-2,4-5
y=1-2,1-2
{UNDERGROUND}
[/time_area]

=== [remove_time_area] ===

{{DevFeature1.13|2}}

This is a syntactic shortcut for [time_area] remove=.
* '''id''': Comma-separated list of time area ids to remove.

=== [end_turn] ===
End the current side's turn. 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''': Content of a wesnoth map file. example:
map="{campaigns/Heir_To_The_Throne/maps/01_The_Elves_Besieged.map}"
* '''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.
Note: When a hex changes from a village terrain to a non-village terrain, and a team owned that village it loses that village. When a hex changes from a non-village terrain to a village terrain and there is a unit on that hex it does not automatically capture the village. The reason for not capturing villages it that there are too many choices to make; should a unit lose its movement points, should capture events be fired. It is easier to do this as wanted by the author in WML.

=== [replace_schedule] ===
Replace the time of day schedule of the entire scenario.
* [[TimeWML]]: the new schedule.
* '''current_time''': The time slot number (starting with zero) active at schedule replacement.

=== [tunnel] ===

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).

'''Behavior Change as of Wesnoth 1.13.6:''' Vision is now possible (and enabled by default) through tunnels and allied units on the exit hex do not block a tunnel by default any more. This is done in order for moves through tunnels to be consistent with other moves. The previous behavior can still be accomplished by using the new optional keys listed below.

* '''[filter]''': (required) [[StandardUnitFilter]] the units which can use the tunnel. Leave empty for "all units".
* '''[source]''': (required) [[StandardLocationFilter]] the source hex(es).
* '''[target]''': (required) [[StandardLocationFilter]] the target hex(es).
* '''id''': (optional) identifier for the tunnel, to allow removing.
* '''remove''': (boolean, default: no) If yes, removes all defined tunnels with the same ID (then only id= is necessary).
* '''bidirectional''': (boolean, default: yes) If yes, creates also a tunnel in the other direction.
* '''always_visible''': (boolean, default: no) If yes, the possible movement of enemies under fog can be seen.
* '''allow_vision''': (boolean, default: yes) {{DevFeature1.13|6}} If no, vision through a tunnel is not possible. Note that in that case the tunnel cannot be used if the tunnel exit is under shroud (which previously was ''always'' the case).
* '''pass_allied_units''': (boolean, default: yes) {{DevFeature1.13|6}} If no, allied (including own) units on the exit hex block a tunnel.

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

=== [do_command] ===

{{DevFeature1.13|0}}

Executes a command, specified using the same syntax as a [command] tag in [[ReplayWML]]. Not all [command]'s are valid: only these are accepted

* [attack]
* [move]
* [recruit]
* [recall]
* [disband]
* [fire_event]
* [lua_ai]

The tags corresponding to player actions generally use the same codepath as if a player had ordered it.

One purpose of this tag is to allow scripting of noninteractive scenarios -- without a tag like this, this might require elaborate mechanisms to coerce ais in order to test these code paths.

This command should always be replay safe.

=== [put_to_recall_list] ===

{{DevFeature1.13|0}}

Puts a unit to the recall list of its side.
* '''[[StandardUnitFilter]]''': the unit(s) to get put to the recall list.
* '''heal''': (default=no) Whether the unit should be refreshed, similar to the unit moving to the recall list at the end of a scenario.

== 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]]

Secrets of the Ancients Walkthrough

2016-11-14T06:16:28Z

Beetlenaut: /* S14 Entering the Northlands */

This is a walkthrough for ''Secrets of the Ancients'', a 21 scenario (18 playable, 3 dialogue only) add-on campaign by beetlenaut featuring the undead. The campaign is playable on both Wesnoth versions 1.12 and 1.13, and the campaign's discussion thread on the forums can be found [https://forums.wesnoth.org/viewtopic.php?f=8&t=40545 here.]

==General==

Although this campaign is listed as intermediate level, it is very challenging and closer in difficulty to the expert level mainline campaigns. Throughout the campaign you will get several loyal units, which are recalled for free in all future scenarios. It is highly recommended to keep them all alive, especially the saurian healer because later scenarios will be difficult or impossible without a healer.

===Units===

Over the course of the campaign you'll gain access to the following recruits:

*'''Bats''' are useful in most scenarios for village grabbing and distracting enemies. Their main asset is their cheap recruit cost and zero upkeep, so it is generally not worth it to level them.
*'''Walking corpses''' can be a lifesaver in difficult scenarios, being dirt cheap and able to zombify enemy units so the enemies will focus on killing their own corpses rather than killing your veterans. The downside is that corpses are not worth leveling since their maximum level is 1, so the experience they get from zombifying enemy units is wasted.
*'''Skeletons and skeleton archers''' will be your main units in the first half of the campaign. They have great resistances to blade, pierce, and cold damage, but are vulnerable to fire, impact and arcane. In this campaign, revenants (level 2 skeletons) can advance to death knights which have level 3 leadership, so getting one early on will be very useful.
*'''Ghouls''' can poison enemies but do very little damage, so they are generally not so useful because you will usually kill enemy units before the poison can take effect.
*'''Ghosts''' can either level into wraiths which have an arcane drain attack, or shadows which can do huge amounts of damage through backstab. Later in the campaign many enemies (such as giant spiders and trolls) do impact damage which will destroy skeletal undead, so wraiths/spectres are essential against them. Shadows/nightgaunts are useful for quickly taking out high priority targets such as mages, and their skirmishing ability can help break through deadlocks.
*'''Dark adepts''' are difficult to level because they are fragile and you can only recruit them later in the campaign, but it is very much worth the trouble. At first they can only advance to necromancers, but late in the campaign necromancers can be converted to liches, which can advance to the rather overpowered level 4 ancient lich.
*'''Chocobones''' are not worth using due to their extremely high cost and low HP. Revenants/death knights can do similar melee damage while being much more durable.

==Chapter One: Unlawful Research==

===S1 Slipping Away===
*Objectives: Move Ardonna to the signpost in the northeast.

You'll be attacked by tons of wolves and rats, and in order to survive you'll need to turn some enemies into walking corpses by finishing them with the undead bat or with another walking corpse. Use Ardonna and the regular bats to soften up the enemies so that your corpses can zombify them.

Try to also get Ardonna some kills, because you'll have a much easier time next scenario if you can get her to level 2 during that scenario.

===S2 Dark Business===
*Objectives: Kill all the guards, and occupy the guardhouse.

You don't get much starting gold, so you'll mainly be relying on recruiting walking corpses and creating corpses out of the enemy units. Maybe recall a soulless if you have one for the extra damage per hex, but recalling more than one unit may leave you with too few units to win with. You can stay back at first and let the guards get close to you, so that you get to strike first.

Focus on zombifying the bowmen first, since they are weak in melee and can kill your corpses without taking retaliation damage. It helps to get Ardonna to level 2 - if she got some kills in the previous scenario and you can get her to kill the enemy Lieutenant, she should be most of the way there.

Be very careful when moving to the guardhouse, because several spearmen (5 on hard!) will surround the guardhouse when you do. If Ardonna is level 2 she should easily make short work of the spearmen; otherwise she will need to be carefully protected because the spearmen will tend to focus on her. Moving a unit to the guardhouse will allow Ardonna to use the graves to recruit skeletons and skeleton archers, both of which are highly effective against spearmen with their 60% pierce resistance, so it is a good idea to save up 14-15 gold to recruit one.

===S3 Bandits===
*Objectives: Defeat the enemy leader.

This scenario can be challenging, because the thugs and footpads do impact damage, which your bats and skeletons are weak to. The key is to recruit/recall several bats and send them up the eastern side of the map to village grab, which will not only generate a high income to recruit reinforcements with, but also split up the bandits' forces since many of them will go northeast to get rid of the bats.

Meanwhile your main force (consisting mostly of skeleton archers to kill thugs, and skeletons to kill footpads/poachers) can hold off the bandits in the forests northeast of the keep. If possible, try to make it so the bandits have to attack you from flat terrain. There will be heavy losses, so it's a good idea to have Ardonna stay near the keep for the first ten or so turns, and pump out reinforcements until you have the clear advantage.

===S4 Becalmed===
*Objectives: Defeat the enemy leader.

This is a relatively easy scenario. The enemies all do blade damage so your skeletal undead units with their 40% blade resistance will easily destroy them. Remember to also pay attention to the lower deck, because the enemies can use the trapdoors too.

===S5 Blackwater===
*Objectives: Kill all enemy units.

This scenario is very difficult due to the lack of healing, so try to manage your experience so that your units heal by leveling up. Start by sending some bats around the edges of the map to grab villages and distract enemy units. After that, skeletal undead should be your main recruits, since they resist pierce and blade damage - anything else (corpses, bats, ghouls) is likely to just get killed in one shot by charging horsemen. However skeletal undead are very vulnerable to mages, so killing mages should be always be your top priority.

It's tempting to just block the bridge chokepoints, but sometimes you may want to deliberately let the enemies flood onto the ship so that you'll have more hexes to attack them from. Use Rudic's level 2 leadership on your lower level units for the extra damage, or even better, level a revenant into a death knight for level 3 leadership.

Try to end the battle as quickly as possible, because without villages you will lose in a war of attrition. If you push hard during the nights (and your bats are doing a good job luring enemies to the edges of the map), you can break through the main loyalist force in the center and attack the loyalist castle as early as the third day (around turn 14).

===S6 Following the Shadow===
*Objectives: Move Ardonna to the tunnel in the southeast of the cave.

There are two main battles in this scenario: you'll first fight the wolves outside the cave, and then after entering the cave you'll have to fight your way through a horde of bats. You'll probably need to spend all your gold at the beginning; you'll want a good mix of veterans (a death knight if you have one is very helpful for leadership) for damage dealing, and expendable fresh recruits to hopefully keep the wolves distracted. Walking corpses are a good choice, being cheap and able to zombify wolves.

Send bats to the corners of the map to village grab. The rest of your units can occupy the hilly terrain to the northeast and wait for the wolves to arrive. The main threats are the goblin pillagers, which are deadly in melee with their fire attack, so it is safest to attack them in ranged with Ardonna or bone shooters. You could also poison them with ghouls, which have +10% fire resistance. Killing the wolf leader is not mandatory, but it is very helpful to do so, because you will then be able to safely focus on the cave enemies without wolves harassing you, and Ardonna can also use the wolf's keep to recruit reinforcements since you'll likely take heavy losses from the wolves. The turn limit in this scenario is a little tight, especially if you go to kill the wolf leader, so you can't afford to waste too much time healing. (If you kill the wolf leader before turn 25, you should be fine.)

After Ardonna has spent 2 turns in the cave (or, when six nonbat units enter the cave), a large amount of vampire bats, blood bats and dread bats will appear in the cave. The bats should not be a problem for your skeletal undead, which resist blade and cannot be drained.

===S7 Meeting of the Minds===
Story.

==Chapter Two: Two Missions==

===S8 Carcyn===
*Objectives: Own every village on the map, or kill every enemy unit.

You will control Ras-Tabahn for the next three scenarios. He has a separate recall list (which will be added to Ardonna's recall list when the two join together in Chapter 3) and starts this scenario with a predefined amount of gold. This is a tough scenario due to the sheer number of enemy units, especially on Hard. Since the enemy only recruits spearmen, bowmen and cavalrymen, you'll want to recruit almost exclusively skeletons and skeleton archers for their high resistance vs. blade and pierce. It is also very helpful to get a corpse or two so you can zombify enemies as a distraction. Ghosts are expensive and do very little damage, so they're not very useful here, though you could get one to village grab in the north and try distracting the enemy cavalrymen in the beginning. It's also a good idea to recall the shadow and the half-leveled skeleton, and focus on feeding kills to the skeleton so it can level up quickly.

During the first afternoon and dusk, you can just passively hang around the initial keep, keeping your units on good terrain like the forests and village around the keep, and wait for the loyalists to come to you. During the night be as aggressive as possible - try to make it so that every single one of your units attacks something, and as always try to manage your experience so that some of your units heal by leveling up. By the time the second day arrives, most of the loyalist army should be gone and you should have several level 2's, so after that the battle will only go one way.

It's probably easier and faster to just kill every enemy unit. When you move to the jailhouse in the west, two loyal level 0 units will join you (if you don't find them during the scenario, they join after you win the scenario). It is strongly recommended to level both of them into dark adepts, so that later in the campaign they may become level 4 ancient liches.

===S9 Training Session===
*Objectives: Destroy all 3 waves of undead.

All three undead waves consist of a mix of walking corpses and soulless, or just soulless on Hard. The first wave of undead which arrives during the day is a good opportunity to try to get some experience for your two new level 0 units. For recruits, bone shooters are nice since they can kill soulless without taking retaliation, and ghosts with their 50% impact resistance are pretty good at blocking the soulless from your more fragile units. You'll probably end up losing most of your recruits though, because skeletal undead are weak to impact and ghosts have such low HP. Try to keep most of the dark adepts alive (use them from the back, and then put your undead units in front to shield them) because unlike the undead, adepts will turn into walking corpses when killed with plague.

===S10 Merfolk Revenge===
*Objectives: Defeat the enemy leader.
*Note: Moving to the bones at 32,12 will cause a chocobone to appear and allow you to recruit chocobones.

The gold carryover from this scenario will carry over to S14 (Entering the Northlands), so make sure you get at least some carryover here or you may end up having to replay several scenarios to fix it. The dialogue recommends at least 50 carryover gold, though it is possible to make do with less even on hard.

The merfolk army consists of fighters and hunters which do pierce damage, and netcasters and initiates which do impact damage. Focus on killing the netcasters and initiates first, because they are the most dangerous units against your skeletal undead. Ghosts are very useful in this scenario because they resist both types of damage.

Try to lure the mermen onto land during dusk so that you can make quick work of them during the night. During the day, just retreat into the villages and heal your units so you can strike again at night. The mermen can be reluctant to come onto land so you may have to use some units as bait to lure them out - skeletons are good at luring out the ranged mermen units and dark adepts are good at luring out melee units. The merman leader will also sometimes come out to attack a unit on the southeast sand village (at 29,11), so if you can trap and kill him there it will save you the trouble of having to wade through water to reach his keep.

===S11 Battleground===
*Objectives: Defeat both enemy leaders.

You now switch back to controlling Ardonna. This is an easy scenario, because the saurians recruit only augurs and soothsayers, whose cold damage is laughably ineffective against your skeletal undead's 60% cold resistance. Skeletal undead are also great versus the nagas which do blade damage.

Your enemies have good defense in swamp and water terrain, so if possible try to avoid putting your units next to these terrains and let the enemies come onto land where they are easily killed. A good place to put your units is in the middle of the patch of flat terrain directly northeast of your keep. The nagas have pretty high HP so it can be very effective to recruit a couple ghouls and use them as bait for the nagas - by the time the ghouls are killed almost the entire naga army will be poisoned.

===S12 Walking Trees===
*Objectives: Move Ardonna to the northeast corner of the map.

You will be fighting woses, which can be drained and have a glaring weakness to arcane damage, making this the perfect chance to level some ghosts. Recall any wraiths or experienced ghosts, and you may also want a death knight for leadership, and then just start mass recruiting ghosts. It is very difficult to get any gold carryover from this scenario, so you may want to just forget about carryover and spend all your gold at the beginning.

Every few turns a bunch of woses will spawn somewhere in the forest. They are invisible in the forest due to their ambush ability, but when a wose moves from its starting location it leaves behind a patch of dirt so you should have a rough idea of which direction it will come from. Pay special attention to your loyal saurian healer, because he can be killed by a single wose attack - try to always keep him protected by ghosts on all sides. In the later half of the scenario, level 2 elder woses will spawn instead of level 1 woses, so hopefully by that time Ardonna is already very close to the northeast corner. Since you probably won't get any gold carryover anyway, you could potentially stay for a couple extra turns killing elder woses for experience.

===S13 Together Again===
Story.

==Chapter Three: To Conquer Death==
===S14 Entering the Northlands===
*Objectives: Defeat both enemy leaders.

There is a lot of experience available in this scenario from the high level orcs. Some good units to focus on leveling are spectres and necromancers, because these units will be the most helpful in later scenarios. Try not to go too negative on gold because you will probably need about 150 gold carryover (100 at the very least) to manage the next scenario on Hard. A couple vampire bats are very helpful for grabbing out of the way villages.

Since the eastern leader is fairly close to you, you should be able to take him out relatively quickly if you send your entire army that way. You can then turn your army northwest to deal with the rest of the orcs, which should arrive around the time you get rid of the eastern orc. Be careful of the orcish archers and crossbowmen, because your ghosts are very vulnerable to their fire arrows. The orcs will do extremely high damage, especially at night, so it really helps to have some expendable cannon fodder units as distractions. When they die, use plague to make more—it might even be worth recalling one or two soulless here.

===S15 Mountain Pass===
*Objectives: Move Ardryn-Na and Ras-Tabahn to the flat terrain in the northeast corner.
*Note: If you did not already find the bones in Scenario 10, moving to the bones at 16,21 will cause a chocobone to appear and allow you to recruit chocobones.

This scenario is extremely hard - you'll be attacked from all directions by gryphons, which have good defense everywhere and are extremely mobile. There are two gryphon leaders, one in the northwest and one in the northeast. The best way to kill gryphons is to zap them with the necromancers' magical attack, but using skeleton archer types can work as well. Ghosts and their advancements are extremely useful due to their mobility, especially spectres/wraiths because their drain attack makes them harder to kill.

If you're low on starting gold or are getting overwhelmed by gryphons, one way to make this scenario much more manageable is to assassinate the northwest gryphon leader using leveled ghosts. Recall all your wraiths, shadows etc., and send them straight northwest. They should reach the enemy gryphon keep during the night, and kill the leader fairly easily especially if you have shadows or nightgaunts. The downside of this tactic is that you will likely lose several of your leveled ghosts in the process.

===S16 The Mage===
*Objectives: Defeat Crelanu.
*Note: Moving a unit onto a bottle of holy water will remove the bottle. A living unit can do this safely, but any undead unit will be destroyed.

This is an easy scenario. Send a couple bats along the edges of the map to village grab, and just have Ras Tabahn move to the village near your keep and stay there for the scenario. You'll be facing high level mages, but only a few at a time. If you wait until night to engage, you'll easily demolish them with skeletons backed by leadership. Necromancers are also very effective here, since they have high HP, no fire weakness, and resistance to arcane. Don't bother with ghostly units because they will just get fried by mages. The mages absolutely love attacking walking corpses, so if you use walking corpses or your necromancers' plague staff to zombify some enemies, your other units probably won't even be attacked.

===S17 Mortality===
Story.

===S18 Abandoned Outpost===
*Objectives: Reach the end of the western tunnel with both Ardryn-Na and Ras-Tabahn, or defeat every enemy unit.

This is a very tough scenario - you'll have to fight your way through two hordes of level 3 giant spiders, in a relatively short amount of turns. By far the best units to use here are spectres, and liches are also useful. You'll also want a bat or two to grab villages near the starting area.

The key to getting rid of the spiders quickly is to get them onto flat terrain, where they only have 30% defense and are easy prey for spectres. A good place to form your line is on the village in the southern tunnel (at 30,12) and the three cave hexes to the right of the village, so that the spiders will attack from the nearby 3 hexes of flat terrain. The spiders tend to be reluctant to attack spectres and liches, so you may want to use bait such as skeletons to lure them onto the flat terrain.

Once you get rid of the first wave of spiders, hopefully you still have about half of the turns remaining, because there is a second horde of spiders in the west blocking the exit. It's actually possible to sneak past them without fighting - send Ardryn-Na, Ras-Tabahn and a spectre or two through the northern 1-hex tunnel (the spiders will probably just ignore them), and then use some bait in the east to lure the spider blocking the tunnel exit away. Then your two leaders can head toward the exit tunnel behind the spiders, while the spectres position themselves so the spiders can't block your leaders from escaping into the exit tunnel next turn.

===S19 Lava and Stone===
*Objectives: Defeat all enemy leaders.

You'll be fighting trolls which are weak to arcane, so wraiths/spectres and liches are the best units to use here. Both units are vulnerable to the troll shamans' fire damage though, so try to kill the shamans quickly using spectres or backstab with shadows/nightgaunts. When you reach the lava chasm in the beginning, the path will branch west, where the main battle will take place, and southeast. The southeastern path leads to a small lake, so you can send a couple spectres/wraiths there to easily pick off trolls in the water.

There are 3 troll leaders in total: a troll shaman leader in the northwest, a great troll in the center, and another troll shaman leader in the southeast corner. This scenario is a good opportunity to try to level some ancient liches, which will be extremely useful next scenario. Finish early, because you get almost no starting gold next scenario, so you will need a pretty high gold carryover (about 150 gold or more).

===S20 North Knalga===
*Objectives: Defeat the enemy leader.

You will be fighting an army of high level dwarves, which have good resistances and extremely high HP. Hopefully you have several ancient liches, because they are basically the only way to kill the level 3 dwarvish lords. Spectres are also very useful since they can help shield your liches. The biggest threats to your units are the lords and runemasters which have a high damage melee impact attack, so focus on killing those first using your ancient liches. Try to put your liches on hills where they have 50% terrain defense - one place to form your line is the small clump of rubble and hills in the center (around 15,7).

When you get near the enemy keep in the southeast, the dwarf leader will recruit some reinforcements. Try the finish as fast as you can, because the early finish bonus in this scenario is huge.

===S21 Against the World===
*Objectives: Defeat all enemy leaders.
*Notes:
**On turn 2, a saurian leader will appear in the eastern swamp castle.
**On turn 4 (turn 3 on easy), a dwarf leader will appear in the southwest mountains.
**On turn 12, a mage leader will appear in the northwest.
**On turn 13, an elf leader will appear in the southeastern forest.

This is the final scenario, so just recall all your best veterans, and recruit some cannon fodder (skeletons are a good choice, since many of the starting enemies do blade/pierce damage) with any remaining gold. Since there's no turn limit, patience and playing defensively will guarantee you eventual victory. Attack all out during the night, then retreat and heal during the day, and eventually the enemy armies will start to thin out. Don't try to block the enemy leaders' keeps before they arrive, because this will just cause them to appear with a full keep of units already recruited. Parking some units just outside the keep to assassinate the leader will have the same effect.

In the beginning you'll just want to hang around the starting keep, and let the knights and nagas come to you so you can wipe them out during the first night. After that you can split your army in half, with one group remaining north of the river to clear out the saurians and later the mermen, and another group heading south of the river to deal with the dwarves and kill the southern knight leader. The mages and elves which arrive last are extremely easy to kill if you meet them on flat terrain during the night. It's best to save the dwarf leader for last, because his keep is surrounded by rough terrain which will take a long time to cross.

[[Category: User-made Campaigns - Walkthroughs]]

Secrets of the Ancients Walkthrough

2016-11-14T06:12:15Z

Beetlenaut: /* S2 Dark Business */

This is a walkthrough for ''Secrets of the Ancients'', a 21 scenario (18 playable, 3 dialogue only) add-on campaign by beetlenaut featuring the undead. The campaign is playable on both Wesnoth versions 1.12 and 1.13, and the campaign's discussion thread on the forums can be found [https://forums.wesnoth.org/viewtopic.php?f=8&t=40545 here.]

==General==

Although this campaign is listed as intermediate level, it is very challenging and closer in difficulty to the expert level mainline campaigns. Throughout the campaign you will get several loyal units, which are recalled for free in all future scenarios. It is highly recommended to keep them all alive, especially the saurian healer because later scenarios will be difficult or impossible without a healer.

===Units===

Over the course of the campaign you'll gain access to the following recruits:

*'''Bats''' are useful in most scenarios for village grabbing and distracting enemies. Their main asset is their cheap recruit cost and zero upkeep, so it is generally not worth it to level them.
*'''Walking corpses''' can be a lifesaver in difficult scenarios, being dirt cheap and able to zombify enemy units so the enemies will focus on killing their own corpses rather than killing your veterans. The downside is that corpses are not worth leveling since their maximum level is 1, so the experience they get from zombifying enemy units is wasted.
*'''Skeletons and skeleton archers''' will be your main units in the first half of the campaign. They have great resistances to blade, pierce, and cold damage, but are vulnerable to fire, impact and arcane. In this campaign, revenants (level 2 skeletons) can advance to death knights which have level 3 leadership, so getting one early on will be very useful.
*'''Ghouls''' can poison enemies but do very little damage, so they are generally not so useful because you will usually kill enemy units before the poison can take effect.
*'''Ghosts''' can either level into wraiths which have an arcane drain attack, or shadows which can do huge amounts of damage through backstab. Later in the campaign many enemies (such as giant spiders and trolls) do impact damage which will destroy skeletal undead, so wraiths/spectres are essential against them. Shadows/nightgaunts are useful for quickly taking out high priority targets such as mages, and their skirmishing ability can help break through deadlocks.
*'''Dark adepts''' are difficult to level because they are fragile and you can only recruit them later in the campaign, but it is very much worth the trouble. At first they can only advance to necromancers, but late in the campaign necromancers can be converted to liches, which can advance to the rather overpowered level 4 ancient lich.
*'''Chocobones''' are not worth using due to their extremely high cost and low HP. Revenants/death knights can do similar melee damage while being much more durable.

==Chapter One: Unlawful Research==

===S1 Slipping Away===
*Objectives: Move Ardonna to the signpost in the northeast.

You'll be attacked by tons of wolves and rats, and in order to survive you'll need to turn some enemies into walking corpses by finishing them with the undead bat or with another walking corpse. Use Ardonna and the regular bats to soften up the enemies so that your corpses can zombify them.

Try to also get Ardonna some kills, because you'll have a much easier time next scenario if you can get her to level 2 during that scenario.

===S2 Dark Business===
*Objectives: Kill all the guards, and occupy the guardhouse.

You don't get much starting gold, so you'll mainly be relying on recruiting walking corpses and creating corpses out of the enemy units. Maybe recall a soulless if you have one for the extra damage per hex, but recalling more than one unit may leave you with too few units to win with. You can stay back at first and let the guards get close to you, so that you get to strike first.

Focus on zombifying the bowmen first, since they are weak in melee and can kill your corpses without taking retaliation damage. It helps to get Ardonna to level 2 - if she got some kills in the previous scenario and you can get her to kill the enemy Lieutenant, she should be most of the way there.

Be very careful when moving to the guardhouse, because several spearmen (5 on hard!) will surround the guardhouse when you do. If Ardonna is level 2 she should easily make short work of the spearmen; otherwise she will need to be carefully protected because the spearmen will tend to focus on her. Moving a unit to the guardhouse will allow Ardonna to use the graves to recruit skeletons and skeleton archers, both of which are highly effective against spearmen with their 60% pierce resistance, so it is a good idea to save up 14-15 gold to recruit one.

===S3 Bandits===
*Objectives: Defeat the enemy leader.

This scenario can be challenging, because the thugs and footpads do impact damage, which your bats and skeletons are weak to. The key is to recruit/recall several bats and send them up the eastern side of the map to village grab, which will not only generate a high income to recruit reinforcements with, but also split up the bandits' forces since many of them will go northeast to get rid of the bats.

Meanwhile your main force (consisting mostly of skeleton archers to kill thugs, and skeletons to kill footpads/poachers) can hold off the bandits in the forests northeast of the keep. If possible, try to make it so the bandits have to attack you from flat terrain. There will be heavy losses, so it's a good idea to have Ardonna stay near the keep for the first ten or so turns, and pump out reinforcements until you have the clear advantage.

===S4 Becalmed===
*Objectives: Defeat the enemy leader.

This is a relatively easy scenario. The enemies all do blade damage so your skeletal undead units with their 40% blade resistance will easily destroy them. Remember to also pay attention to the lower deck, because the enemies can use the trapdoors too.

===S5 Blackwater===
*Objectives: Kill all enemy units.

This scenario is very difficult due to the lack of healing, so try to manage your experience so that your units heal by leveling up. Start by sending some bats around the edges of the map to grab villages and distract enemy units. After that, skeletal undead should be your main recruits, since they resist pierce and blade damage - anything else (corpses, bats, ghouls) is likely to just get killed in one shot by charging horsemen. However skeletal undead are very vulnerable to mages, so killing mages should be always be your top priority.

It's tempting to just block the bridge chokepoints, but sometimes you may want to deliberately let the enemies flood onto the ship so that you'll have more hexes to attack them from. Use Rudic's level 2 leadership on your lower level units for the extra damage, or even better, level a revenant into a death knight for level 3 leadership.

Try to end the battle as quickly as possible, because without villages you will lose in a war of attrition. If you push hard during the nights (and your bats are doing a good job luring enemies to the edges of the map), you can break through the main loyalist force in the center and attack the loyalist castle as early as the third day (around turn 14).

===S6 Following the Shadow===
*Objectives: Move Ardonna to the tunnel in the southeast of the cave.

There are two main battles in this scenario: you'll first fight the wolves outside the cave, and then after entering the cave you'll have to fight your way through a horde of bats. You'll probably need to spend all your gold at the beginning; you'll want a good mix of veterans (a death knight if you have one is very helpful for leadership) for damage dealing, and expendable fresh recruits to hopefully keep the wolves distracted. Walking corpses are a good choice, being cheap and able to zombify wolves.

Send bats to the corners of the map to village grab. The rest of your units can occupy the hilly terrain to the northeast and wait for the wolves to arrive. The main threats are the goblin pillagers, which are deadly in melee with their fire attack, so it is safest to attack them in ranged with Ardonna or bone shooters. You could also poison them with ghouls, which have +10% fire resistance. Killing the wolf leader is not mandatory, but it is very helpful to do so, because you will then be able to safely focus on the cave enemies without wolves harassing you, and Ardonna can also use the wolf's keep to recruit reinforcements since you'll likely take heavy losses from the wolves. The turn limit in this scenario is a little tight, especially if you go to kill the wolf leader, so you can't afford to waste too much time healing. (If you kill the wolf leader before turn 25, you should be fine.)

After Ardonna has spent 2 turns in the cave (or, when six nonbat units enter the cave), a large amount of vampire bats, blood bats and dread bats will appear in the cave. The bats should not be a problem for your skeletal undead, which resist blade and cannot be drained.

===S7 Meeting of the Minds===
Story.

==Chapter Two: Two Missions==

===S8 Carcyn===
*Objectives: Own every village on the map, or kill every enemy unit.

You will control Ras-Tabahn for the next three scenarios. He has a separate recall list (which will be added to Ardonna's recall list when the two join together in Chapter 3) and starts this scenario with a predefined amount of gold. This is a tough scenario due to the sheer number of enemy units, especially on Hard. Since the enemy only recruits spearmen, bowmen and cavalrymen, you'll want to recruit almost exclusively skeletons and skeleton archers for their high resistance vs. blade and pierce. It is also very helpful to get a corpse or two so you can zombify enemies as a distraction. Ghosts are expensive and do very little damage, so they're not very useful here, though you could get one to village grab in the north and try distracting the enemy cavalrymen in the beginning. It's also a good idea to recall the shadow and the half-leveled skeleton, and focus on feeding kills to the skeleton so it can level up quickly.

During the first afternoon and dusk, you can just passively hang around the initial keep, keeping your units on good terrain like the forests and village around the keep, and wait for the loyalists to come to you. During the night be as aggressive as possible - try to make it so that every single one of your units attacks something, and as always try to manage your experience so that some of your units heal by leveling up. By the time the second day arrives, most of the loyalist army should be gone and you should have several level 2's, so after that the battle will only go one way.

It's probably easier and faster to just kill every enemy unit. When you move to the jailhouse in the west, two loyal level 0 units will join you (if you don't find them during the scenario, they join after you win the scenario). It is strongly recommended to level both of them into dark adepts, so that later in the campaign they may become level 4 ancient liches.

===S9 Training Session===
*Objectives: Destroy all 3 waves of undead.

All three undead waves consist of a mix of walking corpses and soulless, or just soulless on Hard. The first wave of undead which arrives during the day is a good opportunity to try to get some experience for your two new level 0 units. For recruits, bone shooters are nice since they can kill soulless without taking retaliation, and ghosts with their 50% impact resistance are pretty good at blocking the soulless from your more fragile units. You'll probably end up losing most of your recruits though, because skeletal undead are weak to impact and ghosts have such low HP. Try to keep most of the dark adepts alive (use them from the back, and then put your undead units in front to shield them) because unlike the undead, adepts will turn into walking corpses when killed with plague.

===S10 Merfolk Revenge===
*Objectives: Defeat the enemy leader.
*Note: Moving to the bones at 32,12 will cause a chocobone to appear and allow you to recruit chocobones.

The gold carryover from this scenario will carry over to S14 (Entering the Northlands), so make sure you get at least some carryover here or you may end up having to replay several scenarios to fix it. The dialogue recommends at least 50 carryover gold, though it is possible to make do with less even on hard.

The merfolk army consists of fighters and hunters which do pierce damage, and netcasters and initiates which do impact damage. Focus on killing the netcasters and initiates first, because they are the most dangerous units against your skeletal undead. Ghosts are very useful in this scenario because they resist both types of damage.

Try to lure the mermen onto land during dusk so that you can make quick work of them during the night. During the day, just retreat into the villages and heal your units so you can strike again at night. The mermen can be reluctant to come onto land so you may have to use some units as bait to lure them out - skeletons are good at luring out the ranged mermen units and dark adepts are good at luring out melee units. The merman leader will also sometimes come out to attack a unit on the southeast sand village (at 29,11), so if you can trap and kill him there it will save you the trouble of having to wade through water to reach his keep.

===S11 Battleground===
*Objectives: Defeat both enemy leaders.

You now switch back to controlling Ardonna. This is an easy scenario, because the saurians recruit only augurs and soothsayers, whose cold damage is laughably ineffective against your skeletal undead's 60% cold resistance. Skeletal undead are also great versus the nagas which do blade damage.

Your enemies have good defense in swamp and water terrain, so if possible try to avoid putting your units next to these terrains and let the enemies come onto land where they are easily killed. A good place to put your units is in the middle of the patch of flat terrain directly northeast of your keep. The nagas have pretty high HP so it can be very effective to recruit a couple ghouls and use them as bait for the nagas - by the time the ghouls are killed almost the entire naga army will be poisoned.

===S12 Walking Trees===
*Objectives: Move Ardonna to the northeast corner of the map.

You will be fighting woses, which can be drained and have a glaring weakness to arcane damage, making this the perfect chance to level some ghosts. Recall any wraiths or experienced ghosts, and you may also want a death knight for leadership, and then just start mass recruiting ghosts. It is very difficult to get any gold carryover from this scenario, so you may want to just forget about carryover and spend all your gold at the beginning.

Every few turns a bunch of woses will spawn somewhere in the forest. They are invisible in the forest due to their ambush ability, but when a wose moves from its starting location it leaves behind a patch of dirt so you should have a rough idea of which direction it will come from. Pay special attention to your loyal saurian healer, because he can be killed by a single wose attack - try to always keep him protected by ghosts on all sides. In the later half of the scenario, level 2 elder woses will spawn instead of level 1 woses, so hopefully by that time Ardonna is already very close to the northeast corner. Since you probably won't get any gold carryover anyway, you could potentially stay for a couple extra turns killing elder woses for experience.

===S13 Together Again===
Story.

==Chapter Three: To Conquer Death==
===S14 Entering the Northlands===
*Objectives: Defeat both enemy leaders.

There is a lot of experience available in this scenario from the high level orcs. Some good units to focus on leveling are spectres and necromancers, because these units will be the most helpful in later scenarios. Try not to go too negative on gold because you will probably need about 150 gold carryover (100 at the very least) to manage the next scenario on Hard. A couple vampire bats are very helpful for grabbing out of the way villages.

Since the eastern leader is fairly close to you, you should be able to take him out relatively quickly if you send your entire army that way. You can then turn your army northwest to deal with the rest of the orcs, which should arrive around the time you get rid of the eastern orc. Be careful of the orcish archers and crossbowmen, because your ghosts are very vulnerable to their fire arrows. The orcs will do extremely high damage especially at night, so it really helps to have some expendable cannon fodder units as distractions.

===S15 Mountain Pass===
*Objectives: Move Ardryn-Na and Ras-Tabahn to the flat terrain in the northeast corner.
*Note: If you did not already find the bones in Scenario 10, moving to the bones at 16,21 will cause a chocobone to appear and allow you to recruit chocobones.

This scenario is extremely hard - you'll be attacked from all directions by gryphons, which have good defense everywhere and are extremely mobile. There are two gryphon leaders, one in the northwest and one in the northeast. The best way to kill gryphons is to zap them with the necromancers' magical attack, but using skeleton archer types can work as well. Ghosts and their advancements are extremely useful due to their mobility, especially spectres/wraiths because their drain attack makes them harder to kill.

If you're low on starting gold or are getting overwhelmed by gryphons, one way to make this scenario much more manageable is to assassinate the northwest gryphon leader using leveled ghosts. Recall all your wraiths, shadows etc., and send them straight northwest. They should reach the enemy gryphon keep during the night, and kill the leader fairly easily especially if you have shadows or nightgaunts. The downside of this tactic is that you will likely lose several of your leveled ghosts in the process.

===S16 The Mage===
*Objectives: Defeat Crelanu.
*Note: Moving a unit onto a bottle of holy water will remove the bottle. A living unit can do this safely, but any undead unit will be destroyed.

This is an easy scenario. Send a couple bats along the edges of the map to village grab, and just have Ras Tabahn move to the village near your keep and stay there for the scenario. You'll be facing high level mages, but only a few at a time. If you wait until night to engage, you'll easily demolish them with skeletons backed by leadership. Necromancers are also very effective here, since they have high HP, no fire weakness, and resistance to arcane. Don't bother with ghostly units because they will just get fried by mages. The mages absolutely love attacking walking corpses, so if you use walking corpses or your necromancers' plague staff to zombify some enemies, your other units probably won't even be attacked.

===S17 Mortality===
Story.

===S18 Abandoned Outpost===
*Objectives: Reach the end of the western tunnel with both Ardryn-Na and Ras-Tabahn, or defeat every enemy unit.

This is a very tough scenario - you'll have to fight your way through two hordes of level 3 giant spiders, in a relatively short amount of turns. By far the best units to use here are spectres, and liches are also useful. You'll also want a bat or two to grab villages near the starting area.

The key to getting rid of the spiders quickly is to get them onto flat terrain, where they only have 30% defense and are easy prey for spectres. A good place to form your line is on the village in the southern tunnel (at 30,12) and the three cave hexes to the right of the village, so that the spiders will attack from the nearby 3 hexes of flat terrain. The spiders tend to be reluctant to attack spectres and liches, so you may want to use bait such as skeletons to lure them onto the flat terrain.

Once you get rid of the first wave of spiders, hopefully you still have about half of the turns remaining, because there is a second horde of spiders in the west blocking the exit. It's actually possible to sneak past them without fighting - send Ardryn-Na, Ras-Tabahn and a spectre or two through the northern 1-hex tunnel (the spiders will probably just ignore them), and then use some bait in the east to lure the spider blocking the tunnel exit away. Then your two leaders can head toward the exit tunnel behind the spiders, while the spectres position themselves so the spiders can't block your leaders from escaping into the exit tunnel next turn.

===S19 Lava and Stone===
*Objectives: Defeat all enemy leaders.

You'll be fighting trolls which are weak to arcane, so wraiths/spectres and liches are the best units to use here. Both units are vulnerable to the troll shamans' fire damage though, so try to kill the shamans quickly using spectres or backstab with shadows/nightgaunts. When you reach the lava chasm in the beginning, the path will branch west, where the main battle will take place, and southeast. The southeastern path leads to a small lake, so you can send a couple spectres/wraiths there to easily pick off trolls in the water.

There are 3 troll leaders in total: a troll shaman leader in the northwest, a great troll in the center, and another troll shaman leader in the southeast corner. This scenario is a good opportunity to try to level some ancient liches, which will be extremely useful next scenario. Finish early, because you get almost no starting gold next scenario, so you will need a pretty high gold carryover (about 150 gold or more).

===S20 North Knalga===
*Objectives: Defeat the enemy leader.

You will be fighting an army of high level dwarves, which have good resistances and extremely high HP. Hopefully you have several ancient liches, because they are basically the only way to kill the level 3 dwarvish lords. Spectres are also very useful since they can help shield your liches. The biggest threats to your units are the lords and runemasters which have a high damage melee impact attack, so focus on killing those first using your ancient liches. Try to put your liches on hills where they have 50% terrain defense - one place to form your line is the small clump of rubble and hills in the center (around 15,7).

When you get near the enemy keep in the southeast, the dwarf leader will recruit some reinforcements. Try the finish as fast as you can, because the early finish bonus in this scenario is huge.

===S21 Against the World===
*Objectives: Defeat all enemy leaders.
*Notes:
**On turn 2, a saurian leader will appear in the eastern swamp castle.
**On turn 4 (turn 3 on easy), a dwarf leader will appear in the southwest mountains.
**On turn 12, a mage leader will appear in the northwest.
**On turn 13, an elf leader will appear in the southeastern forest.

This is the final scenario, so just recall all your best veterans, and recruit some cannon fodder (skeletons are a good choice, since many of the starting enemies do blade/pierce damage) with any remaining gold. Since there's no turn limit, patience and playing defensively will guarantee you eventual victory. Attack all out during the night, then retreat and heal during the day, and eventually the enemy armies will start to thin out. Don't try to block the enemy leaders' keeps before they arrive, because this will just cause them to appear with a full keep of units already recruited. Parking some units just outside the keep to assassinate the leader will have the same effect.

In the beginning you'll just want to hang around the starting keep, and let the knights and nagas come to you so you can wipe them out during the first night. After that you can split your army in half, with one group remaining north of the river to clear out the saurians and later the mermen, and another group heading south of the river to deal with the dwarves and kill the southern knight leader. The mages and elves which arrive last are extremely easy to kill if you meet them on flat terrain during the night. It's best to save the dwarf leader for last, because his keep is surrounded by rough terrain which will take a long time to cross.

[[Category: User-made Campaigns - Walkthroughs]]

Secrets of the Ancients Walkthrough

2016-11-14T05:42:22Z

Beetlenaut: /* S21 Against the World */

This is a walkthrough for ''Secrets of the Ancients'', a 21 scenario (18 playable, 3 dialogue only) add-on campaign by beetlenaut featuring the undead. The campaign is playable on both Wesnoth versions 1.12 and 1.13, and the campaign's discussion thread on the forums can be found [https://forums.wesnoth.org/viewtopic.php?f=8&t=40545 here.]

==General==

Although this campaign is listed as intermediate level, it is very challenging and closer in difficulty to the expert level mainline campaigns. Throughout the campaign you will get several loyal units, which are recalled for free in all future scenarios. It is highly recommended to keep them all alive, especially the saurian healer because later scenarios will be difficult or impossible without a healer.

===Units===

Over the course of the campaign you'll gain access to the following recruits:

*'''Bats''' are useful in most scenarios for village grabbing and distracting enemies. Their main asset is their cheap recruit cost and zero upkeep, so it is generally not worth it to level them.
*'''Walking corpses''' can be a lifesaver in difficult scenarios, being dirt cheap and able to zombify enemy units so the enemies will focus on killing their own corpses rather than killing your veterans. The downside is that corpses are not worth leveling since their maximum level is 1, so the experience they get from zombifying enemy units is wasted.
*'''Skeletons and skeleton archers''' will be your main units in the first half of the campaign. They have great resistances to blade, pierce, and cold damage, but are vulnerable to fire, impact and arcane. In this campaign, revenants (level 2 skeletons) can advance to death knights which have level 3 leadership, so getting one early on will be very useful.
*'''Ghouls''' can poison enemies but do very little damage, so they are generally not so useful because you will usually kill enemy units before the poison can take effect.
*'''Ghosts''' can either level into wraiths which have an arcane drain attack, or shadows which can do huge amounts of damage through backstab. Later in the campaign many enemies (such as giant spiders and trolls) do impact damage which will destroy skeletal undead, so wraiths/spectres are essential against them. Shadows/nightgaunts are useful for quickly taking out high priority targets such as mages, and their skirmishing ability can help break through deadlocks.
*'''Dark adepts''' are difficult to level because they are fragile and you can only recruit them later in the campaign, but it is very much worth the trouble. At first they can only advance to necromancers, but late in the campaign necromancers can be converted to liches, which can advance to the rather overpowered level 4 ancient lich.
*'''Chocobones''' are not worth using due to their extremely high cost and low HP. Revenants/death knights can do similar melee damage while being much more durable.

==Chapter One: Unlawful Research==

===S1 Slipping Away===
*Objectives: Move Ardonna to the signpost in the northeast.

You'll be attacked by tons of wolves and rats, and in order to survive you'll need to turn some enemies into walking corpses by finishing them with the undead bat or with another walking corpse. Use Ardonna and the regular bats to soften up the enemies so that your corpses can zombify them.

Try to also get Ardonna some kills, because you'll have a much easier time next scenario if you can get her to level 2 during that scenario.

===S2 Dark Business===
*Objectives: Kill all the guards, and occupy the guardhouse.

You don't get much starting gold, so you'll mainly be relying on recruiting walking corpses and creating corpses out of the enemy units. Maybe recall a soulless if you have one for the extra damage per hex, but recalling more than one unit may leave you with too few units to win with. You can stay back at first and let the guards get close to you, so that you get to strike first.

Focus on zombifying the bowmen first, since they are weak in melee and can kill your corpses without taking retaliation damage. It helps to get Ardonna to level 2 - if she got some kills in the previous scenario and you can get her to kill the enemy Lieutenant, she should be most of the way there.

Be very careful when moving to the guardhouse, because several spearmen (5 on hard!) will surround the guardhouse when you do. If Ardonna is level 2 she should easily make short work of the spearmen; otherwise she will need to be carefully protected because the spearmen will tend to focus on her. Moving to the guardhouse will allow Ardonna to use the graves to recruit skeletons and skeleton archers, both of which are highly effective against spearmen with their 60% pierce resistance, so it is a good idea to save up 14-15 gold to recruit one.

===S3 Bandits===
*Objectives: Defeat the enemy leader.

This scenario can be challenging, because the thugs and footpads do impact damage, which your bats and skeletons are weak to. The key is to recruit/recall several bats and send them up the eastern side of the map to village grab, which will not only generate a high income to recruit reinforcements with, but also split up the bandits' forces since many of them will go northeast to get rid of the bats.

Meanwhile your main force (consisting mostly of skeleton archers to kill thugs, and skeletons to kill footpads/poachers) can hold off the bandits in the forests northeast of the keep. If possible, try to make it so the bandits have to attack you from flat terrain. There will be heavy losses, so it's a good idea to have Ardonna stay near the keep for the first ten or so turns, and pump out reinforcements until you have the clear advantage.

===S4 Becalmed===
*Objectives: Defeat the enemy leader.

This is a relatively easy scenario. The enemies all do blade damage so your skeletal undead units with their 40% blade resistance will easily destroy them. Remember to also pay attention to the lower deck, because the enemies can use the trapdoors too.

===S5 Blackwater===
*Objectives: Kill all enemy units.

This scenario is very difficult due to the lack of healing, so try to manage your experience so that your units heal by leveling up. Start by sending some bats around the edges of the map to grab villages and distract enemy units. After that, skeletal undead should be your main recruits, since they resist pierce and blade damage - anything else (corpses, bats, ghouls) is likely to just get killed in one shot by charging horsemen. However skeletal undead are very vulnerable to mages, so killing mages should be always be your top priority.

It's tempting to just block the bridge chokepoints, but sometimes you may want to deliberately let the enemies flood onto the ship so that you'll have more hexes to attack them from. Use Rudic's level 2 leadership on your lower level units for the extra damage, or even better, level a revenant into a death knight for level 3 leadership.

Try to end the battle as quickly as possible, because without villages you will lose in a war of attrition. If you push hard during the nights (and your bats are doing a good job luring enemies to the edges of the map), you can break through the main loyalist force in the center and attack the loyalist castle as early as the third day (around turn 14).

===S6 Following the Shadow===
*Objectives: Move Ardonna to the tunnel in the southeast of the cave.

There are two main battles in this scenario: you'll first fight the wolves outside the cave, and then after entering the cave you'll have to fight your way through a horde of bats. You'll probably need to spend all your gold at the beginning; you'll want a good mix of veterans (a death knight if you have one is very helpful for leadership) for damage dealing, and expendable fresh recruits to hopefully keep the wolves distracted. Walking corpses are a good choice, being cheap and able to zombify wolves.

Send bats to the corners of the map to village grab. The rest of your units can occupy the hilly terrain to the northeast and wait for the wolves to arrive. The main threats are the goblin pillagers, which are deadly in melee with their fire attack, so it is safest to attack them in ranged with Ardonna or bone shooters. You could also poison them with ghouls, which have +10% fire resistance. Killing the wolf leader is not mandatory, but it is very helpful to do so, because you will then be able to safely focus on the cave enemies without wolves harassing you, and Ardonna can also use the wolf's keep to recruit reinforcements since you'll likely take heavy losses from the wolves. The turn limit in this scenario is a little tight, especially if you go to kill the wolf leader, so you can't afford to waste too much time healing. (If you kill the wolf leader before turn 25, you should be fine.)

After Ardonna has spent 2 turns in the cave (or, when six nonbat units enter the cave), a large amount of vampire bats, blood bats and dread bats will appear in the cave. The bats should not be a problem for your skeletal undead, which resist blade and cannot be drained.

===S7 Meeting of the Minds===
Story.

==Chapter Two: Two Missions==

===S8 Carcyn===
*Objectives: Own every village on the map, or kill every enemy unit.

You will control Ras-Tabahn for the next three scenarios. He has a separate recall list (which will be added to Ardonna's recall list when the two join together in Chapter 3) and starts this scenario with a predefined amount of gold. This is a tough scenario due to the sheer number of enemy units, especially on Hard. Since the enemy only recruits spearmen, bowmen and cavalrymen, you'll want to recruit almost exclusively skeletons and skeleton archers for their high resistance vs. blade and pierce. It is also very helpful to get a corpse or two so you can zombify enemies as a distraction. Ghosts are expensive and do very little damage, so they're not very useful here, though you could get one to village grab in the north and try distracting the enemy cavalrymen in the beginning. It's also a good idea to recall the shadow and the half-leveled skeleton, and focus on feeding kills to the skeleton so it can level up quickly.

During the first afternoon and dusk, you can just passively hang around the initial keep, keeping your units on good terrain like the forests and village around the keep, and wait for the loyalists to come to you. During the night be as aggressive as possible - try to make it so that every single one of your units attacks something, and as always try to manage your experience so that some of your units heal by leveling up. By the time the second day arrives, most of the loyalist army should be gone and you should have several level 2's, so after that the battle will only go one way.

It's probably easier and faster to just kill every enemy unit. When you move to the jailhouse in the west, two loyal level 0 units will join you (if you don't find them during the scenario, they join after you win the scenario). It is strongly recommended to level both of them into dark adepts, so that later in the campaign they may become level 4 ancient liches.

===S9 Training Session===
*Objectives: Destroy all 3 waves of undead.

All three undead waves consist of a mix of walking corpses and soulless, or just soulless on Hard. The first wave of undead which arrives during the day is a good opportunity to try to get some experience for your two new level 0 units. For recruits, bone shooters are nice since they can kill soulless without taking retaliation, and ghosts with their 50% impact resistance are pretty good at blocking the soulless from your more fragile units. You'll probably end up losing most of your recruits though, because skeletal undead are weak to impact and ghosts have such low HP. Try to keep most of the dark adepts alive (use them from the back, and then put your undead units in front to shield them) because unlike the undead, adepts will turn into walking corpses when killed with plague.

===S10 Merfolk Revenge===
*Objectives: Defeat the enemy leader.
*Note: Moving to the bones at 32,12 will cause a chocobone to appear and allow you to recruit chocobones.

The gold carryover from this scenario will carry over to S14 (Entering the Northlands), so make sure you get at least some carryover here or you may end up having to replay several scenarios to fix it. The dialogue recommends at least 50 carryover gold, though it is possible to make do with less even on hard.

The merfolk army consists of fighters and hunters which do pierce damage, and netcasters and initiates which do impact damage. Focus on killing the netcasters and initiates first, because they are the most dangerous units against your skeletal undead. Ghosts are very useful in this scenario because they resist both types of damage.

Try to lure the mermen onto land during dusk so that you can make quick work of them during the night. During the day, just retreat into the villages and heal your units so you can strike again at night. The mermen can be reluctant to come onto land so you may have to use some units as bait to lure them out - skeletons are good at luring out the ranged mermen units and dark adepts are good at luring out melee units. The merman leader will also sometimes come out to attack a unit on the southeast sand village (at 29,11), so if you can trap and kill him there it will save you the trouble of having to wade through water to reach his keep.

===S11 Battleground===
*Objectives: Defeat both enemy leaders.

You now switch back to controlling Ardonna. This is an easy scenario, because the saurians recruit only augurs and soothsayers, whose cold damage is laughably ineffective against your skeletal undead's 60% cold resistance. Skeletal undead are also great versus the nagas which do blade damage.

Your enemies have good defense in swamp and water terrain, so if possible try to avoid putting your units next to these terrains and let the enemies come onto land where they are easily killed. A good place to put your units is in the middle of the patch of flat terrain directly northeast of your keep. The nagas have pretty high HP so it can be very effective to recruit a couple ghouls and use them as bait for the nagas - by the time the ghouls are killed almost the entire naga army will be poisoned.

===S12 Walking Trees===
*Objectives: Move Ardonna to the northeast corner of the map.

You will be fighting woses, which can be drained and have a glaring weakness to arcane damage, making this the perfect chance to level some ghosts. Recall any wraiths or experienced ghosts, and you may also want a death knight for leadership, and then just start mass recruiting ghosts. It is very difficult to get any gold carryover from this scenario, so you may want to just forget about carryover and spend all your gold at the beginning.

Every few turns a bunch of woses will spawn somewhere in the forest. They are invisible in the forest due to their ambush ability, but when a wose moves from its starting location it leaves behind a patch of dirt so you should have a rough idea of which direction it will come from. Pay special attention to your loyal saurian healer, because he can be killed by a single wose attack - try to always keep him protected by ghosts on all sides. In the later half of the scenario, level 2 elder woses will spawn instead of level 1 woses, so hopefully by that time Ardonna is already very close to the northeast corner. Since you probably won't get any gold carryover anyway, you could potentially stay for a couple extra turns killing elder woses for experience.

===S13 Together Again===
Story.

==Chapter Three: To Conquer Death==
===S14 Entering the Northlands===
*Objectives: Defeat both enemy leaders.

There is a lot of experience available in this scenario from the high level orcs. Some good units to focus on leveling are spectres and necromancers, because these units will be the most helpful in later scenarios. Try not to go too negative on gold because you will probably need about 150 gold carryover (100 at the very least) to manage the next scenario on Hard. A couple vampire bats are very helpful for grabbing out of the way villages.

Since the eastern leader is fairly close to you, you should be able to take him out relatively quickly if you send your entire army that way. You can then turn your army northwest to deal with the rest of the orcs, which should arrive around the time you get rid of the eastern orc. Be careful of the orcish archers and crossbowmen, because your ghosts are very vulnerable to their fire arrows. The orcs will do extremely high damage especially at night, so it really helps to have some expendable cannon fodder units as distractions.

===S15 Mountain Pass===
*Objectives: Move Ardryn-Na and Ras-Tabahn to the flat terrain in the northeast corner.
*Note: If you did not already find the bones in Scenario 10, moving to the bones at 16,21 will cause a chocobone to appear and allow you to recruit chocobones.

This scenario is extremely hard - you'll be attacked from all directions by gryphons, which have good defense everywhere and are extremely mobile. There are two gryphon leaders, one in the northwest and one in the northeast. The best way to kill gryphons is to zap them with the necromancers' magical attack, but using skeleton archer types can work as well. Ghosts and their advancements are extremely useful due to their mobility, especially spectres/wraiths because their drain attack makes them harder to kill.

If you're low on starting gold or are getting overwhelmed by gryphons, one way to make this scenario much more manageable is to assassinate the northwest gryphon leader using leveled ghosts. Recall all your wraiths, shadows etc., and send them straight northwest. They should reach the enemy gryphon keep during the night, and kill the leader fairly easily especially if you have shadows or nightgaunts. The downside of this tactic is that you will likely lose several of your leveled ghosts in the process.

===S16 The Mage===
*Objectives: Defeat Crelanu.
*Note: Moving a unit onto a bottle of holy water will remove the bottle. A living unit can do this safely, but any undead unit will be destroyed.

This is an easy scenario. Send a couple bats along the edges of the map to village grab, and just have Ras Tabahn move to the village near your keep and stay there for the scenario. You'll be facing high level mages, but only a few at a time. If you wait until night to engage, you'll easily demolish them with skeletons backed by leadership. Necromancers are also very effective here, since they have high HP, no fire weakness, and resistance to arcane. Don't bother with ghostly units because they will just get fried by mages. The mages absolutely love attacking walking corpses, so if you use walking corpses or your necromancers' plague staff to zombify some enemies, your other units probably won't even be attacked.

===S17 Mortality===
Story.

===S18 Abandoned Outpost===
*Objectives: Reach the end of the western tunnel with both Ardryn-Na and Ras-Tabahn, or defeat every enemy unit.

This is a very tough scenario - you'll have to fight your way through two hordes of level 3 giant spiders, in a relatively short amount of turns. By far the best units to use here are spectres, and liches are also useful. You'll also want a bat or two to grab villages near the starting area.

The key to getting rid of the spiders quickly is to get them onto flat terrain, where they only have 30% defense and are easy prey for spectres. A good place to form your line is on the village in the southern tunnel (at 30,12) and the three cave hexes to the right of the village, so that the spiders will attack from the nearby 3 hexes of flat terrain. The spiders tend to be reluctant to attack spectres and liches, so you may want to use bait such as skeletons to lure them onto the flat terrain.

Once you get rid of the first wave of spiders, hopefully you still have about half of the turns remaining, because there is a second horde of spiders in the west blocking the exit. It's actually possible to sneak past them without fighting - send Ardryn-Na, Ras-Tabahn and a spectre or two through the northern 1-hex tunnel (the spiders will probably just ignore them), and then use some bait in the east to lure the spider blocking the tunnel exit away. Then your two leaders can head toward the exit tunnel behind the spiders, while the spectres position themselves so the spiders can't block your leaders from escaping into the exit tunnel next turn.

===S19 Lava and Stone===
*Objectives: Defeat all enemy leaders.

You'll be fighting trolls which are weak to arcane, so wraiths/spectres and liches are the best units to use here. Both units are vulnerable to the troll shamans' fire damage though, so try to kill the shamans quickly using spectres or backstab with shadows/nightgaunts. When you reach the lava chasm in the beginning, the path will branch west, where the main battle will take place, and southeast. The southeastern path leads to a small lake, so you can send a couple spectres/wraiths there to easily pick off trolls in the water.

There are 3 troll leaders in total: a troll shaman leader in the northwest, a great troll in the center, and another troll shaman leader in the southeast corner. This scenario is a good opportunity to try to level some ancient liches, which will be extremely useful next scenario. Finish early, because you get almost no starting gold next scenario, so you will need a pretty high gold carryover (about 150 gold or more).

===S20 North Knalga===
*Objectives: Defeat the enemy leader.

You will be fighting an army of high level dwarves, which have good resistances and extremely high HP. Hopefully you have several ancient liches, because they are basically the only way to kill the level 3 dwarvish lords. Spectres are also very useful since they can help shield your liches. The biggest threats to your units are the lords and runemasters which have a high damage melee impact attack, so focus on killing those first using your ancient liches. Try to put your liches on hills where they have 50% terrain defense - one place to form your line is the small clump of rubble and hills in the center (around 15,7).

When you get near the enemy keep in the southeast, the dwarf leader will recruit some reinforcements. Try the finish as fast as you can, because the early finish bonus in this scenario is huge.

===S21 Against the World===
*Objectives: Defeat all enemy leaders.
*Notes:
**On turn 2, a saurian leader will appear in the eastern swamp castle.
**On turn 4 (turn 3 on easy), a dwarf leader will appear in the southwest mountains.
**On turn 12, a mage leader will appear in the northwest.
**On turn 13, an elf leader will appear in the southeastern forest.

This is the final scenario, so just recall all your best veterans, and recruit some cannon fodder (skeletons are a good choice, since many of the starting enemies do blade/pierce damage) with any remaining gold. Since there's no turn limit, patience and playing defensively will guarantee you eventual victory. Attack all out during the night, then retreat and heal during the day, and eventually the enemy armies will start to thin out. Don't try to block the enemy leaders' keeps before they arrive, because this will just cause them to appear with a full keep of units already recruited. Parking some units just outside the keep to assassinate the leader will have the same effect.

In the beginning you'll just want to hang around the starting keep, and let the knights and nagas come to you so you can wipe them out during the first night. After that you can split your army in half, with one group remaining north of the river to clear out the saurians and later the mermen, and another group heading south of the river to deal with the dwarves and kill the southern knight leader. The mages and elves which arrive last are extremely easy to kill if you meet them on flat terrain during the night. It's best to save the dwarf leader for last, because his keep is surrounded by rough terrain which will take a long time to cross.

[[Category: User-made Campaigns - Walkthroughs]]

InterfaceActionsWML

2016-03-24T18:49:31Z

Beetlenaut: /* [delay] */

{{WML Tags}}
== Interface actions ==

Part of [[ActionWML]], interface actions are actions that do not have a direct effect on gameplay;
instead, they show something to the player. The main interface tags
are '''[message]''' and '''[objectives]''', but several other tags affect
the interface also.

== [inspect] ==
This user interface instantly displays the gamestate inspector dialog at the current scenario state (the same one that can be brought up with [[CommandMode|the ''':inspect''' command]]), which can be used to inspect the values of WML variables, AI configuration, recall lists, and more.

* '''name''': optional attribute to specify the name of this gamestate inspector dialog. It is just a label to help differentiate between different invocations of gamestate inspector dialog.

== [message] ==
The most commonly used interface action is [message], which displays a message to the user in a dialog box. It can also be used to take input from the user.

The following key/tags are accepted for [message]:
* [[StandardUnitFilter]]: The unit whose profile and name are displayed. Do not use a [filter] tag. If no unit matching this filter is found, the message is not displayed (The unit has probably been killed). '''[message]''' elements should be constructed so that it is either guaranteed that a certain unit is alive, or so that dialog flows smoothly even if the message isn't displayed.

* '''speaker''': an alternative to standard unit filter. You may specify as the value of the speaker attribute a unit id or any of the following special values:
** '''narrator''': the dialog box is displayed without a caption for the unit speaking or a unit image
** '''unit''': the primary unit for the event is speaking
** '''second_unit''': the secondary unit for the event is speaking

* '''message''': (translatable) the text to display to the right of the image. ''message'' is sometimes multiple lines; if it is, be sure to use quotes(''' ' ''' or ''' " ''')
* '''male_message''', '''female_message''': {{DevFeature1.13|2}} (translatable) Used instead of ''message'' if the unit's gender matches. Never used if there is no unit (ie ''speaker=narrator'').
* '''wait_description''': {{DevFeature1.13|2}} the description of this message displayed when other players in a mp game wait for one player doing input in a [message] (with [option]s or [text_input]).
* '''[show_if]''': if present then this message will only be displayed if the conditional statement in this tag is passed (see [[ConditionalActionsWML#Condition_Tags|ConditionalActionsWML]])
* '''side_for''': (default: all sides) comma-separated list of sides for who message is shown. This will not work with messages that take user input ([option]/[text_input]), which can only ever be shown to the current player. {{DevFeature1.13|0}} side_for= is now also accepted for messages with user input, it specifies on which side the message is shown (defaults to the currently playing side). For messages with input it does not accept a comma seperated list only a single number.
* '''image''': (default: profile image of speaker) the image to display next to the message. Append ~RIGHT() if you want the image to appear on the right side.
** {{DevFeature1.13|0}} none: display no image
* '''caption''': (default: name of speaker) the caption to display beside the image. Name to be displayed. Note: use a translation mark to avoid wmllint errors.
* '''scroll''': Boolean specifying whether the game view should scroll to the speaking unit. Defaults to ''yes''.
* '''highlight''': {{DevFeature1.13|5}} Boolean specifying whether to highlight the speaker. Defaults to ''yes''.
* '''duration''': (default: 10) the minimum number of frames for this message to be displayed. (A frame lasts about 30 milliseconds.) During this time any dialog decisions will be disregarded.
* '''sound''': a sound effect (wav file) to play as the message is displayed. This can be a comma-separated list, from which one will be randomly chosen.
* '''[option]''': No '''[option]''' elements have to be used. If '''[option]''' elements are present, then each option will be displayed in a menu for the user to select one option. ''Note: Messages with options will not be shown at all in prestart events''
** '''message''': (translatable) the text displayed for the option (see [[DescriptionWML]]) {{DevFeature1.13|2}} This is now a synonym for '''label='''.
** '''image''', '''label''', '''description''', '''default''': See [[DescriptionWML#WML_Format|DescriptionWML]].
** '''[show_if]''': if present then this option will only be displayed if the conditional statement in this tag is passed (see [[ConditionalActionsWML#Condition_Tags|ConditionalActionsWML]])
** '''[command]''': an element containing actions which are executed if the option is selected.
* '''[text_input]''': there can be only one [text_input] tag. this adds a text input field to the message. ''Note: Messages with text_input will not be shown at all in prestart events''
** '''variable''': the variable that the user's input will be written to
** '''label''': a text label to the left of the input field
** '''max_length''': the maximum number of characters that may be typed into the field
** '''text''': text that is written into the field in the beginning
* Check [[EventWML#Multiplayer_safety]] to find out in which events you can safely use '''[option]''' and '''[text_input]''' without causing OOS.

=== Formatting ===
'''[message]''' and other tags such as unit names (user_description), objectives, and floating text can make use of [http://developer.gnome.org/pango/unstable/PangoMarkupFormat.html Pango markup formatting codes].

Remember to use single quotes (') instead of double quotes (") within the formatting string, as double quotes cannot be escaped, and the string will appear fragmented and possibly cause errors.

For example, if you wanted to write "You are victorious!" in large, italic, gold letters, you might write it this way:

<nowiki>You are victorious!</nowiki>

These are the codes taken from the Pango markup formatting guide:

*'''font''', '''font_desc''': A font description string, such as "Sans Italic 12".
*'''font_family''', '''face''': A font family name.
*'''font_size''', '''size''': Font size in 1024ths of a point, or one of the absolute sizes 'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large', or one of the relative sizes 'smaller' or 'larger'.
*'''font_style''', '''style''': One of 'normal', 'oblique', 'italic'.
*'''font_weight''', '''weight''': One of 'ultralight', 'light', 'normal', 'bold', 'ultrabold', 'heavy', or a numeric weight.
*'''font_variant''', '''variant''': One of 'normal' or 'smallcaps'.
*'''font_stretch''', '''stretch''': One of 'ultracondensed', 'extracondensed', 'condensed', 'semicondensed', 'normal', 'semiexpanded', 'expanded', 'extraexpanded', 'ultraexpanded'.
*'''foreground''', '''fgcolor''', '''color''': An RGB color specification such as '#00FF00' or a color name such as 'red'.
*'''background, bgcolor''': An RGB color specification such as '#00FF00' or a color name such as 'red'.
*'''underline''': One of 'none', 'single', 'double', 'low', 'error'.
*'''underline_color''': The color of underlines; an RGB color specification such as '#00FF00' or a color name such as 'red'.
*'''rise''': Vertical displacement, in 10000ths of an em. Can be negative for subscript, positive for superscript.
*'''strikethrough''': 'true' or 'false' whether to strike through the text.
*'''strikethrough_color''': The color of strikethrough lines; an RGB color specification such as '#00FF00' or a color name such as 'red'
*'''fallback''': 'true' or 'false' whether to enable fallback. If disabled, then characters will only be used from the closest matching font on the system. No fallback will be done to other fonts on the system that might contain the characters in the text. Fallback is enabled by default. Most applications should not disable fallback.
*'''letter_spacing''': Inter-letter spacing in 1024ths of a point.
*'''gravity''': One of 'south', 'east', 'north', 'west', 'auto'.
*'''gravity_hint''': One of 'natural', 'strong', 'line'.

== [objectives] ==
The other tag used for plot development is '''[objectives]'''.
The '''[objectives]''' tag overwrites any previously set objectives,
and displays text which should describe the objectives of the scenario.
Scenario objectives are displayed on the player's first turn after the tag is used,
or as part of the event if it triggers during that player's turn.
Objectives can also be accessed at any time in a scenario using the
"Scenario Objectives" game menu option, making this tag useful for
scenario-specific information that the player may need to refer to during play.

Attributes of '''[objectives]''':
* '''side''': Default '0'. The side to set the objectives for. A value of 0 sets objectives for all sides. note: There are side-specific objectives and default objectives, which are used in case a side doesn't have specific ones. Specifying 0 sets the default ones.
* '''[[StandardSideFilter]]''' tags and keys: Sets the objectives of all matching sides to these passed specifications (the rest of this [objectives] tag). If no sides (such as when passing side=0) or all sides match, sets the default objectives, and the side specific ones for the matching sides otherwise.
* '''bullet''': Default '• '. Replaces the default bullet, with whatever is passed, for all objectives, gold carryover notes, and notes defined with [note].
* '''summary''': Displayed first in the objectives text, this should describe the basic objective for the overall scenario. Can be omitted.
* '''note''': Displayed last in the objectives text, this is sometimes used for hints or additional information. Can be omitted.
* '''victory_string''': Default ' _ "Victory:"', this text precedes the victory objectives.
* '''defeat_string''': Default ' _ "Defeat:"', this text precedes the defeat objectives.
* '''gold_carryover_string''': Default ' _ "Gold carryover:"', this text precedes the gold carryover information.
* '''notes_string''': Default ' _ "Notes:"', this text precedes the notes.
* '''silent''': Default: not present. If set to "yes", the objectives are silently changed. Else, they will be shown to the user when appropriate.

Tags of '''[objectives]''':
* '''[objective]''': describes a win or loss condition. Most scenarios have multiple win or loss conditions, so use a separate [objective] subtag for each line; this helps with translations.
** '''bullet''': Default '• ' or whatever is set in the parent [objectives] block. Replaces the default bullet, with whatever is provided, for the objective defined by the [objective] block.
** '''red''': Default '0' for winning objectives, '255' for losing objectives. Overrides the default red coloring of the entire objective, including the bullet.
** '''green''': Default '255' for winning objectives, '0' for losing objectives. Overrides the default green coloring of the entire objective, including the bullet.
** '''blue''': Default '0'. Overrides the default blue coloring of the entire objective, including the bullet.
** '''description''': text for the specific win or loss condition.
** '''condition''': The color and placement of the text. Values are 'win'(colored green, placed after ''victory_string'') and 'lose'(colored red, placed after ''defeat_string'')
** '''show_turn_counter''': If set to yes, displays the number of turns remaining in the scenario. Default is no.
** '''[show_if]''': A condition that disables the objective if it doesn't hold. Conditional objectives are refreshed at '''[show_objectives]''' time only.
* '''[gold_carryover]''': describes how the gold carryover works in this scenario. This is intended to be a more convenient way of displaying carryover information than using the note= key in [objectives].
** '''bullet''': Default '• ' or whatever is set in the parent [objectives] block. Replaces the default bullet with whatever is provided.
** '''red''': Default '255'. Overrides the default red coloring of the entire objective, including the bullet.
** '''green''': Default '255'. Overrides the default green coloring of the entire objective, including the bullet.
** '''blue''': Default '192'. Overrides the default blue coloring of the entire objective, including the bullet.
** '''bonus''' (boolean): whether an early finish bonus is granted. If omitted, early finish bonus is not mentioned.
** '''carryover_percentage''': the amount of carryover gold. If omitted, the amount is not mentioned.
* '''[note]''': describes a note, usually used for hints or additional information. This is an easier way of adding several notes than concatenating them together into a single string to use with the ''note='' key.
** '''bullet''': Default '• ' or whatever is set in the parent [objectives] block. Replaces the default bullet with whatever is provided for the note defined by the [note] block.
** '''red''': Default '255'. Overrides the default red coloring of the entire note, including the bullet.
** '''green''': Default '255'. Overrides the default green coloring of the entire note, including the bullet.
** '''blue''': Default '255'. Overrides the default blue coloring of the entire note, including the bullet.
** '''description''': the text of the note.
** '''[show_if]''': The note will not be shown if the specified condition isn't met. Conditional notes are refreshed at '''[show_objectives]''' time only.

== [set_menu_item] ==
This tag is used to add a custom option in the right-click context menu which can then be used to trigger arbitrary WML commands. The menu items can be set and modified during any event, for example during "start" or "prestart" events. The user can also assign hotkeys to these WML commands unless specified otherwise. When the hotkey is pressed the event will be fired/filtered at the current mouse position.

'''Note:''' Due to limitations in portable devices where there are no scroll bars for context menus, there is a hard-coded limit of 7 custom WML menu items. If you really need to have more than 7 menu items, try combining some of them in a submenu. {{DevFeature1.13|0}} This limitation is being removed in a [http://forums.wesnoth.org/viewtopic.php?p=572554#p572554 future version] of Wesnoth.

* '''id''': the unique id for this menu item. If a menu item with this id already exists, it allows you to set specific changes to that item.
* '''description''': the in-game text that will appear for this item in the menu.
* '''image''': the image to display next to this item.
* '''needs_select''': if ''yes'' (default ''no''), then the latest select event (see [[EventWML]]) that triggered before this menu item was chosen will be transmitted over the network before this menu item action will be. This only has any effect in networked multiplayer, and is intended to allow more elaborate menu item behaviour there without causing out of sync errors. If you don't know what this means, just leave it false.
* '''use_hotkey''': if ''no'' (default ''yes''), then the user cannot assign hotkeys to this menu item. If ''only'', the menu item is only accessible via hotkeys, not via right-click context; you can use this in combination with [default_hotkey] if you want custom hotkeys in your campaign/mp.
* '''[show_if]''': If present, the menu item will only be available if the conditional statement (see [[ConditionalActionsWML#Condition_Tags|ConditionalActionsWML]]) within evaluates to true. When this is evaluated, the WML variables ''$x1'' and ''$y1'' will point to the location on which the context menu was invoked, so it's possible to for example only enable the option on empty hexes or on a particular unit.
* '''[filter_location]''': contains a location filter similar to the one found inside Single Unit Filters (see [[FilterWML]]). The menu item will only be available on matching locations.
* '''[default_hotkey]''': contains a hotkey WML to specify what hotkey to assign to this, '''if the user has no hotkey assigned to this yet'''. (Unlike the rest of a menu item definition, modifying this tag has no effect on the game; it is only effective when initially defining a menu item.) Hotkey WML matches the format in the preferences file and contains the following keys:
** '''key''': a string that contains the key to assign to this.
** '''alt''', '''shift''', '''cmd'''(apple only), '''ctrl''': boolean values.
* '''[command]''': contains the WML actions to be executed when the menu item is selected. Again, the WML variables ''$x1'' and ''$y1'' will point to the location on which the context menu was invoked on.
** '''delayed_variable_substitution ''' (boolean yes|no, default: yes): If no, forces a variable substitution run onto the wml included in this [command] block. Use this, if you want variables which are to substitute to get the values they have at execution time of the event where this set_menu_item appears. Other than that, they get the values they have at invocation time of the menu item.

== [clear_menu_item] ==

Removes a menu item from the scenario.
Normally menu items are, including all their defining wml, automatically carried over between scenarios. This tag prevents this. (The behavior is comparable to set_variable/clear_variable).
* '''id''': (string): id of the menu item to clear. Can be a comma-separated list.

== Other interface tags ==

The following tags are also action tags:

=== [item] ===
Makes a graphical item appear on a certain hex. Note this only places the graphics for an item. It does not make the item do anything. Use a moveto event to make moving onto the item do something. <tt>''('''Hint:''' There are a number of predefined items that are used in various campaigns that you can make use of. You can find [http://www.wesnoth.org/macro-reference.xhtml#file:items.cfg a list of them] if you look into the items.cfg file in the wesnoth install directory (under /data/core/macros).)''</tt>
* '''x''', '''y''': the location to place the item. (only for [event][item]: full [[StandardLocationFilter|SLF]] support)
* '''image''': the image (in ''images/'' as .png) to place on the hex. This image is aligned with the top-left of the hex (which is 72 pixels wide and 72 pixels tall). It is drawn underneath units. ''('''Hint:''' If using an image smaller than 72x72, then it might be useful to [[ImagePathFunctionWML#Blit_Function|BLIT]] the image onto <tt>misc/blank-hex.png</tt> (a blank 72x72 image).)''
* '''halo''': an image to place centered on the hex. It is drawn on top of units. Use this instead of ''image'' if the image is bigger than the hex or if you want to animate an image.
''Example (where the integer after the colon is the duration of each frame or square bracket expansion as per AnimationWML is used): halo=scenery/fire1.png:100,scenery/fire2.png:100,scenery/fire3.png:100,scenery/fire4.png:100,scenery/fire5.png:100,scenery/fire6.png:100,scenery/fire7.png:100,scenery/fire8.png:100''
or equivalently (requires Wesnoth 1.11.2+):
''halo=scenery/fire[1~8].png:100''
* '''team_name''': name of the team for which the item is to be displayed (hidden for others). For multiple teams just put all the names in one string, for example separated by commas.
* '''visible_in_fog''': whether the item should be visible through fog or not. Default yes.
* '''redraw''': (boolean yes|no, default: yes): If no, disables implicit calls to [[InterfaceActionsWML#.5Bredraw.5D|[redraw]]] when placing the items.

=== [remove_item] ===
Removes any graphical items on a given hex.
* [[StandardLocationFilter]]: the hexes to remove items off
* '''image''' if specified, only removes the given image item (This image name must include any [[ImagePathFunctionWML|image path functions]] appended to the original image name.)

=== [print] ===
Displays a message across the screen. The message will disappear after a certain time.
* '''text''': (translatable) the text to display.
* '''size''': (default=12) the pointsize of the font to use
* '''duration''': (default=50) the length of time to display the text for. This is measured in the number of 'frames'. A frame in Wesnoth is usually displayed for around 30ms.
* '''red''', '''green''', '''blue''': (default=0,0,0) the color to display the text in. Values vary from 0-255.
=== [move_unit_fake] ===
Moves an image of a unit along a certain path on the map. The path does not need to be a continuous list of adjacent hexes, so for example only the start and end points can be given, in which case the straightest line between those points will be calculated and used.
* '''type''': the type of the unit whose image to use
* '''x''': a comma-separated list of x locations to move along
* '''y''': a comma-separated list of y locations to move along (x and y values are matched pairs)
* '''side''': the side of the fake unit, used for team-coloring the fake unit
* '''gender''': the gender of the fake unit. Example: gender=female
* '''variation''': the variation of the fake unit. Example: variation=undead
* '''image_mods''': [[ImagePathFunctionWML|image path functions]] sequence to be applied on the fake unit.
* '''force_scroll''': Whether to scroll the map or not even when [[#.5Block_view.5D|[lock_view]]] is in effect or ''Follow Unit Actions'' is disabled in ''Advanced Preferences''. Defaults to ''yes'' starting with version '''1.11.6'''; the attribute did not exist in previous versions and this action behaved as if ''no'' was passed instead.

=== [move_units_fake] ===
moves multiple images of units along paths on the map. These units are moved in lockstep.
* '''[fake_unit]''': A fake unit to move
** '''type''': the type of unit whose image to use
** '''x''': a comma-separated list of x locations to move along
** '''y''': a comma-separated list of y locations to move along (x and y values are matched pairs)
** '''side''': the side of the fake unit, used for team-coloring the fake unit
** '''skip_steps''': the number of steps to skip before this unit starts moving
=== [hide_unit] ===
Temporarily prevents the engine from displaying the given unit. The unit does not become invisible, as it would be with the '''[hides]''' ability; it is still the same plain unit, but without an image. Useful in conjunction with '''[move_unit_fake]''': to move a leader unit into position on-screen. Until 1.8 each '''[hide_unit]''' tag only hides one unit.
* [[StandardUnitFilter]]: All matching units will be hidden

=== [unhide_unit] ===
Stops the currently hidden units from being hidden.
* [[StandardUnitFilter]]: Only the matching units will be unhidden

=== [lock_view] ===
Locks gamemap view scrolling for human players, so they cannot scroll the gamemap view until it is unlocked. WML or Lua actions such as '''[scroll_to]''' will continue to work normally, as they ignore this restriction; the locked/unlocked state is preserved when saving the current game.

This feature is generally intended to be used in cutscenes to prevent the player scrolling away from scripted actions.

=== [unlock_view] ===
Unlocks gamemap view scrolling for human players.

=== [scroll] ===
Scroll a certain number of pixels in a given direction. Useful for earthquake/shaking effects.
* '''x''', '''y''': the number of pixels to scroll along the x and y axis
* '''side''': the side or sides for which this should happen. By default, the [scroll] happens for everyone.
* '''[filter_side]''': a [[StandardSideFilter]] to select the sides for which this should happen. By default, the [scroll] happens for everyone.

=== [scroll_to] ===
Scroll to a given hex
* '''x''', '''y''': the hex to scroll to
* [[StandardLocationFilter]], do not use a [filter_location] sub-tag. If more than one location matches the filter, only the first matching location will be used.
* '''check_fogged''': whether to scroll even to locations covered in fog or shroud. Possible values ''true'' (don't scroll to fog) and ''false'' (scroll even to fog), with ''false'' as the default.
* '''immediate''': whether to instantly warp to the target hex regardless of the scroll speed setting in Preferences (defaults to ''false'').
* '''highlight''': {{DevFeature1.13|5}} Whether to highlight the hex being scrolled to (defaults to ''false'').
* '''side''': the side or sides for which this should happen. By default, the [scroll_to] happens for everyone.
* '''[filter_side]''': a [[StandardSideFilter]] to select the sides for which this should happen. By default, the [scroll_to] happens for everyone.

=== [scroll_to_unit] ===
Scroll to a given unit
* [[StandardUnitFilter]]
* '''check_fogged''': whether to scroll even to locations covered in fog or shroud. Possible values ''true'' (don't scroll to fog) and ''false'' (scroll even to fog), with ''false'' as the default.
* '''immediate''': whether to instantly warp to the target hex regardless of the scroll speed setting in Preferences (defaults to ''false'').
* '''highlight''': {{DevFeature1.13|5}} Whether to highlight the hex the unit is on (defaults to ''false'').
* '''for_side''': the side or sides for which this should happen. By default, the [scroll_to_unit] happens for everyone.
* '''[for_side]''': a [[StandardSideFilter]] to select the sides for which this should happen. By default, the [scroll_to_unit] happens for everyone.

=== [select_unit] ===
Selects a given unit.
* [[StandardUnitFilter]]: The first unit found will be selected.
* '''fire_event''': whether a ''select'' event should be triggered or not (def. ''no''). (Note that select events aren't multiplayer save.)
* '''highlight''': whether the unit's current hex should be highlighted (def. ''yes'').

=== [sound]===
Plays a sound
* '''name''': the filename of the sound to play (in ''sounds/'' as .wav or .ogg)
* '''repeat''': repeats the sound for a specified additional number of times (default=0)
=== [sound_source] ===
Creates a sound source. "Sound sources" is a general name for a mechanism which makes possible for map elements to emit sounds according to some rules, where "map elements" can be specific locations or terrain types. For now, only sound sources tied to locations are supported.
* '''id''': a unique identification key of the sound source
* '''sounds''': a list of comma separated, randomly played sounds associated with the sound source
* '''delay''': a numerical value (in milliseconds) of the minimal delay between two playbacks of the source's sound if the source remains visible on the screen; if one scrolls out and back in, the source will be considered as ready to play
* '''chance''': a percentage (a value from 0 to 100) describing the chance of the source being activated every second after the delay has passed or when the source's location appears on the screen (note that it cannot play more than one file at the same time)
* '''check_fogged''': possible values "true" and "false" - if true the source will not play if its locations are fogged
* '''check_shrouded''': possible values "true" and "false" - if true the source will not play if its locations are shrouded
* '''x,y''': similar to x,y as found in a [[StandardLocationFilter]], these are the locations associated with the sound source
* '''fade_range''' (default = 3): distance in hexes that determines a "circular" area around the one specified by '''full_range''' where sound volume fades out linearly
* '''full_range''' (default = 14): distance in hexes that determines a "circular" area where source plays with full volume, relative to screen center
* '''loop''': number of times a sound sample should be looped if it stays visible. -1 means infinite (~65000)

=== [remove_sound_source] ===
Removes a previously defined sound source.
* '''id''': the identification key of the sound source to remove

=== [music]===
Switches to playing different music
* '''name''': the filename of the music to play (in ''music/'' as .ogg)
* see [[MusicListWML]] for the correct syntax
===[volume]===
Changes the game volume to a percent of the preferences volume for the game being played. Values can go from 0 to 100:
* '''music''': Changes the music volume.
* '''sound''': Changes the sound volume.
=== [color_adjust]===
Tints the color of the screen.
* '''red''', '''green''', '''blue''': values from -255 to 255, the amount to tint by for each color
=== [delay] ===
Pauses the game.
* '''time''': the time to pause in milliseconds
* '''accelerate ''' (boolean yes|no, default no): {{DevFeature1.13|0}} whether the delay is affected by acceleration. When [delay] is used to make an animation, this should be set to yes so that your animation matches the ones generated by the game.

=== [redraw] ===
Redraws the screen (this normally isn't done during events, although some of the other interface actions cause the screen or parts of it to be redrawn).
* '''clear_shroud''' (boolean yes|no, default no): If yes, clears fog and shroud around existing units. Useful if you, for example, spawn friendly units in the middle of an event and want the shroud to update accordingly (otherwise units that spawn inside fog would remain invisible for the duration of the event, since the fog would not automatically get cleared around them).
* '''[[StandardSideFilter]]''': the sides for which to recalculate fog and shroud.
* '''side''': If used (forces clear_shroud=yes), clears fog and shroud for that side.

=== [unit_overlay] ===
Sets an image that will be drawn over a particular unit, and follow it around
* [[StandardUnitFilter]]: All matching units will get the overlay (do not use [filter])
* '''image''': the image to place on the unit

=== [remove_unit_overlay] ===
removes a particular overlayed image from a unit
* [[StandardUnitFilter]]: The overlay will get removed from all matching units (do not use [filter])
* '''image''': the image to remove from the unit

=== [animate_unit] ===
Uses an animation of a unit to animate it on screen (if the unit has the corresponding animation).
* '''flag''': The key to find the custom animation in the unit description (see the '''[extra_anim]''' description in [[AnimationWML]]). Standard animations can be triggered with the following keywords: ''leading recruited standing idling levelout levelin healing healed poisoned movement defend attack death victory pre_teleport post_teleport''
* '''[filter]''' with a [[StandardUnitFilter]] as argument, see [[FilterWML]]. By default, the unit at the event location will be animated. You can use this tag to choose any other unit to animate.
* '''[primary_attack]''': If this tag is not present, the filter for animation will be triggered with no attack. If it is here, all attacks from the unit will be filtered, and a matching one will be used to filter the animation. Takes a weapon filter as argument, see [[FilterWML]].
* '''[secondary_attack]''': Similar to '''[primary_attack]'''. May be needed to trigger a defense animation correctly, if there are more than one animations available for the defending unit.
* '''hits''': yes/no/hit/miss/kill: which according variation of a attack/defense animation shall be chosen (required)
* '''text''': a text to hover during the animation
* '''male_text''', '''female_text''': {{DevFeature1.13|2}} (translatable) gender-specific versions of the above
* '''red''': red value for the text color (0-255)
* '''green''': green value for the text color
* '''blue''': blue value for the text color
* '''with_bars''': yes/no: whether to display the status bars during the animation (e.g. the hitpoint bar)
* '''[animate]''': a sub block with the same syntax as '''[animate_unit]''' except that the '''[filter]''' block is mandatory to find the unit. This block will find and animate another unit simultaneously.
* '''[facing]''': a [[StandardLocationFilter]] specifying what direction the unit should be facing when animated

=== [label] ===
Places a label on the map.
* '''x''', '''y''': the location of the label. {{DevFeature1.13|1}} (only for [event][label]: full [[StandardLocationFilter|SLF]] support)
* '''text''': what the label should say
* '''team_name''': if specified, the label will only be visible to the given team.
* '''color''': color of the label. The format is r,g,b; r, g and b are numbers between 0 and 255.
* '''visible_in_fog''': whether the label should be visible through fog or not. Default yes.
* '''visible_in_shroud''': whether the label should be visible through shroud or not. Default no.
* '''immutable''': whether this label is protected from being removed or changed by players. Default yes.

=== [floating_text]===
Floats text (similar to the damage and healing numbers) on the given locations.
* [[StandardLocationFilter]]: the text will be floated on all matching locations simultaneously.
* '''text''': the text to display.

The default text color is '''#6b8cff'''. To change the color, use [[#Formatting|Pango markup]]. For example:

<pre>
# Float some golden yellow text at 20,20.
[floating_text]
x,y=20,20
text="" + _ "Your text here" + ""
[/floating_text]
</pre>

=== [deprecated_message] ===
Shows a deprecated message in the message area, this feature is only intended to be used to warn about deprecated macros in mainline. The message is not translatable.
* '''message''': the message to show.
=== [wml_message] ===
Outputs a message to Wesnoth's console output. Intended for campaign designers to output silent text to the console, without annoying the player; then, that text might contain information useful for later bug-reporting. The log domain for it is '''wml''', and the '''debug/dbg''' log level is available for use with the '''logger''' attribute. Depending on the current log level ('''error''' by default), which may be changed with the in-game :log command, or the --log-<level>=wml command line switch, the messages are echoed to the in-game chat.
* '''message''': the message to show.
* '''logger''': the Wesnoth engine output logger that should catch the text; this might be 'err' (the errors log level), 'warn'/'wrn' (the warnings log level) or anything else (the information log level). Not all information will be displayed depending on the log level chosen when starting Wesnoth.

Note: As of 1.9.4/1.9.5 (r48805) the following "loggers" should work: If in [wml_message]: err/error, warn/wrn/warning, debug/dbg; using the :log command: Only the long forms error, warning, info and debug (this part gathered by trying rather than source inspecting). The long forms are most likely also the only ones working when starting wesnoth with --log-<level>=wml.
For log level warning or error (as during normal play), only wml_messages with logger error or warning display (for both). With logger info or debug, additionally wml_messages with logger info or debug display (for both).

=== [test_condition] ===

{{DevFeature1.13|2}}

Evaluates the contained conditional tags. If they evaluate to the expected value, it prints out a message to the console explaining which part of the condition caused this result in a way similar to [wml_message]. This can be used if your conditional test is failing and you're not sure why.

* '''result''': Whether you expect the conditions to fail or succeed. If no (the default), a message will be printed if the conditional tags fail. If yes, a message will instead be printed if the conditional tags pass.
* '''logger''': Same as for [wml_message]. Defaults to "warning".

=== [open_help] ===
Opens the in-game help.
* '''topic''': the id of the topic to open
=== [show_objectives] ===
refreshes the objectives defined by [objectives] and its [show_if] tags, and displays them. (It is also called whenever the user explicitly asks for the objectives; this matters only if the tag was overridden by a [[LuaWML#register_wml_action|Lua]] script.)
* '''side''': the side to show the objectives. If not set, all sides are used.
* '''[[StandardSideFilter]]''' tags and keys: Tag affects the matching sides instead of just all or the one given by the integer value of the side= key.

=== [chat] ===
Displays a message in the chat area, not visible for observers. Alternative visible for observers: [[LuaWML:Display#wesnoth.message]]
* '''speaker''': (default="WML") A string for the name of the sender of the message.
* '''message''': The message that should be displayed.
* '''[[StandardSideFilter]]''' tags and keys as argument; if the same client controls multiple sides that match, then the message will only be displayed once.

== Useful Macros ==
There are some predefined macros that you find useful for interface actions. You can find a complete list along with a detailed explanation of how they work [http://www.wesnoth.org/macro-reference.xhtml here].
* '''{HIGHLIGHT_UNIT}''' Highlight a unit on the map. Use this to show important units
* '''{HIGHLIGHT_IMAGE}''' Places and highlights an image on the map. Use this to show important items or locations
* '''{SET_IMAGE}''' Places an image on the map which has no other function.
* '''{QUAKE <soundfile>}''' Creates a tremor-like screenshake and plays <soundfile>. For example, '''{QUAKE (rumble.ogg)}'''.
* '''{FLASH_WHITE}''' Flash the screen white momentarily. You can also replace WHITE with RED, BLUE or GREEN for a different colour.

== See Also ==
* [[DirectActionsWML]]
* [[InternalActionsWML]]
* [[EventWML]]
* [[ReferenceWML]]

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

Guide to UMC Content

2014-09-12T18:57:15Z

Beetlenaut: /* The Founding of Borstep */

This is a guide to the current (1.10.x/1.11.x) UMC content for players. It aims to provide unfamiliar players detailed information about campaigns (including story, completion, difficulty and playing style) as well as detailed information about eras. See also [[Player_UMC_Reviews|Player UMC Reviews]], as well as [http://forums.wesnoth.org/viewtopic.php?f=8&t=37476 here] for further information and [http://forums.wesnoth.org/viewtopic.php?f=8&t=36733 here] for currently non-available UMC-content. Feel free to edit this, it is a wiki.

== Blueprint for Campaigns ==

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status:
** Broken = Does not work at all
** Incomplete = Partially written, no progress
** WIP = Partially written, some progress
** Complete = Completely written, but buggy as well as potential balance issues.
** Finished = Completely written, minimal to no bugs, slight balance issues possible.

* Length:

* Version:

* Requirements: (only if needed)

* Difficulty:

Please note: Often campaigns introducing new mechanics are listed as expert level on the add-on server, here difficulty means the raw difficulty after the mechanics are understood.

** Unbalanced = If you can't beat the hard mode, it isn't necessarily unbalanced, but if the difficulty changes erratically from one scenario to the next and only people using the debug mode have seen the final, then it is.
** Easy
** Normal
** Hard

* Style:

Please note: Many campaigns will feature more than one style. Please list the most significant ones.

** Skirmish = small to medium sized armies, your standard Wesnoth gameplay
** Dungeon = long and narrow tunnels (not every underground scenario is a dungeon, a dungeon isn't necessarily underground)
** RPG = role playing game elements such as talking with non-player-characters, item collection, dependency on a party of very few adventurers without or limited recruits
** Survival = being exposed to changing, spawning enemies while remaining on the same map
** Large Battle = large number of units on the battlefield, sizely maps
** Simulation = campaigns feat. terrain modification, alternative resources
** Boss battle = the challenge is to defeat a single powerful enemy unit
** Minigames = there are puzzles and minigames in the campaign that significantly differ from standard Wesnoth gameplay

* Faction/Era: Era for the whole campaign and more specifically the faction or unit composition you field.

* Custom units: Link to the unit tree for cases that don't feel sufficiently described by Faction / Era entry.

* Forum: Links to the feedback and development threads at forums.wesnoth.org

== Blueprint for Eras ==

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status:
** Broken = Does not work at all
** Incomplete = Partially written, no progress
** WIP = Partially written, progress
** Complete = Completely written, but buggy as well as potential balance issues.
** Finished = Completely written, minimal to no bugs, slight balance issues possible.

* Faction Descriptions: Describe your individual factions here.

* Version:

* Requirements: (only if needed)

* Forum: Links to the feedback and development threads at forums.wesnoth.org

== Battle for Wesnoth 1.10.x - stable ==

=== Campaigns ===

==== A Gryphon's Tale ====

''A Gryphon's Tale tells the story of a community of civilized Gryphons, and of Neliflua, an ambitious young female among them who falls into unusual circumstances.''

'''Author:''' Ringcaat/Dwarven_Void

'''Status:''' One branch complete, most incomplete

'''Length:''' 11-12 scenarios (branch dependent)

'''Version:''' 0.6.12

'''Difficulty:''' Easy

'''Style:''' RPG/minigames

'''Faction/Era:''' Gryphon/Orc

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=2906&start=195&

==== After the Storm ====

''Follow the journey of Galas and his band following the events of Invasion from the Unknown''

'''Author:''' shadowmaster/ShikadiLord

'''Status:''' Finished

'''Length:''' 3 episodes of 13 scenarios each, some of which are multi-part

'''Version:''' 0.9.9

'''Difficulty:''' Medium-hard

'''Style:''' Skirmish, Boss Battle, Dungeon

'''Faction/Era:''' Many custom units

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=32091

'''Note:''' (vultraz) Long, very enjoyable campaign with great story. (Knyghtmare) The best UMC campaign ever!

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#After_the_Storm Players’ Review(s)]'''

==== Aldur The Great ====

''This is a story about Aldur the Great.''

'''Author:''' pintercsabi

'''Status:''' Complete, but unbalanced

'''Length:''' 5 playable scenarios

'''Version:''' 1.2.2

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default

'''Forum:''' -

'''Note:''' (Adamant14) Short unbalanced campaign, maybe abandoned. You fight with Peasants, Ruffians and Woodsman against Orcs

==== Alfhelm the Wise ====

''This is the tale of Alfhelm, called by some the Wise, son of Alfric Conqueror. This is the tale of his victories over his enemies, and his rise to power in the clans of Marauderdom. This is the tale of his journey south and his destruction of the Lavinian Empire. And this is the tale of his demise in the dark forests far to the east of his homeland.''

'''Author:''' turin

'''Maintainer:''' UnwiseOwl

'''Status:''' Complete

'''Length:''' 15 gameplay scenarios

'''Version:''' 0.6.0

'''Difficulty:''' Moderate

'''Style:''' Skirmish

'''Faction/Era:''' Imperial Era, Marauders.

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=17144

'''Note:''' (Maintainer) Though this campaign is complete and playable the whole way through, the code is four years old and pretty buggy. If you notice any errors while playing, please let me know and I'll incorporate the fixes into my next revision as soon as possible.]

==== A New Order ====

''The old kingdom of Wesnoth has fallen before barbarian hordes. The occupying barbarians are on the brink of civil war, the seeds of Wesnothian rebellion are kept alive by old legends, while bandits and Khalifate mercenaries roam the land. Can Gawen Hagarthen unite these disparate factions against a common foe?
Note: This campaign contains mature themes, some of which may be unsuitable for children.

'''Author:''' szopen

'''Status:''' Finished.

'''Length:''' 45 scenarios.

'''Version: ''' 1.2.15

'''Requirements:''' Requires BfW 1.10. In addition, you have to install Era Khalifate add-on; the Akladian Music package is optional

'''Difficulty:''' Normal

'''Style:''' Skirmish, Large Battle

'''Faction/Era:''' Akladians, Khalifate

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=6486

'''Note:''' (Pyrophorus) Certainly one of the most mature and well designed campaign in add-ons. A must.

''' [http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#A_New_Order Players’ Review(s)]'''

==== Antar, Son of Rheor ====

''This is the story about a young Lord and his first mission; sent by his father the young Lord Antar has to relieve his neighbours; he has to convince the Elves and Dwarves to ally him; he has to fight against hordes of Orcs and Endless Undead; and finally he has to defeat Mal Kazur, the mastermind who is behind all the evil.''

'''Author:''' Adamant14

'''Status:''' WIP

'''Length:''' 9 playable scenarios / 1 cutscene

'''Version:''' 0.9.9

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Loyalists and Elves (feat. fencer as main hero + various allies)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36075

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Antar.2C_Son_of_Rheor Players’ Review(s)]'''

==== A Story of the Northlands ====

''A story of life and death in a remote village of the Northlands. Your village has been overrun by an orcish raid. You fight for its freedom while you wait for help to arrive.''

'''Author:''' zepko

'''Status:''' Complete

'''Length:''' 10 playable scenarios + 1 dialogue-only

'''Version:''' 1.0.0

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default + additions: you play with a custom faction of outlaws and with a custom party of loyalist knights.

'''[http://units.wesnoth.org/1.10/A_Story_of_the_Northlands/en_US/A_Story_of_the_Northlands.html Custom Units]'''

==== A Vision Blinded ====

''Defend the northern forest against what appeared like a routine orcish raid, and unravel the greater conspiracies that lie below its waves.''

'''Author:''' LemonTea

'''Maintainer:''' Adamant14

'''Status:''' Complete

'''Length:''' 13 playable scenarios + 1 dialogue-only

'''Version:''' 1.0.2

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves (+ Trolls, Outlaws)

'''[http://units.wesnoth.org/1.10/A_Vision_Blinded/en_US/A_Vision_Blinded.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=23463&hilit=a+vision+blinded

==== Bad Moon Rising ====

''An expedition to gather treasure from the cold north sets off compounding disaster.''

'''Author:''' Doofus-01

'''Status:''' Finished

'''Length:''' 20 scenarios

'''Version:''' 1.4.4.a

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Archaic Era

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=31348

==== Battle Against Time ====

''Rescue fellow orcish warchief before he is executed. (This is not a normal campaign. It is experiment with carryover system. You will start with defined number of turns and gold. You will only have that many turns to play through the whole campaign. There is no finish bonus and gold carryover is always 100%.)''

'''Author:''' Wonderboy

'''Status:''' Complete

'''Length:''' 4 playable scenarios + 1 prologue scenario

'''Version:''' 1.0.0

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Default: Orcs

'''Forum:''' http://wesnoth.org/forum/viewtopic.php?f=8&t=27319

==== Besieged Druids ====

''A elvish school for druids comes under attack by goblins. It seems more than just a routine raid; is there something more sinister behind this attack? - In Beseiged Druids, you control Eärendil, the surviving teacher at the school, and the many and varied initiates. Not all of these are ordinary students; many have been experimenting with other forms of magic, while others are simply overachievers in some area of study. Unfortunately, they are not especially good at combat, at least initially. Together with a very small contingent of surviving guards, it is up to these students to save the island of Aleron from disaster.''

'''Author:''' Celtic Minstrel

'''Status:''' Complete

'''Length:''' 9 scenarios

'''Version:''' 1

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves

'''[http://units.wesnoth.org/1.10/DruidSiege/en_US/celmin-druid-siege.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37342

==== Birth of a Lich ====

''This is the life story of the dreaded lich Malifor, his struggle as a mage outcast, the orcish conquest of the northlands and his transformation to quench the thirst for revenge''

'''Author:''' chak_abhi

'''Status:''' Finished

'''Length:''' 12 playable scenarios / 2 dialogue only

'''Version:''' 1.0.3

'''Difficulty:''' Normal

'''Style:''' Skirmish, Large Battle, Dungeon

'''Faction/Era:''' Human outlaws, dwarves, undead

'''[http://units.wesnoth.org/1.10/Birth_of_a_Lich/en_US/Birth_of_a_Lich.html Custom Units]

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37057

==== Bitter Revenge====

''Amidst the strife and turmoil of the first Dark Age of Wesnoth, a time of transient monarchies and conspiracies against the Crown, the boy Darith witnesses the murder of his father by a general of Wesnoth. Follow Darith's quest for retribution in this treacherous tale of betrayal, deceit, love, remorse, and vengeance.''

'''Author:''' Wonderboy

'''Status:''' Complete

'''Length:''' 11 playable scenarios + 4 dialogue only

'''Version:''' 1.1.0

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Default (mostly outlaws and undead, custom units)

'''Forum:''' http://wesnoth.org/forum/viewtopic.php?f=8&t=26699

==== Cavanagh The Conqueror ====

''This is the tale of Cavanagh Orc-Foundling, who was blessed by the gods to conquer and unite all of the Great Continent. Orcs and elves, gods and men, queens and sorcerers populate this epic tale of revenge and redemption.''

'''Author:''' TheEmptyLord (Programming, Map-making, Editing), Scott_Free(Story)

'''Status:''' WIP

'''Length:''' 10 Playable Scenarios so far

'''Version:''' 0.1.2

'''Difficulty:''' Normal

'''Style:''' Skirmish, limited RPG, limited Large Battle

'''Faction/Era:''' Default (Units from Northerners, Outlaws, Loyalists as well as other factions interspersed. Several custom units.)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=35927

==== Cities of the Frontier ====

''Settle a new town in the wilds north of the Great River.''

''This campaign makes several changes to the standard Wesnoth game mechanics, and focuses on city-building and gold management.''

'''Author:''' esci

'''Status:''' Complete

'''Length:''' Not fixed, approximately 6-10 seasons of 36 turns each
'''Version:''' 0.5.1

'''Difficulty:''' Normal

'''Style:''' Simulation, Survival

'''Faction/Era:''' Default, Loyalist

'''[http://units.wesnoth.org/1.10/Cities_of_the_Frontier/en_US/Cities_of_the_Frontier.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36004

==== Considerate Dead ====

''As the wind goes on and on, people discover necromancer aren't always bad. Made by tribes45 - No scenarios are done, 4 playable out of ??.''

'''Author:''' tribes45 aka tribes55

'''Status:''' Incomplete, unbalanced, abandoned

'''Length:''' 5 scenarios

'''Version:''' .009

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36522

==== Count Kromire ====

''You are the blood son of a vampire lord, however when the might of the celestial crusades comes knocking, and your father is slain, you flee your lands. However you intend to return, to restore the lands of Kromire to the Kromires, to avenge your father, and most importantly, to make sure that no celestial ever dares come into your mountains again.''

'''Author:''' Velensk

'''Maintainer:''' currently none

'''Status:''' Complete

'''Length:''' 9 scenarios

'''Version:''' 1.3.2

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Era of Myths, Vampires

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=21560

==== Dystopia ====

''During the reign of queen Asheviere, the province Annuvin rebelled. You, a royal agent, are sent to stop it.''

'''Author:''' bumbadadabum

'''Maintainer:''' ?

'''Status:''' Broken (does not load at all)

'''Length:''' 5 scenarios

'''Version:''' 0.9.0

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Loyalists

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=35530&p=564646&hilit=dystopia#p514297

==== Elvish Dynasty RPG ====

''You are the new ruler of an elvish kingdom! Can you lead your people to glory? This campaign is highly randomized so it will be different every time you play!''

''Sequel to Ooze Mini-Campaign''

'''Author:''' spencelack

'''Maintainer:''' Wesbane

'''Status:''' Complete

'''Length:''' 10 years, in each year choice between dialogue and fighting scenario (selected out of a large pool of possible scenarios)

'''Version:''' 0.9.9b

'''Difficulty:''' Normal

'''Style:''' RPG, Skirmish

'''Faction/Era:''' Default, Elves

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=28627

==== Fall of Silvium ====

''You are Caius Regilius, Tribune of the province of Silvia, located in the northmost reaches of the Lavinian Empire at the height of its power. But the Empire has overextended itself, The city of Silvium lies seperated from the rest of the Empire by the mountains of Arendia, and is sandwiched between the Marauders and the Sidhe... war is inevitable, and the province of Silvia will almost certainly fall.''

'''Author:''' turin

'''Maintainer:''' UnwiseOwl

'''Status:''' Complete

'''Length:''' 8 scenarios

'''Version:''' 0.6

'''Difficulty:''' Medium

'''Style:''' Skirmish

'''Faction/Era:''' Imperial Era, Lavinian Legion.

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=31&t=24356

'''Note:''' The final level of this campaign is not supposed to be winnable. It's a final blaze of glory and chance to use all your high-powered units, but to 'win' the campaign, you must lose...the ending is similar to a certain mainline campaign, but predates it.

==== Fate of a Princess ====

''Part I: Baldres, a notorious robber baron, flees Wesnoth with his followers and sets off into the northlands to evade the king's justice. The baron's deeds and misdeeds are to change the balance of power between orcs and non-orcs throughout the northlands, and will carry consequences long after his eventual death.''

''Part II: The Greenwood elves face a crisis which demands the return of the queen's estranged half-elven half-sister, Baldres' daughter. Two brave young elves must make a perilous journey to find her and bring her back to her former home. If they fail, the whole northlands will be engulfed in war with the resurgent orcs...''

'''Author:''' SkyOne, mich, Simons Mith

'''Status:''' Finished

'''Length:''' 26-29 scenarios (some dialogue-only), 2 parts

'''Version:''' 0.9.24

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon

'''Faction/Era:''' Default with additions. You play two different, unique cross-faction combinations in each part.

'''[http://units.wesnoth.org/1.10/Fate_of_a_Princess/en_US/Fate_of_a_Princess.html Custom units]'''

'''Required Wesnoth version:''' 1.9.12 or later

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=26327

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Fate_of_a_princess Players’ Review(s)]'''

==== Flight to Freedom ====

''Flight to Freedom chronicles the story of the drake hero Malakar, and his desperate cross-country flight out of slavery.''

'''Authors:''' MadMax, Nova

'''Status:''' Complete

'''Length:''' 20 playable scenarios + 1 dialogue-only

'''Version:''' 5.1.2

'''Difficulty:''' Expert

'''Style:''' Skirmish, Large Battle, Puzzle

'''Faction/Era:''' Drakes

'''Required Wesnoth version:''' 1.11.9 or later

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=1887

==== Forgotten Kingdom ====

''Help Orlog, a troll chieftan, lead his people to safety in the underground and discover an ancient power long forgotten.''

'''Author:''' Limabean

'''Maintainer:''' Chrysophylax

'''Status:''' Incomplete ( but all scenarios playable and balanced )

'''Length:''' 9 playable scenarios + 1 dialogue-only

'''Version:''' 0.1.7

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Goblins, Trolls

'''[http://units.wesnoth.org/1.10/Forgotten_Kingdom/en_US/Forgotten_Kingdom.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=23483

'''Note:''' (Adamant14) This campaign includes a custom Troll line. A good campaign, I hope Limabean and/or Chrysophylax will finish it.

==== Forward they Cried ====

''You are the leader of an advanced detachment that has been tasked with capturing a bridgehead while the main army prepares to attack. It should be a simple enough assignment.''

'''Author:''' Glowing Fish

'''Maintainer:''' 1.10 - Lord-Knightmare; 1.11 - Turuk

'''Status:''' Finished

'''Length:''' 1 scenario ( rather a single scenario than a campaign )

'''Version:''' 1.0.1

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Default Loyalists

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=23656&p=350126&hilit=forward+they+cried#p350126

'''Note:''' (Adamant14) Only a single scenario, but a great scenario.
(UnwiseOwl) You wouldn't want to stop thinking for a turn, and it's good for the first few turns, but this one leaves me wanting more.

==== Galuldur's First Journey ====

''While the belligerence of orcs is nothing new, their intensifying attacks on a fledgling colony of elves in Pindir Forest begin to show signs of a deeper malice, forcing Galuldur, the young son of the colony's adventurous founder Galur, to venture out of his forest's friendly trees in search of help. His simple errand quickly turns into a frantic quest to unearth the roots of the mysterious evil threatening his people. As you lead him through unknown lands, Galuldur, forced to match wits with unexpected adversaries at nearly every turn in a desperate attempt to save his world, quickly learns that the world is neither a friendly nor a simple place.''

'''Author:''' mattsc

'''Status:''' Complete

'''Length:''' 8-9 scenarios

'''Version:''' 1.1.1

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves

'''[http://units.wesnoth.org/1.10/Galuldur/en_US/Galuldur.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=31895

==== Girl unDead ====

''A little undead girl fights against the Kingdom.''

'''Author:''' tapaboy

'''Status:''' Complete

'''Length:''' 14 playable scenarios

'''Version: ''' 1.0.1

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default undead,elves

'''[http://units.wesnoth.org/1.10/Girl_unDead/en_US/Girl_unDead.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37458

==== Grnk the Mighty ====

''All his life, puny little goblin Grnk the Frail had been dreaming about leaving the orcs and starting a better life. When he finally arrives in the human town of Shmaltupp, he realizes that the world is not as black and white as he had imagined. He also discovers that he is no ordinary goblin. Follow Grnk the Frail on his path to becoming Grnk the Mighty.''

'''Author:''' mattsc

'''Status:''' Part I complete

'''Length:''' 13 scenarios

'''Version:''' 1.0.5

'''Difficulty:''' Hard

'''Style:''' Skirmish, RPG

'''Faction/Era:''' Default, changing (no standard army building gameplay)

'''[http://units.wesnoth.org/1.10/Grnk/en_US/Grnk.html Custom units]'''

'''Required Wesnoth version:''' 1.9.5 or later

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=34970

==== Hunter ====

''This is a story. Not about a hunter. About thé Hunter.''

'''Author:''' Thor the God

'''Status:''' WIP

'''Length:''' 4 scenario (unfinished ?)

'''Version: ''' 0.0.1

'''Difficulty:''' easy, unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default

'''Forum:''' no forum thread

==== Inky's Quest ====

''The Cuttlefish Campaign
Are the cuttlefish mere beasts or something more? What stories would they tell if they could speak? This story provides one possible answer.The easiest difficulty provides hints for novice players.''

'''Author:''' Telchin

'''Status:''' Complete

'''Length:''' 12 scenarios + story-only epilogue

'''Version:''' 1.3.0

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Custom units (cuttlefish, tentacles, giant clams...). Enemies use both default era units and custom ones.

'''[http://units.wesnoth.org/1.10/Inky_Quest/en_US/Inky_Quest.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=32501

==== Invasion from the Unknown ====

''Episode I - Seeking the Light: Long after the Fall, the last forest elves are forced to abandon their safe valley, and find themselves resorting to the dark means of necromancy in order to survive the perils and challenges of this new harsh world. May they finally free the Great Continent from its chaos, or perish in the foolish attempt of restoring peace and life to the lands.''

''Episode II - Armageddon: As the shadow of Chaos covers the entire continent, an assorted group of foolish heroes prepares a counter-attack to the Empire, with one unique goal in their minds: defeat the evil Emperor, whoever it is. Lead these courageous living and non-living warriors to victory, and rediscover lost secrets of the history.''

'''Author:''' shadowmaster

'''Maintainer:''' Espreon

'''Status:''' Finished

'''Length:''' 26 scenarios in two episodes

'''Version:''' 1.90.6

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon, Boss battle

'''Faction/Era:''' Unique. You play Elves and Undead throughout the campaign + in the 2nd part Northerners and Aragwaithi.

''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Invasion_from_the_Unknown Players’ Review(s)]'''

==== Invasion of Eliador ====

''A peaceful island is about to be invaded by unknadd-ons foes travelling towards the eastern shore. It is up to a family of outlaws to warn the island's inhabitants before it's too late.''

'''Author:''' Sam M. (Genosuke)

'''Maintainer:''' trewe

'''Status:''' Complete

'''Length:''' 10 scenarios + epilogue

'''Version:''' 1.0.4

'''Style:''' RPG, Skirmish, Puzzle

'''Difficulty:''' Easy

'''Faction:''' Default (outlaws)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=6556

'''Wiki:''' [[Invasion_of_Eliador]]

==== King ====

''The adventure started when a simple man who was living far from Wesnoth discovered that he is the next king.''

'''Author:''' Alexjercan

'''Maintainer:''' -

'''Status:''' Broken, Unbalanced, Unfinished

'''Length:''' 14 scenarios

'''Version:''' 1.0.1

'''Style:''' Skirmish

'''Difficulty:''' Unbalanced

'''Faction:''' Default

'''Forum:''' no forum thread

Note: (Adamant14) This campaign should be removed from the server (broken, no progress, no maintainer)

==== Langrisser Sample Campaign ====

''The Imperial Knights of the Rayguard Empire have disrupted the peace of the village that was Hein's hometown, seeking only a girl named Liana. Fight to rescue Liana.''

'''Author:''' Morath

'''Status:''' Finished

'''Length:''' 1 playable scenario

'''Version:''' 0.1.0.5

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36417&hilit=Langrisser

'''Wikipedia:''' [http://en.wikipedia.org/wiki/Langrisser What is Langrisser]

'''Note:''' (Adamant14) Single scenario, different from usual Wesnoth behaviour.

==== Legend of Far North ====

''The tale of the legendary Black Eye Karun,depicting his rise to power, his successes and his brutal assassination.'

'''Author:''' chak_abhi

'''Status:''' Finished

'''Length:''' 16 playable scenarios / 1 dialogue only,1 cutscene

'''Version:''' 1.0.2

'''Difficulty:''' Normal

'''Style:''' Skirmish, Large Battle

'''Faction/Era:''' Orcs, Trolls, Saurians, Nagas

'''[http://units.wesnoth.org/1.10/Legend_of_Far_North/en_US/Legend_of_Far_North.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=34769

==== Legend of the Invincibles ====

'''''Part I: Shrouded in Darkness''' (5 chapters, 90 scenarios) - A pair of heroes, after stopping an orcish thread, are outcast into caves, where they have no other choice than to become liches in order to survive. They preserved their original appearance and moral principles, and fight in various skirmishes against evil (although using evil methods sometimes), until the Fall, when they are buried alive under the ashes of the third sun.''

'''''Part II: Into the Light''' (5 chapters, 110 scenarios) - Long after the Fall, the lich heroes awaken. Searching for more power, they manage to resurrect themselves as living beings, but this time more powerful and ridden of the evil within. But the evil from inside them did not cease to exist, and started a campaign to conquer the world. Stopping the campaign caused an even worse disaster...''

'''Author:''' Dugi

'''Status:''' complete

'''Length:''' 200 (+8 talk-only) scenarios

'''Version:''' 3.0.1

'''Difficulty:''' Normal

'''Style:''' mostly Skirmish and Dungeon (all other styles are present as well, but less frequently)

'''Faction/Era:''' Elves, Loyalists, Undead, Dwarves; but they advance past their usual maximum level

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Legends_of_the_Invincibles Players’ Review(s)]'''

'''Note:''' The most unique feature of this campaign is its RPG-like unit development system, enemies drop items units can use, leaders are stronger than most usual units and all units get AMLA (after maximum level advancement) after reaching their maximum level (that is also increased by a load of additional level 4 units).

==== Merry Christmas ====

''Santa's elfs have to travel south into Lintanir Forest to collect Christmas trees.''

'''Author:''' Desert_Shyde

'''Status:''' Finished

'''Length:''' 3 playable scenarios

'''Version:''' 1.1.2

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Custom

'''[http://units.wesnoth.org/1.10/Merry_Christmas/en_US/merry_christmas.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=32519

==== Only Death Behind ====

''Legends of the Emerald Forest, chapter II: Only Death Behind.''

''Three ghosts have escaped from the land of the dead. Yet they don't remember anything about their past.''

''This is an Undead campaign that references certain characters and events from 'The Flight of Drakes', yet it can be played separately.''

'''Author:''' NoQ

'''Status:''' Complete

'''Length:''' 7 playable scenarios / 1 talk only

'''Version:''' 1.0.0

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Undead

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=39119&p=556996#p556996

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Only_Death_Behind Player's Review]'''

'''Note:''' (Adamant14) A short and unusual undead campaign, you play with just a few units. Playable in a few hours, nevertheless it is fun to play.

==== Panther Lord ====

''The Imperialists ambitions of pushing into the Sea States have been repeatedly thwarted and now they turn their attentions elsewhere. You are an outcast Darklander now living as a mercenary in the Sea States and the rumors you hear indicate that they will be coming to your people. Though an outcast you do not wish to see them subjugated. The spirit whose friendship caused you to be an outcast has a plan that might allow you to save them.''

'''Author:''' Velensk

'''Maintainer:''' Lavender

'''Status:''' Finished

'''Length:''' 14 scenarios

'''Version:''' 1.0.2

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Era of Four Moons, Darklanders (+ a wide variety of mercenaries)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=34318

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Panther_Lord Players’ Review(s)]'''

==== Random Campaign ====

''Gain experience playing the Default Era faction of your choice in a campaign setting''

'''Author:''' SigurdFireDragon

'''Status:''' Complete

'''Length:''' 7 playable scenarios

'''Version:''' 1.0.0

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Age of Heroes, & Era of Legends

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=32922

'''Note:''' (Author) A 4 scenario version is under the multiplayer button, which lets you choose any era.
Intended for players to gain practice with a faction and learn sound strategies using faction specific adjustments against random factions from the chosen era.

==== Rebellion in the North ====

''A great orcish uprising tends to destabilise the Northlands. As the future Lord Protector of the Northern Alliance you have to crush the rebellion and establish peace again."

'''Author:''' chak_abhi

'''Status:''' Finished

'''Length:''' 24 playable scenarios / 3 dialogue only,2 cutscenes

'''Version:''' 1.1.12

'''Difficulty:''' Normal

'''Style:''' Skirmish, Large Battle

'''Faction/Era:''' Loyalists, Dwarves, Gryphons, Merfolk

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=33059

==== Return of the Monster ====

''It was time for Amailoss, born from the naga queen's last egg, to leave home. Time for him to grow into a leader in his own right, and eventually become the guardian and leader of another naga city. But along the way, he became friends with an unusual mud-crawler, they met a strange young monster, discovered that a spirit had escaped from an orc prison, and the mystery of that spirit became a grave challenge for Amailoss and the many races in the region....''

''A naga campaign, involving elves, orcs, saurians, turtle-like races, and some monsters.''

'''Author:''' SkyOne

'''Status:''' Complete

'''Length:''' 16 playable, 2 dialog scenarios

'''Version:''' 0.7.1

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon

'''Faction/Era:''' Default with additions. You play a custom naga faction and carapaces (a turtle-like race).

'''[http://units.wesnoth.org/1.10/Return_of_the_Monster/en_US/Return_of_the_Monster.html Custom units]'''

'''Required Wesnoth version:''' 1.10.x

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36438

==== Return to Noelren ====

''A story in the first Dark Age of Wesnoth. See how various heroes stick together to shun the threat of black magics, restore the secret kingdom of Noelren and install Garard I on the throne of Wesnoth. This campaign features complex scenarios, unusual objectives and units, emphasizing more on story and adventures than hardcore fighting.''

'''Author:''' Pyrophorus

'''Status:''' Complete.

'''Length:''' 26 scenarios + 7 cut scenes

'''Version: ''' 0.7.6

'''Requirements:''' BfW 1.10 (not tested on 1.11)

'''Difficulty:''' Easy, unbalanced

'''Style:''' Skirmish, RPG, Large Battle, Simulation

'''Faction/Era:''' Default + custom units

'''[http://units.wesnoth.org/1.10/ReturnToNoelren/en_US/ReturnToNoelren.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=34685#p501026

'''Note:''' (Adamant14) I never saw so much fantastic and new ideas in one single UMC, wow!

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Return_to_Noelren Players’ Review(s)]'''

==== Return to Ruins ====

''The humble farmers of Vertegris are summoned by Erik the General of Weldyn to put an end to an orcish raiding party. If they knew what would befall their former home... They never would have left. This is a relatively short campaign with 8 scenarios, It is still undergoing changes.''

'''Author:''' Jeff Stevens (Ulfsark)

'''Composer:''' Paul Fredericks (paulfredericksmusic.com)

'''Status:''' Complete

'''Length:''' 7 scenarios + 1 dialogue-only

'''Version:''' 0.5.1

'''Difficulty:''' Easy,Normal,Hard

'''Style:''' Skirmish

'''Faction/Era:''' Default,(Loyalists, Outlaws)

'''Required Wesnoth version:''' 1.10.x

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37790&sid=9059f18497cda1219f42a626544d0ffd&p=540646#p540646

'''Note:''' (Adamant14) You play a short campaign with just a few units. Playable in a few hours, nevertheless it is fun to play.

==== Salt Wars ====

''Introductory campaign for the Era of Four Moons.''

''As an officer of one of the Sea States you must defend your organization from aggressive rivals.''

'''Author:''' Velensk

'''Maintainer:''' Lavender

'''Status:''' Complete

'''Length:''' 5 scenarios

'''Version:''' 0.2.1

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Era of Four Moons, Sea States

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=31498

==== Saving Elensefar ====

''Meneldur, elvish mariner of Elensefar, is driven to sea by the same orcs who attacked the city. He must gather an army willing to fight for him to regain Elensefar, his adopted homeland.''

'''Author:''' Turin

'''Maintainer:''' trewe

'''Status:''' Finished

'''Length:''' 1 year (around 12 scenarios)

'''Version:''' 1.5.2

'''Difficulty:''' Normal

'''Style:''' Skirmish, RPG, Simulation

'''Faction:''' Default Era

'''Forum:''' http://wesnoth.org/forum/viewtopic.php?t=3072&start=0

'''Wiki:''' [[Saving_Elensefar]]

'''Note:''' Labeled as Expert, recruit list changes in all scenarios.

==== Shameless Crossover Excuse ====

''Fugitive dark sorcerer Gwiti Ha'atel discovers he has the power to mess with Wesnoth's continuity. His quest for revenge on the NPCs who have used his portraits will lead him through perils untold and in-jokes unnumbered, but shall pale before the horror he finds at his quest's end.''

'''Author:''' Orcish Shyde, Mountain_King

'''Status:''' Complete

'''Length:''' 9 scenarios

'''Version:''' 1.1.0

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction:''' Undead

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=32016&start=15

==== Swamplings ====

''Banished by Yushnak the Ponderer, a tribe of lowly swamp goblins endure in the deadly mire of Pogo Bog. Four centuries before the founding of Wesnoth, this is the story of the goblins' struggle against the intrigues and betrayals of the greater races, and the rise of the first wolf rider.''

'''Author:''' John Rawlins (boru)

'''Status:''' Complete

'''Length:''' 14 scenarios

'''Version:''' 1.1.7n

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction:''' Goblins

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=29784

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Swamplings Players’ Review(s)]'''

==== Swamp Witch's Curse ====

''A Faerie tale form the World of Four Moons.''

'''Author:''' Velensk

'''Status:''' Complete

'''Length:''' 9 scenarios

'''Version:''' 1.0

'''Difficulty:''' Expert

'''Style:''' Skirmish

'''Faction:''' Freemen

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=40467

==== Talentless Mage====

''Humorous and silly campaign about mage apprentice who has managed to learn only one simple spell in thirty years.''

'''Author:''' Wonderboy

'''Status:''' Complete

'''Length:''' 11 playable scenarios + 3 dialogue scenarios

'''Version:''' 1.1.0

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Noob Faction

'''[http://units.wesnoth.org/1.10/Talentless_Mage/en_US/Talentless%20Mage.html Custom Units]'''

'''Forum:''' http://wesnoth.org/forum/viewtopic.php?f=8&t=27608]

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Talentless_Mage Players’ Review(s)]'''

==== The Attack of the Western Cavalry ====

''The story of the century's biggest invasion from the West. A story with the destiny of Wesnoth depending on your decisions; save, or remove it?''

'''Author & Maintainer:''' WhiteWolf

'''Status:''' Under development, second beta phase

'''Length:''' 18, 19 or 20 maps, depending on your decisions

'''Version:''' 1.1.7beta"

'''Difficulty:''' Intermediate

'''Style:''' Mixed (Large battle & Stimulation & RPG & Skirmish)

'''Faction/Era:''' Custom, mixed (undead & human & elvish & custom)

'''Forum/Feedback:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36294

==== The Blind Sentinel ====

''The story of a mysterious soldier, the Blind Sentinel, and the wilds of the North, the Nightbrethren. Will Wesnoth vanquish the appreaching Doom? It only depends on you, the Player...''

'''Author:''' WhiteWolf

'''Status:''' Under development, first beta phase

'''Length:''' 29 maps (26 playable) + bonus map (still experimental)

'''Version:''' 1.1.3beta"

'''Difficulty:''' Intermediate/Expert

'''Style:''' Mixed/Custom

'''Faction/Era:''' Humans,Undead,Custom

'''Forum/Feedback:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=39269

==== The Dark Alliance ====

''Prince Terhar lived two years with elves. Little did he expect what would happen when he returned back to Weldyn.''

'''Author:''' Wonderboy

'''Status:''' Complete

'''Length:''' 11 or 10 playable scenarios depending on the branch you take (+ 5 dialogue scenarios)

'''Version:''' 1.0.3"

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Default: Recruit list changes in almost every scenario

'''[http://units.wesnoth.org/1.10/The_Dark_Alliance/en_US/The%20Dark%20Alliance.html Custom Units]'''

'''Forum:''' http://wesnoth.org/forum/viewtopic.php?f=8&t=26924

==== The Dark Hordes ====

''Lead fugitive dark sorcerer Gwiti Ha’atel to mastery of the undead hordes.''

'''Author:''' Circon

'''Maintainer:''' Various

'''Status:''' Incomplete/WIP

'''Length:''' 11/?

'''Version: '''

'''Requirements:'''

'''Difficulty:'''

'''Style:''' Skirmish

'''Faction/Era:''' Default undead

'''[http://units.wesnoth.org/1.10/The_Dark_Hordes/en_US/The_Dark_Hordes_1.html Custom Units]'''

'''Walkthrough:''' [[TheDarkHordes]]

'''Forum:''' [[http://forums.wesnoth.org/viewtopic.php?f=8&t=16576&]]

==== The Devil's Flute ====

''Creona, the well-known assassin, gets a strange job from a strange person. So, in fact, it's no surprise that things take a strange turn...''

'''Author:''' lipk

'''Status:''' Complete, unmaintained

'''Length:''' 10 scenarios

'''Version:''' 0.1.4c

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish, Minigames

'''[http://units.wesnoth.org/1.10/The_Devils_Flute/en_US/The_Devils_Flute.html Custom Units]'''

'''Faction/Era:''' Outlaws

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36044

==== The Earth's Gut ====

''The year is 515YW. You are the young dwarven leader Hamel. Your tribe in the caves of Knalga is under pressure from its enemies, and resources are growing scarce. In order to forge the weapons required to resist your enemies, you must set forth and collect what ores and minerals remain.''

'''Author:''' Anonymissimus

'''Maintainer:''' Anonymissimus

'''Status:''' WIP, story is unfinished (I didn't add any scenario since long, but that doesn't mean nothing is added to the campaign. My addons tend to be in good shape and bug-free which means also WIP as I'm updating it since 1.4 days.)

'''Length:''' 23 scenarios, 5 of which are cutscene only, some others have changing objectives

'''Version:''' 0.2.14

'''Difficulty:''' Normal

'''Style:''' Dungeon, Skirmish

'''Faction/Era:''' Default, dwarves, woses, mages, a few custom units

'''[http://units.wesnoth.org/1.10/The_Earths_Gut/en_US/the_earths_gut.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=26800

'''Note:''' This campaign is a "Dwarvish dungeon crawler" (It currently contains about as many surface scenarios as underground though.) and is intended to be challenging for experienced players on hard whilst suitably easy on easy. I develop the campaign with the wesnoth development version and I advise to play with that, but it is intended to work almost equally well with the stable wesnoth version (except for features only available in the wesnoth development version).

==== The Epic of Vaniyera ====

''The expansionist Lavinian Legion, led by the Imperator himself, has invaded the northern forests of the Sidhe, or Wild Elves. It is up to Leithan the Thunderblade and his advisor Vaniyera to push its armies back where they came from...''

'''Author:''' oreb, turin

'''Maintainer:''' UnwiseOwl

'''Status:''' Complete

'''Length:''' 6 scenarios

'''Version:''' 0.9.0

'''Difficulty:''' Hard (Don't be fooled by "novice level" in the campaign description, this one is very hard.)

'''Note:''' (Maintainer) Working on this issue, the next release (due at the end of November, hah!) should bring easy difficulty back to the level of a reasonable introduction to the IE, while the hard difficulty will also become slightly easier. With any luck, this will be the last release before version 1.0 of the campaign].

'''Style:''' Skirmish

'''Faction/Era:''' Imperial Era, Sidhe.

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=19490

==== The Fall of Wesnoth ====

''As the beloved human empire of Wesnoth becomes lazy and arrogant in its peaceful state of happiness, Emperor Dantair demands the creation of another sun in a bid to destroy all evil. Or is it all for a different purpose? A man named Alitar sees it that way, and now he must survive the most evil inhabited lands if he is to stop chaos from rising, and Wesnoth from falling... This is the story of The Fall of Wesnoth.''

'''Author:''' Pewskeepski

'''Status:''' 1st part complete, 2nd WIP.

'''Length:''' 10 playable scenarios

'''Version:''' 1.0.8

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Outlaws

'''[http://units.wesnoth.org/1.10/The_Fall_of_Wesnoth/en_US/The_Fall_of_Wesnoth-1.html Custom units]'''

==== The Flight of Drakes ====

''Legends of the Emerald Forest, chapter I: The Flight of Drakes.

''Follow drake king Klader on his quest to find the Crown of Light, a legendary artifact from pre-historic times.''

''This campaign is the first chapter of a trilogy; the second chapter is an Undead campaign and it's called 'Only Death Behind'.''

'''Author:''' NoQ

'''Status:''' Finished

'''Length:''' 7 playable scenarios / 2 talk only

'''Version:''' 1.1.2

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Drakes

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37981

==== The Founding of Borstep ====

''The chieftain of your tribe has become decadent and weak. Take over, and lead your people to a better home--whether it is already occupied or not. The Northlands in year 9W are a barbaric place, but anyone who stands in your way will learn the power of orcs!''

'''Author:''' beetlenaut

'''Status:''' Complete

'''Length:''' 10 and 1 dialogue only

'''Version:''' 1.1.1b

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Default, Northerners

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=29264

'''[http://units.wesnoth.org/1.10/The_Founding_of_Borstep/en_US/The_Founding_of_Borstep.html Custom units]'''

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#The_Founding_of_Borstep Player's Review]'''

'''Note:''' (Kanzil) I find the protagonist hard to sympathise with. Also, most scenarios contain interesting twists. For example, in one, each time you killed a boar it gives you extra health.

'''Note:''' (beetlenaut--author) In most Orcish campaigns the leader is heroic or just wants peace. Krag-Ubor wants plunder and battle like all enemy Orcs in other campaigns. I ''hope'' you don't sympathize too strongly, but I don't think you need to in order to enjoy the game play.

==== The Great Invasion ====

''Argon, a great ruler, Jer, a simple peasant, Gorn, a dwarvish lord, and Elon, an Elvish High Lord, Were fighting against the darkness.13 Scenario some are difficult''

'''Author:''' Alexjercan

'''Maintainer:''' -

'''Status:''' Broken

'''Length:''' 9 "playable" scenarios + 3 talk scenarios

'''Version:''' 1.0.0

'''Style:''' Skirmish

'''Difficulty:''' Unbalanced

'''Faction:''' Default

'''Forum:''' no forum thread

Note: (Adamant14) This campaign should be removed from the server (broken, no progress, no maintainer)

==== The Legend Begins ====

''The tale of Jahin, the greatest hero the land of Arkenova, or perhaps the world of Irdya, had ever known. Watch his legend unfold before your very eyes.''

'''Author:''' Tahsin Jahin Khalid (Lord-Knightmare)

'''Status:''' Complete

'''Length:''' 73 scenarios divided into 3 episodes. Continuation from one episode to the next one is possible, but not recommended.

Episode 1 - 28 scenarios

Episode 2 - 26 scenarios

Episode 3 - 20 scenarios

'''Version:''' 0.5.2

'''Requirements:''' ''War of Legends'' is required to be installed. Latest version recommended.

'''Difficulty:''' Intermediate

'''Style:''' skirmishes, survivals, large battles, dungeons, boss battles

'''Faction/Era:''' [http://units.wesnoth.org/trunk/mainline/en_US/era_default.html Default], [http://units.wesnoth.org/trunk/War_of_Legends/en_US/war_of_legends.html War of Legends]

'''Custom units:''' [http://units.wesnoth.org/trunk/The_Legend_Begins/en_US/The_Legend_Begins-E1.html Custom Units]

'''Forum:''' [http://forums.wesnoth.org/viewtopic.php?f=8&t=37424 Click Here]

'''Notes:'''

----

==== The Library of Kratemaqht ====

''An ancient story from the old continent.''

'''Author:''' Rich Marinaccio (cephalo)

'''Status:''' Complete

'''Length:''' 17 scenarios

'''Version:''' 1.0.0

'''Difficulty:''' Unbalanced (some scenarios are Easy - some rather Hard)

'''Style:''' Skirmish, RPG

'''Faction/Era:''' Loyalists and custom units.

'''[http://units.wesnoth.org/1.10/Library_Of_Kratemaqht/en_US/The_Library_Of_Kratemaqht.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37798

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#The_Library_of_Kratemaqht Players’ Review(s)]'''

'''Notes:''' (Adamant14) This campaign has a thought-out story, shows a great love for detail;
It includes a great custom Dragon, some brilliant custom images (fire, burning houses, burning forest) that makes the scenery / maps look very nice.

==== The Militia ====

''The Travels of a group of Peasants and their Friends; a level 0 campaign that does not focus on a singular hero.''

'''Author:''' Desert_Shyde

'''Status:''' Finished

'''Length:''' 15 scenarios

'''Version:''' 1.5.1

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default

'''[http://units.wesnoth.org/1.10/The_Militia/en_US/the_militia.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?t=30294

==== The Roar of the Woses ====

''When the construction of a dam threatens the existence of her home, Kylix is forced on a journey to stop it.''

'''Author:''' Alarantalara

'''Status:''' Finished

'''Length:''' 10-11 scenarios + 1 dialogue-only

'''Version:''' 1.2.7

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default with Additions (primarily Saurians, Nagas, Woses)

'''[http://units.wesnoth.org/1.10/Roar_of_the_Woses/en_US/Swamp_Rage.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=29830

'''Note:''' (author) Potentially unbalanced on Hard difficulty due to experiments with non-standard ways to increase difficulty. This issue does not exist on the lower difficulty levels.

==== The Three Elves ====

''Three elves have just begun their adventure in the northern swampland. Will they become heroes or will they be responsible for another undead expansion?''

'''Author:''' Stanislav Hoferek

'''Maintainer:''' trewe

'''Status:''' Complete

'''Length:''' 8 scenarios + 2 dialogue

'''Version:''' 0.9

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction:''' Default (Elves)

'''Forum:''' (does it have one?)

==== The Sojournings of Grog ====

''Grog (as starred in Under the Burning Suns) goes home.''

'''Author:''' Peter Christopher, Thomas Hockings

'''Maintainer:''' Elvish_Hunter

'''Status:''' Finished

'''Length:''' 18 playable scenarios in 2 parts

'''Version:''' 3.0.1

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon, Large Battle

'''[http://units.wesnoth.org/1.10/The_Sojournings_of_Grog/en_US/The_Sojournings_of_Grog.html Custom units]'''

'''Faction/Era:''' Default. Most of the time you play trolls and some desert elves accompanying Grog.

==== The Unstoppable Legion ====

''Horseback campaign. The kingdom of Suveran, far away from Wesnoth, is under attack. Only Deuterus, a Great Druid, knows their weakness and only Viktor, a young noble, dares go on the quest to stop them.''

'''Author:''' Chris Neville-Smith (Chris NS)

'''Maintainer:''' Chris Neville-Smith (Chris NS)

'''Status:''' WIP

'''Length:''' Currently 15 playable sceanrios, including a fork of three paths near the beginning, and another fork of two paths later on.

'''Version:''' 0.8.7

'''Difficulty:''' Normal

'''Style:''' Mainly Skirmish

'''[http://units.wesnoth.org/1.10/The_Unstoppable_Legion/en_US/The_Unstoppable_Legion.html Custom units]'''

'''Faction/Era:''' Play mounted units, including expanded Cavalryman line, and completely new Bowrider line. Joined later by Dwarves. Main enemies are the dark fighters and dark cultists.

==== The White Troll ====

''The story of a white troll whelp with strange magic powers, who is raised in an elvish village.''

'''Author:''' Wesnoth Italian Forum

'''Status:''' Complete

'''Length:''' 8 scenarios

'''Version:''' 1.0.0

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default: you play with elves and trolls. Also features custom units with special advancements and abilities.

'''[http://units.wesnoth.org/1.10/White_Troll/en_US/white_troll.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=38828

==== To Lands Unknown ====

''This is the story of Mehir, the Summoner, and his journey to lands unknown.''

'''Author:''' inferno8

'''Status:''' Complete

'''Length:''' 20 scenarios, 4 dialogue only

'''Version:''' 1.6.0

'''Difficulty:''' Intermediate (Era of Magic)

'''Style''': Skirmish, Dungeon

'''Era:''' Era of Magic

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=31799

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#To_Lands_Unknown Players’ Review(s)]'''

==== Up from Slavery ====

''The Orcei are captives in the imperial city of Lavinium, gladiators performing for the emperor Optus Maximus. All it will take, however, is one orc to lead his people to freedom. The Samnis called Sparxus may be that orc.''

'''Author:''' turin

'''Maintainer:''' UnwiseOwl

'''Status:''' Complete

'''Length:''' 7 scenarios

'''Version:''' 0.6.0

'''Difficulty:''' Normal

'''Style:''' Skirmish, Arena (= No recruit, small group gladiator fights)

'''Faction/Era:''' Imperial Era, Orcei Gladiatores

'''Note:''' (Maintainer) At some point, I am intending to completely re-work this campaign to be a multi-player campaign, with one side led by Sparxus and one by Gravirivus. If anyone would like to take this on or has ideas for how to accomplish this, let us know. Nevertheless, its playable as a single player campaign now with some nice ideas that could be developed further.]

==== Warmaster ====

''One day the scout of your king brings a mysterious little stone, called Zrai-Stone, back from one of his trips. Soon that stone causes a lot of trouble...''

'''Author:''' Conkinator

'''Maintainer:''' trewe

'''Status:''' Finished

'''Length:''' 16 battle + 2 bonus + 1 epilogue scenarios

'''Version:''' 1.3.5

'''Difficulty:''' Hard

'''Faction:''' Default (loyalists)

'''Style:''' Skirmish, Survival

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=15527

==== Way of Dragon ====

''The story of what might happen if a person against his will transform into a dragon...''

'''Author:''' DrakeDragon

'''Status:''' Complete

'''Length:''' 7 playable scenarios + 1 dialogue-only

'''Version:''' 1.2.0

'''Difficulty:''' Normal

'''Style:''' Skirmish/RPG

'''Faction/Era:''' Default Loyalists

'''Forum:''' [http://forums.wesnoth.org/viewtopic.php?f=8&t=37876 Wesnoth Forum] [http://uporoom.ru/index.php/topic,179.0.html Russian Forum]

'''Note:''' (Adamant14) Promising short campaign, you play with just a few units.

=== Eras ===

==== Era of Four Moons ====

An era based of the cultures in fictional world Ialfa. There are a core set of four which have had the blunt of the balancing effort put into them, and an additional four which represent other parts of the world and are not complete or balanced.

'''Author:''' Velensk

'''Status:'''

'''Faction Descriptions:''' The four core factions are:

-The Highlanders (Chaotic/Neutral): A nomadic people living along the savanna and steppes. Units generally have high hp and low resistances and good movement and defense in the hills. Features cheap mobile infantry and recruitable level 2 Elephants that act as a living battering ram.

-The Imperialists (Lawful): A massive oligarchy centered around an emperor and his house. Most units do well in the open and not well in forests. Can create durable positions and hold open ground exceptionally well but most units do not inflict a lot of damage. Features units with 50% defense in the open and suicidal units.

-The Sea States (Lawful/Neutral): A collation of small mercantile city states. Can field a variety of versatile units with no exceptional strengths or weaknesses.

-The Darklanders (Chaotic): A society of tribal Jungle people. Units generally have low hitpoints but good defense and movement in forests. Features very efficient melee power and access to both slows and berserk.

The other factions are:

-The Dalefolk (Neutral): A cluster of rural settlements known for it's magicians and inventors: Most units do exceptionally well in mountains. Features some good defensive units, the shapeshifter (who changes form depending on terrain), and a powerful melee magician.

-The Pygmies (Chaotic): A strange race of tiny jungle dwellers shrouded in mystery: Most units do very well in forests and swamps and are very dodgy at the cost of experience points. Also, most units will heal themselves slightly over time. Feature effective mobile level 0s and many powerful support units.

-The Whites (Chaotic/Neutral): Barbarians from another continent: Units are generally mobile and fight well in any rough terrain but low on hp. Feature powerful magicians and a steadfast berserker.

-The Freemen (Lawful): A society of desert dwellers split between the city dwellers and the nomads. Units tend to be durable and adept in deserts and hills and not as good in forests. Features units with stun and recruitable level 2 rocs.

'''Version: ''' 0.4.1

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=19&t=30513

==== War of Legends ====
* Description: An era based on the continent of Arkenova as well as other parts of Irdya.

* Author: Tahsin Jahin Khalid (Lord-Knyghtmare)

* Maintainer: Tahsin Jahin Khalid (Lord-Knyghtmare)

* Status: Finished

* Faction Descriptions: (Descriptions to be added later)

01. Aragwaithi

02. Windsong

03. Human Alliance

04. Orcish Union

05. Southerners

06. Outlaws

07. Elementals

08. Undead

09. Drakes

10. Dark Legion

11. Sylvans

12. Minotaurs

13. Vampires

* Version: 1.1.5.1

* Forum: [http://forums.wesnoth.org/viewtopic.php?f=19&t=30087 Development and Feedback Thread]

== Battle for Wesnoth 1.11.x - development ==

=== Campaigns ===

''Please note: Battle for Wesnoth 1.11.0 features a bug that messes up the selection of difficulty levels.''

==== A Gryphon's Tale ====

''A Gryphon's Tale tells the story of a community of civilized Gryphons, and of Neliflua, an ambitious young female among them who falls into unusual circumstances.''

'''Author:''' Ringcaat/Dwarven_Void

'''Status:''' One branch complete, most incomplete

'''Length:''' 11-12 scenarios (branch dependent)

'''Version:''' 0.6.12

'''Difficulty:''' Easy

'''Style:''' RPG/minigames

'''Faction/Era:''' Gryphon/Orc

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=2906&start=195&

==== After the Storm ====

''Follow the journey of Galas and his band following the events of Invasion from the Unknown''

'''Author:''' shadowmaster/ShikadiLord

'''Status:''' Finished

'''Length:''' 3 episodes of 13 scenarios each, some of which are multi-part

'''Version:''' 0.9.9

'''Difficulty:''' Medium-hard

'''Style:''' Skirmish, Boss Battle, Dungeon

'''Faction/Era:''' Many custom units

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=32091

'''Note:''' (vultraz) Long, very enjoyable campaign with great story. (Knyghtmare) The best UMC campaign ever!

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#After_the_Storm Players’ Review(s)]'''

==== Antar, Son of Rheor ====

''This is the story about a young Lord and his first mission; sent by his father the young Lord Antar has to relieve his neighbours; he has to convince the Elves and Dwarves to ally him; he has to fight against hordes of Orcs and Endless Undead; and finally he has to defeat Mal Kazur, the mastermind who is behind all the evil.''

'''Author:''' Adamant14

'''Status:''' WIP

'''Length:''' 10 playable scenarios / 1 cutscene

'''Version:''' 0.10.2

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Loyalists and Elves (feat. fencer as main hero + various allies)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36075

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Antar.2C_Son_of_Rheor Players’ Review(s)]'''

'''Note:''' (Adamant14) The campaign does not work with BfW version 1.11.0, or BfW version 1.11.1, so please use BfW version 1.11.2 or later!

==== A Song of Fire (The Dragon Trilogy, Part I) ====

''''''Part I: The Last War''' - In a long-forgotten era, at the heart of the Great Continent, an ancestral evil is awakened, threatening to destroy the whole world. Follow young Myra in the war that will alter the future of Irdya and its peoples forever.''

''''''Part II: Towards the Rising Sun''' - After the vicious Last War, Myra has become the new leader of Aragwaithi and Windsong alike. Albeit young and shaken by many losses, she must steel herself to lead her people through the vast and hostile Hannuk Steppes. However, her journey will take them all farther than in their wildest dreams. Furthermore, Myra must deal with the evil influence of the mysterious red gem she found after the last battle.''

''''''Part III: Raging Skies''' - The refugees have finally found a new home: families are built, allies are made and, for the first time in years, Myra and her friends know peace. However, when everything seems normal, ambition and thirst for power cause the break out of a continental war. And, amidst this new storm, an old foe rises agan, more powerful than ever. Witness the end of the song of Irdya's first great heroine.''

'''Author:''' revansurik

'''Status:''' Complete

'''Length:''' 36 scenarios

'''Version:''' 0.4.7

'''Difficulty:''' Normal

'''Style:''' Skirmish, Large Battle

'''Faction/Era:''' Default+War of Legends

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=38210

==== A Vision Blinded ====

''Defend the northern forest against what appeared like a routine orcish raid, and unravel the greater conspiracies that lie below its waves.''

'''Author:''' LemonTea

'''Maintainer:''' Adamant14

'''Status:''' Complete

'''Length:''' 13 playable scenarios + 1 dialogue-only

'''Version:''' 1.0.2

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves (+ Trolls, Outlaws)

'''[http://units.wesnoth.org/1.10/A_Vision_Blinded/en_US/A_Vision_Blinded.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=23463&hilit=a+vision+blinded

==== Bad Moon Rising ====

''An expedition to gather treasure from the cold north sets off compounding disaster.''

'''Author:''' Doofus-01

'''Status:''' Finished

'''Length:''' 20 scenarios

'''Version:''' 1.5.8

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Archaic Era

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=31348

==== Birth of a Lich ====

''This is the life story of the dreaded lich Malifor, his struggle as a mage outcast, the orcish conquest of the northlands and his transformation to quench the thirst for revenge''

'''Author:''' chak_abhi

'''Status:''' Finished

'''Length:''' 12 playable scenarios / 2 dialogue only

'''Version:''' 1.0.3

'''Difficulty:''' Normal

'''Style:''' Skirmish, Large Battle, Dungeon

'''Faction/Era:''' Human outlaws, dwarves, undead

'''[http://units.wesnoth.org/1.10/Birth_of_a_Lich/en_US/Birth_of_a_Lich.html Custom Units]

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37057

==== Coming of the Storm ====

''A new recruit joins the imperial army, eager to change the world and see combat. Little does he realise just how much action he will get and where his journey will take him. ''

'''Author:''' TrashMan

'''Status:''' WIP

'''Length:''' 26 playable scenarios / 4 dialogue only

'''Version:''' 1.2.1

'''Difficulty:''' Normal

'''Style:''' Skirmish, Large Battle, Dungeon

'''Faction/Era:''' Default

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=23361

==== Invasion from the Unknown ====

''Episode I - Seeking the Light: Long after the Fall, the last forest elves are forced to abandon their safe valley, and find themselves resorting to the dark means of necromancy in order to survive the perils and challenges of this new harsh world. May they finally free the Great Continent from its chaos, or perish in the foolish attempt of restoring peace and life to the lands.''

''Episode II - Armageddon: As the shadow of Chaos covers the entire continent, an assorted group of foolish heroes prepares a counter-attack to the Empire, with one unique goal in their minds: defeat the evil Emperor, whoever it is. Lead these courageous living and non-living warriors to victory, and rediscover lost secrets of the history.''

'''Author:''' shadowmaster

'''Maintainer:''' Espreon

'''Status:''' Finished

'''Length:''' 26 scenarios in two episodes

'''Version:''' 1.90.6

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon, Boss battle

'''Faction/Era:''' Unique. You play Elves and Undead throughout the campaign + in the 2nd part Northerners and Aragwaithi.

''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Invasion_from_the_Unknown Players’ Review(s)]'''

'''Note:''' (taptap) Despite its acknowledged flaws (generic hero, plot holes, deus ex machina moments, gameplay issues in the 2nd part) this is undoubtedly the most iconic campaign in UMC. It single-handedly redefines the elvish history and sketches a cosmology for the ages after the fall. With the Chaos empire and its various allies it introduces an era worth of factions to single-player play. At the same time it features some of the most beautiful maps in Wesnoth and stunning art on par with mainline campaigns.

==== Invasion of Eliador ====

''A peaceful island is about to be invaded by unknadd-ons foes travelling towards the eastern shore. It is up to a family of outlaws to warn the island's inhabitants before it's too late.''

'''Author:''' Sam M. (Genosuke)

'''Maintainer:''' trewe

'''Status:''' Complete

'''Length:''' 10 scenarios + epilogue

'''Version:''' 1.0.4

'''Style:''' RPG, Skirmish, Puzzle

'''Difficulty:''' Easy

'''Faction:''' Default (outlaws)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=6556

'''Wiki:''' [[Invasion_of_Eliador]]

==== Legend of Far North ====

''The tale of the legendary Black Eye Karun,depicting his rise to power, his successes and his brutal assassination.'

'''Author:''' chak_abhi

'''Status:''' Finished

'''Length:''' 16 playable scenarios / 1 dialogue only,1 cutscene

'''Version:''' 1.0.2

'''Difficulty:''' Normal

'''Style:''' Skirmish, Large Battle

'''Faction/Era:''' Orcs, Trolls, Saurians, Nagas

'''[http://units.wesnoth.org/1.10/Legend_of_Far_North/en_US/Legend_of_Far_North.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=34769

==== Legend of the Invincibles ====

'''''Part I: Shrouded in Darkness''' (5 chapters, 90 scenarios) - A pair of heroes, after stopping an orcish thread, are outcast into caves, where they have no other choice than to become liches in order to survive. They preserved their original appearance and moral principles, and fight in various skirmishes against evil (although using evil methods sometimes), until the Fall, when they are buried alive under the ashes of the third sun.''

'''''Part II: Into the Light''' (5 chapters, 110 scenarios) - Long after the Fall, the lich heroes awaken. Searching for more power, they manage to resurrect themselves as living beings, but this time more powerful and ridden of the evil within. But the evil from inside them did not cease to exist, and started a campaign to conquer the world. Stopping the campaign caused an even worse disaster...''

'''Author:''' Dugi

'''Status:''' complete

'''Length:''' 200 (+8 talk-only) scenarios

'''Version:''' 3.0.1

'''Difficulty:''' Normal

'''Style:''' mostly Skirmish and Dungeon (all other styles are present as well, but less frequently)

'''Faction/Era:''' Elves, Loyalists, Undead, Dwarves; but they advance past their usual maximum level

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Legends_of_the_Invincibles Players’ Review(s)]'''

'''Note:''' The most unique feature of this campaign is its RPG-like unit development system, enemies drop items units can use, leaders are stronger than most usual units and all units get AMLA (after maximum level advancement) after reaching their maximum level (that is also increased by a load of additional level 4 units).

==== Merry Christmas ====

''Santa's elfs have to travel south into Lintanir Forest to collect Christmas trees.''

'''Author:''' Desert_Shyde

'''Status:''' Finished

'''Length:''' 3 playable scenarios

'''Version:''' 1.1.2

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Custom

'''[http://units.wesnoth.org/1.10/Merry_Christmas/en_US/merry_christmas.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=32519

==== Only Death Behind ====

''Legends of the Emerald Forest, chapter II: Only Death Behind.''

''Three ghosts have escaped from the land of the dead. Yet they don't remember anything about their past.''

''This is an Undead campaign that references certain characters and events from 'The Flight of Drakes', yet it can be played separately.''

'''Author:''' NoQ

'''Status:''' Complete

'''Length:''' 7 playable scenarios / 1 talk only

'''Version:''' 1.0.0

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Undead

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=39119&p=556996#p556996

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Review_by_Adamant14 Player's Review]'''

'''Note:''' (Adamant14) A short and unusual undead campaign, you play with just a few units. Playable in a few hours, nevertheless it is fun to play.

==== Rebellion in the North ====

''A great orcish uprising tends to destabilise the Northlands. As the future Lord Protector of the Northern Alliance you have to crush the rebellion and establish peace again."

'''Author:''' chak_abhi

'''Status:''' Finished

'''Length:''' 24 playable scenarios / 3 dialogue only,2 cutscenes

'''Version:''' 1.1.12

'''Difficulty:''' Normal

'''Style:''' Skirmish, Large Battle

'''Faction/Era:''' Loyalists, Dwarves, Gryphons, Merfolk

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=33059

==== Roboke's Island ====

Mystic Island Quest

''Embark from Elensefar on an expedition to the west that will not only change your life but conearn the fate of many.''

''"Unraveling the mystery of Roboke island is a magic experience." (Weldyn Gazette)''

''"Ferocious battles and mysterious riddles await you." (Wesmere Post)''

''"The adventures of Roboke and his side-kick are truly stunning." (Knalga News)''

'''Author:''' x42

'''Status:''' beta, story-complete

'''Length:''' 18 playable scenarios + 6 story chapters

'''Version:''' 0.8.X-beta

'''Difficulty:''' Hard

'''Style:''': various (RPG, Skirmish, Puzzle)

'''Faction/Era:''' Default (Fencer as main hero + various allies)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=31&t=39423

'''Note:''' Requires BfW ≥ 1.11.6 (for MicroAI)

==== Ruthless ====

''A bard (an aging criminal) is walking in wasteland. Nothing but two hands in his pockets, and nothing but stones around. Suddenly he sees a knight on errand--a dangerous opponent, especially in broad daylight. The two strangers are soon sitting by the campfire, and the bard is telling a story.
(Beginner level, 10+ fights).''

'''Author:''' homunculus

'''Status:''' Finished

'''Length:''' 12 playable scenarios + 5 cutscene scenarios

'''Version:''' 1.0.4

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default (Orcs)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37874

'''Note:''' (Adamant14) Recommendable campaign, with smart unusual ideas and a good detailed story.
You fight with few units on small but perfect maps. About the difficulty: The author describes his campaign as 'beginner level', but for me the difficulty is rather NORMAL than EASY.

==== Saving Elensefar ====

''Meneldur, elvish mariner of Elensefar, is driven to sea by the same orcs who attacked the city. He must gather an army willing to fight for him to regain Elensefar, his adopted homeland.''

'''Author:''' Turin

'''Maintainer:''' trewe

'''Status:''' Finished

'''Length:''' 1 year (around 12 scenarios)

'''Version:''' 1.5.2

'''Difficulty:''' Normal

'''Style:''' Skirmish, RPG, Simulation

'''Faction:''' Default Era

'''Forum:''' http://wesnoth.org/forum/viewtopic.php?t=3072&start=0

'''Wiki:''' [[Saving_Elensefar]]

'''Note:''' Labeled as Expert, recruit list changes in all scenarios.

==== Secrets of the Ancients ====

''From the Journal of Ardonna of Tarrynth:''

''It's unfair that we humans must die after so few years. Though this is the natural order, we need not embrace it! The lords on the Green Isle knew how to live forever. Pursuit of that knowledge was declared illegal by King Haldric I, but I believe it is worth the risk: If I can rediscover the secrets of the ancients, not only will I cheat death, I will become a hero to the whole continent!''

'''Author:''' beetlenaut

'''Status:''' Completed

'''Length:''' 18 playable scenarios + 3 story only

'''Version:''' 1.0.0

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Undead/Default

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=40545

==== Soldier of Wesnoth ====

''697 YW. More than two decades after King Konrad II died leaving no heir, three noble Houses vie for the control of the kingdom, which, still feeling the damages of Mal-Ravanal's invasion, sees its glory and power slowly fade away. Meanwhile, in the southern province of Kerlath, a young peasant called Addraryn sets out to join Weldyn's Army, in order to be able to marry the fair Elywen. However, his travel will suffer some very unexpected twists which will lead him to the main stages of the Second Civil War. Journey across Wesnoth, witness its decadence, meet old heroes and save the kingdom from the enemies within and from the formidable Lion of the Desert...''

'''Author:''' revansurik

'''Status:''' Completed

'''Length:''' 31 scenarios

'''Version:''' 1.1.2

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default+Khalifate+Custom Units

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=39123

==== Sven's Adventure ====

''A young adventurer's quest to retrieve the fabled, and dangerous, Spellbook of Death.''

'''Author:''' kpearce

'''Status:''' Complete

'''Length:''' 19 scenarios

'''Version:''' 0.1.1

'''Difficulty:''' Normal

'''Style:''' RPG, Dungeon, Boss Battle

'''Faction/Era:''' Default (mixed factions)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=39080

==== The Devil's Flute ====

''Creona, the well-known assassin, gets a strange job from a strange person. So, in fact, it's no surprise that things take a strange turn...''

'''Author:''' lipk

'''Status:''' Complete, unmaintained

'''Length:''' 10 scenarios

'''Version:''' 0.1.4c

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish, Minigames

'''Faction/Era:''' Outlaws

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36044

==== The Earth's Gut ====

''The year is 515YW. You are the young dwarven leader Hamel. Your tribe in the caves of Knalga is under pressure from its enemies, and resources are growing scarce. In order to forge the weapons required to resist your enemies, you must set forth and collect what ores and minerals remain.''

'''Author:''' Anonymissimus

'''Maintainer:''' Anonymissimus

'''Status:''' WIP, story is unfinished (I didn't add any scenario since long, but that doesn't mean nothing is added to the campaign. My addons tend to be in good shape and bug-free which means also WIP as I'm updating it since 1.4 days.)

'''Length:''' 23 scenarios, 5 of which are cutscene only, some others have changing objectives

'''Version:''' 0.2.14

'''Difficulty:''' Normal

'''Style:''' Dungeon, Skirmish

'''Faction/Era:''' Default, dwarves, woses, mages, a few custom units

'''[http://units.wesnoth.org/1.10/The_Earths_Gut/en_US/the_earths_gut.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=26800

'''Note:''' This campaign is a "Dwarvish dungeon crawler" (It currently contains about as many surface scenarios as underground though.) and is intended to be challenging for experienced players on hard whilst suitably easy on easy. I develop the campaign with the wesnoth development version and I advise to play with that, but it is intended to work almost equally well with the stable wesnoth version (except for features only available in the wesnoth development version).

==== The Epic of Vaniyera ====

''The expansionist Lavinian Legion, led by the Imperator himself, has invaded the northern forests of the Sidhe, or Wild Elves. It is up to Leithan the Thunderblade and his advisor Vaniyera to push its armies back where they came from...''

'''Author:''' oreb, turin

'''Maintainer:''' UnwiseOwl

'''Status:''' Complete

'''Length:''' 6 scenarios

'''Version:''' 0.9.0

'''Difficulty:''' Hard (Don't be fooled by "novice level" in the campaign description, this one is very hard.)

'''Note:''' (Maintainer) Working on this issue, the next release (due at the end of November, hah!) should bring easy difficulty back to the level of a reasonable introduction to the IE, while the hard difficulty will also become slightly easier. With any luck, this will be the last release before version 1.0 of the campaign].

'''Style:''' Skirmish

'''Faction/Era:''' Imperial Era, Sidhe.

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=19490

==== The Flight of Drakes ====

''Legends of the Emerald Forest, chapter I: The Flight of Drakes.

''Follow drake king Klader on his quest to find the Crown of Light, a legendary artifact from pre-historic times.''

''This campaign is the first chapter of a trilogy; the second chapter is an Undead campaign and it's called 'Only Death Behind'.''

'''Author:''' NoQ

'''Status:''' Finished

'''Length:''' 7 playable scenarios / 2 talk only

'''Version:''' 1.1.2

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Drakes

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37981

==== The Legend Begins ====

''The tale of Jahin, the greatest hero the land of Arkenova, or perhaps the world of Irdya, had ever known. Watch his legend unfold before your very eyes.''

'''Author:''' Tahsin Jahin Khalid (Lord-Knightmare)

'''Status:''' Complete

'''Length:''' 73 scenarios divided into 3 episodes. Continuation from one episode to the next one is possible, but not recommended.

Episode 1 - 28 scenarios

Episode 2 - 26 scenarios

Episode 3 - 20 scenarios

'''Version:''' 0.5.2

'''Requirements:''' ''War of Legends'' is required to be installed. Latest version recommended.

'''Difficulty:''' Intermediate

'''Style:''' skirmishes, survivals, large battles, dungeons, boss battles

'''Faction/Era:''' [http://units.wesnoth.org/trunk/mainline/en_US/era_default.html Default], [http://units.wesnoth.org/trunk/War_of_Legends/en_US/war_of_legends.html War of Legends]

'''Custom units:''' [http://units.wesnoth.org/trunk/The_Legend_Begins/en_US/The_Legend_Begins-E1.html Custom Units]

'''Forum:''' [http://forums.wesnoth.org/viewtopic.php?f=8&t=37424 Click Here]

'''Notes:'''

----

==== The Library of Kratemaqht ====

''An ancient story from the old continent.''

'''Author:''' Rich Marinaccio (cephalo)

'''Status:''' Complete

'''Length:''' 17 scenarios

'''Version:''' 1.0.0

'''Difficulty:''' Unbalanced (some scenarios are Easy - some rather Hard)

'''Style:''' Skirmish, RPG

'''Faction/Era:''' Loyalists and custom units.

'''[http://units.wesnoth.org/1.10/Library_Of_Kratemaqht/en_US/The_Library_Of_Kratemaqht.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37798

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#The_Library_of_Kratemaqht Players’ Review(s)]'''

'''Notes:''' (Adamant14) This campaign has a thought-out story, shows a great love for detail;
It includes a great custom Dragon, some brilliant custom images (fire, burning houses, burning forest) that makes the scenery / maps look very nice.

==== The Militia ====

''The Travels of a group of Peasants and their Friends; a level 0 campaign that does not focus on a singular hero.''

'''Author:''' Desert_Shyde

'''Status:''' Finished

'''Length:''' 15 scenarios

'''Version:''' 1.5.2

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default

'''[http://units.wesnoth.org/1.10/The_Militia/en_US/the_militia.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?t=30294

==== The Rising ====

''A young elvish fighter is send to represent the Aethenwood at the Ka'lian. The adventure turns out to be bigger then expected.''

'''Author:''' Paulomat4

'''Status:''' unfinished

'''Length:''' 8 scenarios, 1 talking only

'''Version:''' 1.1.0

'''Difficulty:''' challenging

'''Style:''' Skirmish, Large Battle, RPG-elements

'''Faction/Era:''' Default, Elves, Humans

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=39512

==== The Roar of the Woses ====

''When the construction of a dam threatens the existence of her home, Kylix is forced on a journey to stop it.''

'''Author:''' Alarantalara

'''Status:''' Finished

'''Length:''' 10-11 scenarios + 1 dialogue-only

'''Version:''' 1.2.7

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default with Additions (primarily Saurians, Nagas, Woses)

'''[http://units.wesnoth.org/1.10/Roar_of_the_Woses/en_US/Swamp_Rage.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=29830

'''Note:''' (author) Potentially unbalanced on Hard difficulty due to experiments with non-standard ways to increase difficulty. This issue does not exist on the lower difficulty levels.

==== The Three Elves ====

''Three elves have just begun their adventure in the northern swampland. Will they become heroes or will they be responsible for another undead expansion?''

'''Author:''' Stanislav Hoferek

'''Maintainer:''' trewe

'''Status:''' Complete

'''Length:''' 8 scenarios + 2 dialogue

'''Version:''' 0.9

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction:''' Default (Elves)

'''Forum:''' (does it have one?)

==== The Sojournings of Grog ====

''Grog (as starred in Under the Burning Suns) goes home.''

'''Author:''' Peter Christopher, Thomas Hockings

'''Maintainer:''' Elvish_Hunter

'''Status:''' Finished

'''Length:''' 18 playable scenarios in 2 parts

'''Version:''' 3.0.1

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon, Large Battle

'''[http://units.wesnoth.org/1.10/The_Sojournings_of_Grog/en_US/The_Sojournings_of_Grog.html Custom units]'''

'''Faction/Era:''' Default. Most of the time you play trolls and some desert elves accompanying Grog.

==== The White Troll ====

''The story of a white troll whelp with strange magic powers, who is raised in an elvish village.''

'''Author:''' Wesnoth Italian Forum

'''Status:''' Complete

'''Length:''' 8 scenarios

'''Version:''' 1.0.0

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default: you play with elves and trolls. Also features custom units with special advancements and abilities.

'''[http://units.wesnoth.org/1.10/White_Troll/en_US/white_troll.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=38828

==== To Lands Unknown ====

''This is the story of Mehir, the Summoner, and his journey to lands unknown.''

'''Author:''' inferno8

'''Status:''' Complete

'''Length:''' 20 scenarios, 4 dialogue only

'''Version:''' 1.6.0

'''Difficulty:''' Intermediate (Era of Magic)

'''Style''': Skirmish, Dungeon

'''Era:''' Era of Magic

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=31799

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#To_Lands_Unknown Players’ Review(s)]'''

==== War of the Jewel (The Dragon Trilogy, Part II)====

'''''Part IV: City of the Sun''' - Centuries have passed since the refugees of the Last War, led by Myra of Hiera'Shirsha and the Exodus Heroes, have established a new city for themselves in the faraway Netjer-Ta, the golden Maat'Kare; although they are constantly combatting foes who threaten to conquer them, the Maat'Karians have experienced times of relative comfort. However, this age of peace is soon to end, when the ancient evil that nearly destroyed their ancestors reappears at the very heart of their civilization, attracting upon itself the greedy eyes of darkly neighbours... And, in this brewing storm, the young Akhen Wadjet, Myra's last heir, will be forced to overcome his fears and doubts to protect the legacy his ancestor gave her own life for...''

'''Author:''' revansurik

'''Status:''' Complete

'''Length:''' 38 scenarios + epilogue

'''Version:''' 0.1.4

'''Difficulty:''' Normal

'''Style:''' Skirmish/Large Battle

'''Faction/Era:''' War of Legends+Custom factions (Maat'Karians, Wargs, Chomi, Deshra, Washraha, Woodlanders, Aeserians)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=39618&p=562944#p562944

==== Warmaster ====

''One day the scout of your king brings a mysterious little stone, called Zrai-Stone, back from one of his trips. Soon that stone causes a lot of trouble...''

'''Author:''' Conkinator

'''Maintainer:''' trewe

'''Status:''' Finished

'''Length:''' 16 battle + 2 bonus + 1 epilogue scenarios

'''Version:''' 1.3.5

'''Difficulty:''' Hard

'''Faction:''' Default (loyalists)

'''Style:''' Skirmish, Survival

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=15527

=== Eras ===

[[Category:Campaigns|*]]
[[Category:Eras|*]]

==== Era of Four Moons ====

An era based of the cultures in fictional world Ialfa. There are a core set of four which have had the blunt of the balancing effort put into them, and an additional four which represent other parts of the world and are not complete or balanced.

'''Author:''' Velensk

'''Status:'''

'''Faction Descriptions:''' The four core factions are:

-The Highlanders (Chaotic/Neutral): A nomadic people living along the savanna and steppes. Units generally have high hp and low resistances and good movement and defense in the hills. Features cheap mobile infantry and recruitable level 2 Elephants that act as a living battering ram.

-The Imperialists (Lawful): A massive oligarchy centered around an emperor and his house. Most units do well in the open and not well in forests. Can create durable positions and hold open ground exceptionally well but most units do not inflict a lot of damage. Features units with 50% defense in the open and suicidal units.

-The Sea States (Lawful/Neutral): A collation of small mercantile city states. Can field a variety of versatile units with no exceptional strengths or weaknesses.

-The Darklanders (Chaotic): A society of tribal Jungle people. Units generally have low hitpoints but good defense and movement in forests. Features very efficient melee power and access to both slows and berserk.

The other factions are:

-The Dalefolk (Neutral): A cluster of rural settlements known for it's magicians and inventors: Most units do exceptionally well in mountains. Features some good defensive units, the shapeshifter (who changes form depending on terrain), and a powerful melee magician.

-The Pygmies (Liminal): A strange race of tiny jungle dwellers shrouded in mystery: Most units do very well in forests and swamps and are very dodgy at the cost of experience points. Also, most units will heal themselves slightly over time. Feature effective mobile level 0s and many powerful support units.

-The Whites (Chaotic/Neutral): Barbarians from another continent: Units are generally mobile and high on hp but have low defenses when not in rough terrain. Feature powerful magicians and a steadfast berserker.

-The Freemen (Lawful): A society of desert dwellers split between the city dwellers and the nomads. Units tend to be durable and adept in deserts and hills and not as good in forests. Features units with stun and recruitable level 2 rocs.

'''Version: ''' 0.5.1

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=19&t=30513

==== War of Legends ====
* Description: An era based on the continent of Arkenova as well as other parts of Irdya.

* Author: Tahsin Jahin Khalid (Lord-Knyghtmare)

* Maintainer: Tahsin Jahin Khalid (Lord-Knyghtmare)

* Status: Finished

* Faction Descriptions: (Descriptions to be added later)

01. Aragwaithi

02. Windsong

03. Human Alliance

04. Orcish Union

05. Southerners

06. Outlaws

07. Elementals

08. Undead

09. Drakes

10. Dark Legion

11. Sylvans

12. Minotaurs

13. Vampires

* Version: 1.1.5.1

* Forum: [http://forums.wesnoth.org/viewtopic.php?f=19&t=30087 Development and Feedback Thread]

Guide to UMC Content

2014-09-12T17:03:49Z

Beetlenaut: /* Battle for Wesnoth 1.11.x - development */

This is a guide to the current (1.10.x/1.11.x) UMC content for players. It aims to provide unfamiliar players detailed information about campaigns (including story, completion, difficulty and playing style) as well as detailed information about eras. See also [[Player_UMC_Reviews|Player UMC Reviews]], as well as [http://forums.wesnoth.org/viewtopic.php?f=8&t=37476 here] for further information and [http://forums.wesnoth.org/viewtopic.php?f=8&t=36733 here] for currently non-available UMC-content. Feel free to edit this, it is a wiki.

== Blueprint for Campaigns ==

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status:
** Broken = Does not work at all
** Incomplete = Partially written, no progress
** WIP = Partially written, some progress
** Complete = Completely written, but buggy as well as potential balance issues.
** Finished = Completely written, minimal to no bugs, slight balance issues possible.

* Length:

* Version:

* Requirements: (only if needed)

* Difficulty:

Please note: Often campaigns introducing new mechanics are listed as expert level on the add-on server, here difficulty means the raw difficulty after the mechanics are understood.

** Unbalanced = If you can't beat the hard mode, it isn't necessarily unbalanced, but if the difficulty changes erratically from one scenario to the next and only people using the debug mode have seen the final, then it is.
** Easy
** Normal
** Hard

* Style:

Please note: Many campaigns will feature more than one style. Please list the most significant ones.

** Skirmish = small to medium sized armies, your standard Wesnoth gameplay
** Dungeon = long and narrow tunnels (not every underground scenario is a dungeon, a dungeon isn't necessarily underground)
** RPG = role playing game elements such as talking with non-player-characters, item collection, dependency on a party of very few adventurers without or limited recruits
** Survival = being exposed to changing, spawning enemies while remaining on the same map
** Large Battle = large number of units on the battlefield, sizely maps
** Simulation = campaigns feat. terrain modification, alternative resources
** Boss battle = the challenge is to defeat a single powerful enemy unit
** Minigames = there are puzzles and minigames in the campaign that significantly differ from standard Wesnoth gameplay

* Faction/Era: Era for the whole campaign and more specifically the faction or unit composition you field.

* Custom units: Link to the unit tree for cases that don't feel sufficiently described by Faction / Era entry.

* Forum: Links to the feedback and development threads at forums.wesnoth.org

== Blueprint for Eras ==

* Description:

* Author:

* Maintainer: if not maintained by the author anymore.

* Status:
** Broken = Does not work at all
** Incomplete = Partially written, no progress
** WIP = Partially written, progress
** Complete = Completely written, but buggy as well as potential balance issues.
** Finished = Completely written, minimal to no bugs, slight balance issues possible.

* Faction Descriptions: Describe your individual factions here.

* Version:

* Requirements: (only if needed)

* Forum: Links to the feedback and development threads at forums.wesnoth.org

== Battle for Wesnoth 1.10.x - stable ==

=== Campaigns ===

==== A Gryphon's Tale ====

''A Gryphon's Tale tells the story of a community of civilized Gryphons, and of Neliflua, an ambitious young female among them who falls into unusual circumstances.''

'''Author:''' Ringcaat/Dwarven_Void

'''Status:''' One branch complete, most incomplete

'''Length:''' 11-12 scenarios (branch dependent)

'''Version:''' 0.6.12

'''Difficulty:''' Easy

'''Style:''' RPG/minigames

'''Faction/Era:''' Gryphon/Orc

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=2906&start=195&

==== After the Storm ====

''Follow the journey of Galas and his band following the events of Invasion from the Unknown''

'''Author:''' shadowmaster/ShikadiLord

'''Status:''' Finished

'''Length:''' 3 episodes of 13 scenarios each, some of which are multi-part

'''Version:''' 0.9.9

'''Difficulty:''' Medium-hard

'''Style:''' Skirmish, Boss Battle, Dungeon

'''Faction/Era:''' Many custom units

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=32091

'''Note:''' (vultraz) Long, very enjoyable campaign with great story. (Knyghtmare) The best UMC campaign ever!

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#After_the_Storm Players’ Review(s)]'''

==== Aldur The Great ====

''This is a story about Aldur the Great.''

'''Author:''' pintercsabi

'''Status:''' Complete, but unbalanced

'''Length:''' 5 playable scenarios

'''Version:''' 1.2.2

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default

'''Forum:''' -

'''Note:''' (Adamant14) Short unbalanced campaign, maybe abandoned. You fight with Peasants, Ruffians and Woodsman against Orcs

==== Alfhelm the Wise ====

''This is the tale of Alfhelm, called by some the Wise, son of Alfric Conqueror. This is the tale of his victories over his enemies, and his rise to power in the clans of Marauderdom. This is the tale of his journey south and his destruction of the Lavinian Empire. And this is the tale of his demise in the dark forests far to the east of his homeland.''

'''Author:''' turin

'''Maintainer:''' UnwiseOwl

'''Status:''' Complete

'''Length:''' 15 gameplay scenarios

'''Version:''' 0.6.0

'''Difficulty:''' Moderate

'''Style:''' Skirmish

'''Faction/Era:''' Imperial Era, Marauders.

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=17144

'''Note:''' (Maintainer) Though this campaign is complete and playable the whole way through, the code is four years old and pretty buggy. If you notice any errors while playing, please let me know and I'll incorporate the fixes into my next revision as soon as possible.]

==== A New Order ====

''The old kingdom of Wesnoth has fallen before barbarian hordes. The occupying barbarians are on the brink of civil war, the seeds of Wesnothian rebellion are kept alive by old legends, while bandits and Khalifate mercenaries roam the land. Can Gawen Hagarthen unite these disparate factions against a common foe?
Note: This campaign contains mature themes, some of which may be unsuitable for children.

'''Author:''' szopen

'''Status:''' Finished.

'''Length:''' 45 scenarios.

'''Version: ''' 1.2.15

'''Requirements:''' Requires BfW 1.10. In addition, you have to install Era Khalifate add-on; the Akladian Music package is optional

'''Difficulty:''' Normal

'''Style:''' Skirmish, Large Battle

'''Faction/Era:''' Akladians, Khalifate

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=6486

'''Note:''' (Pyrophorus) Certainly one of the most mature and well designed campaign in add-ons. A must.

''' [http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#A_New_Order Players’ Review(s)]'''

==== Antar, Son of Rheor ====

''This is the story about a young Lord and his first mission; sent by his father the young Lord Antar has to relieve his neighbours; he has to convince the Elves and Dwarves to ally him; he has to fight against hordes of Orcs and Endless Undead; and finally he has to defeat Mal Kazur, the mastermind who is behind all the evil.''

'''Author:''' Adamant14

'''Status:''' WIP

'''Length:''' 9 playable scenarios / 1 cutscene

'''Version:''' 0.9.9

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Loyalists and Elves (feat. fencer as main hero + various allies)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36075

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Antar.2C_Son_of_Rheor Players’ Review(s)]'''

==== A Story of the Northlands ====

''A story of life and death in a remote village of the Northlands. Your village has been overrun by an orcish raid. You fight for its freedom while you wait for help to arrive.''

'''Author:''' zepko

'''Status:''' Complete

'''Length:''' 10 playable scenarios + 1 dialogue-only

'''Version:''' 1.0.0

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default + additions: you play with a custom faction of outlaws and with a custom party of loyalist knights.

'''[http://units.wesnoth.org/1.10/A_Story_of_the_Northlands/en_US/A_Story_of_the_Northlands.html Custom Units]'''

==== A Vision Blinded ====

''Defend the northern forest against what appeared like a routine orcish raid, and unravel the greater conspiracies that lie below its waves.''

'''Author:''' LemonTea

'''Maintainer:''' Adamant14

'''Status:''' Complete

'''Length:''' 13 playable scenarios + 1 dialogue-only

'''Version:''' 1.0.2

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves (+ Trolls, Outlaws)

'''[http://units.wesnoth.org/1.10/A_Vision_Blinded/en_US/A_Vision_Blinded.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=23463&hilit=a+vision+blinded

==== Bad Moon Rising ====

''An expedition to gather treasure from the cold north sets off compounding disaster.''

'''Author:''' Doofus-01

'''Status:''' Finished

'''Length:''' 20 scenarios

'''Version:''' 1.4.4.a

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Archaic Era

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=31348

==== Battle Against Time ====

''Rescue fellow orcish warchief before he is executed. (This is not a normal campaign. It is experiment with carryover system. You will start with defined number of turns and gold. You will only have that many turns to play through the whole campaign. There is no finish bonus and gold carryover is always 100%.)''

'''Author:''' Wonderboy

'''Status:''' Complete

'''Length:''' 4 playable scenarios + 1 prologue scenario

'''Version:''' 1.0.0

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Default: Orcs

'''Forum:''' http://wesnoth.org/forum/viewtopic.php?f=8&t=27319

==== Besieged Druids ====

''A elvish school for druids comes under attack by goblins. It seems more than just a routine raid; is there something more sinister behind this attack? - In Beseiged Druids, you control Eärendil, the surviving teacher at the school, and the many and varied initiates. Not all of these are ordinary students; many have been experimenting with other forms of magic, while others are simply overachievers in some area of study. Unfortunately, they are not especially good at combat, at least initially. Together with a very small contingent of surviving guards, it is up to these students to save the island of Aleron from disaster.''

'''Author:''' Celtic Minstrel

'''Status:''' Complete

'''Length:''' 9 scenarios

'''Version:''' 1

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves

'''[http://units.wesnoth.org/1.10/DruidSiege/en_US/celmin-druid-siege.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37342

==== Birth of a Lich ====

''This is the life story of the dreaded lich Malifor, his struggle as a mage outcast, the orcish conquest of the northlands and his transformation to quench the thirst for revenge''

'''Author:''' chak_abhi

'''Status:''' Finished

'''Length:''' 12 playable scenarios / 2 dialogue only

'''Version:''' 1.0.3

'''Difficulty:''' Normal

'''Style:''' Skirmish, Large Battle, Dungeon

'''Faction/Era:''' Human outlaws, dwarves, undead

'''[http://units.wesnoth.org/1.10/Birth_of_a_Lich/en_US/Birth_of_a_Lich.html Custom Units]

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37057

==== Bitter Revenge====

''Amidst the strife and turmoil of the first Dark Age of Wesnoth, a time of transient monarchies and conspiracies against the Crown, the boy Darith witnesses the murder of his father by a general of Wesnoth. Follow Darith's quest for retribution in this treacherous tale of betrayal, deceit, love, remorse, and vengeance.''

'''Author:''' Wonderboy

'''Status:''' Complete

'''Length:''' 11 playable scenarios + 4 dialogue only

'''Version:''' 1.1.0

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Default (mostly outlaws and undead, custom units)

'''Forum:''' http://wesnoth.org/forum/viewtopic.php?f=8&t=26699

==== Cavanagh The Conqueror ====

''This is the tale of Cavanagh Orc-Foundling, who was blessed by the gods to conquer and unite all of the Great Continent. Orcs and elves, gods and men, queens and sorcerers populate this epic tale of revenge and redemption.''

'''Author:''' TheEmptyLord (Programming, Map-making, Editing), Scott_Free(Story)

'''Status:''' WIP

'''Length:''' 10 Playable Scenarios so far

'''Version:''' 0.1.2

'''Difficulty:''' Normal

'''Style:''' Skirmish, limited RPG, limited Large Battle

'''Faction/Era:''' Default (Units from Northerners, Outlaws, Loyalists as well as other factions interspersed. Several custom units.)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=35927

==== Cities of the Frontier ====

''Settle a new town in the wilds north of the Great River.''

''This campaign makes several changes to the standard Wesnoth game mechanics, and focuses on city-building and gold management.''

'''Author:''' esci

'''Status:''' Complete

'''Length:''' Not fixed, approximately 6-10 seasons of 36 turns each
'''Version:''' 0.5.1

'''Difficulty:''' Normal

'''Style:''' Simulation, Survival

'''Faction/Era:''' Default, Loyalist

'''[http://units.wesnoth.org/1.10/Cities_of_the_Frontier/en_US/Cities_of_the_Frontier.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36004

==== Considerate Dead ====

''As the wind goes on and on, people discover necromancer aren't always bad. Made by tribes45 - No scenarios are done, 4 playable out of ??.''

'''Author:''' tribes45 aka tribes55

'''Status:''' Incomplete, unbalanced, abandoned

'''Length:''' 5 scenarios

'''Version:''' .009

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36522

==== Count Kromire ====

''You are the blood son of a vampire lord, however when the might of the celestial crusades comes knocking, and your father is slain, you flee your lands. However you intend to return, to restore the lands of Kromire to the Kromires, to avenge your father, and most importantly, to make sure that no celestial ever dares come into your mountains again.''

'''Author:''' Velensk

'''Maintainer:''' currently none

'''Status:''' Complete

'''Length:''' 9 scenarios

'''Version:''' 1.3.2

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Era of Myths, Vampires

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=21560

==== Dystopia ====

''During the reign of queen Asheviere, the province Annuvin rebelled. You, a royal agent, are sent to stop it.''

'''Author:''' bumbadadabum

'''Maintainer:''' ?

'''Status:''' Broken (does not load at all)

'''Length:''' 5 scenarios

'''Version:''' 0.9.0

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Loyalists

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=35530&p=564646&hilit=dystopia#p514297

==== Elvish Dynasty RPG ====

''You are the new ruler of an elvish kingdom! Can you lead your people to glory? This campaign is highly randomized so it will be different every time you play!''

''Sequel to Ooze Mini-Campaign''

'''Author:''' spencelack

'''Maintainer:''' Wesbane

'''Status:''' Complete

'''Length:''' 10 years, in each year choice between dialogue and fighting scenario (selected out of a large pool of possible scenarios)

'''Version:''' 0.9.9b

'''Difficulty:''' Normal

'''Style:''' RPG, Skirmish

'''Faction/Era:''' Default, Elves

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=28627

==== Fall of Silvium ====

''You are Caius Regilius, Tribune of the province of Silvia, located in the northmost reaches of the Lavinian Empire at the height of its power. But the Empire has overextended itself, The city of Silvium lies seperated from the rest of the Empire by the mountains of Arendia, and is sandwiched between the Marauders and the Sidhe... war is inevitable, and the province of Silvia will almost certainly fall.''

'''Author:''' turin

'''Maintainer:''' UnwiseOwl

'''Status:''' Complete

'''Length:''' 8 scenarios

'''Version:''' 0.6

'''Difficulty:''' Medium

'''Style:''' Skirmish

'''Faction/Era:''' Imperial Era, Lavinian Legion.

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=31&t=24356

'''Note:''' The final level of this campaign is not supposed to be winnable. It's a final blaze of glory and chance to use all your high-powered units, but to 'win' the campaign, you must lose...the ending is similar to a certain mainline campaign, but predates it.

==== Fate of a Princess ====

''Part I: Baldres, a notorious robber baron, flees Wesnoth with his followers and sets off into the northlands to evade the king's justice. The baron's deeds and misdeeds are to change the balance of power between orcs and non-orcs throughout the northlands, and will carry consequences long after his eventual death.''

''Part II: The Greenwood elves face a crisis which demands the return of the queen's estranged half-elven half-sister, Baldres' daughter. Two brave young elves must make a perilous journey to find her and bring her back to her former home. If they fail, the whole northlands will be engulfed in war with the resurgent orcs...''

'''Author:''' SkyOne, mich, Simons Mith

'''Status:''' Finished

'''Length:''' 26-29 scenarios (some dialogue-only), 2 parts

'''Version:''' 0.9.24

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon

'''Faction/Era:''' Default with additions. You play two different, unique cross-faction combinations in each part.

'''[http://units.wesnoth.org/1.10/Fate_of_a_Princess/en_US/Fate_of_a_Princess.html Custom units]'''

'''Required Wesnoth version:''' 1.9.12 or later

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=26327

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Fate_of_a_princess Players’ Review(s)]'''

==== Flight to Freedom ====

''Flight to Freedom chronicles the story of the drake hero Malakar, and his desperate cross-country flight out of slavery.''

'''Authors:''' MadMax, Nova

'''Status:''' Complete

'''Length:''' 20 playable scenarios + 1 dialogue-only

'''Version:''' 5.1.2

'''Difficulty:''' Expert

'''Style:''' Skirmish, Large Battle, Puzzle

'''Faction/Era:''' Drakes

'''Required Wesnoth version:''' 1.11.9 or later

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=1887

==== Forgotten Kingdom ====

''Help Orlog, a troll chieftan, lead his people to safety in the underground and discover an ancient power long forgotten.''

'''Author:''' Limabean

'''Maintainer:''' Chrysophylax

'''Status:''' Incomplete ( but all scenarios playable and balanced )

'''Length:''' 9 playable scenarios + 1 dialogue-only

'''Version:''' 0.1.7

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Goblins, Trolls

'''[http://units.wesnoth.org/1.10/Forgotten_Kingdom/en_US/Forgotten_Kingdom.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=23483

'''Note:''' (Adamant14) This campaign includes a custom Troll line. A good campaign, I hope Limabean and/or Chrysophylax will finish it.

==== Forward they Cried ====

''You are the leader of an advanced detachment that has been tasked with capturing a bridgehead while the main army prepares to attack. It should be a simple enough assignment.''

'''Author:''' Glowing Fish

'''Maintainer:''' 1.10 - Lord-Knightmare; 1.11 - Turuk

'''Status:''' Finished

'''Length:''' 1 scenario ( rather a single scenario than a campaign )

'''Version:''' 1.0.1

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Default Loyalists

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=23656&p=350126&hilit=forward+they+cried#p350126

'''Note:''' (Adamant14) Only a single scenario, but a great scenario.
(UnwiseOwl) You wouldn't want to stop thinking for a turn, and it's good for the first few turns, but this one leaves me wanting more.

==== Galuldur's First Journey ====

''While the belligerence of orcs is nothing new, their intensifying attacks on a fledgling colony of elves in Pindir Forest begin to show signs of a deeper malice, forcing Galuldur, the young son of the colony's adventurous founder Galur, to venture out of his forest's friendly trees in search of help. His simple errand quickly turns into a frantic quest to unearth the roots of the mysterious evil threatening his people. As you lead him through unknown lands, Galuldur, forced to match wits with unexpected adversaries at nearly every turn in a desperate attempt to save his world, quickly learns that the world is neither a friendly nor a simple place.''

'''Author:''' mattsc

'''Status:''' Complete

'''Length:''' 8-9 scenarios

'''Version:''' 1.1.1

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves

'''[http://units.wesnoth.org/1.10/Galuldur/en_US/Galuldur.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=31895

==== Girl unDead ====

''A little undead girl fights against the Kingdom.''

'''Author:''' tapaboy

'''Status:''' Complete

'''Length:''' 14 playable scenarios

'''Version: ''' 1.0.1

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default undead,elves

'''[http://units.wesnoth.org/1.10/Girl_unDead/en_US/Girl_unDead.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37458

==== Grnk the Mighty ====

''All his life, puny little goblin Grnk the Frail had been dreaming about leaving the orcs and starting a better life. When he finally arrives in the human town of Shmaltupp, he realizes that the world is not as black and white as he had imagined. He also discovers that he is no ordinary goblin. Follow Grnk the Frail on his path to becoming Grnk the Mighty.''

'''Author:''' mattsc

'''Status:''' Part I complete

'''Length:''' 13 scenarios

'''Version:''' 1.0.5

'''Difficulty:''' Hard

'''Style:''' Skirmish, RPG

'''Faction/Era:''' Default, changing (no standard army building gameplay)

'''[http://units.wesnoth.org/1.10/Grnk/en_US/Grnk.html Custom units]'''

'''Required Wesnoth version:''' 1.9.5 or later

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=34970

==== Hunter ====

''This is a story. Not about a hunter. About thé Hunter.''

'''Author:''' Thor the God

'''Status:''' WIP

'''Length:''' 4 scenario (unfinished ?)

'''Version: ''' 0.0.1

'''Difficulty:''' easy, unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default

'''Forum:''' no forum thread

==== Inky's Quest ====

''The Cuttlefish Campaign
Are the cuttlefish mere beasts or something more? What stories would they tell if they could speak? This story provides one possible answer.The easiest difficulty provides hints for novice players.''

'''Author:''' Telchin

'''Status:''' Complete

'''Length:''' 12 scenarios + story-only epilogue

'''Version:''' 1.3.0

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Custom units (cuttlefish, tentacles, giant clams...). Enemies use both default era units and custom ones.

'''[http://units.wesnoth.org/1.10/Inky_Quest/en_US/Inky_Quest.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=32501

==== Invasion from the Unknown ====

''Episode I - Seeking the Light: Long after the Fall, the last forest elves are forced to abandon their safe valley, and find themselves resorting to the dark means of necromancy in order to survive the perils and challenges of this new harsh world. May they finally free the Great Continent from its chaos, or perish in the foolish attempt of restoring peace and life to the lands.''

''Episode II - Armageddon: As the shadow of Chaos covers the entire continent, an assorted group of foolish heroes prepares a counter-attack to the Empire, with one unique goal in their minds: defeat the evil Emperor, whoever it is. Lead these courageous living and non-living warriors to victory, and rediscover lost secrets of the history.''

'''Author:''' shadowmaster

'''Maintainer:''' Espreon

'''Status:''' Finished

'''Length:''' 26 scenarios in two episodes

'''Version:''' 1.90.6

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon, Boss battle

'''Faction/Era:''' Unique. You play Elves and Undead throughout the campaign + in the 2nd part Northerners and Aragwaithi.

''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Invasion_from_the_Unknown Players’ Review(s)]'''

==== Invasion of Eliador ====

''A peaceful island is about to be invaded by unknadd-ons foes travelling towards the eastern shore. It is up to a family of outlaws to warn the island's inhabitants before it's too late.''

'''Author:''' Sam M. (Genosuke)

'''Maintainer:''' trewe

'''Status:''' Complete

'''Length:''' 10 scenarios + epilogue

'''Version:''' 1.0.4

'''Style:''' RPG, Skirmish, Puzzle

'''Difficulty:''' Easy

'''Faction:''' Default (outlaws)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=6556

'''Wiki:''' [[Invasion_of_Eliador]]

==== King ====

''The adventure started when a simple man who was living far from Wesnoth discovered that he is the next king.''

'''Author:''' Alexjercan

'''Maintainer:''' -

'''Status:''' Broken, Unbalanced, Unfinished

'''Length:''' 14 scenarios

'''Version:''' 1.0.1

'''Style:''' Skirmish

'''Difficulty:''' Unbalanced

'''Faction:''' Default

'''Forum:''' no forum thread

Note: (Adamant14) This campaign should be removed from the server (broken, no progress, no maintainer)

==== Langrisser Sample Campaign ====

''The Imperial Knights of the Rayguard Empire have disrupted the peace of the village that was Hein's hometown, seeking only a girl named Liana. Fight to rescue Liana.''

'''Author:''' Morath

'''Status:''' Finished

'''Length:''' 1 playable scenario

'''Version:''' 0.1.0.5

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36417&hilit=Langrisser

'''Wikipedia:''' [http://en.wikipedia.org/wiki/Langrisser What is Langrisser]

'''Note:''' (Adamant14) Single scenario, different from usual Wesnoth behaviour.

==== Legend of Far North ====

''The tale of the legendary Black Eye Karun,depicting his rise to power, his successes and his brutal assassination.'

'''Author:''' chak_abhi

'''Status:''' Finished

'''Length:''' 16 playable scenarios / 1 dialogue only,1 cutscene

'''Version:''' 1.0.2

'''Difficulty:''' Normal

'''Style:''' Skirmish, Large Battle

'''Faction/Era:''' Orcs, Trolls, Saurians, Nagas

'''[http://units.wesnoth.org/1.10/Legend_of_Far_North/en_US/Legend_of_Far_North.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=34769

==== Legend of the Invincibles ====

'''''Part I: Shrouded in Darkness''' (5 chapters, 90 scenarios) - A pair of heroes, after stopping an orcish thread, are outcast into caves, where they have no other choice than to become liches in order to survive. They preserved their original appearance and moral principles, and fight in various skirmishes against evil (although using evil methods sometimes), until the Fall, when they are buried alive under the ashes of the third sun.''

'''''Part II: Into the Light''' (5 chapters, 110 scenarios) - Long after the Fall, the lich heroes awaken. Searching for more power, they manage to resurrect themselves as living beings, but this time more powerful and ridden of the evil within. But the evil from inside them did not cease to exist, and started a campaign to conquer the world. Stopping the campaign caused an even worse disaster...''

'''Author:''' Dugi

'''Status:''' complete

'''Length:''' 200 (+8 talk-only) scenarios

'''Version:''' 3.0.1

'''Difficulty:''' Normal

'''Style:''' mostly Skirmish and Dungeon (all other styles are present as well, but less frequently)

'''Faction/Era:''' Elves, Loyalists, Undead, Dwarves; but they advance past their usual maximum level

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Legends_of_the_Invincibles Players’ Review(s)]'''

'''Note:''' The most unique feature of this campaign is its RPG-like unit development system, enemies drop items units can use, leaders are stronger than most usual units and all units get AMLA (after maximum level advancement) after reaching their maximum level (that is also increased by a load of additional level 4 units).

==== Merry Christmas ====

''Santa's elfs have to travel south into Lintanir Forest to collect Christmas trees.''

'''Author:''' Desert_Shyde

'''Status:''' Finished

'''Length:''' 3 playable scenarios

'''Version:''' 1.1.2

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Custom

'''[http://units.wesnoth.org/1.10/Merry_Christmas/en_US/merry_christmas.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=32519

==== Only Death Behind ====

''Legends of the Emerald Forest, chapter II: Only Death Behind.''

''Three ghosts have escaped from the land of the dead. Yet they don't remember anything about their past.''

''This is an Undead campaign that references certain characters and events from 'The Flight of Drakes', yet it can be played separately.''

'''Author:''' NoQ

'''Status:''' Complete

'''Length:''' 7 playable scenarios / 1 talk only

'''Version:''' 1.0.0

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Undead

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=39119&p=556996#p556996

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Only_Death_Behind Player's Review]'''

'''Note:''' (Adamant14) A short and unusual undead campaign, you play with just a few units. Playable in a few hours, nevertheless it is fun to play.

==== Panther Lord ====

''The Imperialists ambitions of pushing into the Sea States have been repeatedly thwarted and now they turn their attentions elsewhere. You are an outcast Darklander now living as a mercenary in the Sea States and the rumors you hear indicate that they will be coming to your people. Though an outcast you do not wish to see them subjugated. The spirit whose friendship caused you to be an outcast has a plan that might allow you to save them.''

'''Author:''' Velensk

'''Maintainer:''' Lavender

'''Status:''' Finished

'''Length:''' 14 scenarios

'''Version:''' 1.0.2

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Era of Four Moons, Darklanders (+ a wide variety of mercenaries)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=34318

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Panther_Lord Players’ Review(s)]'''

==== Random Campaign ====

''Gain experience playing the Default Era faction of your choice in a campaign setting''

'''Author:''' SigurdFireDragon

'''Status:''' Complete

'''Length:''' 7 playable scenarios

'''Version:''' 1.0.0

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Age of Heroes, & Era of Legends

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=32922

'''Note:''' (Author) A 4 scenario version is under the multiplayer button, which lets you choose any era.
Intended for players to gain practice with a faction and learn sound strategies using faction specific adjustments against random factions from the chosen era.

==== Rebellion in the North ====

''A great orcish uprising tends to destabilise the Northlands. As the future Lord Protector of the Northern Alliance you have to crush the rebellion and establish peace again."

'''Author:''' chak_abhi

'''Status:''' Finished

'''Length:''' 24 playable scenarios / 3 dialogue only,2 cutscenes

'''Version:''' 1.1.12

'''Difficulty:''' Normal

'''Style:''' Skirmish, Large Battle

'''Faction/Era:''' Loyalists, Dwarves, Gryphons, Merfolk

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=33059

==== Return of the Monster ====

''It was time for Amailoss, born from the naga queen's last egg, to leave home. Time for him to grow into a leader in his own right, and eventually become the guardian and leader of another naga city. But along the way, he became friends with an unusual mud-crawler, they met a strange young monster, discovered that a spirit had escaped from an orc prison, and the mystery of that spirit became a grave challenge for Amailoss and the many races in the region....''

''A naga campaign, involving elves, orcs, saurians, turtle-like races, and some monsters.''

'''Author:''' SkyOne

'''Status:''' Complete

'''Length:''' 16 playable, 2 dialog scenarios

'''Version:''' 0.7.1

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon

'''Faction/Era:''' Default with additions. You play a custom naga faction and carapaces (a turtle-like race).

'''[http://units.wesnoth.org/1.10/Return_of_the_Monster/en_US/Return_of_the_Monster.html Custom units]'''

'''Required Wesnoth version:''' 1.10.x

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36438

==== Return to Noelren ====

''A story in the first Dark Age of Wesnoth. See how various heroes stick together to shun the threat of black magics, restore the secret kingdom of Noelren and install Garard I on the throne of Wesnoth. This campaign features complex scenarios, unusual objectives and units, emphasizing more on story and adventures than hardcore fighting.''

'''Author:''' Pyrophorus

'''Status:''' Complete.

'''Length:''' 26 scenarios + 7 cut scenes

'''Version: ''' 0.7.6

'''Requirements:''' BfW 1.10 (not tested on 1.11)

'''Difficulty:''' Easy, unbalanced

'''Style:''' Skirmish, RPG, Large Battle, Simulation

'''Faction/Era:''' Default + custom units

'''[http://units.wesnoth.org/1.10/ReturnToNoelren/en_US/ReturnToNoelren.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=34685#p501026

'''Note:''' (Adamant14) I never saw so much fantastic and new ideas in one single UMC, wow!

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Return_to_Noelren Players’ Review(s)]'''

==== Return to Ruins ====

''The humble farmers of Vertegris are summoned by Erik the General of Weldyn to put an end to an orcish raiding party. If they knew what would befall their former home... They never would have left. This is a relatively short campaign with 8 scenarios, It is still undergoing changes.''

'''Author:''' Jeff Stevens (Ulfsark)

'''Composer:''' Paul Fredericks (paulfredericksmusic.com)

'''Status:''' Complete

'''Length:''' 7 scenarios + 1 dialogue-only

'''Version:''' 0.5.1

'''Difficulty:''' Easy,Normal,Hard

'''Style:''' Skirmish

'''Faction/Era:''' Default,(Loyalists, Outlaws)

'''Required Wesnoth version:''' 1.10.x

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37790&sid=9059f18497cda1219f42a626544d0ffd&p=540646#p540646

'''Note:''' (Adamant14) You play a short campaign with just a few units. Playable in a few hours, nevertheless it is fun to play.

==== Salt Wars ====

''Introductory campaign for the Era of Four Moons.''

''As an officer of one of the Sea States you must defend your organization from aggressive rivals.''

'''Author:''' Velensk

'''Maintainer:''' Lavender

'''Status:''' Complete

'''Length:''' 5 scenarios

'''Version:''' 0.2.1

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Era of Four Moons, Sea States

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=31498

==== Saving Elensefar ====

''Meneldur, elvish mariner of Elensefar, is driven to sea by the same orcs who attacked the city. He must gather an army willing to fight for him to regain Elensefar, his adopted homeland.''

'''Author:''' Turin

'''Maintainer:''' trewe

'''Status:''' Finished

'''Length:''' 1 year (around 12 scenarios)

'''Version:''' 1.5.2

'''Difficulty:''' Normal

'''Style:''' Skirmish, RPG, Simulation

'''Faction:''' Default Era

'''Forum:''' http://wesnoth.org/forum/viewtopic.php?t=3072&start=0

'''Wiki:''' [[Saving_Elensefar]]

'''Note:''' Labeled as Expert, recruit list changes in all scenarios.

==== Shameless Crossover Excuse ====

''Fugitive dark sorcerer Gwiti Ha'atel discovers he has the power to mess with Wesnoth's continuity. His quest for revenge on the NPCs who have used his portraits will lead him through perils untold and in-jokes unnumbered, but shall pale before the horror he finds at his quest's end.''

'''Author:''' Orcish Shyde, Mountain_King

'''Status:''' Complete

'''Length:''' 9 scenarios

'''Version:''' 1.1.0

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction:''' Undead

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=32016&start=15

==== Swamplings ====

''Banished by Yushnak the Ponderer, a tribe of lowly swamp goblins endure in the deadly mire of Pogo Bog. Four centuries before the founding of Wesnoth, this is the story of the goblins' struggle against the intrigues and betrayals of the greater races, and the rise of the first wolf rider.''

'''Author:''' John Rawlins (boru)

'''Status:''' Complete

'''Length:''' 14 scenarios

'''Version:''' 1.1.7n

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction:''' Goblins

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=29784

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Swamplings Players’ Review(s)]'''

==== Swamp Witch's Curse ====

''A Faerie tale form the World of Four Moons.''

'''Author:''' Velensk

'''Status:''' Complete

'''Length:''' 9 scenarios

'''Version:''' 1.0

'''Difficulty:''' Expert

'''Style:''' Skirmish

'''Faction:''' Freemen

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=40467

==== Talentless Mage====

''Humorous and silly campaign about mage apprentice who has managed to learn only one simple spell in thirty years.''

'''Author:''' Wonderboy

'''Status:''' Complete

'''Length:''' 11 playable scenarios + 3 dialogue scenarios

'''Version:''' 1.1.0

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Noob Faction

'''[http://units.wesnoth.org/1.10/Talentless_Mage/en_US/Talentless%20Mage.html Custom Units]'''

'''Forum:''' http://wesnoth.org/forum/viewtopic.php?f=8&t=27608]

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Talentless_Mage Players’ Review(s)]'''

==== The Attack of the Western Cavalry ====

''The story of the century's biggest invasion from the West. A story with the destiny of Wesnoth depending on your decisions; save, or remove it?''

'''Author & Maintainer:''' WhiteWolf

'''Status:''' Under development, second beta phase

'''Length:''' 18, 19 or 20 maps, depending on your decisions

'''Version:''' 1.1.7beta"

'''Difficulty:''' Intermediate

'''Style:''' Mixed (Large battle & Stimulation & RPG & Skirmish)

'''Faction/Era:''' Custom, mixed (undead & human & elvish & custom)

'''Forum/Feedback:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36294

==== The Blind Sentinel ====

''The story of a mysterious soldier, the Blind Sentinel, and the wilds of the North, the Nightbrethren. Will Wesnoth vanquish the appreaching Doom? It only depends on you, the Player...''

'''Author:''' WhiteWolf

'''Status:''' Under development, first beta phase

'''Length:''' 29 maps (26 playable) + bonus map (still experimental)

'''Version:''' 1.1.3beta"

'''Difficulty:''' Intermediate/Expert

'''Style:''' Mixed/Custom

'''Faction/Era:''' Humans,Undead,Custom

'''Forum/Feedback:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=39269

==== The Dark Alliance ====

''Prince Terhar lived two years with elves. Little did he expect what would happen when he returned back to Weldyn.''

'''Author:''' Wonderboy

'''Status:''' Complete

'''Length:''' 11 or 10 playable scenarios depending on the branch you take (+ 5 dialogue scenarios)

'''Version:''' 1.0.3"

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Default: Recruit list changes in almost every scenario

'''[http://units.wesnoth.org/1.10/The_Dark_Alliance/en_US/The%20Dark%20Alliance.html Custom Units]'''

'''Forum:''' http://wesnoth.org/forum/viewtopic.php?f=8&t=26924

==== The Dark Hordes ====

''Lead fugitive dark sorcerer Gwiti Ha’atel to mastery of the undead hordes.''

'''Author:''' Circon

'''Maintainer:''' Various

'''Status:''' Incomplete/WIP

'''Length:''' 11/?

'''Version: '''

'''Requirements:'''

'''Difficulty:'''

'''Style:''' Skirmish

'''Faction/Era:''' Default undead

'''[http://units.wesnoth.org/1.10/The_Dark_Hordes/en_US/The_Dark_Hordes_1.html Custom Units]'''

'''Walkthrough:''' [[TheDarkHordes]]

'''Forum:''' [[http://forums.wesnoth.org/viewtopic.php?f=8&t=16576&]]

==== The Devil's Flute ====

''Creona, the well-known assassin, gets a strange job from a strange person. So, in fact, it's no surprise that things take a strange turn...''

'''Author:''' lipk

'''Status:''' Complete, unmaintained

'''Length:''' 10 scenarios

'''Version:''' 0.1.4c

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish, Minigames

'''[http://units.wesnoth.org/1.10/The_Devils_Flute/en_US/The_Devils_Flute.html Custom Units]'''

'''Faction/Era:''' Outlaws

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36044

==== The Earth's Gut ====

''The year is 515YW. You are the young dwarven leader Hamel. Your tribe in the caves of Knalga is under pressure from its enemies, and resources are growing scarce. In order to forge the weapons required to resist your enemies, you must set forth and collect what ores and minerals remain.''

'''Author:''' Anonymissimus

'''Maintainer:''' Anonymissimus

'''Status:''' WIP, story is unfinished (I didn't add any scenario since long, but that doesn't mean nothing is added to the campaign. My addons tend to be in good shape and bug-free which means also WIP as I'm updating it since 1.4 days.)

'''Length:''' 23 scenarios, 5 of which are cutscene only, some others have changing objectives

'''Version:''' 0.2.14

'''Difficulty:''' Normal

'''Style:''' Dungeon, Skirmish

'''Faction/Era:''' Default, dwarves, woses, mages, a few custom units

'''[http://units.wesnoth.org/1.10/The_Earths_Gut/en_US/the_earths_gut.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=26800

'''Note:''' This campaign is a "Dwarvish dungeon crawler" (It currently contains about as many surface scenarios as underground though.) and is intended to be challenging for experienced players on hard whilst suitably easy on easy. I develop the campaign with the wesnoth development version and I advise to play with that, but it is intended to work almost equally well with the stable wesnoth version (except for features only available in the wesnoth development version).

==== The Epic of Vaniyera ====

''The expansionist Lavinian Legion, led by the Imperator himself, has invaded the northern forests of the Sidhe, or Wild Elves. It is up to Leithan the Thunderblade and his advisor Vaniyera to push its armies back where they came from...''

'''Author:''' oreb, turin

'''Maintainer:''' UnwiseOwl

'''Status:''' Complete

'''Length:''' 6 scenarios

'''Version:''' 0.9.0

'''Difficulty:''' Hard (Don't be fooled by "novice level" in the campaign description, this one is very hard.)

'''Note:''' (Maintainer) Working on this issue, the next release (due at the end of November, hah!) should bring easy difficulty back to the level of a reasonable introduction to the IE, while the hard difficulty will also become slightly easier. With any luck, this will be the last release before version 1.0 of the campaign].

'''Style:''' Skirmish

'''Faction/Era:''' Imperial Era, Sidhe.

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=19490

==== The Fall of Wesnoth ====

''As the beloved human empire of Wesnoth becomes lazy and arrogant in its peaceful state of happiness, Emperor Dantair demands the creation of another sun in a bid to destroy all evil. Or is it all for a different purpose? A man named Alitar sees it that way, and now he must survive the most evil inhabited lands if he is to stop chaos from rising, and Wesnoth from falling... This is the story of The Fall of Wesnoth.''

'''Author:''' Pewskeepski

'''Status:''' 1st part complete, 2nd WIP.

'''Length:''' 10 playable scenarios

'''Version:''' 1.0.8

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Outlaws

'''[http://units.wesnoth.org/1.10/The_Fall_of_Wesnoth/en_US/The_Fall_of_Wesnoth-1.html Custom units]'''

==== The Flight of Drakes ====

''Legends of the Emerald Forest, chapter I: The Flight of Drakes.

''Follow drake king Klader on his quest to find the Crown of Light, a legendary artifact from pre-historic times.''

''This campaign is the first chapter of a trilogy; the second chapter is an Undead campaign and it's called 'Only Death Behind'.''

'''Author:''' NoQ

'''Status:''' Finished

'''Length:''' 7 playable scenarios / 2 talk only

'''Version:''' 1.1.2

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Drakes

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37981

==== The Founding of Borstep ====

''The chieftain of your tribe has become decadent and weak. Take over, and lead your people to a better home--whether it is already occupied or not. The Northlands in year 9W are a barbaric place, but anyone who stands in your way will learn the power of orcs!''

'''Author:''' Beetlenaut

'''Status:''' Complete

'''Length:''' 10 and 1 dialogue only

'''Version:''' 1.1.1b

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Default, Northerners

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=29264

'''[http://units.wesnoth.org/1.10/The_Founding_of_Borstep/en_US/The_Founding_of_Borstep.html Custom units]'''

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#The_Founding_of_Borstep Player's Review]'''

'''Note:''' (Kanzil) I find the protagonist hard to sympathise with. Also, most scenarios contain interesting twists. For example, in one, each time you killed a boar it gives you extra health.

'''Note:''' (beetlenaut--author) In most Orcish campaigns the leader is heroic or just wants peace. Krag-Ubor wants plunder and battle like all enemy Orcs in other campaigns. I '''hope''' you don't sympathize too strongly, but I don't think you need to in order to enjoy the game play.

==== The Great Invasion ====

''Argon, a great ruler, Jer, a simple peasant, Gorn, a dwarvish lord, and Elon, an Elvish High Lord, Were fighting against the darkness.13 Scenario some are difficult''

'''Author:''' Alexjercan

'''Maintainer:''' -

'''Status:''' Broken

'''Length:''' 9 "playable" scenarios + 3 talk scenarios

'''Version:''' 1.0.0

'''Style:''' Skirmish

'''Difficulty:''' Unbalanced

'''Faction:''' Default

'''Forum:''' no forum thread

Note: (Adamant14) This campaign should be removed from the server (broken, no progress, no maintainer)

==== The Legend Begins ====

''The tale of Jahin, the greatest hero the land of Arkenova, or perhaps the world of Irdya, had ever known. Watch his legend unfold before your very eyes.''

'''Author:''' Tahsin Jahin Khalid (Lord-Knightmare)

'''Status:''' Complete

'''Length:''' 73 scenarios divided into 3 episodes. Continuation from one episode to the next one is possible, but not recommended.

Episode 1 - 28 scenarios

Episode 2 - 26 scenarios

Episode 3 - 20 scenarios

'''Version:''' 0.5.2

'''Requirements:''' ''War of Legends'' is required to be installed. Latest version recommended.

'''Difficulty:''' Intermediate

'''Style:''' skirmishes, survivals, large battles, dungeons, boss battles

'''Faction/Era:''' [http://units.wesnoth.org/trunk/mainline/en_US/era_default.html Default], [http://units.wesnoth.org/trunk/War_of_Legends/en_US/war_of_legends.html War of Legends]

'''Custom units:''' [http://units.wesnoth.org/trunk/The_Legend_Begins/en_US/The_Legend_Begins-E1.html Custom Units]

'''Forum:''' [http://forums.wesnoth.org/viewtopic.php?f=8&t=37424 Click Here]

'''Notes:'''

----

==== The Library of Kratemaqht ====

''An ancient story from the old continent.''

'''Author:''' Rich Marinaccio (cephalo)

'''Status:''' Complete

'''Length:''' 17 scenarios

'''Version:''' 1.0.0

'''Difficulty:''' Unbalanced (some scenarios are Easy - some rather Hard)

'''Style:''' Skirmish, RPG

'''Faction/Era:''' Loyalists and custom units.

'''[http://units.wesnoth.org/1.10/Library_Of_Kratemaqht/en_US/The_Library_Of_Kratemaqht.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37798

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#The_Library_of_Kratemaqht Players’ Review(s)]'''

'''Notes:''' (Adamant14) This campaign has a thought-out story, shows a great love for detail;
It includes a great custom Dragon, some brilliant custom images (fire, burning houses, burning forest) that makes the scenery / maps look very nice.

==== The Militia ====

''The Travels of a group of Peasants and their Friends; a level 0 campaign that does not focus on a singular hero.''

'''Author:''' Desert_Shyde

'''Status:''' Finished

'''Length:''' 15 scenarios

'''Version:''' 1.5.1

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default

'''[http://units.wesnoth.org/1.10/The_Militia/en_US/the_militia.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?t=30294

==== The Roar of the Woses ====

''When the construction of a dam threatens the existence of her home, Kylix is forced on a journey to stop it.''

'''Author:''' Alarantalara

'''Status:''' Finished

'''Length:''' 10-11 scenarios + 1 dialogue-only

'''Version:''' 1.2.7

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default with Additions (primarily Saurians, Nagas, Woses)

'''[http://units.wesnoth.org/1.10/Roar_of_the_Woses/en_US/Swamp_Rage.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=29830

'''Note:''' (author) Potentially unbalanced on Hard difficulty due to experiments with non-standard ways to increase difficulty. This issue does not exist on the lower difficulty levels.

==== The Three Elves ====

''Three elves have just begun their adventure in the northern swampland. Will they become heroes or will they be responsible for another undead expansion?''

'''Author:''' Stanislav Hoferek

'''Maintainer:''' trewe

'''Status:''' Complete

'''Length:''' 8 scenarios + 2 dialogue

'''Version:''' 0.9

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction:''' Default (Elves)

'''Forum:''' (does it have one?)

==== The Sojournings of Grog ====

''Grog (as starred in Under the Burning Suns) goes home.''

'''Author:''' Peter Christopher, Thomas Hockings

'''Maintainer:''' Elvish_Hunter

'''Status:''' Finished

'''Length:''' 18 playable scenarios in 2 parts

'''Version:''' 3.0.1

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon, Large Battle

'''[http://units.wesnoth.org/1.10/The_Sojournings_of_Grog/en_US/The_Sojournings_of_Grog.html Custom units]'''

'''Faction/Era:''' Default. Most of the time you play trolls and some desert elves accompanying Grog.

==== The Unstoppable Legion ====

''Horseback campaign. The kingdom of Suveran, far away from Wesnoth, is under attack. Only Deuterus, a Great Druid, knows their weakness and only Viktor, a young noble, dares go on the quest to stop them.''

'''Author:''' Chris Neville-Smith (Chris NS)

'''Maintainer:''' Chris Neville-Smith (Chris NS)

'''Status:''' WIP

'''Length:''' Currently 15 playable sceanrios, including a fork of three paths near the beginning, and another fork of two paths later on.

'''Version:''' 0.8.7

'''Difficulty:''' Normal

'''Style:''' Mainly Skirmish

'''[http://units.wesnoth.org/1.10/The_Unstoppable_Legion/en_US/The_Unstoppable_Legion.html Custom units]'''

'''Faction/Era:''' Play mounted units, including expanded Cavalryman line, and completely new Bowrider line. Joined later by Dwarves. Main enemies are the dark fighters and dark cultists.

==== The White Troll ====

''The story of a white troll whelp with strange magic powers, who is raised in an elvish village.''

'''Author:''' Wesnoth Italian Forum

'''Status:''' Complete

'''Length:''' 8 scenarios

'''Version:''' 1.0.0

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default: you play with elves and trolls. Also features custom units with special advancements and abilities.

'''[http://units.wesnoth.org/1.10/White_Troll/en_US/white_troll.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=38828

==== To Lands Unknown ====

''This is the story of Mehir, the Summoner, and his journey to lands unknown.''

'''Author:''' inferno8

'''Status:''' Complete

'''Length:''' 20 scenarios, 4 dialogue only

'''Version:''' 1.6.0

'''Difficulty:''' Intermediate (Era of Magic)

'''Style''': Skirmish, Dungeon

'''Era:''' Era of Magic

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=31799

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#To_Lands_Unknown Players’ Review(s)]'''

==== Up from Slavery ====

''The Orcei are captives in the imperial city of Lavinium, gladiators performing for the emperor Optus Maximus. All it will take, however, is one orc to lead his people to freedom. The Samnis called Sparxus may be that orc.''

'''Author:''' turin

'''Maintainer:''' UnwiseOwl

'''Status:''' Complete

'''Length:''' 7 scenarios

'''Version:''' 0.6.0

'''Difficulty:''' Normal

'''Style:''' Skirmish, Arena (= No recruit, small group gladiator fights)

'''Faction/Era:''' Imperial Era, Orcei Gladiatores

'''Note:''' (Maintainer) At some point, I am intending to completely re-work this campaign to be a multi-player campaign, with one side led by Sparxus and one by Gravirivus. If anyone would like to take this on or has ideas for how to accomplish this, let us know. Nevertheless, its playable as a single player campaign now with some nice ideas that could be developed further.]

==== Warmaster ====

''One day the scout of your king brings a mysterious little stone, called Zrai-Stone, back from one of his trips. Soon that stone causes a lot of trouble...''

'''Author:''' Conkinator

'''Maintainer:''' trewe

'''Status:''' Finished

'''Length:''' 16 battle + 2 bonus + 1 epilogue scenarios

'''Version:''' 1.3.5

'''Difficulty:''' Hard

'''Faction:''' Default (loyalists)

'''Style:''' Skirmish, Survival

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=15527

==== Way of Dragon ====

''The story of what might happen if a person against his will transform into a dragon...''

'''Author:''' DrakeDragon

'''Status:''' Complete

'''Length:''' 7 playable scenarios + 1 dialogue-only

'''Version:''' 1.2.0

'''Difficulty:''' Normal

'''Style:''' Skirmish/RPG

'''Faction/Era:''' Default Loyalists

'''Forum:''' [http://forums.wesnoth.org/viewtopic.php?f=8&t=37876 Wesnoth Forum] [http://uporoom.ru/index.php/topic,179.0.html Russian Forum]

'''Note:''' (Adamant14) Promising short campaign, you play with just a few units.

=== Eras ===

==== Era of Four Moons ====

An era based of the cultures in fictional world Ialfa. There are a core set of four which have had the blunt of the balancing effort put into them, and an additional four which represent other parts of the world and are not complete or balanced.

'''Author:''' Velensk

'''Status:'''

'''Faction Descriptions:''' The four core factions are:

-The Highlanders (Chaotic/Neutral): A nomadic people living along the savanna and steppes. Units generally have high hp and low resistances and good movement and defense in the hills. Features cheap mobile infantry and recruitable level 2 Elephants that act as a living battering ram.

-The Imperialists (Lawful): A massive oligarchy centered around an emperor and his house. Most units do well in the open and not well in forests. Can create durable positions and hold open ground exceptionally well but most units do not inflict a lot of damage. Features units with 50% defense in the open and suicidal units.

-The Sea States (Lawful/Neutral): A collation of small mercantile city states. Can field a variety of versatile units with no exceptional strengths or weaknesses.

-The Darklanders (Chaotic): A society of tribal Jungle people. Units generally have low hitpoints but good defense and movement in forests. Features very efficient melee power and access to both slows and berserk.

The other factions are:

-The Dalefolk (Neutral): A cluster of rural settlements known for it's magicians and inventors: Most units do exceptionally well in mountains. Features some good defensive units, the shapeshifter (who changes form depending on terrain), and a powerful melee magician.

-The Pygmies (Chaotic): A strange race of tiny jungle dwellers shrouded in mystery: Most units do very well in forests and swamps and are very dodgy at the cost of experience points. Also, most units will heal themselves slightly over time. Feature effective mobile level 0s and many powerful support units.

-The Whites (Chaotic/Neutral): Barbarians from another continent: Units are generally mobile and fight well in any rough terrain but low on hp. Feature powerful magicians and a steadfast berserker.

-The Freemen (Lawful): A society of desert dwellers split between the city dwellers and the nomads. Units tend to be durable and adept in deserts and hills and not as good in forests. Features units with stun and recruitable level 2 rocs.

'''Version: ''' 0.4.1

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=19&t=30513

==== War of Legends ====
* Description: An era based on the continent of Arkenova as well as other parts of Irdya.

* Author: Tahsin Jahin Khalid (Lord-Knyghtmare)

* Maintainer: Tahsin Jahin Khalid (Lord-Knyghtmare)

* Status: Finished

* Faction Descriptions: (Descriptions to be added later)

01. Aragwaithi

02. Windsong

03. Human Alliance

04. Orcish Union

05. Southerners

06. Outlaws

07. Elementals

08. Undead

09. Drakes

10. Dark Legion

11. Sylvans

12. Minotaurs

13. Vampires

* Version: 1.1.5.1

* Forum: [http://forums.wesnoth.org/viewtopic.php?f=19&t=30087 Development and Feedback Thread]

== Battle for Wesnoth 1.11.x - development ==

=== Campaigns ===

''Please note: Battle for Wesnoth 1.11.0 features a bug that messes up the selection of difficulty levels.''

==== A Gryphon's Tale ====

''A Gryphon's Tale tells the story of a community of civilized Gryphons, and of Neliflua, an ambitious young female among them who falls into unusual circumstances.''

'''Author:''' Ringcaat/Dwarven_Void

'''Status:''' One branch complete, most incomplete

'''Length:''' 11-12 scenarios (branch dependent)

'''Version:''' 0.6.12

'''Difficulty:''' Easy

'''Style:''' RPG/minigames

'''Faction/Era:''' Gryphon/Orc

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=2906&start=195&

==== After the Storm ====

''Follow the journey of Galas and his band following the events of Invasion from the Unknown''

'''Author:''' shadowmaster/ShikadiLord

'''Status:''' Finished

'''Length:''' 3 episodes of 13 scenarios each, some of which are multi-part

'''Version:''' 0.9.9

'''Difficulty:''' Medium-hard

'''Style:''' Skirmish, Boss Battle, Dungeon

'''Faction/Era:''' Many custom units

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=32091

'''Note:''' (vultraz) Long, very enjoyable campaign with great story. (Knyghtmare) The best UMC campaign ever!

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#After_the_Storm Players’ Review(s)]'''

==== Antar, Son of Rheor ====

''This is the story about a young Lord and his first mission; sent by his father the young Lord Antar has to relieve his neighbours; he has to convince the Elves and Dwarves to ally him; he has to fight against hordes of Orcs and Endless Undead; and finally he has to defeat Mal Kazur, the mastermind who is behind all the evil.''

'''Author:''' Adamant14

'''Status:''' WIP

'''Length:''' 10 playable scenarios / 1 cutscene

'''Version:''' 0.10.2

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Loyalists and Elves (feat. fencer as main hero + various allies)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36075

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Antar.2C_Son_of_Rheor Players’ Review(s)]'''

'''Note:''' (Adamant14) The campaign does not work with BfW version 1.11.0, or BfW version 1.11.1, so please use BfW version 1.11.2 or later!

==== A Song of Fire (The Dragon Trilogy, Part I) ====

''''''Part I: The Last War''' - In a long-forgotten era, at the heart of the Great Continent, an ancestral evil is awakened, threatening to destroy the whole world. Follow young Myra in the war that will alter the future of Irdya and its peoples forever.''

''''''Part II: Towards the Rising Sun''' - After the vicious Last War, Myra has become the new leader of Aragwaithi and Windsong alike. Albeit young and shaken by many losses, she must steel herself to lead her people through the vast and hostile Hannuk Steppes. However, her journey will take them all farther than in their wildest dreams. Furthermore, Myra must deal with the evil influence of the mysterious red gem she found after the last battle.''

''''''Part III: Raging Skies''' - The refugees have finally found a new home: families are built, allies are made and, for the first time in years, Myra and her friends know peace. However, when everything seems normal, ambition and thirst for power cause the break out of a continental war. And, amidst this new storm, an old foe rises agan, more powerful than ever. Witness the end of the song of Irdya's first great heroine.''

'''Author:''' revansurik

'''Status:''' Complete

'''Length:''' 36 scenarios

'''Version:''' 0.4.7

'''Difficulty:''' Normal

'''Style:''' Skirmish, Large Battle

'''Faction/Era:''' Default+War of Legends

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=38210

==== A Vision Blinded ====

''Defend the northern forest against what appeared like a routine orcish raid, and unravel the greater conspiracies that lie below its waves.''

'''Author:''' LemonTea

'''Maintainer:''' Adamant14

'''Status:''' Complete

'''Length:''' 13 playable scenarios + 1 dialogue-only

'''Version:''' 1.0.2

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves (+ Trolls, Outlaws)

'''[http://units.wesnoth.org/1.10/A_Vision_Blinded/en_US/A_Vision_Blinded.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=23463&hilit=a+vision+blinded

==== Bad Moon Rising ====

''An expedition to gather treasure from the cold north sets off compounding disaster.''

'''Author:''' Doofus-01

'''Status:''' Finished

'''Length:''' 20 scenarios

'''Version:''' 1.5.8

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Archaic Era

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=31348

==== Birth of a Lich ====

''This is the life story of the dreaded lich Malifor, his struggle as a mage outcast, the orcish conquest of the northlands and his transformation to quench the thirst for revenge''

'''Author:''' chak_abhi

'''Status:''' Finished

'''Length:''' 12 playable scenarios / 2 dialogue only

'''Version:''' 1.0.3

'''Difficulty:''' Normal

'''Style:''' Skirmish, Large Battle, Dungeon

'''Faction/Era:''' Human outlaws, dwarves, undead

'''[http://units.wesnoth.org/1.10/Birth_of_a_Lich/en_US/Birth_of_a_Lich.html Custom Units]

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37057

==== Coming of the Storm ====

''A new recruit joins the imperial army, eager to change the world and see combat. Little does he realise just how much action he will get and where his journey will take him. ''

'''Author:''' TrashMan

'''Status:''' WIP

'''Length:''' 26 playable scenarios / 4 dialogue only

'''Version:''' 1.2.1

'''Difficulty:''' Normal

'''Style:''' Skirmish, Large Battle, Dungeon

'''Faction/Era:''' Default

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=23361

==== Invasion from the Unknown ====

''Episode I - Seeking the Light: Long after the Fall, the last forest elves are forced to abandon their safe valley, and find themselves resorting to the dark means of necromancy in order to survive the perils and challenges of this new harsh world. May they finally free the Great Continent from its chaos, or perish in the foolish attempt of restoring peace and life to the lands.''

''Episode II - Armageddon: As the shadow of Chaos covers the entire continent, an assorted group of foolish heroes prepares a counter-attack to the Empire, with one unique goal in their minds: defeat the evil Emperor, whoever it is. Lead these courageous living and non-living warriors to victory, and rediscover lost secrets of the history.''

'''Author:''' shadowmaster

'''Maintainer:''' Espreon

'''Status:''' Finished

'''Length:''' 26 scenarios in two episodes

'''Version:''' 1.90.6

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon, Boss battle

'''Faction/Era:''' Unique. You play Elves and Undead throughout the campaign + in the 2nd part Northerners and Aragwaithi.

''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Invasion_from_the_Unknown Players’ Review(s)]'''

'''Note:''' (taptap) Despite its acknowledged flaws (generic hero, plot holes, deus ex machina moments, gameplay issues in the 2nd part) this is undoubtedly the most iconic campaign in UMC. It single-handedly redefines the elvish history and sketches a cosmology for the ages after the fall. With the Chaos empire and its various allies it introduces an era worth of factions to single-player play. At the same time it features some of the most beautiful maps in Wesnoth and stunning art on par with mainline campaigns.

==== Invasion of Eliador ====

''A peaceful island is about to be invaded by unknadd-ons foes travelling towards the eastern shore. It is up to a family of outlaws to warn the island's inhabitants before it's too late.''

'''Author:''' Sam M. (Genosuke)

'''Maintainer:''' trewe

'''Status:''' Complete

'''Length:''' 10 scenarios + epilogue

'''Version:''' 1.0.4

'''Style:''' RPG, Skirmish, Puzzle

'''Difficulty:''' Easy

'''Faction:''' Default (outlaws)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=6556

'''Wiki:''' [[Invasion_of_Eliador]]

==== Legend of Far North ====

''The tale of the legendary Black Eye Karun,depicting his rise to power, his successes and his brutal assassination.'

'''Author:''' chak_abhi

'''Status:''' Finished

'''Length:''' 16 playable scenarios / 1 dialogue only,1 cutscene

'''Version:''' 1.0.2

'''Difficulty:''' Normal

'''Style:''' Skirmish, Large Battle

'''Faction/Era:''' Orcs, Trolls, Saurians, Nagas

'''[http://units.wesnoth.org/1.10/Legend_of_Far_North/en_US/Legend_of_Far_North.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=34769

==== Legend of the Invincibles ====

'''''Part I: Shrouded in Darkness''' (5 chapters, 90 scenarios) - A pair of heroes, after stopping an orcish thread, are outcast into caves, where they have no other choice than to become liches in order to survive. They preserved their original appearance and moral principles, and fight in various skirmishes against evil (although using evil methods sometimes), until the Fall, when they are buried alive under the ashes of the third sun.''

'''''Part II: Into the Light''' (5 chapters, 110 scenarios) - Long after the Fall, the lich heroes awaken. Searching for more power, they manage to resurrect themselves as living beings, but this time more powerful and ridden of the evil within. But the evil from inside them did not cease to exist, and started a campaign to conquer the world. Stopping the campaign caused an even worse disaster...''

'''Author:''' Dugi

'''Status:''' complete

'''Length:''' 200 (+8 talk-only) scenarios

'''Version:''' 3.0.1

'''Difficulty:''' Normal

'''Style:''' mostly Skirmish and Dungeon (all other styles are present as well, but less frequently)

'''Faction/Era:''' Elves, Loyalists, Undead, Dwarves; but they advance past their usual maximum level

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Legends_of_the_Invincibles Players’ Review(s)]'''

'''Note:''' The most unique feature of this campaign is its RPG-like unit development system, enemies drop items units can use, leaders are stronger than most usual units and all units get AMLA (after maximum level advancement) after reaching their maximum level (that is also increased by a load of additional level 4 units).

==== Merry Christmas ====

''Santa's elfs have to travel south into Lintanir Forest to collect Christmas trees.''

'''Author:''' Desert_Shyde

'''Status:''' Finished

'''Length:''' 3 playable scenarios

'''Version:''' 1.1.2

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Custom

'''[http://units.wesnoth.org/1.10/Merry_Christmas/en_US/merry_christmas.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=32519

==== Only Death Behind ====

''Legends of the Emerald Forest, chapter II: Only Death Behind.''

''Three ghosts have escaped from the land of the dead. Yet they don't remember anything about their past.''

''This is an Undead campaign that references certain characters and events from 'The Flight of Drakes', yet it can be played separately.''

'''Author:''' NoQ

'''Status:''' Complete

'''Length:''' 7 playable scenarios / 1 talk only

'''Version:''' 1.0.0

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Undead

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=39119&p=556996#p556996

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#Review_by_Adamant14 Player's Review]'''

'''Note:''' (Adamant14) A short and unusual undead campaign, you play with just a few units. Playable in a few hours, nevertheless it is fun to play.

==== Rebellion in the North ====

''A great orcish uprising tends to destabilise the Northlands. As the future Lord Protector of the Northern Alliance you have to crush the rebellion and establish peace again."

'''Author:''' chak_abhi

'''Status:''' Finished

'''Length:''' 24 playable scenarios / 3 dialogue only,2 cutscenes

'''Version:''' 1.1.12

'''Difficulty:''' Normal

'''Style:''' Skirmish, Large Battle

'''Faction/Era:''' Loyalists, Dwarves, Gryphons, Merfolk

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=33059

==== Roboke's Island ====

Mystic Island Quest

''Embark from Elensefar on an expedition to the west that will not only change your life but conearn the fate of many.''

''"Unraveling the mystery of Roboke island is a magic experience." (Weldyn Gazette)''

''"Ferocious battles and mysterious riddles await you." (Wesmere Post)''

''"The adventures of Roboke and his side-kick are truly stunning." (Knalga News)''

'''Author:''' x42

'''Status:''' beta, story-complete

'''Length:''' 18 playable scenarios + 6 story chapters

'''Version:''' 0.8.X-beta

'''Difficulty:''' Hard

'''Style:''': various (RPG, Skirmish, Puzzle)

'''Faction/Era:''' Default (Fencer as main hero + various allies)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=31&t=39423

'''Note:''' Requires BfW ≥ 1.11.6 (for MicroAI)

==== Ruthless ====

''A bard (an aging criminal) is walking in wasteland. Nothing but two hands in his pockets, and nothing but stones around. Suddenly he sees a knight on errand--a dangerous opponent, especially in broad daylight. The two strangers are soon sitting by the campfire, and the bard is telling a story.
(Beginner level, 10+ fights).''

'''Author:''' homunculus

'''Status:''' Finished

'''Length:''' 12 playable scenarios + 5 cutscene scenarios

'''Version:''' 1.0.4

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default (Orcs)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37874

'''Note:''' (Adamant14) Recommendable campaign, with smart unusual ideas and a good detailed story.
You fight with few units on small but perfect maps. About the difficulty: The author describes his campaign as 'beginner level', but for me the difficulty is rather NORMAL than EASY.

==== Saving Elensefar ====

''Meneldur, elvish mariner of Elensefar, is driven to sea by the same orcs who attacked the city. He must gather an army willing to fight for him to regain Elensefar, his adopted homeland.''

'''Author:''' Turin

'''Maintainer:''' trewe

'''Status:''' Finished

'''Length:''' 1 year (around 12 scenarios)

'''Version:''' 1.5.2

'''Difficulty:''' Normal

'''Style:''' Skirmish, RPG, Simulation

'''Faction:''' Default Era

'''Forum:''' http://wesnoth.org/forum/viewtopic.php?t=3072&start=0

'''Wiki:''' [[Saving_Elensefar]]

'''Note:''' Labeled as Expert, recruit list changes in all scenarios.

==== Secrets of the Ancients ====

''From the Journal of Ardonna of Tarrynth:''

''It's unfair that we humans must die after so few years. Though this is the natural order, we need not embrace it! The lords on the Green Isle knew how to live forever. Pursuit of that knowledge was declared illegal by King Haldric I, but I believe it is worth the risk: If I can rediscover the secrets of the ancients, not only will I cheat death, I will become a hero to the whole continent!''

'''Author:''' beetlenaut

'''Status:''' Completed

'''Length:''' 18 playable scenarios + 3 story only

'''Version:''' 1.0.0

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Undead/Default

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=40545

==== Soldier of Wesnoth ====

''697 YW. More than two decades after King Konrad II died leaving no heir, three noble Houses vie for the control of the kingdom, which, still feeling the damages of Mal-Ravanal's invasion, sees its glory and power slowly fade away. Meanwhile, in the southern province of Kerlath, a young peasant called Addraryn sets out to join Weldyn's Army, in order to be able to marry the fair Elywen. However, his travel will suffer some very unexpected twists which will lead him to the main stages of the Second Civil War. Journey across Wesnoth, witness its decadence, meet old heroes and save the kingdom from the enemies within and from the formidable Lion of the Desert...''

'''Author:''' revansurik

'''Status:''' Completed

'''Length:''' 31 scenarios

'''Version:''' 1.1.2

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default+Khalifate+Custom Units

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=39123

==== Sven's Adventure ====

''A young adventurer's quest to retrieve the fabled, and dangerous, Spellbook of Death.''

'''Author:''' kpearce

'''Status:''' Complete

'''Length:''' 19 scenarios

'''Version:''' 0.1.1

'''Difficulty:''' Normal

'''Style:''' RPG, Dungeon, Boss Battle

'''Faction/Era:''' Default (mixed factions)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=39080

==== The Devil's Flute ====

''Creona, the well-known assassin, gets a strange job from a strange person. So, in fact, it's no surprise that things take a strange turn...''

'''Author:''' lipk

'''Status:''' Complete, unmaintained

'''Length:''' 10 scenarios

'''Version:''' 0.1.4c

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish, Minigames

'''Faction/Era:''' Outlaws

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36044

==== The Earth's Gut ====

''The year is 515YW. You are the young dwarven leader Hamel. Your tribe in the caves of Knalga is under pressure from its enemies, and resources are growing scarce. In order to forge the weapons required to resist your enemies, you must set forth and collect what ores and minerals remain.''

'''Author:''' Anonymissimus

'''Maintainer:''' Anonymissimus

'''Status:''' WIP, story is unfinished (I didn't add any scenario since long, but that doesn't mean nothing is added to the campaign. My addons tend to be in good shape and bug-free which means also WIP as I'm updating it since 1.4 days.)

'''Length:''' 23 scenarios, 5 of which are cutscene only, some others have changing objectives

'''Version:''' 0.2.14

'''Difficulty:''' Normal

'''Style:''' Dungeon, Skirmish

'''Faction/Era:''' Default, dwarves, woses, mages, a few custom units

'''[http://units.wesnoth.org/1.10/The_Earths_Gut/en_US/the_earths_gut.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=26800

'''Note:''' This campaign is a "Dwarvish dungeon crawler" (It currently contains about as many surface scenarios as underground though.) and is intended to be challenging for experienced players on hard whilst suitably easy on easy. I develop the campaign with the wesnoth development version and I advise to play with that, but it is intended to work almost equally well with the stable wesnoth version (except for features only available in the wesnoth development version).

==== The Epic of Vaniyera ====

''The expansionist Lavinian Legion, led by the Imperator himself, has invaded the northern forests of the Sidhe, or Wild Elves. It is up to Leithan the Thunderblade and his advisor Vaniyera to push its armies back where they came from...''

'''Author:''' oreb, turin

'''Maintainer:''' UnwiseOwl

'''Status:''' Complete

'''Length:''' 6 scenarios

'''Version:''' 0.9.0

'''Difficulty:''' Hard (Don't be fooled by "novice level" in the campaign description, this one is very hard.)

'''Note:''' (Maintainer) Working on this issue, the next release (due at the end of November, hah!) should bring easy difficulty back to the level of a reasonable introduction to the IE, while the hard difficulty will also become slightly easier. With any luck, this will be the last release before version 1.0 of the campaign].

'''Style:''' Skirmish

'''Faction/Era:''' Imperial Era, Sidhe.

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=19490

==== The Flight of Drakes ====

''Legends of the Emerald Forest, chapter I: The Flight of Drakes.

''Follow drake king Klader on his quest to find the Crown of Light, a legendary artifact from pre-historic times.''

''This campaign is the first chapter of a trilogy; the second chapter is an Undead campaign and it's called 'Only Death Behind'.''

'''Author:''' NoQ

'''Status:''' Finished

'''Length:''' 7 playable scenarios / 2 talk only

'''Version:''' 1.1.2

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Drakes

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37981

==== The Legend Begins ====

''The tale of Jahin, the greatest hero the land of Arkenova, or perhaps the world of Irdya, had ever known. Watch his legend unfold before your very eyes.''

'''Author:''' Tahsin Jahin Khalid (Lord-Knightmare)

'''Status:''' Complete

'''Length:''' 73 scenarios divided into 3 episodes. Continuation from one episode to the next one is possible, but not recommended.

Episode 1 - 28 scenarios

Episode 2 - 26 scenarios

Episode 3 - 20 scenarios

'''Version:''' 0.5.2

'''Requirements:''' ''War of Legends'' is required to be installed. Latest version recommended.

'''Difficulty:''' Intermediate

'''Style:''' skirmishes, survivals, large battles, dungeons, boss battles

'''Faction/Era:''' [http://units.wesnoth.org/trunk/mainline/en_US/era_default.html Default], [http://units.wesnoth.org/trunk/War_of_Legends/en_US/war_of_legends.html War of Legends]

'''Custom units:''' [http://units.wesnoth.org/trunk/The_Legend_Begins/en_US/The_Legend_Begins-E1.html Custom Units]

'''Forum:''' [http://forums.wesnoth.org/viewtopic.php?f=8&t=37424 Click Here]

'''Notes:'''

----

==== The Library of Kratemaqht ====

''An ancient story from the old continent.''

'''Author:''' Rich Marinaccio (cephalo)

'''Status:''' Complete

'''Length:''' 17 scenarios

'''Version:''' 1.0.0

'''Difficulty:''' Unbalanced (some scenarios are Easy - some rather Hard)

'''Style:''' Skirmish, RPG

'''Faction/Era:''' Loyalists and custom units.

'''[http://units.wesnoth.org/1.10/Library_Of_Kratemaqht/en_US/The_Library_Of_Kratemaqht.html Custom units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37798

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#The_Library_of_Kratemaqht Players’ Review(s)]'''

'''Notes:''' (Adamant14) This campaign has a thought-out story, shows a great love for detail;
It includes a great custom Dragon, some brilliant custom images (fire, burning houses, burning forest) that makes the scenery / maps look very nice.

==== The Militia ====

''The Travels of a group of Peasants and their Friends; a level 0 campaign that does not focus on a singular hero.''

'''Author:''' Desert_Shyde

'''Status:''' Finished

'''Length:''' 15 scenarios

'''Version:''' 1.5.2

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default

'''[http://units.wesnoth.org/1.10/The_Militia/en_US/the_militia.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?t=30294

==== The Rising ====

''A young elvish fighter is send to represent the Aethenwood at the Ka'lian. The adventure turns out to be bigger then expected.''

'''Author:''' Paulomat4

'''Status:''' unfinished

'''Length:''' 8 scenarios, 1 talking only

'''Version:''' 1.1.0

'''Difficulty:''' challenging

'''Style:''' Skirmish, Large Battle, RPG-elements

'''Faction/Era:''' Default, Elves, Humans

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=39512

==== The Roar of the Woses ====

''When the construction of a dam threatens the existence of her home, Kylix is forced on a journey to stop it.''

'''Author:''' Alarantalara

'''Status:''' Finished

'''Length:''' 10-11 scenarios + 1 dialogue-only

'''Version:''' 1.2.7

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default with Additions (primarily Saurians, Nagas, Woses)

'''[http://units.wesnoth.org/1.10/Roar_of_the_Woses/en_US/Swamp_Rage.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=29830

'''Note:''' (author) Potentially unbalanced on Hard difficulty due to experiments with non-standard ways to increase difficulty. This issue does not exist on the lower difficulty levels.

==== The Three Elves ====

''Three elves have just begun their adventure in the northern swampland. Will they become heroes or will they be responsible for another undead expansion?''

'''Author:''' Stanislav Hoferek

'''Maintainer:''' trewe

'''Status:''' Complete

'''Length:''' 8 scenarios + 2 dialogue

'''Version:''' 0.9

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction:''' Default (Elves)

'''Forum:''' (does it have one?)

==== The Sojournings of Grog ====

''Grog (as starred in Under the Burning Suns) goes home.''

'''Author:''' Peter Christopher, Thomas Hockings

'''Maintainer:''' Elvish_Hunter

'''Status:''' Finished

'''Length:''' 18 playable scenarios in 2 parts

'''Version:''' 3.0.1

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon, Large Battle

'''[http://units.wesnoth.org/1.10/The_Sojournings_of_Grog/en_US/The_Sojournings_of_Grog.html Custom units]'''

'''Faction/Era:''' Default. Most of the time you play trolls and some desert elves accompanying Grog.

==== The White Troll ====

''The story of a white troll whelp with strange magic powers, who is raised in an elvish village.''

'''Author:''' Wesnoth Italian Forum

'''Status:''' Complete

'''Length:''' 8 scenarios

'''Version:''' 1.0.0

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default: you play with elves and trolls. Also features custom units with special advancements and abilities.

'''[http://units.wesnoth.org/1.10/White_Troll/en_US/white_troll.html Custom Units]'''

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=38828

==== To Lands Unknown ====

''This is the story of Mehir, the Summoner, and his journey to lands unknown.''

'''Author:''' inferno8

'''Status:''' Complete

'''Length:''' 20 scenarios, 4 dialogue only

'''Version:''' 1.6.0

'''Difficulty:''' Intermediate (Era of Magic)

'''Style''': Skirmish, Dungeon

'''Era:''' Era of Magic

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=31799

'''[http://wiki.wesnoth.org/Guide_to_UMC_Campaigns/Players_Reviews#To_Lands_Unknown Players’ Review(s)]'''

==== War of the Jewel (The Dragon Trilogy, Part II)====

'''''Part IV: City of the Sun''' - Centuries have passed since the refugees of the Last War, led by Myra of Hiera'Shirsha and the Exodus Heroes, have established a new city for themselves in the faraway Netjer-Ta, the golden Maat'Kare; although they are constantly combatting foes who threaten to conquer them, the Maat'Karians have experienced times of relative comfort. However, this age of peace is soon to end, when the ancient evil that nearly destroyed their ancestors reappears at the very heart of their civilization, attracting upon itself the greedy eyes of darkly neighbours... And, in this brewing storm, the young Akhen Wadjet, Myra's last heir, will be forced to overcome his fears and doubts to protect the legacy his ancestor gave her own life for...''

'''Author:''' revansurik

'''Status:''' Complete

'''Length:''' 38 scenarios + epilogue

'''Version:''' 0.1.4

'''Difficulty:''' Normal

'''Style:''' Skirmish/Large Battle

'''Faction/Era:''' War of Legends+Custom factions (Maat'Karians, Wargs, Chomi, Deshra, Washraha, Woodlanders, Aeserians)

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=39618&p=562944#p562944

==== Warmaster ====

''One day the scout of your king brings a mysterious little stone, called Zrai-Stone, back from one of his trips. Soon that stone causes a lot of trouble...''

'''Author:''' Conkinator

'''Maintainer:''' trewe

'''Status:''' Finished

'''Length:''' 16 battle + 2 bonus + 1 epilogue scenarios

'''Version:''' 1.3.5

'''Difficulty:''' Hard

'''Faction:''' Default (loyalists)

'''Style:''' Skirmish, Survival

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=15527

=== Eras ===

[[Category:Campaigns|*]]
[[Category:Eras|*]]

==== Era of Four Moons ====

An era based of the cultures in fictional world Ialfa. There are a core set of four which have had the blunt of the balancing effort put into them, and an additional four which represent other parts of the world and are not complete or balanced.

'''Author:''' Velensk

'''Status:'''

'''Faction Descriptions:''' The four core factions are:

-The Highlanders (Chaotic/Neutral): A nomadic people living along the savanna and steppes. Units generally have high hp and low resistances and good movement and defense in the hills. Features cheap mobile infantry and recruitable level 2 Elephants that act as a living battering ram.

-The Imperialists (Lawful): A massive oligarchy centered around an emperor and his house. Most units do well in the open and not well in forests. Can create durable positions and hold open ground exceptionally well but most units do not inflict a lot of damage. Features units with 50% defense in the open and suicidal units.

-The Sea States (Lawful/Neutral): A collation of small mercantile city states. Can field a variety of versatile units with no exceptional strengths or weaknesses.

-The Darklanders (Chaotic): A society of tribal Jungle people. Units generally have low hitpoints but good defense and movement in forests. Features very efficient melee power and access to both slows and berserk.

The other factions are:

-The Dalefolk (Neutral): A cluster of rural settlements known for it's magicians and inventors: Most units do exceptionally well in mountains. Features some good defensive units, the shapeshifter (who changes form depending on terrain), and a powerful melee magician.

-The Pygmies (Liminal): A strange race of tiny jungle dwellers shrouded in mystery: Most units do very well in forests and swamps and are very dodgy at the cost of experience points. Also, most units will heal themselves slightly over time. Feature effective mobile level 0s and many powerful support units.

-The Whites (Chaotic/Neutral): Barbarians from another continent: Units are generally mobile and high on hp but have low defenses when not in rough terrain. Feature powerful magicians and a steadfast berserker.

-The Freemen (Lawful): A society of desert dwellers split between the city dwellers and the nomads. Units tend to be durable and adept in deserts and hills and not as good in forests. Features units with stun and recruitable level 2 rocs.

'''Version: ''' 0.5.1

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=19&t=30513

==== War of Legends ====
* Description: An era based on the continent of Arkenova as well as other parts of Irdya.

* Author: Tahsin Jahin Khalid (Lord-Knyghtmare)

* Maintainer: Tahsin Jahin Khalid (Lord-Knyghtmare)

* Status: Finished

* Faction Descriptions: (Descriptions to be added later)

01. Aragwaithi

02. Windsong

03. Human Alliance

04. Orcish Union

05. Southerners

06. Outlaws

07. Elementals

08. Undead

09. Drakes

10. Dark Legion

11. Sylvans

12. Minotaurs

13. Vampires

* Version: 1.1.5.1

* Forum: [http://forums.wesnoth.org/viewtopic.php?f=19&t=30087 Development and Feedback Thread]

Guide to UMC Content

2012-09-22T08:47:39Z

Beetlenaut: /* The Founding of Borstep */

''This is a guide to the current (1.10.x/1.11.x) UMC campaigns for players. It aims to provide all the information not only about the story, but also about completion, difficulty and playing style of the campaign. See http://forums.wesnoth.org/viewtopic.php?f=8&t=37476 for further information, for currently non-available UMC-content please refer to http://forums.wesnoth.org/viewtopic.php?f=8&t=36733. Please edit, it is a wiki.''

=== Blueprint ===

'''Status:'''
* Broken = Does not work at all
* Incomplete = Partially written, no progress
* WIP = Partially written, progress
* Complete = Completely written, but buggy as well as potential balance issues.
* Finished = Completely written, minimal to no bugs, slight balance issues possible.

'''Length:'''

'''Author:'''

'''Maintainer:''' if not maintained by the author anymore.

'''Description:'''

'''Version: '''

'''Requirements:'''

'''Difficulty:'''

Please note: Often campaigns introducing new mechanics are listed as expert level on the add-on server, here difficulty means the raw difficulty after the mechanics are understood.

* Unbalanced = If you can't beat the hard mode, it isn't necessarily unbalanced, but if the difficulty changes erraticly from one scenario to the next and only people using the debug mode have seen the final, then it is.
* Easy
* Normal
* Hard

'''Style:'''

Please note: Many campaigns will feature more than one style. Please list the most significant ones.

* Skirmish = small to medium sized armies, your standard Wesnoth gameplay
* Dungeon = long and narrow tunnels (not every underground scenario is a dungeon, a dungeon isn't necessarily underground)
* RPG = role playing game elements such as talking with non-player-characters, item collection, dependency on a party of very few adventurers without or limited recruits
* Survival = being exposed to changing, spawning enemies while remaining on the same map
* Large Battle = Eastern Flank in Northern Rebirth, Civil War in Son of the Black-Eye
* Simulation = campaigns feat. terrain modification, alternative resources
* Boss battle = a recurring feature of Invasion of the Unknown (basically a triggered event creating a solvable puzzle for the player)

'''Faction/Era:'''

* Era for the whole campaign and more specifically the faction or unit composition you field.

'''Forum:'''

* Links to the feedback and development threads at forums.wesnoth.org

== Battle for Wesnoth 1.10.x - stable ==

''Campaigns available in the 1.10.x stable version.''

=== A Story of the Northlands ===

''A story of life and death in a remote village of the Northlands. Your village has been overrun by an orcish raid. You fight for its freedom while you wait for help to arrive.''

'''Author:''' zepko

'''Status:''' Complete

'''Length:''' 10 playable scenarios + 1 dialog-only

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default + additions: you play with a custom faction of outlaws and with a custom party of loyalist knights.

'''Version:''' 0.2.0

=== A Vision Blinded ===

''Defend the northern forest against what appeared like a routine orcish raid, and unravel the greater conspiracies that lie below its waves.''

'''Author:''' LemonTea

'''Maintainer:''' Adamant14

'''Status:''' Complete

'''Length:''' 13 playable scenarios + 1 dialog-only

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves (+ Trolls, Outlaws)

'''[http://units.wesnoth.org/1.10/A_Vision_Blinded/en_US/A_Vision_Blinded.html Custom units]'''

'''Version:''' 0.6.6

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=23463&hilit=a+vision+blinded

=== Antar, Son of Rheor ===

''This is the story about a young Lord and his first mission; sent by his father the young Lord Antar has to relieve his neighbours; he has to convince the Elves and Dwarves to ally him; he has to fight against hordes of Orcs and Endless Undead; and finally he has to defeat Mal Kazur, the mastermind who is behind all the evil.''

'''Author:''' Adamant14

'''Status:''' WIP

'''Length:''' 8 playable scenarios

'''Difficulty:''' WIP

'''Style:''' Skirmish

'''Faction/Era:''' Default, Loyalists (feat. fencer as main hero + various allies)

'''Version:''' 0.8.21

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36075

=== Besieged Druids ===

''A elvish school for druids comes under attack by goblins. It seems more than just a routine raid; is there something more sinister behind this attack? - In Beseiged Druids, you control Eärendil, the surviving teacher at the school, and the many and varied initiates. Not all of these are ordinary students; many have been experimenting with other forms of magic, while others are simply overachievers in some area of study. Unfortunately, they are not especially good at combat, at least initially. Together with a very small contingent of surviving guards, it is up to these students to save the island of Aleron from disaster.''

'''Author:''' Celtic Minstrel

'''Status:''' Complete

'''Length:''' 9 scenarios

'''Difficulty:''' Unbalanced

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves

'''[http://units.wesnoth.org/1.10/DruidSiege/en_US/celmin-druid-siege.html Custom units]'''

'''Version:''' 1

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=37342

=== Cities of the Frontier ===

''Settle a new town in the wilds north of the Great River.''

''This campaign makes several changes to the standard Wesnoth game mechanics, and focuses on city-building and gold management.''

'''Author:''' esci

'''Status:''' Complete

'''Length:''' Not fixed, approximately 6-10 seasons of 36 turns each

'''Difficulty:''' Normal

'''Style:''' Simulation, Survival

'''Faction/Era:''' Default, Loyalist

'''[http://units.wesnoth.org/1.10/Cities_of_the_Frontier/en_US/Cities_of_the_Frontier.html Custom units]'''

'''Version:''' 0.5.1

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36004

=== Count Kromire ===

''You are the blood son of a vampire lord, however when the might of the celestial crusades comes knocking, and your father is slain, you flee your lands. However you intend to return, to restore the lands of Kromire to the Kromires, to avenge your father, and most importantly, to make sure that no celestial ever dares come into your mountains again.''

'''Author:''' Velensk

'''Maintainer:''' currently none

'''Status:''' Complete

'''Length:''' 9 scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Era of Myths, Vampires

'''Version:''' 1.3.2

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=21560

=== Elvish Dynasty RPG ===

''You are the new ruler of an elvish kingdom! Can you lead your people to glory? This campaign is highly randomized so it will be different every time you play!''

''Sequel to Ooze Mini-Campaign''

'''Author:''' spencelack

'''Status:''' Complete

'''Length:''' 10 years, in each year choice between dialogue and fighting scenario (selected out of a large pool of possible scenarios)

'''Difficulty:''' Normal

'''Style:''' RPG, Skirmish

'''Faction/Era:''' Default, Elves

'''Version:''' 0.9.9b

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=28627

=== Fate of a Princess ===

''Part I: Baldres, a notorious robber baron, flees Wesnoth with his followers and sets off into the northlands to evade the king's justice. The baron's deeds and misdeeds are to change the balance of power between orcs and non-orcs throughout the northlands, and will carry consequences long after his eventual death.''

''Part II: The Greenwood elves face a crisis which demands the return of the queen's estranged half-elven half-sister, Baldres' daughter. Two brave young elves must make a perilous journey to find her and bring her back to her former home. If they fail, the whole northlands will be engulfed in war with the resurgent orcs...''

'''Author:''' SkyOne, mich, simonsmith

'''Status:''' Finished

'''Length:''' 26-29 scenarios (some dialogue-only), 2 parts

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon

'''Faction/Era:''' Default with additions. You play two different, unique cross-faction combinations in each part.

'''[http://units.wesnoth.org/1.10/Fate_of_a_Princess/en_US/Fate_of_a_Princess.html Custom units]'''

'''Version:''' 0.9.17

'''Required Wesnoth version:''' 1.9.12 or later

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=26327

=== Galuldur's First Journey ===

''While the belligerence of orcs is nothing new, their intensifying attacks on a fledgling colony of elves in Pindir Forest begin to show signs of a deeper malice, forcing Galuldur, the young son of the colony's adventurous founder Galur, to venture out of his forest's friendly trees in search of help. His simple errand quickly turns into a frantic quest to unearth the roots of the mysterious evil threatening his people. As you lead him through unknown lands, Galuldur, forced to match wits with unexpected adversaries at nearly every turn in a desperate attempt to save his world, quickly learns that the world is neither a friendly nor a simple place.''

'''Author:''' mattsc

'''Status:''' Complete

'''Length:''' 8-9 scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Elves

'''[http://units.wesnoth.org/1.10/Galuldur/en_US/Galuldur.html Custom units]'''

'''Version:''' 1.1.1

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=31895

=== Grnk the Mighty ===

''All his life, puny little goblin Grnk the Frail had been dreaming about leaving the orcs and starting a better life. When he finally arrives in the human town of Shmaltupp, he realizes that the world is not as black and white as he had imagined. He also discovers that he is no ordinary goblin. Follow Grnk the Frail on his path to becoming Grnk the Mighty.''

'''Author:''' mattsc

'''Status:''' Part I complete

'''Length:''' 13 scenarios

'''Difficulty:''' Hard

'''Style:''' Skirmish, RPG

'''Faction/Era:''' Default, changing (no standard army building gameplay)

'''[http://units.wesnoth.org/1.10/Grnk/en_US/Grnk.html Custom units]'''

'''Version:''' 1.0.5

'''Required Wesnoth version:''' 1.9.5 or later

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=34970

=== Invasion from the Unknown ===

''Episode I - Seeking the Light: Long after the Fall, the last forest elves are forced to abandon their safe valley, and find themselves resorting to the dark means of necromancy in order to survive the perils and challenges of this new harsh world. May they finally free the Great Continent from its chaos, or perish in the foolish attempt of restoring peace and life to the lands.''

''Episode II - Armageddon: As the shadow of Chaos covers the entire continent, an assorted group of foolish heroes prepares a counter-attack to the Empire, with one unique goal in their minds: defeat the evil Emperor, whoever it is. Lead these courageous living and non-living warriors to victory, and rediscover lost secrets of the history.''

'''Author:''' shadowmaster

'''Maintainer:''' Espreon

'''Status:''' Finished

'''Length:''' 26 scenarios in two episodes

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon, Boss battle

'''Faction/Era:''' Unique. You play Elves, Undead and in the 2nd part Aragwaithi.

'''Version:''' 1.90.6

''Note (taptap): Despite its acknowledged flaws (generic hero, plot holes, deus ex machina moments, gameplay issues in the 2nd part) this is undoubtedly the most iconic campaign in UMC. It single-handedly redefines the elvish history and sketches a cosmology for the ages after the fall. With the Chaos empire and its various allies it introduces an era worth of factions to single-player play. At the same time it features some of the most beautiful maps in Wesnoth and stunning art on par with mainline campaigns.''

=== Panther Lord ===

''The Imperialists ambitions of pushing into the Sea States have been repeatedly thwarted and now they turn their attentions elsewhere. You are an outcast Darklander now living as a mercenary in the Sea States and the rumors you hear indicate that they will be coming to your people. Though an outcast you do not wish to see them subjugated. The spirit whose friendship caused you to be an outcast has a plan that might allow you to save them.''

'''Author:''' Velensk

'''Maintainer:''' Lavender

'''Status:''' Finished

'''Length:''' 14 scenarios

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Era of Four Moons, Darklanders (+ a wide variety of mercenaries)

'''Version:''' 1.0.2

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=34318

=== Return of the Monster ===

''It was time for Amailoss, born from the naga queen's last egg, to leave home. Time for him to grow into a leader in his own right, and eventually become the guardian and leader of another naga city. But along the way, he became friends with an unusual mud-crawler, they met a strange young monster, discovered that a spirit had escaped from an orc prison, and the mystery of that spirit became a grave challenge for Amailoss and the many races in the region....''

''A naga campaign, involving elves, orcs, saurians, turtle-like races, and some monsters.''

'''Author:''' SkyOne

'''Status:''' Complete

'''Length:''' 16 playable, 2 dialog scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon

'''Faction/Era:''' Default with additions. You play a custom naga faction and carapaces (a turtle-like race).

'''[http://units.wesnoth.org/1.10/Return_of_the_Monster/en_US/Return_of_the_Monster.html Custom units]'''

'''Version:''' 0.7.1

'''Required Wesnoth version:''' 1.10.x

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36438

=== Salt Wars ===

''Introductory campaign for the Era of Four Moons.''

''As an officer of one of the Sea States you must defend your organization from aggressive rivals.''

'''Author:''' Velensk

'''Maintainer:''' Lavender

'''Status:''' Complete

'''Length:''' 5 scenarios

'''Difficulty:''' Easy

'''Style:''' Skirmish

'''Faction/Era:''' Era of Four Moons, Sea States

'''Version:''' 0.2.1

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=31498

=== The Earth's Gut ===

''The year is 515YW. You are the young dwarven leader Hamel. Your tribe in the caves of Knalga is under pressure from its enemies, and resources are growing scarce. In order to forge the weapons required to resist your enemies, you must set forth and collect what ores and minerals remain.''

'''Author:''' Anonymissimus

'''Maintainer:''' Anonymissimus

'''Status:''' Incomplete

'''Length:''' 21 scenarios

'''Difficulty:''' Normal

'''Style:''' Dungeon

'''Faction/Era:''' Default, dwarves.

'''[http://units.wesnoth.org/1.10/The_Earths_Gut/en_US/the_earths_gut.html Custom units]'''

'''Version:''' 0.2.11

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=26800

'''Note''' This campaign is a "Dwarvish dungeon crawler" and is intended to be challenging for experienced players on hard whilst suitably easy on easy.

=== The Epic of Vaniyera ===

''The expansionist Lavinian Legion, led by the Imperator himself, has invaded the northern forests of the Sidhe. It is up to the young Vaniyera to push its armies back from the border...''

'''Author:''' oreb, turin

'''Maintainer:''' unwiseowl

'''Status:''' Complete

'''Length:''' 6 scenarios

'''Difficulty:''' Hard (Don't be fooled by "novice level" in the campaign description, this one is very hard.)

'''Style:''' Skirmish

'''Faction/Era:''' Imperial Era, Sidhe.

'''Version:''' 0.9.0

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=19490

=== The Fall of Wesnoth ===

''As the beloved human empire of Wesnoth becomes lazy and arrogant in its peaceful state of happiness, Emperor Dantair demands the creation of another sun in a bid to destroy all evil. Or is it all for a different purpose? A man named Alitar sees it that way, and now he must survive the most evil inhabited lands if he is to stop chaos from rising, and Wesnoth from falling... This is the story of The Fall of Wesnoth.''

'''Author:''' Pewskeepski

'''Status:''' 1st part complete, 2nd WIP.

'''Length:''' 10 playable scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish

'''Faction/Era:''' Default, Outlaws

'''[http://units.wesnoth.org/1.10/The_Fall_of_Wesnoth/en_US/The_Fall_of_Wesnoth-1.html Custom units]'''

'''Version:''' 1.0.8

=== The Founding of Borstep ===

''The chieftain of your tribe has become decadent and weak. Take over, and lead your people to a better home--whether it is already occupied or not. The Northlands in year 9W are a barbaric place, but anyone who stands in your way will learn the power of orcs!''

'''Author:''' Beetlenaut

'''Status:''' Complete

'''Length:''' 10 and 1 dialogue only

'''Difficulty:''' Hard

'''Style:''' Skirmish

'''Faction/Era:''' Default, Northerners

'''[http://units.wesnoth.org/1.10/The_Founding_of_Borstep/en_US/The_Founding_of_Borstep.html Custom units]'''

'''Version:''' 1.1.1b

''Note(Kanzil): I find the protagonist hard to sympathise with. Also, most scenarios contain interesting twists. For example, in one, each time you killed a boar it gives you extra health.''

''Note(beetlenaut--author): In most Orcish campaigns the leader is heroic or just wants peace. Krag-Ubor wants plunder and battle like all enemy Orcs in other campaigns. I '''hope''' you don't sympathize too strongly, but I don't think you need to in order to enjoy the game play.''

=== The Sojournings of Grog ===

''Grog (as starred in Under the Burning Suns) goes home.''

'''Author:''' Peter Christopher, Thomas Hockings

'''Maintainer:''' Elvish_Hunter

'''Status:''' Finished

'''Length:''' 18 playable scenarios in 2 parts

'''Difficulty:''' Normal

'''Style:''' Skirmish, Dungeon, Large Battle

'''[http://units.wesnoth.org/1.10/The_Sojournings_of_Grog/en_US/The_Sojournings_of_Grog.html Custom units]'''

'''Faction/Era:''' Default. Most of the time you play trolls and some desert elves accompanying Grog.

'''Version:''' 3.0.1

=== Up from Slavery ===

''Well, the orcs don't know exactly what year it is. They are captives in the imperial city of Lavinium, gladiators performing for the emperor Optus Maximus. All it will take, however, is one orc to lead his people to freedom. The Samnis called Sparxus may be that orc.''

'''Author:''' turin

'''Maintainer:''' unwiseowl

'''Status:''' Complete

'''Length:''' 7 scenarios

'''Difficulty:''' Normal

'''Style:''' Skirmish, Arena (= No recruit, small group gladiator fights)

'''Faction/Era:''' Imperial Era, Orcei Gladiatores

'''Version:''' 0.6.0

== Battle for Wesnoth 1.11.x - development ==

''Campaigns available in the 1.11.x development version.''

''Please note: Battle for Wesnoth 1.11.0 features a bug that messes up the selection of difficulty levels.''

=== Antar, Son of Rheor ===

''This is the story about a young Lord and his first mission; sent by his father the young Lord Antar has to relieve his neighbours; he has to convince the Elves and Dwarves to ally him; he has to fight against hordes of Orcs and Endless Undead; and finally he has to defeat Mal Kazur, the mastermind who is behind all the evil.''

'''Author:''' Adamant14

'''Status:''' WIP

'''Length:''' 8 playable scenarios

'''Difficulty:''' WIP

'''Style:''' Skirmish

'''Faction/Era:''' Default, Loyalists (feat. fencer as main hero + various allies)

'''Version:''' 0.8.21b

'''Forum:''' http://forums.wesnoth.org/viewtopic.php?f=8&t=36075

[[Category:Campaigns|*]]

Dead Water

2010-09-09T06:19:34Z

Beetlenaut: /* Uncharted Islands */

This walkthrough started with the comments in the cfg files, which are based on normal difficulty. Maiklas3000 has updated the comments for difficult (Triton/nightmare) level. Feel free to add your own comments. Place your attribution here (using "edit" at the bottom) rather than in each scenario.

==Campaign Strategy==
You have piercing-attack Mermen to fight pierce-resistant Undead. What to do? Fortunately, for this campaign you are given a special impact unit, namely the Merman Brawler, which is an advancement of Merman Citizen, the peasants of the Mermen. Spamming Citizens and promoting them to Brawler is one of the keys to the campaign. Take note of the Brawlers' tail attacks with "stun", which can sometimes be used to good effect to disrupt Z.O.C's. You should also aggressively advance Hunters to Netcasters for their impact attacks, with "slow" as a bonus on the ranged attack. Many scenarios benefit from having at least two healers, so you should also promote an Initiate or two (or three) to Priestess early on, to supplement your starting Priestess, Cylanna, whom you should try to promote quickly to Diviner for the illumination. Fighters/Warriors and Spearmen are less useful in this campaign, but you do not always fight Undead, so groom a few on your roster "just in case."

This is a campaign where it pays to read one scenario ahead, to see if you can better prepare yourself.

==Scenarios==

=== Invasion ===
This scenario is tricky. Mastering a winning strategy may take you a few attempts.

A key feature of this scenario is that when the Undead capture any village, Walking Corpses spawn. (Soulless spawn on Difficult.) In light of this, you have two possible strategies, with which others have had success:

Option 1: Leader assassination / blitzbrieg. First turn, recruit several level 1 units and just a couple Citizens. Advance on the enemy leader and kill him. The enemy will be focused on capturing villages in order to create an overwhelming number of Walking Corpses - so much so that you may be able to just walk in and kill their leader.

Option 2: "General Motorsing". Your basic strategy should be to take and hold as many villages as possible, both to prevent the spawning and to boost your income. If possible, grant the enemy only the three villages closest to his keep (not counting the two in the mountains, which your Mermen can't do anything about.) If you don't let many villages fall into enemy hands, eventually your income will be overwhelming. First turn, recruit only a couple of level 1 units, and the rest Citizens. Send the level 1's south to capture and protect villages there and send the Citizens in all directions to snatch up villages. Try not to lose any of the villages north of the eastern river. On Difficult, this is a challenge, but quite possible. To accomplish this, use the Citizen in the east to help Cylanna protect the villages there from the Skeleton that starts nearby. Keep that area free of Soulless and Walking Corpses, so that you can concentrate your Citizens there and suicide attack them versus Skeletons.

If you start losing villages, it may not be the end of the world. You can sacrifice the land villages, but hold the ones in the water, using a couple of Fighters/Hunters plus Citizens. Use Cylanna, Gwabbo, and a few Citizens to hold off the Skeletons and Soulless southeast of your keep until the village situation is under control.

Let the swimming Soulless/WC advance a bit towards your keep, so that your baby king can dart out to get an easy kill or two. As Gwabbo hints, you would be wise to get Krellis as much experience as possible this scenario; it will make the next scenario much easier.

Attack during the day, but retreat and heal at night. Keep your Citizens and wounded safe from becoming WC's, which often means sitting them on villages, but you can think of other ways, like using the ZOC's of level 1's and 2's to protect them.

Bat control is essential. Don't let even one Bat get into your rear area, or it may spell defeat. Initiates are good against Bats. A key to success is understanding how the Bats work. They will forego capturing a village in favor of making an attack. So, if there is a friendly or unowned village within range of a Bat, you have to make sure the Bat has someone to attack. Citizens make good bat bait.

Towards the end, your income will be quite large, so if the situation is under control, then it's better to milk XP than go for an early finish. You can swarm the enemy keep with Citizens and take your time to end it. Try to turn some of the Citizens into Brawlers.

=== Flight ===

Hopefully Kai Krellis is at least half leveled up already. Otherwise, this can be painful, as one of the victory conditions is that the Kai must be at least level 1.

You must decide whether to attack east or southwest. To the east is the prospect of more experience, while to the southwest is an easier foe and less distance for Krellis to travel back to the signpost.

Option 1, east: Recruit a bunch of Citizens
and Brawlers, and send them east with Krellis. Use Citizens to lure
the Skeleton Archer types into the water. They are easy pickings
there for other Citizens, Brawlers, and Krellis. One of those guys
gets Krellis half way up to level one. A few Citizens should also
survive to become Brawlers. Remember that you can often turn a near-dead
Citizen into a healthy Brawler by going for a kill, especially with
the leadership of Krellis if he is already at level 1.
About the time you get Krellis leveled
up, and you are thinking about retreating everyone else, the bats
will arrive. On Difficult, this will be a nasty number of Blood Bats.
Use Hunters and Initiates to clear a path back west. Send three or four
expendable units with Krellis. Their job is only to serve as bat bait,
distracting the bats from Krellis, so that he does not get ZOC-locked.
Krellis runs for the corner, while the rest of the troops gain experience doing a
fighting retreat from the skeletons and other bad guys arriving in
the middle of the map.

Option 2, southwest: Send Citizens east, while your best troops go southwest. After you advance to where you meet the enemy, you will start retreating almost as quickly, especially at night. Feed near-dead Blood Bats to Krellis for experience.

Whichever option you choose, this is not the normal sort of scenario where you will slaughter all the enemy. Remember that you are just trying to get enough experience for Krellis to level up. Then have him run like hell for the signpost. Ignore gold for now. You don't need much on the next level.

Killing all the enemy leaders will end the level, but that won't be easy.

Spoiler: Killing any enemy leader is good for a bonus. Each one gives you a different bonus: cash, a loyal bat, or a ring of strength.

=== Wolf Coast ===

This is a fairly easy level to give you a break. Go north, then lure
wolves into the water where you can pick them off. If the wolves come
in too big of a pack, you can split them up by sending Citizens
off to the edges, in (or next to) shallow water.

You really should get a second healer leveled up here if you haven't yet.
Netcasters and enchantresses are probably your next priorities. You'll want a
bunch of both.

There is a storm trident in the southeast, sticking out of a pond. A fighter
would be a wise choice of holder, simply because they have a lot of hit points. With the
trident, he will level quickly. When you get him to level 3, choose Triton, as
Hoplites have only pierce melee attack (bad for Skeletons.)

Money is useful going into the next scenario, but it's hard to get
money out of this scenario. Scrounge every gold piece you can by
starting with mostly level 1's (and 0's) and taking villages.
Rushing for an early finish isn't really a good idea, as the
next scenario also demands leveled troops (or better yet:
about to level troops.)

=== Slavers ===

This is one of those scenarios that some will find impossible. However, rest assured it's possible, even on Difficult/Triton/Nightmare.

You get a free, loyal brawler.

There are two cages on the shore. One contains Keshan, a drake burner who can be very useful
during the campaign, and the other contains a poacher named
Siddry. He's not going to be much help here, and he won't come with you. However, if you
keep him alive, he comes back in The Flaming Sword with some friends who
are a big help taking villages in the beginning (and not much help
thereafter). If Siddry lives, he will be stored in a variable until
then.

The shipwreck in the north contains a treasure chest with 100
gold.

Recruit about two castles, one of which should be all level 2's. Hopefully
that includes at least one more healer. Healers are essential here. Any
units close to leveling are especially good.

Send a quick Citizen north to get the gold and villages along the way. Send
everyone else east. Hang back a bit during the first watch of the first night: don't try to
grab as much territory as possible, but do try to force the Saurians into water.

During daytime, be aggressive in taking out the troops and getting to the leader, but don't leave any units out and exposed. As always against Saurians, maintain a solid line and make constant use of
control-v to watch where the enemy can move.

For triggering the slave revolt, there are different options for timing:

Option 1, daytime (turn 5 or 6): If you trigger the revolt after you've made your attacks in the most favorable time of day, you can stick your neck out a bit during those attacks. Even if you leave a hole in your line, the enemy will probably be too distracted by slaves to bother your units (unless you leave a juicy wounded unit accessible.) Additionally, the slaves' attacks will be most effective at daytime, and the enemy's attacks against them will be least effective. However, this means the slaves will tend to linger on, possibly interfering with your ability to maintain a battleline or attack the units you want to attack.

Option 2, nightfall (turn 7 or 8): You could instigate the slave rebellion as night comes at the end of your first offensive. That will keep some the retalliation against you low, and slow down the Saurians coming towards you from the north.

When it's safe, rescue the drake, and try to get him some experience--carefully.

After taking out the leader and taking over the keep, you can recruit a unit or two as
replacements, and maybe a couple of Citizens for distractions, but you shouldn't need more than that, except maybe on Difficult. You should just be getting involved with the first wave from the north leader now. (He's slowed down by the water.) Sit tight around the castle until the enemy onslaught has thinned out. Try to secure the board edge east of the enemy fortress and north of the forest, so that you do not get surrounded.

After that it should be no problem wiping out the other two leaders--if you have survived this far, you have quite a few high-level units.

=== Tirigaz ===

This level is not too hard, so long as you give the high level undead their due respect.

Don't go too negative on gold, but recruit three or four high-level units. You need mostly leveled
initiates for their magic ranged attacks. Keshan is a big help, and
so is the unit with the storm trident.

Back off at the initial advance of the undead, waiting until daytime to go
after them. Keep a solid line to protect against Shadows/Nightgaunts.

If you decide to go after the orc leader, wait until the undead are dispatched. Heal everyone,
then assemble just to the north of his keep. Don't touch the ships
or piers though! Wait until daytime, then send in all the units
with magical attacks. Use other units to keep the slurbows
busy. Hopefully the leader won't kill anyone before your next
turn. One more round of magical attacks should kill him before his
recruits start beating you up. Killing the orc leader isn't really
necessary, but he helps someone level up, and he has a fair bit of
gold. The next level is much easier with lots of gold.

=== Uncharted Islands ===

Get some Citizens to collect gold and some more Citizens and level 1's to serve as cannon fodder
to help soak up the awesome damage capability of the first wave of monsters. Then, recall your
most powerful units. You need firepower. You also could really use the slow ability of Netcasters
and Entanglers. Two healers are probably a minimum.

Slide the first units around the
edges getting gold, because your income will be very negative in a
hurry, and you probably need all the firepower you can get. Don't
worry about gold too much though--you probably can't start the next
scenario with more than the minimum.

Keshan can handle the upper bottleneck section himself. He is good against the tentacles, and even
the cuttlefish if he stays healed. If you lack Keshan, then an Entangler will suffice.

Put everyone else in the middle, using terrain to your advantage. Use your auras as much as
possible: leadership and illuminate (Cylanna is a diviner by now isn't she?), and use
"slows" to keep all your units from dying. You will probably lose a
couple leveled-up ones anyway.

The loyal Cuttle Fish isn't terribly useful, but cool to have
anyway. When he levels into a Kraken, he is quite a
bit nicer to have.

=== BilHeld ===

This scenario should be rated "R" for massive violence! Both sides
can do lots of damage to the other.

Here's where you can use all the
piercing units you have. Hopefully you haven't been totally ignoring
the spearman and warrior lines. Even level one units can do pretty
high damage to drakes though, so you can level up some more
here. Get piercing units, almost exclusively. Netcasters aren't
really necessary, and one diviner is enough (but a second healer can help.)
However, don't get any units aside from maybe a few level zero Citizens for
about four turns. The drakes will take a while getting to
you, so just take some villages and let your income
work. Don't worry about holding the villages; you'll get a bonus
in the end if you survive. Just worry about getting enough units
so that you do survive.

Let the first wave of drakes come to you. You'll have the advantage in
the water--even against high-level units. They will kill some of your
weaker units, but you will do far more damage to them, and level up
some new ones in the process. If you survive the first wave, you should
be fine. You probably will have to do a little fighting on land towards the end.
Just be careful about how many units can attack each of yours.

=== Talking to Tyegea ===

No fighting to do here. Give one of your leveled fighters the holy water. Those units won't
be as useful after one more scenario unless they have special weapons.

=== The Mage ===

You need fire (i.e., storm trident) and pierce to take care of scorpions. Mermen Javelineers get
one more level to shine. Diviners are also great.

Hopefully you have Keshan, as he is especially helpful in actually finding the
mage. He can get there several turns ahead of even the fastest
Merman (after you take out most of the scorpions in the way), but of
course you don't need him. Without Keshan, the timing will
be very tight, and you must focus on killing the creepy crawlies
quickly and getting on your way ASAP.

=== The Flaming Sword ===

This is one of those scenarios where there are a lot of villages, so you will
want to start with some level 0 units (e.g., Mermen Citizens), but don't expect
them to last long. After you advance to the three villages in the center, you'll
want to retreat just as fast, as night will be coming, as well as a nasty wave
of high level Undead.

You defeat the lich to try to get the sword, but as soon as the lich
drops it, Caladon teleports in and picks it up. Now, you need to
defeat Caladon to get the sword. He grants you time to leave, which
is actually a turn to remove any very damaged units from the
vicinity as Caladon is pretty dangerous. You can attack him now, or
wait a turn for him to get impatient and attack you. When he
attacks, or you attack him, he summons fire guardians (stolen from
UtBS). He does not also recruit, because that would just be
mean. (There is no reason he would have much gold anyway.)

=== Getting Help ===
(No walkthrough comments yet.)

=== Revenge ===
(No walkthrough comments yet.)

Dead Water

2010-09-09T06:18:46Z

Beetlenaut: /* Invasion */

This walkthrough started with the comments in the cfg files, which are based on normal difficulty. Maiklas3000 has updated the comments for difficult (Triton/nightmare) level. Feel free to add your own comments. Place your attribution here (using "edit" at the bottom) rather than in each scenario.

==Campaign Strategy==
You have piercing-attack Mermen to fight pierce-resistant Undead. What to do? Fortunately, for this campaign you are given a special impact unit, namely the Merman Brawler, which is an advancement of Merman Citizen, the peasants of the Mermen. Spamming Citizens and promoting them to Brawler is one of the keys to the campaign. Take note of the Brawlers' tail attacks with "stun", which can sometimes be used to good effect to disrupt Z.O.C's. You should also aggressively advance Hunters to Netcasters for their impact attacks, with "slow" as a bonus on the ranged attack. Many scenarios benefit from having at least two healers, so you should also promote an Initiate or two (or three) to Priestess early on, to supplement your starting Priestess, Cylanna, whom you should try to promote quickly to Diviner for the illumination. Fighters/Warriors and Spearmen are less useful in this campaign, but you do not always fight Undead, so groom a few on your roster "just in case."

This is a campaign where it pays to read one scenario ahead, to see if you can better prepare yourself.

==Scenarios==

=== Invasion ===
This scenario is tricky. Mastering a winning strategy may take you a few attempts.

A key feature of this scenario is that when the Undead capture any village, Walking Corpses spawn. (Soulless spawn on Difficult.) In light of this, you have two possible strategies, with which others have had success:

Option 1: Leader assassination / blitzbrieg. First turn, recruit several level 1 units and just a couple Citizens. Advance on the enemy leader and kill him. The enemy will be focused on capturing villages in order to create an overwhelming number of Walking Corpses - so much so that you may be able to just walk in and kill their leader.

Option 2: "General Motorsing". Your basic strategy should be to take and hold as many villages as possible, both to prevent the spawning and to boost your income. If possible, grant the enemy only the three villages closest to his keep (not counting the two in the mountains, which your Mermen can't do anything about.) If you don't let many villages fall into enemy hands, eventually your income will be overwhelming. First turn, recruit only a couple of level 1 units, and the rest Citizens. Send the level 1's south to capture and protect villages there and send the Citizens in all directions to snatch up villages. Try not to lose any of the villages north of the eastern river. On Difficult, this is a challenge, but quite possible. To accomplish this, use the Citizen in the east to help Cylanna protect the villages there from the Skeleton that starts nearby. Keep that area free of Soulless and Walking Corpses, so that you can concentrate your Citizens there and suicide attack them versus Skeletons.

If you start losing villages, it may not be the end of the world. You can sacrifice the land villages, but hold the ones in the water, using a couple of Fighters/Hunters plus Citizens. Use Cylanna, Gwabbo, and a few Citizens to hold off the Skeletons and Soulless southeast of your keep until the village situation is under control.

Let the swimming Soulless/WC advance a bit towards your keep, so that your baby king can dart out to get an easy kill or two. As Gwabbo hints, you would be wise to get Krellis as much experience as possible this scenario; it will make the next scenario much easier.

Attack during the day, but retreat and heal at night. Keep your Citizens and wounded safe from becoming WC's, which often means sitting them on villages, but you can think of other ways, like using the ZOC's of level 1's and 2's to protect them.

Bat control is essential. Don't let even one Bat get into your rear area, or it may spell defeat. Initiates are good against Bats. A key to success is understanding how the Bats work. They will forego capturing a village in favor of making an attack. So, if there is a friendly or unowned village within range of a Bat, you have to make sure the Bat has someone to attack. Citizens make good bat bait.

Towards the end, your income will be quite large, so if the situation is under control, then it's better to milk XP than go for an early finish. You can swarm the enemy keep with Citizens and take your time to end it. Try to turn some of the Citizens into Brawlers.

=== Flight ===

Hopefully Kai Krellis is at least half leveled up already. Otherwise, this can be painful, as one of the victory conditions is that the Kai must be at least level 1.

You must decide whether to attack east or southwest. To the east is the prospect of more experience, while to the southwest is an easier foe and less distance for Krellis to travel back to the signpost.

Option 1, east: Recruit a bunch of Citizens
and Brawlers, and send them east with Krellis. Use Citizens to lure
the Skeleton Archer types into the water. They are easy pickings
there for other Citizens, Brawlers, and Krellis. One of those guys
gets Krellis half way up to level one. A few Citizens should also
survive to become Brawlers. Remember that you can often turn a near-dead
Citizen into a healthy Brawler by going for a kill, especially with
the leadership of Krellis if he is already at level 1.
About the time you get Krellis leveled
up, and you are thinking about retreating everyone else, the bats
will arrive. On Difficult, this will be a nasty number of Blood Bats.
Use Hunters and Initiates to clear a path back west. Send three or four
expendable units with Krellis. Their job is only to serve as bat bait,
distracting the bats from Krellis, so that he does not get ZOC-locked.
Krellis runs for the corner, while the rest of the troops gain experience doing a
fighting retreat from the skeletons and other bad guys arriving in
the middle of the map.

Option 2, southwest: Send Citizens east, while your best troops go southwest. After you advance to where you meet the enemy, you will start retreating almost as quickly, especially at night. Feed near-dead Blood Bats to Krellis for experience.

Whichever option you choose, this is not the normal sort of scenario where you will slaughter all the enemy. Remember that you are just trying to get enough experience for Krellis to level up. Then have him run like hell for the signpost. Ignore gold for now. You don't need much on the next level.

Killing all the enemy leaders will end the level, but that won't be easy.

Spoiler: Killing any enemy leader is good for a bonus. Each one gives you a different bonus: cash, a loyal bat, or a ring of strength.

=== Wolf Coast ===

This is a fairly easy level to give you a break. Go north, then lure
wolves into the water where you can pick them off. If the wolves come
in too big of a pack, you can split them up by sending Citizens
off to the edges, in (or next to) shallow water.

You really should get a second healer leveled up here if you haven't yet.
Netcasters and enchantresses are probably your next priorities. You'll want a
bunch of both.

There is a storm trident in the southeast, sticking out of a pond. A fighter
would be a wise choice of holder, simply because they have a lot of hit points. With the
trident, he will level quickly. When you get him to level 3, choose Triton, as
Hoplites have only pierce melee attack (bad for Skeletons.)

Money is useful going into the next scenario, but it's hard to get
money out of this scenario. Scrounge every gold piece you can by
starting with mostly level 1's (and 0's) and taking villages.
Rushing for an early finish isn't really a good idea, as the
next scenario also demands leveled troops (or better yet:
about to level troops.)

=== Slavers ===

This is one of those scenarios that some will find impossible. However, rest assured it's possible, even on Difficult/Triton/Nightmare.

You get a free, loyal brawler.

There are two cages on the shore. One contains Keshan, a drake burner who can be very useful
during the campaign, and the other contains a poacher named
Siddry. He's not going to be much help here, and he won't come with you. However, if you
keep him alive, he comes back in The Flaming Sword with some friends who
are a big help taking villages in the beginning (and not much help
thereafter). If Siddry lives, he will be stored in a variable until
then.

The shipwreck in the north contains a treasure chest with 100
gold.

Recruit about two castles, one of which should be all level 2's. Hopefully
that includes at least one more healer. Healers are essential here. Any
units close to leveling are especially good.

Send a quick Citizen north to get the gold and villages along the way. Send
everyone else east. Hang back a bit during the first watch of the first night: don't try to
grab as much territory as possible, but do try to force the Saurians into water.

During daytime, be aggressive in taking out the troops and getting to the leader, but don't leave any units out and exposed. As always against Saurians, maintain a solid line and make constant use of
control-v to watch where the enemy can move.

For triggering the slave revolt, there are different options for timing:

Option 1, daytime (turn 5 or 6): If you trigger the revolt after you've made your attacks in the most favorable time of day, you can stick your neck out a bit during those attacks. Even if you leave a hole in your line, the enemy will probably be too distracted by slaves to bother your units (unless you leave a juicy wounded unit accessible.) Additionally, the slaves' attacks will be most effective at daytime, and the enemy's attacks against them will be least effective. However, this means the slaves will tend to linger on, possibly interfering with your ability to maintain a battleline or attack the units you want to attack.

Option 2, nightfall (turn 7 or 8): You could instigate the slave rebellion as night comes at the end of your first offensive. That will keep some the retalliation against you low, and slow down the Saurians coming towards you from the north.

When it's safe, rescue the drake, and try to get him some experience--carefully.

After taking out the leader and taking over the keep, you can recruit a unit or two as
replacements, and maybe a couple of Citizens for distractions, but you shouldn't need more than that, except maybe on Difficult. You should just be getting involved with the first wave from the north leader now. (He's slowed down by the water.) Sit tight around the castle until the enemy onslaught has thinned out. Try to secure the board edge east of the enemy fortress and north of the forest, so that you do not get surrounded.

After that it should be no problem wiping out the other two leaders--if you have survived this far, you have quite a few high-level units.

=== Tirigaz ===

This level is not too hard, so long as you give the high level undead their due respect.

Don't go too negative on gold, but recruit three or four high-level units. You need mostly leveled
initiates for their magic ranged attacks. Keshan is a big help, and
so is the unit with the storm trident.

Back off at the initial advance of the undead, waiting until daytime to go
after them. Keep a solid line to protect against Shadows/Nightgaunts.

If you decide to go after the orc leader, wait until the undead are dispatched. Heal everyone,
then assemble just to the north of his keep. Don't touch the ships
or piers though! Wait until daytime, then send in all the units
with magical attacks. Use other units to keep the slurbows
busy. Hopefully the leader won't kill anyone before your next
turn. One more round of magical attacks should kill him before his
recruits start beating you up. Killing the orc leader isn't really
necessary, but he helps someone level up, and he has a fair bit of
gold. The next level is much easier with lots of gold.

=== Uncharted Islands ===

Get some Citizens to collect gold and some more Citizens and level 1's to serve as cannon fodder
to help soak up the awesome damage capability of the first wave of monsters. Then, recall your
most powerful units. You need firepower. You also could really use the slow ability of Netcasters
and Entanglers. Two healers are probably a minimum.

Slide the first units around the
edges getting gold, because your income will be very negative in a
hurry, and you probably need all the firepower you can get. Don't
worry about gold too much though--you probably can't start the next
scenario with more than the minimum.

Keshan can handle the upper bottleneck section himself. He is good against the tentacles, and even
the cuttlefish if he stays healed. If you lack Keshan, then an Entangler will suffice.

Put everyone else in the middle, using terrain to your advantage. Use your auras as much as
possible: leadership and illuminate (Cylanna is a diviner by now isn't she?), and use
"slows" to keep all your units from dying. You will probably lose a
couple leveled-up ones anyway.

The loyal Cuttle Fish isn't terribly useful, but cool to have
anyway. When he levels into a Kraken, he is quite a
bit nicer to have. (And pretty cool looking if I do say so myself.)

=== BilHeld ===

This scenario should be rated "R" for massive violence! Both sides
can do lots of damage to the other.

Here's where you can use all the
piercing units you have. Hopefully you haven't been totally ignoring
the spearman and warrior lines. Even level one units can do pretty
high damage to drakes though, so you can level up some more
here. Get piercing units, almost exclusively. Netcasters aren't
really necessary, and one diviner is enough (but a second healer can help.)
However, don't get any units aside from maybe a few level zero Citizens for
about four turns. The drakes will take a while getting to
you, so just take some villages and let your income
work. Don't worry about holding the villages; you'll get a bonus
in the end if you survive. Just worry about getting enough units
so that you do survive.

Let the first wave of drakes come to you. You'll have the advantage in
the water--even against high-level units. They will kill some of your
weaker units, but you will do far more damage to them, and level up
some new ones in the process. If you survive the first wave, you should
be fine. You probably will have to do a little fighting on land towards the end.
Just be careful about how many units can attack each of yours.

=== Talking to Tyegea ===

No fighting to do here. Give one of your leveled fighters the holy water. Those units won't
be as useful after one more scenario unless they have special weapons.

=== The Mage ===

You need fire (i.e., storm trident) and pierce to take care of scorpions. Mermen Javelineers get
one more level to shine. Diviners are also great.

Hopefully you have Keshan, as he is especially helpful in actually finding the
mage. He can get there several turns ahead of even the fastest
Merman (after you take out most of the scorpions in the way), but of
course you don't need him. Without Keshan, the timing will
be very tight, and you must focus on killing the creepy crawlies
quickly and getting on your way ASAP.

=== The Flaming Sword ===

This is one of those scenarios where there are a lot of villages, so you will
want to start with some level 0 units (e.g., Mermen Citizens), but don't expect
them to last long. After you advance to the three villages in the center, you'll
want to retreat just as fast, as night will be coming, as well as a nasty wave
of high level Undead.

You defeat the lich to try to get the sword, but as soon as the lich
drops it, Caladon teleports in and picks it up. Now, you need to
defeat Caladon to get the sword. He grants you time to leave, which
is actually a turn to remove any very damaged units from the
vicinity as Caladon is pretty dangerous. You can attack him now, or
wait a turn for him to get impatient and attack you. When he
attacks, or you attack him, he summons fire guardians (stolen from
UtBS). He does not also recruit, because that would just be
mean. (There is no reason he would have much gold anyway.)

=== Getting Help ===
(No walkthrough comments yet.)

=== Revenge ===
(No walkthrough comments yet.)

Dead Water

2010-09-09T06:17:03Z

Beetlenaut: /* Campaign Strategy */

This walkthrough started with the comments in the cfg files, which are based on normal difficulty. Maiklas3000 has updated the comments for difficult (Triton/nightmare) level. Feel free to add your own comments. Place your attribution here (using "edit" at the bottom) rather than in each scenario.

==Campaign Strategy==
You have piercing-attack Mermen to fight pierce-resistant Undead. What to do? Fortunately, for this campaign you are given a special impact unit, namely the Merman Brawler, which is an advancement of Merman Citizen, the peasants of the Mermen. Spamming Citizens and promoting them to Brawler is one of the keys to the campaign. Take note of the Brawlers' tail attacks with "stun", which can sometimes be used to good effect to disrupt Z.O.C's. You should also aggressively advance Hunters to Netcasters for their impact attacks, with "slow" as a bonus on the ranged attack. Many scenarios benefit from having at least two healers, so you should also promote an Initiate or two (or three) to Priestess early on, to supplement your starting Priestess, Cylanna, whom you should try to promote quickly to Diviner for the illumination. Fighters/Warriors and Spearmen are less useful in this campaign, but you do not always fight Undead, so groom a few on your roster "just in case."

This is a campaign where it pays to read one scenario ahead, to see if you can better prepare yourself.

==Scenarios==

=== Invasion ===
This scenario is tricky. Mastering a winning strategy may take you a few attempts.

A key feature of this scenario is that when the Undead capture any village, Walking Corpses spawn. (Soulless spawn on Difficult.) In light of this, you have two possible strategies, with which others have had success:

Option 1: Leader assassination / blitzbrieg. First turn, recruit several level 1 units and just a couple Citizens. Advance on the enemy leader and kill him. The enemy will be focused on capturing villages in order to create an overwhelming number of Walking Corpses - so much so that you may be able to just walk in and kill their leader.

Option 2: "General Motorsing". Your basic strategy should be to take and hold as many villages as possible, both to prevent the spawning and to boost your income. If possible, grant the enemy only the three villages closest to his keep (not counting the two in the mountains, which your Mermen can't do anything about.) If you don't let many villages fall into enemy hands, eventually your income will be overwhelming. First turn, recruit only a couple of level 1 units, and the rest Citizens. Send the level 1's south to capture and protect villages there and send the Citizens in all directions to snatch up villages. Try not to lose any of the villages north of the eastern river. On Difficult, this is a challenge, but quite possible. To accomplish this, it is necessary that you got a Quick Citizen in the east on the scenario start, so that it can help Cylanna protect the villages there from the Skeleton that starts nearby. Keep that area free of Soulless and Walking Corpses, so that you can concentrate your Citizens there and suicide attack them versus Skeletons.

If you start losing villages, it may not be the end of the world. You can sacrifice the land villages, but hold the ones in the water, using a couple of Fighters/Hunters plus Citizens. Use Cylanna, Gwabbo, and a few Citizens to hold off the Skeletons and Soulless southeast of your keep until the village situation is under control.

Let the swimming Soulless/WC advance a bit towards your keep, so that your baby king can dart out to get an easy kill or two. As Gwabbo hints, you would be wise to get Krellis as much experience as possible this scenario; it will make the next scenario much easier.

Attack during the day, but retreat and heal at night. Keep your Citizens and wounded safe from becoming WC's, which often means sitting them on villages, but you can think of other ways, like using the ZOC's of level 1's and 2's to protect them.

Bat control is essential. Don't let even one Bat get into your rear area, or it may spell defeat. Initiates are good against Bats. A key to success is understanding how the Bats work. They will forego capturing a village in favor of making an attack. So, if there is a friendly or unowned village within range of a Bat, you have to make sure the Bat has someone to attack. Citizens make good bat bait.

Towards the end, your income will be quite large, so if the situation is under control, then it's better to milk XP than go for an early finish. You can swarm the enemy keep with Citizens and take your time to end it. Try to turn some of the Citizens into Brawlers.

=== Flight ===

Hopefully Kai Krellis is at least half leveled up already. Otherwise, this can be painful, as one of the victory conditions is that the Kai must be at least level 1.

You must decide whether to attack east or southwest. To the east is the prospect of more experience, while to the southwest is an easier foe and less distance for Krellis to travel back to the signpost.

Option 1, east: Recruit a bunch of Citizens
and Brawlers, and send them east with Krellis. Use Citizens to lure
the Skeleton Archer types into the water. They are easy pickings
there for other Citizens, Brawlers, and Krellis. One of those guys
gets Krellis half way up to level one. A few Citizens should also
survive to become Brawlers. Remember that you can often turn a near-dead
Citizen into a healthy Brawler by going for a kill, especially with
the leadership of Krellis if he is already at level 1.
About the time you get Krellis leveled
up, and you are thinking about retreating everyone else, the bats
will arrive. On Difficult, this will be a nasty number of Blood Bats.
Use Hunters and Initiates to clear a path back west. Send three or four
expendable units with Krellis. Their job is only to serve as bat bait,
distracting the bats from Krellis, so that he does not get ZOC-locked.
Krellis runs for the corner, while the rest of the troops gain experience doing a
fighting retreat from the skeletons and other bad guys arriving in
the middle of the map.

Option 2, southwest: Send Citizens east, while your best troops go southwest. After you advance to where you meet the enemy, you will start retreating almost as quickly, especially at night. Feed near-dead Blood Bats to Krellis for experience.

Whichever option you choose, this is not the normal sort of scenario where you will slaughter all the enemy. Remember that you are just trying to get enough experience for Krellis to level up. Then have him run like hell for the signpost. Ignore gold for now. You don't need much on the next level.

Killing all the enemy leaders will end the level, but that won't be easy.

Spoiler: Killing any enemy leader is good for a bonus. Each one gives you a different bonus: cash, a loyal bat, or a ring of strength.

=== Wolf Coast ===

This is a fairly easy level to give you a break. Go north, then lure
wolves into the water where you can pick them off. If the wolves come
in too big of a pack, you can split them up by sending Citizens
off to the edges, in (or next to) shallow water.

You really should get a second healer leveled up here if you haven't yet.
Netcasters and enchantresses are probably your next priorities. You'll want a
bunch of both.

There is a storm trident in the southeast, sticking out of a pond. A fighter
would be a wise choice of holder, simply because they have a lot of hit points. With the
trident, he will level quickly. When you get him to level 3, choose Triton, as
Hoplites have only pierce melee attack (bad for Skeletons.)

Money is useful going into the next scenario, but it's hard to get
money out of this scenario. Scrounge every gold piece you can by
starting with mostly level 1's (and 0's) and taking villages.
Rushing for an early finish isn't really a good idea, as the
next scenario also demands leveled troops (or better yet:
about to level troops.)

=== Slavers ===

This is one of those scenarios that some will find impossible. However, rest assured it's possible, even on Difficult/Triton/Nightmare.

You get a free, loyal brawler.

There are two cages on the shore. One contains Keshan, a drake burner who can be very useful
during the campaign, and the other contains a poacher named
Siddry. He's not going to be much help here, and he won't come with you. However, if you
keep him alive, he comes back in The Flaming Sword with some friends who
are a big help taking villages in the beginning (and not much help
thereafter). If Siddry lives, he will be stored in a variable until
then.

The shipwreck in the north contains a treasure chest with 100
gold.

Recruit about two castles, one of which should be all level 2's. Hopefully
that includes at least one more healer. Healers are essential here. Any
units close to leveling are especially good.

Send a quick Citizen north to get the gold and villages along the way. Send
everyone else east. Hang back a bit during the first watch of the first night: don't try to
grab as much territory as possible, but do try to force the Saurians into water.

During daytime, be aggressive in taking out the troops and getting to the leader, but don't leave any units out and exposed. As always against Saurians, maintain a solid line and make constant use of
control-v to watch where the enemy can move.

For triggering the slave revolt, there are different options for timing:

Option 1, daytime (turn 5 or 6): If you trigger the revolt after you've made your attacks in the most favorable time of day, you can stick your neck out a bit during those attacks. Even if you leave a hole in your line, the enemy will probably be too distracted by slaves to bother your units (unless you leave a juicy wounded unit accessible.) Additionally, the slaves' attacks will be most effective at daytime, and the enemy's attacks against them will be least effective. However, this means the slaves will tend to linger on, possibly interfering with your ability to maintain a battleline or attack the units you want to attack.

Option 2, nightfall (turn 7 or 8): You could instigate the slave rebellion as night comes at the end of your first offensive. That will keep some the retalliation against you low, and slow down the Saurians coming towards you from the north.

When it's safe, rescue the drake, and try to get him some experience--carefully.

After taking out the leader and taking over the keep, you can recruit a unit or two as
replacements, and maybe a couple of Citizens for distractions, but you shouldn't need more than that, except maybe on Difficult. You should just be getting involved with the first wave from the north leader now. (He's slowed down by the water.) Sit tight around the castle until the enemy onslaught has thinned out. Try to secure the board edge east of the enemy fortress and north of the forest, so that you do not get surrounded.

After that it should be no problem wiping out the other two leaders--if you have survived this far, you have quite a few high-level units.

=== Tirigaz ===

This level is not too hard, so long as you give the high level undead their due respect.

Don't go too negative on gold, but recruit three or four high-level units. You need mostly leveled
initiates for their magic ranged attacks. Keshan is a big help, and
so is the unit with the storm trident.

Back off at the initial advance of the undead, waiting until daytime to go
after them. Keep a solid line to protect against Shadows/Nightgaunts.

If you decide to go after the orc leader, wait until the undead are dispatched. Heal everyone,
then assemble just to the north of his keep. Don't touch the ships
or piers though! Wait until daytime, then send in all the units
with magical attacks. Use other units to keep the slurbows
busy. Hopefully the leader won't kill anyone before your next
turn. One more round of magical attacks should kill him before his
recruits start beating you up. Killing the orc leader isn't really
necessary, but he helps someone level up, and he has a fair bit of
gold. The next level is much easier with lots of gold.

=== Uncharted Islands ===

Get some Citizens to collect gold and some more Citizens and level 1's to serve as cannon fodder
to help soak up the awesome damage capability of the first wave of monsters. Then, recall your
most powerful units. You need firepower. You also could really use the slow ability of Netcasters
and Entanglers. Two healers are probably a minimum.

Slide the first units around the
edges getting gold, because your income will be very negative in a
hurry, and you probably need all the firepower you can get. Don't
worry about gold too much though--you probably can't start the next
scenario with more than the minimum.

Keshan can handle the upper bottleneck section himself. He is good against the tentacles, and even
the cuttlefish if he stays healed. If you lack Keshan, then an Entangler will suffice.

Put everyone else in the middle, using terrain to your advantage. Use your auras as much as
possible: leadership and illuminate (Cylanna is a diviner by now isn't she?), and use
"slows" to keep all your units from dying. You will probably lose a
couple leveled-up ones anyway.

The loyal Cuttle Fish isn't terribly useful, but cool to have
anyway. When he levels into a Kraken, he is quite a
bit nicer to have. (And pretty cool looking if I do say so myself.)

=== BilHeld ===

This scenario should be rated "R" for massive violence! Both sides
can do lots of damage to the other.

Here's where you can use all the
piercing units you have. Hopefully you haven't been totally ignoring
the spearman and warrior lines. Even level one units can do pretty
high damage to drakes though, so you can level up some more
here. Get piercing units, almost exclusively. Netcasters aren't
really necessary, and one diviner is enough (but a second healer can help.)
However, don't get any units aside from maybe a few level zero Citizens for
about four turns. The drakes will take a while getting to
you, so just take some villages and let your income
work. Don't worry about holding the villages; you'll get a bonus
in the end if you survive. Just worry about getting enough units
so that you do survive.

Let the first wave of drakes come to you. You'll have the advantage in
the water--even against high-level units. They will kill some of your
weaker units, but you will do far more damage to them, and level up
some new ones in the process. If you survive the first wave, you should
be fine. You probably will have to do a little fighting on land towards the end.
Just be careful about how many units can attack each of yours.

=== Talking to Tyegea ===

No fighting to do here. Give one of your leveled fighters the holy water. Those units won't
be as useful after one more scenario unless they have special weapons.

=== The Mage ===

You need fire (i.e., storm trident) and pierce to take care of scorpions. Mermen Javelineers get
one more level to shine. Diviners are also great.

Hopefully you have Keshan, as he is especially helpful in actually finding the
mage. He can get there several turns ahead of even the fastest
Merman (after you take out most of the scorpions in the way), but of
course you don't need him. Without Keshan, the timing will
be very tight, and you must focus on killing the creepy crawlies
quickly and getting on your way ASAP.

=== The Flaming Sword ===

This is one of those scenarios where there are a lot of villages, so you will
want to start with some level 0 units (e.g., Mermen Citizens), but don't expect
them to last long. After you advance to the three villages in the center, you'll
want to retreat just as fast, as night will be coming, as well as a nasty wave
of high level Undead.

You defeat the lich to try to get the sword, but as soon as the lich
drops it, Caladon teleports in and picks it up. Now, you need to
defeat Caladon to get the sword. He grants you time to leave, which
is actually a turn to remove any very damaged units from the
vicinity as Caladon is pretty dangerous. You can attack him now, or
wait a turn for him to get impatient and attack you. When he
attacks, or you attack him, he summons fire guardians (stolen from
UtBS). He does not also recruit, because that would just be
mean. (There is no reason he would have much gold anyway.)

=== Getting Help ===
(No walkthrough comments yet.)

=== Revenge ===
(No walkthrough comments yet.)

InterfaceActionsWML

2010-03-20T06:29:36Z

Beetlenaut: /* Other interface tags */

{{WML Tags}}
== Interface actions ==

Interface actions are actions that do not have an effect on gameplay;
instead, they show something to the player. The main interface tags
are '''[message]''' and '''[objectives]''', but several other tags affect
the interface also.

== [inspect] ==
This user interface action only works in debug mode. It displays the gamestate inspector dialog (the same one which can be brought up with '':inspect'' ), which can be used to inspect the values of WML variables, AI configuration, recall lists, and more.

* '''name''': optional attribute to specify the name of this gamestate inspector dialog. It is just a label to help differentiate between different invocations of gamestate inspector dialog.

== [message] ==
The most commonly used interface action is [message], which displays a message to the user in a dialog box. It can also be used to take input from the user.

The following key/tags are accepted for [message]:
* [[StandardUnitFilter]]: The unit whose profile and name are displayed. Do not use a [filter] tag. If no unit matching this filter is found, the message is not displayed (The unit has probably been killed). '''[message]''' elements should be constructed so that it is either guaranteed that a certain unit is alive, or so that dialog flows smoothly even if the message isn't displayed.

* '''speaker''': an alternative to standard unit filter. You may specify as the value of the speaker attribute a unit id or any of the following special values:
** '''narrator''': the dialog box is displayed without a caption for the unit speaking or a unit image
** '''unit''': the primary unit for the event is speaking
** '''second_unit''': the secondary unit for the event is speaking

* '''message''': (translatable) the text to display to the right of the image. ''message'' is sometimes multiple lines; if it is, be sure to use quotes(''' ' ''' or ''' " ''')
* '''[show_if]''': if present then this message will only be displayed if the conditional statement in this tag is passed (see [[ConditionalActionsWML#Condition_Tags|ConditionalActionsWML]])
* '''side_for''': (default: all sides) comma-separated list of sides for who message is shown.
* '''image''': (default: profile image of speaker) the image to display next to the message.
* '''caption''': (default: name of speaker) the caption to display beside the image. Name to be displayed.
* '''duration''': (default: 10) the minimum number of frames for this message to be displayed. (A frame lasts about 30 milliseconds.) During this time any dialog decisions will be disregarded.
* '''sound''': a sound effect (wav file) to play as the message is displayed. This can be a comma-separated list, from which one will be randomly chosen.
* '''[option]''': zero or more '''[option]''' elements may be present. If '''[option]''' elements are present, then each option will be displayed in a menu for the user to select one option.
** '''message''': (translatable) the text displayed for the option (see [[DescriptionWML]])
** '''[show_if]''': if present then this option will only be displayed if the conditional statement in this tag is passed (see [[InternalActionsWML]])
** '''[command]''': an element containing actions which are executed if the option is selected.
* '''[text_input]''': there can be only one [text_input] tag. this adds a text input field to the message.
** '''variable''': the variable that the user's input will be written to
** '''label''': a text label to the left of the input field
** '''max_chars''': the maximum number of characters that may be typed into the field
** '''text''': text that is written into the field in the beginning
* Check [[EventWML#Multiplayer_safety]] to find out in which events you can safely use '''[option]''' and '''[text_input]''' without causing OOS.

=== Formatting ===

Text formatting options for '''[message]'''. These can also be used in unit names (user_description), objectives, and such.
* A tilde (~) as the first character causes the line to be boldfaced.
* An at symbol (@) as the first character causes the line to be green, as done with victory conditions.
* A pound symbol (#) as the first character causes the line to be red, as done with defeat conditions.
* An asterisk (*) as the first character causes the line to be bigger.
* A backquote (`) as the first character causes the line to be smaller.
* If used, the caption key text is boldfaced.
* An RGB colour code in the beginning causes the line to be the given colour. This can still be preceded by the above characters. Example: ''message=_"<255,0,0>Red!"''

{{DevFeature}} In the 1.7 branch these formatting codes are being discarded in favor of [http://library.gnome.org/devel/pango/unstable/PangoMarkupFormat.html Pango markup]. Note that it's easiest to use ' for quoting in Pango markup since " is encoded as "" inside a WML string (so you have to modify the Pango examples accordingly if you want to use " quotes). Running wmllint on your campaign will up-convert it, warning you about unusual cases you must fix by hand.

== [objectives] ==
The other tag used for plot development is '''[objectives]'''.
The '''[objectives]''' tag overwrites any previously set objectives,
and displays text which should describe the objectives of the scenario.
Scenario objectives are displayed on the player's first turn after the tag is used,
or as part of the event if it triggers during that player's turn.
Objectives can also be accessed at any time in a scenario using the
"Scenario Objectives" game menu option, making this tag useful for
scenario-specific information that the player may need to refer to during play.

This tag renders the ''objectives'' attribute of [scenario] obsolete (see ''objectives'', [[ScenarioWML]]).
Instead of using ''objectives'', use '''[objectives]''' to set scenario objectives inside a prestart event.
It can also be used to overwrite the starting objectives mid-scenario.

Attributes of '''[objectives]''':
* '''side''': Default '0'. The side to set the objectives for. A value of 0 sets objectives for all sides.
* '''summary''': Displayed first in the objectives text, this should describe the basic objective for the overall scenario. Can be omitted.
* '''note''': Displayed last in the objectives text, this is sometimes used for hints or additional information. Can be omitted.
* '''victory_string''': Default ' _ "Victory:"', this text precedes the victory objectives.
* '''defeat_string''': Default ' _ "Defeat:"', this text precedes the defeat objectives.
* '''silent''': Default: not present. If set to "yes", the objectives are silently changed. Else, they will be shown to the user when appropriate.

Tags of '''[objectives]''':
* '''[objective]''': describes a win or loss condition. Most scenarios have multiple win or loss conditions, so use a separate [objective] subtag for each line; this helps with translations.
** '''description''': text for the specific win or loss condition.
** '''condition''': The color and placement of the text. Values are 'win'(colored green, placed after ''victory_string'') and 'lose'(colored red, placed after ''defeat_string'')
** '''[show_if]''': A condition that disables the objective if it doesn't hold. Conditional objectives are refreshed at '''[show_objectives]''' time only. {{DevFeature}}

=== Macros ===
There are a few predefined macros for Objectives that you can use to shorten the code: [http://www.wesnoth.org/macro-reference.xhtml#SET_OBJECTIVES SET_OBJECTIVES], [http://www.wesnoth.org/macro-reference.xhtml#VICTORY_CONDITION VICTORY_CONDITION], and [http://www.wesnoth.org/macro-reference.xhtml#DEFEAT_CONDITION DEFEAT_CONDITION]. Follow the links for each one to see complete syntax and example usage.

== [set_menu_item] ==
This tag is used to add a custom option in the right-click context menu which can then be used to trigger arbitrary WML commands.

'''Note:''' Due to limitations in portable devices where there are no scroll bars for context menus, there is a hard-coded limit of 7 custom WML menu items. If you really need to have more than 7 menu items, try combining some of them in a submenu.

* '''id''': the unique id for this menu item. If a menu item with this id already exists, it allows you to set specific changes to that item.
* '''description''': the in-game text that will appear for this item in the menu.
* '''image''': the image to display next to this item.
* '''needs_select''': if ''yes'' (default ''no''), then the latest select event (see [[EventWML]]) that triggered before this menu item was chosen will be transmitted over the network before this menu item action will be. This only has any effect in networked multiplayer, and is intended to allow more elaborate menu item behaviour there without causing out of sync errors. If you don't know what this means, just leave it false.
* '''[show_if]''': If present, the menu item will only be available if the conditional statement (see [[InternalActionsWML]]) within evaluates to true. When this is evaluated, the WML variables ''$x1'' and ''$y1'' will point to the location on which the context menu was invoked, so it's possible to for example only enable the option on empty hexes or on a particular unit.
* '''[filter_location]''': contains a location filter similar to the one found inside Single Unit Filters (see [[FilterWML]]). The menu item will only be available on matching locations.
* '''[command]''': contains the WML actions to be executed when the menu item is selected. Again, the WML variables ''$x1'' and ''$y1'' will point to the location on which the context menu was invoked on.

== Other interface tags ==

The following tags are also action tags:
* '''[item]''': makes a graphical item appear on a certain hex. Note this only places the graphics for an item. It does not make the item do anything. Use a moveto event to make moving onto the item do something. <tt>''('''Hint:''' There are a number of predefined items that are used in various campaigns that you can make use of. You can find [http://www.wesnoth.org/macro-reference.xhtml#file:items.cfg a list of them] if you look into the items.cfg file in the wesnoth install directory (under /data/core/macros))''</tt>
** '''x''', '''y''': the location to place the item.
** '''image''': the image (in ''images/'' as .png) to place on the hex.
** '''halo''': an image to place centered on the hex. Use this instead of ''image'' if the image is bigger than the hex or if you want to animate an image. ''Example (where the integer after the colon is the duration of each frame): halo=scenery/fire1.png:100,scenery/fire2.png:100,scenery/fire3.png:100,scenery/fire4.png:100,scenery/fire5.png:100,scenery/fire6.png:100,scenery/fire7.png:100,scenery/fire8.png:100''
** '''team_name''': name of the team for which the item is to be displayed (hidden for others). For multiple teams just put all the names in one string, for example separated by commas.
** '''visible_in_fog''': whether the item should be visible through fog or not. Default yes.
* '''[removeitem]''': removes any graphical items on a given hex
** '''x''', '''y''': the hex to remove items off
** '''image''' if specified, only removes the given image item (This image name must include any [[ImagePathFunctionWML|image path functions]] appended to the original image name.)
* '''[print]''': displays a message across the screen. The message will disappear after a certain time.
** '''text''': (translatable) the text to display.
** '''size''': (default=12) the pointsize of the font to use
** '''duration''': (default=50) the length of time to display the text for. This is measured in the number of 'frames'. A frame in Wesnoth is usually displayed for around 30ms.
** '''red''', '''green''', '''blue''': (default=0,0,0) the color to display the text in. Values vary from 0-255.
* '''[move_unit_fake]''': moves an image of a unit along a certain path on the map. The path does not need to be a continuous list of adjacent hexes, so for example only the start and end points can be given, in which case the straightest line between those points will be calculated and used.
** '''type''': the type of the unit whose image to use
** '''x''': a comma-separated list of x locations to move along
** '''y''': a comma-separated list of y locations to move along (x and y values are matched pairs)
** '''side''': the side of the fake unit, used for team-coloring the fake unit
* '''[hide_unit]''': makes the given unit become invisible. Useful in conjunction with '''[move_unit_fake]''': to move a leader unit into position on-screen. Each '''[hide_unit]''' tag only hides one unit.
** '''x''', '''y''': location of the unit to be hidden. (NOT a standard unit filter! Just x and y.)
* '''[unhide_unit]''': stops the currently hidden unit from being hidden.
* '''[scroll]''': Scroll a certain number of pixels in a given direction. Useful for earthquake/shaking effects.
** '''x''', '''y''': the number of pixels to scroll along the x and y axis
* '''[scroll_to]''': Scroll to a given hex
** '''x''', '''y''': the hex to scroll to
** '''check_fogged''': whether to scroll even to locations covered in fog or shroud. Possible values ''true'' (don't scroll to fog) and ''false'' (scroll even to fog), with ''false'' as the default.
* '''[scroll_to_unit]''' Scroll to a given unit
** [[StandardUnitFilter]]
** '''check_fogged''': whether to scroll even to locations covered in fog or shroud. Possible values ''true'' (don't scroll to fog) and ''false'' (scroll even to fog), with ''false'' as the default.
* '''[sound]''': Plays a sound
** '''name''': the filename of the sound to play (in ''sounds/'' as .wav or .ogg)
** '''repeat''': repeats the sound for a specified additional number of times (default=0)
* '''[sound_source]''': Creates a sound source. "Sound sources" is a general name for a mechanism which makes possible for map elements to emit sounds according to some rules, where "map elements" can be specific locations or terrain types. For now, only sound sources tied to locations are supported.
** '''id''': a unique identification key of the sound source
** '''sounds''': a list of comma separated, randomly played sounds associated with the sound source
** '''delay''': a numerical value (in milliseconds) of the minimal delay between two playbacks of the source's sound if the source remains visible on the screen; if one scrolls out and back in, the source will be considered as ready to play
** '''chance''': a percentage (a value from 0 to 100) describing the chance of the source being activated every second after the delay has passed or when the source's location appears on the screen (note that it cannot play more than one file at the same time)
** '''check_fogged''': possible values "true" and "false" - if true the source will not play if its locations are fogged
** '''check_shrouded''': {{DevFeature}} possible values "true" and "false" - if true the source will not play if its locations are shrouded
** '''x,y''': a [[StandardLocationFilter]] for the locations associated with the sound source
** '''fade_range''' (default = 3): distance in hexes that determines a "circular" area around the one specified by '''full_range''' where sound volume fades out linearly
** '''full_range''' (default = 14): distance in hexes that determines a "circular" area where source plays with full volume, relative to screen center
** '''loop''': number of times a sound sample should be looped if it stays visible. -1 means infinite (~65000)
* '''[remove_sound_source]''': Removes a previously defined sound source.
** '''id''': the identification key of the sound source to remove
* '''[music]''': Switches to playing different music
** '''name''': the filename of the music to play (in ''music/'' as .ogg)
** see [[MusicListWML]] for the correct syntax
* '''[colour_adjust]''': tints the colour of the screen.
** '''red''', '''green''', '''blue''': values from -255 to 255, the amount to tint by for each colour
* '''[delay]''': pauses the game
** '''time''': the time to pause in milliseconds
* '''[redraw]''': redraws the screen (this normally isn't done during events, although some of the other interface actions cause the screen or parts of it to be redrawn).
** '''side''': if used, recalculates fog and shroud for that side. Useful if you for example spawn friendly units in the middle of an event and want the shroud to update accordingly (otherwise units that spawn inside fog would remain invisible for the duration of the event, since the fog would not automatically get cleared around them).
* '''[unit_overlay]''': sets an image that will be drawn over a particular unit, and follow it around
** '''x''', '''y''': the location of the unit to overlay on
** '''image''': the image to place on the unit
* '''[remove_unit_overlay]''': removes a particular overlayed image from a unit
** '''x''', '''y''': the location of the unit to remove an overlay from
** '''image''': the image to remove from the unit
* '''[animate_unit]''': Uses an animation of a unit to animate it on screen (if the unit has the corresponding animation).
** '''flag''': The key to find the custom animation in the unit description (see the '''[extra_anim]''' description in [[AnimationWML]]). Standard animations can be triggered with the following keywords: ''leading recruited standing idling levelin levelout healing healed poisoned movement defend attack death victory pre_teleport post_teleport''
** '''[filter]''' with a [[StandardUnitFilter]] as argument, see [[FilterWML]]. By default, the unit at the event location will be animated. You can use this tag to choose any other unit to animate.
** '''[primary_attack]''': If this tag is not present, the filter for animation will be triggered with no attack. If it is here, all attacks from the unit will be filtered, and a matching one will be used to filter the animation. Takes a weapon filter as argument, see [[FilterWML]].
** '''[secondary_attack]''': Similar to '''[primary_attack]'''. May be needed to trigger a defense animation correctly, if there are more than one animations available for the defending unit.
** '''hits''': yes/no: whether the being-hit or being-not-hit variants of attack/defense animations are chosen
** '''text''': a text to hover during the animation
** '''red''': red value for the text color (0-255)
** '''green''': green value for the text color
** '''blue''': blue value for the text color
** '''with_bars''': yes/no: whether to display the status bars during the animation (e.g. the hitpoint bar)
** '''[animate]''': a sub block with the same syntax as '''[animate_unit]''' except that the '''[filter]''' block is mandatory to find the unit. This block will find and animate another unit simultaneously.
** '''[facing]''': a [[StandardLocationFilter]] specifying what direction the unit should be facing when animated
* '''[label]''' places a label on the map.
** '''x''', '''y''': the location of the label
** '''text''': what the label should say
** '''team_name''': if specified, the label will only be visible to the given team.
** '''visible_in_fog''': whether the label should be visible through fog or not. Default yes.
* '''[deprecated_message]''' shows a deprecated message in the message area, this feature is only intended to be used to warn about deprecated macros in mainline. The message is not translatable.
** '''message''': the message to show.
* '''[wml_message]''' outputs a message to Wesnoth's console output. Intended for campaign designers to output silent text to the console, without annoying the player; then, that text might contain information useful for later bug-reporting. The log domain for it is '''wml''', and the '''debug/dbg''' log level is available for use with the '''logger''' attribute. Depending on the current log level ('''error''' by default), which may be changed with the in-game :log command, or the --log-<level>=wml command line switch, the messages are echoed to the in-game chat.
** '''message''': the message to show.
** '''logger''': the Wesnoth engine output logger that should catch the text; this might be 'err' (the errors log level), 'warn'/'wrn' (the warnings log level) or anything else (the information log level). Not all information will be displayed depending on the log level chosen when starting Wesnoth.
* '''[open_help]''' opens the in-game help.
** '''topic''': the id of the topic to open
* '''[show_objectives]''': {{DevFeature}} refreshes the objectives defined by [objectives] and its [show_if] tags, and displays them. (It is also called whenever the user explicitly asks for the objectives; this matters only if the tag was overridden by a [[LuaWML#register_wml_action|Lua]] script.)
** '''side''': the side to show the objectives. If not set, all sides are used.

== Useful Macros ==
There are some predefined macros that you find useful for interface actions. You can find a complete list along with a detailed explanation of how they work [http://www.wesnoth.org/macro-reference.xhtml here].
* '''{FLOATING_TEXT}''' Float some text over a unit similar to the damage numbers.
* '''{HIGHLIGHT_UNIT}''' Highlight a unit on the map. Use this to show important units
* '''{HIGHLIGHT_IMAGE}''' Places and highlights an image on the map. Use this to show important items or locations
* '''{SET_IMAGE}''' Places an image on the map which has no other function.
* '''{QUAKE <soundfile>}''' Creates a tremor like screenshake and plays <soundfile>. ('''{TREMOR}''' is a deprecated version, equivalent to '''{QUAKE (rumble.ogg)}''')
* '''{FLASH_WHITE}''' Flash the screen white momentarily. You can also replace WHITE with RED, BLUE or GREEN for a different colour.

== See Also ==
* [[DirectActionsWML]]
* [[InternalActionsWML]]
* [[EventWML]]
* [[ReferenceWML]]

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

InterfaceActionsWML

2010-03-20T06:25:59Z

Beetlenaut: /* Other interface tags */

{{WML Tags}}
== Interface actions ==

Interface actions are actions that do not have an effect on gameplay;
instead, they show something to the player. The main interface tags
are '''[message]''' and '''[objectives]''', but several other tags affect
the interface also.

== [inspect] ==
This user interface action only works in debug mode. It displays the gamestate inspector dialog (the same one which can be brought up with '':inspect'' ), which can be used to inspect the values of WML variables, AI configuration, recall lists, and more.

* '''name''': optional attribute to specify the name of this gamestate inspector dialog. It is just a label to help differentiate between different invocations of gamestate inspector dialog.

== [message] ==
The most commonly used interface action is [message], which displays a message to the user in a dialog box. It can also be used to take input from the user.

The following key/tags are accepted for [message]:
* [[StandardUnitFilter]]: The unit whose profile and name are displayed. Do not use a [filter] tag. If no unit matching this filter is found, the message is not displayed (The unit has probably been killed). '''[message]''' elements should be constructed so that it is either guaranteed that a certain unit is alive, or so that dialog flows smoothly even if the message isn't displayed.

* '''speaker''': an alternative to standard unit filter. You may specify as the value of the speaker attribute a unit id or any of the following special values:
** '''narrator''': the dialog box is displayed without a caption for the unit speaking or a unit image
** '''unit''': the primary unit for the event is speaking
** '''second_unit''': the secondary unit for the event is speaking

* '''message''': (translatable) the text to display to the right of the image. ''message'' is sometimes multiple lines; if it is, be sure to use quotes(''' ' ''' or ''' " ''')
* '''[show_if]''': if present then this message will only be displayed if the conditional statement in this tag is passed (see [[ConditionalActionsWML#Condition_Tags|ConditionalActionsWML]])
* '''side_for''': (default: all sides) comma-separated list of sides for who message is shown.
* '''image''': (default: profile image of speaker) the image to display next to the message.
* '''caption''': (default: name of speaker) the caption to display beside the image. Name to be displayed.
* '''duration''': (default: 10) the minimum number of frames for this message to be displayed. (A frame lasts about 30 milliseconds.) During this time any dialog decisions will be disregarded.
* '''sound''': a sound effect (wav file) to play as the message is displayed. This can be a comma-separated list, from which one will be randomly chosen.
* '''[option]''': zero or more '''[option]''' elements may be present. If '''[option]''' elements are present, then each option will be displayed in a menu for the user to select one option.
** '''message''': (translatable) the text displayed for the option (see [[DescriptionWML]])
** '''[show_if]''': if present then this option will only be displayed if the conditional statement in this tag is passed (see [[InternalActionsWML]])
** '''[command]''': an element containing actions which are executed if the option is selected.
* '''[text_input]''': there can be only one [text_input] tag. this adds a text input field to the message.
** '''variable''': the variable that the user's input will be written to
** '''label''': a text label to the left of the input field
** '''max_chars''': the maximum number of characters that may be typed into the field
** '''text''': text that is written into the field in the beginning
* Check [[EventWML#Multiplayer_safety]] to find out in which events you can safely use '''[option]''' and '''[text_input]''' without causing OOS.

=== Formatting ===

Text formatting options for '''[message]'''. These can also be used in unit names (user_description), objectives, and such.
* A tilde (~) as the first character causes the line to be boldfaced.
* An at symbol (@) as the first character causes the line to be green, as done with victory conditions.
* A pound symbol (#) as the first character causes the line to be red, as done with defeat conditions.
* An asterisk (*) as the first character causes the line to be bigger.
* A backquote (`) as the first character causes the line to be smaller.
* If used, the caption key text is boldfaced.
* An RGB colour code in the beginning causes the line to be the given colour. This can still be preceded by the above characters. Example: ''message=_"<255,0,0>Red!"''

{{DevFeature}} In the 1.7 branch these formatting codes are being discarded in favor of [http://library.gnome.org/devel/pango/unstable/PangoMarkupFormat.html Pango markup]. Note that it's easiest to use ' for quoting in Pango markup since " is encoded as "" inside a WML string (so you have to modify the Pango examples accordingly if you want to use " quotes). Running wmllint on your campaign will up-convert it, warning you about unusual cases you must fix by hand.

== [objectives] ==
The other tag used for plot development is '''[objectives]'''.
The '''[objectives]''' tag overwrites any previously set objectives,
and displays text which should describe the objectives of the scenario.
Scenario objectives are displayed on the player's first turn after the tag is used,
or as part of the event if it triggers during that player's turn.
Objectives can also be accessed at any time in a scenario using the
"Scenario Objectives" game menu option, making this tag useful for
scenario-specific information that the player may need to refer to during play.

This tag renders the ''objectives'' attribute of [scenario] obsolete (see ''objectives'', [[ScenarioWML]]).
Instead of using ''objectives'', use '''[objectives]''' to set scenario objectives inside a prestart event.
It can also be used to overwrite the starting objectives mid-scenario.

Attributes of '''[objectives]''':
* '''side''': Default '0'. The side to set the objectives for. A value of 0 sets objectives for all sides.
* '''summary''': Displayed first in the objectives text, this should describe the basic objective for the overall scenario. Can be omitted.
* '''note''': Displayed last in the objectives text, this is sometimes used for hints or additional information. Can be omitted.
* '''victory_string''': Default ' _ "Victory:"', this text precedes the victory objectives.
* '''defeat_string''': Default ' _ "Defeat:"', this text precedes the defeat objectives.
* '''silent''': Default: not present. If set to "yes", the objectives are silently changed. Else, they will be shown to the user when appropriate.

Tags of '''[objectives]''':
* '''[objective]''': describes a win or loss condition. Most scenarios have multiple win or loss conditions, so use a separate [objective] subtag for each line; this helps with translations.
** '''description''': text for the specific win or loss condition.
** '''condition''': The color and placement of the text. Values are 'win'(colored green, placed after ''victory_string'') and 'lose'(colored red, placed after ''defeat_string'')
** '''[show_if]''': A condition that disables the objective if it doesn't hold. Conditional objectives are refreshed at '''[show_objectives]''' time only. {{DevFeature}}

=== Macros ===
There are a few predefined macros for Objectives that you can use to shorten the code: [http://www.wesnoth.org/macro-reference.xhtml#SET_OBJECTIVES SET_OBJECTIVES], [http://www.wesnoth.org/macro-reference.xhtml#VICTORY_CONDITION VICTORY_CONDITION], and [http://www.wesnoth.org/macro-reference.xhtml#DEFEAT_CONDITION DEFEAT_CONDITION]. Follow the links for each one to see complete syntax and example usage.

== [set_menu_item] ==
This tag is used to add a custom option in the right-click context menu which can then be used to trigger arbitrary WML commands.

'''Note:''' Due to limitations in portable devices where there are no scroll bars for context menus, there is a hard-coded limit of 7 custom WML menu items. If you really need to have more than 7 menu items, try combining some of them in a submenu.

* '''id''': the unique id for this menu item. If a menu item with this id already exists, it allows you to set specific changes to that item.
* '''description''': the in-game text that will appear for this item in the menu.
* '''image''': the image to display next to this item.
* '''needs_select''': if ''yes'' (default ''no''), then the latest select event (see [[EventWML]]) that triggered before this menu item was chosen will be transmitted over the network before this menu item action will be. This only has any effect in networked multiplayer, and is intended to allow more elaborate menu item behaviour there without causing out of sync errors. If you don't know what this means, just leave it false.
* '''[show_if]''': If present, the menu item will only be available if the conditional statement (see [[InternalActionsWML]]) within evaluates to true. When this is evaluated, the WML variables ''$x1'' and ''$y1'' will point to the location on which the context menu was invoked, so it's possible to for example only enable the option on empty hexes or on a particular unit.
* '''[filter_location]''': contains a location filter similar to the one found inside Single Unit Filters (see [[FilterWML]]). The menu item will only be available on matching locations.
* '''[command]''': contains the WML actions to be executed when the menu item is selected. Again, the WML variables ''$x1'' and ''$y1'' will point to the location on which the context menu was invoked on.

== Other interface tags ==

The following tags are also action tags:
* '''[item]''': makes a graphical item appear on a certain hex. Note this only places the graphics for an item. It does not make the item do anything. Use a moveto event to make moving onto the item do something. <tt>''('''Hint:''' There are a number of predefined items that are used in various campaigns that you can make use of. You can find [http://www.wesnoth.org/macro-reference.xhtml#file:items.cfg a list of them] if you look into the items.cfg file in the wesnoth install directory (under /data/core/macros))''</tt>
** '''x''', '''y''': the location to place the item.
** '''image''': the image (in ''images/'' as .png) to place on the hex.
** '''halo''': an image to place centered on the hex. Use this instead of ''image'' if the image is bigger than the hex or if you want to animate an image. ''Example (where the integer after the colon is the duration of each frame): halo=scenery/fire1.png:100,scenery/fire2.png:100,scenery/fire3.png:100,scenery/fire4.png:100,scenery/fire5.png:100,scenery/fire6.png:100,scenery/fire7.png:100,scenery/fire8.png:100''
** '''team_name''': name of the team for which the item is to be displayed (hidden for others). For multiple teams just put all the names in one string, for example separated by commas.
** '''visible_in_fog''': whether the item should be visible through fog or not. Default yes.
* '''[removeitem]''': removes any graphical items on a given hex
** '''x''', '''y''': the hex to remove items off
** '''image''' if specified, only removes the given image item (This image name must include any [[#ImagePathFunctionWML|image path functions]] appended to the original image name.)
* '''[print]''': displays a message across the screen. The message will disappear after a certain time.
** '''text''': (translatable) the text to display.
** '''size''': (default=12) the pointsize of the font to use
** '''duration''': (default=50) the length of time to display the text for. This is measured in the number of 'frames'. A frame in Wesnoth is usually displayed for around 30ms.
** '''red''', '''green''', '''blue''': (default=0,0,0) the color to display the text in. Values vary from 0-255.
* '''[move_unit_fake]''': moves an image of a unit along a certain path on the map. The path does not need to be a continuous list of adjacent hexes, so for example only the start and end points can be given, in which case the straightest line between those points will be calculated and used.
** '''type''': the type of the unit whose image to use
** '''x''': a comma-separated list of x locations to move along
** '''y''': a comma-separated list of y locations to move along (x and y values are matched pairs)
** '''side''': the side of the fake unit, used for team-coloring the fake unit
* '''[hide_unit]''': makes the given unit become invisible. Useful in conjunction with '''[move_unit_fake]''': to move a leader unit into position on-screen. Each '''[hide_unit]''' tag only hides one unit.
** '''x''', '''y''': location of the unit to be hidden. (NOT a standard unit filter! Just x and y.)
* '''[unhide_unit]''': stops the currently hidden unit from being hidden.
* '''[scroll]''': Scroll a certain number of pixels in a given direction. Useful for earthquake/shaking effects.
** '''x''', '''y''': the number of pixels to scroll along the x and y axis
* '''[scroll_to]''': Scroll to a given hex
** '''x''', '''y''': the hex to scroll to
** '''check_fogged''': whether to scroll even to locations covered in fog or shroud. Possible values ''true'' (don't scroll to fog) and ''false'' (scroll even to fog), with ''false'' as the default.
* '''[scroll_to_unit]''' Scroll to a given unit
** [[StandardUnitFilter]]
** '''check_fogged''': whether to scroll even to locations covered in fog or shroud. Possible values ''true'' (don't scroll to fog) and ''false'' (scroll even to fog), with ''false'' as the default.
* '''[sound]''': Plays a sound
** '''name''': the filename of the sound to play (in ''sounds/'' as .wav or .ogg)
** '''repeat''': repeats the sound for a specified additional number of times (default=0)
* '''[sound_source]''': Creates a sound source. "Sound sources" is a general name for a mechanism which makes possible for map elements to emit sounds according to some rules, where "map elements" can be specific locations or terrain types. For now, only sound sources tied to locations are supported.
** '''id''': a unique identification key of the sound source
** '''sounds''': a list of comma separated, randomly played sounds associated with the sound source
** '''delay''': a numerical value (in milliseconds) of the minimal delay between two playbacks of the source's sound if the source remains visible on the screen; if one scrolls out and back in, the source will be considered as ready to play
** '''chance''': a percentage (a value from 0 to 100) describing the chance of the source being activated every second after the delay has passed or when the source's location appears on the screen (note that it cannot play more than one file at the same time)
** '''check_fogged''': possible values "true" and "false" - if true the source will not play if its locations are fogged
** '''check_shrouded''': {{DevFeature}} possible values "true" and "false" - if true the source will not play if its locations are shrouded
** '''x,y''': a [[StandardLocationFilter]] for the locations associated with the sound source
** '''fade_range''' (default = 3): distance in hexes that determines a "circular" area around the one specified by '''full_range''' where sound volume fades out linearly
** '''full_range''' (default = 14): distance in hexes that determines a "circular" area where source plays with full volume, relative to screen center
** '''loop''': number of times a sound sample should be looped if it stays visible. -1 means infinite (~65000)
* '''[remove_sound_source]''': Removes a previously defined sound source.
** '''id''': the identification key of the sound source to remove
* '''[music]''': Switches to playing different music
** '''name''': the filename of the music to play (in ''music/'' as .ogg)
** see [[MusicListWML]] for the correct syntax
* '''[colour_adjust]''': tints the colour of the screen.
** '''red''', '''green''', '''blue''': values from -255 to 255, the amount to tint by for each colour
* '''[delay]''': pauses the game
** '''time''': the time to pause in milliseconds
* '''[redraw]''': redraws the screen (this normally isn't done during events, although some of the other interface actions cause the screen or parts of it to be redrawn).
** '''side''': if used, recalculates fog and shroud for that side. Useful if you for example spawn friendly units in the middle of an event and want the shroud to update accordingly (otherwise units that spawn inside fog would remain invisible for the duration of the event, since the fog would not automatically get cleared around them).
* '''[unit_overlay]''': sets an image that will be drawn over a particular unit, and follow it around
** '''x''', '''y''': the location of the unit to overlay on
** '''image''': the image to place on the unit
* '''[remove_unit_overlay]''': removes a particular overlayed image from a unit
** '''x''', '''y''': the location of the unit to remove an overlay from
** '''image''': the image to remove from the unit
* '''[animate_unit]''': Uses an animation of a unit to animate it on screen (if the unit has the corresponding animation).
** '''flag''': The key to find the custom animation in the unit description (see the '''[extra_anim]''' description in [[AnimationWML]]). Standard animations can be triggered with the following keywords: ''leading recruited standing idling levelin levelout healing healed poisoned movement defend attack death victory pre_teleport post_teleport''
** '''[filter]''' with a [[StandardUnitFilter]] as argument, see [[FilterWML]]. By default, the unit at the event location will be animated. You can use this tag to choose any other unit to animate.
** '''[primary_attack]''': If this tag is not present, the filter for animation will be triggered with no attack. If it is here, all attacks from the unit will be filtered, and a matching one will be used to filter the animation. Takes a weapon filter as argument, see [[FilterWML]].
** '''[secondary_attack]''': Similar to '''[primary_attack]'''. May be needed to trigger a defense animation correctly, if there are more than one animations available for the defending unit.
** '''hits''': yes/no: whether the being-hit or being-not-hit variants of attack/defense animations are chosen
** '''text''': a text to hover during the animation
** '''red''': red value for the text color (0-255)
** '''green''': green value for the text color
** '''blue''': blue value for the text color
** '''with_bars''': yes/no: whether to display the status bars during the animation (e.g. the hitpoint bar)
** '''[animate]''': a sub block with the same syntax as '''[animate_unit]''' except that the '''[filter]''' block is mandatory to find the unit. This block will find and animate another unit simultaneously.
** '''[facing]''': a [[StandardLocationFilter]] specifying what direction the unit should be facing when animated
* '''[label]''' places a label on the map.
** '''x''', '''y''': the location of the label
** '''text''': what the label should say
** '''team_name''': if specified, the label will only be visible to the given team.
** '''visible_in_fog''': whether the label should be visible through fog or not. Default yes.
* '''[deprecated_message]''' shows a deprecated message in the message area, this feature is only intended to be used to warn about deprecated macros in mainline. The message is not translatable.
** '''message''': the message to show.
* '''[wml_message]''' outputs a message to Wesnoth's console output. Intended for campaign designers to output silent text to the console, without annoying the player; then, that text might contain information useful for later bug-reporting. The log domain for it is '''wml''', and the '''debug/dbg''' log level is available for use with the '''logger''' attribute. Depending on the current log level ('''error''' by default), which may be changed with the in-game :log command, or the --log-<level>=wml command line switch, the messages are echoed to the in-game chat.
** '''message''': the message to show.
** '''logger''': the Wesnoth engine output logger that should catch the text; this might be 'err' (the errors log level), 'warn'/'wrn' (the warnings log level) or anything else (the information log level). Not all information will be displayed depending on the log level chosen when starting Wesnoth.
* '''[open_help]''' opens the in-game help.
** '''topic''': the id of the topic to open
* '''[show_objectives]''': {{DevFeature}} refreshes the objectives defined by [objectives] and its [show_if] tags, and displays them. (It is also called whenever the user explicitly asks for the objectives; this matters only if the tag was overridden by a [[LuaWML#register_wml_action|Lua]] script.)
** '''side''': the side to show the objectives. If not set, all sides are used.

== Useful Macros ==
There are some predefined macros that you find useful for interface actions. You can find a complete list along with a detailed explanation of how they work [http://www.wesnoth.org/macro-reference.xhtml here].
* '''{FLOATING_TEXT}''' Float some text over a unit similar to the damage numbers.
* '''{HIGHLIGHT_UNIT}''' Highlight a unit on the map. Use this to show important units
* '''{HIGHLIGHT_IMAGE}''' Places and highlights an image on the map. Use this to show important items or locations
* '''{SET_IMAGE}''' Places an image on the map which has no other function.
* '''{QUAKE <soundfile>}''' Creates a tremor like screenshake and plays <soundfile>. ('''{TREMOR}''' is a deprecated version, equivalent to '''{QUAKE (rumble.ogg)}''')
* '''{FLASH_WHITE}''' Flash the screen white momentarily. You can also replace WHITE with RED, BLUE or GREEN for a different colour.

== See Also ==
* [[DirectActionsWML]]
* [[InternalActionsWML]]
* [[EventWML]]
* [[ReferenceWML]]

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

EventWML

2010-01-15T12:35:16Z

Beetlenaut: Added note to 'die'.

{{WML Tags}}
== The [event] Tag ==

This tag is a subtag of the [scenario], [unit_type] and [era] tags which is used to describe a set of actions which trigger at a certain point in a scenario. When used in a [scenario] tag (also includes [multiplayer], [tutorial] and [test]), the event only occurs in that scenario. When used in a [unit_type] tag, the event will occur in all scenarios in which a unit of that type appears in (only after such a unit appears during the scenario, however). When used in an [era], the event will occur in any scenario which is played using that era.

This tag has keys and child tags that control when and if the event actions will be triggered. Most important of these is the '''name''' key. Without it, no error will be raised but the event will never fire. Therefore, from a practical standpoint, it can be considered mandatory. All of the others can be used or not and the event actions will fire either way.

=== The 'name' Key (Mandatory) ===

Usage:
name=<value>

This is '''not''' like a normal 'name' key. ''It is a basic description of when the event will trigger.'' It also has a very large number of predefined values, one of which must be used for the key to be valid.

'''Lexicon side note:''' ''It is not uncommon to refer to these values as the 'trigger' for an event and, furthermore, to call an event by its 'trigger' name. For example, in an event containing '''name=moveto''', a person might refer to the event as a ''''moveto''' event' and/or refer to the ''''moveto''' trigger' in the event or even talk about the 'event trigger' when referring to the '''moveto''' value of the 'name' key in that event. Some or all of this usage can, in fact, be found throughout this page.''

The '''name''' key can accept a list of comma separated values describing when the event will be triggered.* These values may be either predefined event types or custom event names not matching any predefined type.

For example:

name=attacker misses,defender misses

''* Note that unless you use [[#first_time_only|first_time_only=no]], the event will fire only once, '''not''' once for each listed type.''

==== Predefined 'name' Key Values ====

All predefined event types are listed here along with a description of when this value will cause the event to be triggered. Any value ''not'' listed here is a custom event name which can be triggered only by a '''[fire_event]''' tag somewhere else. Spaces in event names can be interchanged with underscores (for example, '''name=new turn''' and '''name=new_turn''' are equivalent).

; preload {{DevFeature}}
: Triggers before a scenario 'prestarts' and when loading a savegame -- before anything is shown on the screen at all. Can be used to set up the [[LuaWML|Lua]] environment: loading libraries, defining helper functions, etc.
: '''Note:''' Unlike prestart and start, the preload event '''must be able to fire more than once!''' This is because it is triggered each time a savegame is loaded in addition to the initial time when it loads before the scenario 'prestart'. This means that it is effectively ''mandatory'' to have the [[#first_time_only|first_time_only=no]] key value in a preload event.

; prestart
: Triggers before a scenario 'starts' -- before anything is shown on the screen at all. Can be used to set up things like village ownership. For things displayed on-screen such as character dialog, use '''start''' instead.
: '''Note:''' ''This value makes the [[#first_time_only|first_time_only]] key irrelevant since, by definition, it can only fire once.''

; start
: Triggers after the map is shown but before the scenario begins -- before players can 'do' anything.
: '''Note:''' ''This value makes the [[#first_time_only|first_time_only]] key irrelevant since, by definition, it can only fire once.''

; new turn
: Triggers at the start of every turn (not side turn). See also [[#first_time_only|first_time_only=no]]. Before any events of this type trigger, the value of the WML variable '''turn_number''' is set to the number of the turn that is beginning.

; side turn
: Triggers when a side is about to start its turn. Before events of this type trigger, the value of the WML variable '''side_number''' is set to the number of the side of the player about to take their turn. This is before any healing takes place for that side, before calculating income, and before restoring unit movement and status.

; ai turn
: Triggered just before the AI is invoked for a side. This is called after ''side turn'', and thus the WML variable '''side_number''' still holds the number of this side. Note that this event might be called several times per turn in case that fallbacks to human or droiding is involved. I.e. it happens at the middle of turn of human side 1 if the human player droids his side. It happens after the selection of ai to play the turn but before AI is told that new turn has come.
: '''Note:''' ''This event currently breaks replays since it is not explicitly saved in a replay and there is no AI involved in replays...''

; turn refresh
: Like '''side turn''', triggers just before a side is taking control but '''after''' healing, calculating income, and restoring unit movement and status.

; turn ''X''
: Triggers at the start of turn ''X''. It's the first side initialization event. Side initialization events go in the order of:
: 1) '''turn ''X''''' 2) '''new turn''' 3) '''side turn''' 4) '''side ''X'' turn''' 5) '''side ''X'' turn ''Y''''' 6) '''turn refresh'''

; side ''X'' turn ''Y''
: This event triggers at the start of turn ''X'' of side Y {{DevFeature}}

; side ''X'' turn
: This event triggers at the start of any turn of side Y {{DevFeature}}
: '''Note:''' ''Of course, [[#first_time_only|first_time_only=no]] is needed for this event to be triggered more than once.''

; time over
: Triggers on turn ''turns''. (''turns'' is specified in [scenario])

; enemies defeated
: Triggers when all units with '''canrecruit=yes''' (that is, all leaders) not allied with side 1 are killed.

; victory
: In this scenario, any tag of the form '''[endlevel] result=victory [/endlevel]''' will be automatically preceded by all actions in this tag. It helps debugging if the victory event allows you to safely advance to any of the possible next maps after using the ":n" command. Scenarios where key units are picked up before the victory, or where some action chosen earlier determines which map to advance to, make it hard to quickly test scenarios in a campaign. (See also: [endlevel], [[DirectActionsWML]])

; defeat
: In this scenario, any tag of the form '''[endlevel] result=defeat [/endlevel]''' will be automatically preceded by all actions in this tag. (See also [endlevel], [[DirectActionsWML]])

Filters can be applied to the following event triggers (see [[FilterWML]]; see also below). The actions specified in the event tag will be executed only if the filter returns true.
These event triggers are all actions by units ('''moveto''', '''attack''') or things that happen to units ('''recruit''', '''advance'''). When one of these events is triggered, the position of the active unit (referred to as the '''primary unit''') is stored in the variables '''x1''' and '''y1''' and the position of any unit that primary unit does something to is stored in the variables '''x2''' and '''y2''' (this unit is referred to as the '''secondary unit''' below). '' These units are also automatically stored in the variables 'unit' and 'second_unit' as if they had been stored using the '''[store_unit]''' tag. see [[SingleUnitWML]]

; moveto
: Triggers after the primary unit moves. Typically this is used when the primary unit gets to a particular location and a filter for the location of the primary unit is included; remember that this is the location that the primary unit lands on, not the location it started on or any location it travels on. ''An '''[allow_undo]''' tag anywhere within a moveto event will cancel any lack of undo functionality the event would have caused. Note that undo functionality will only move the unit back to its former location; it will not other changes to the game caused by the event. Thus it is up to the scenario designer to use this tag correctly.'' {{DevFeature}} $x2 and $y2 refer to the hex the unit came from.

; sighted
: Triggers when the primary unit becomes visible to the secondary unit in particular after not being visible to the secondary unit's side (so if the secondary unit's side doesn't have shroud or fog, the event never triggers). This happens both when the primary unit moves into view during its turn, and when the secondary unit moves to a location where it can see the primary unit. (This editor hasn't tested whether the event triggers multiple times if the primary unit moves into view of multiple units at once, or if not, which one gets chosen to be the secondary unit here.) (Note: it appears that when a sighted event is triggered because an enemy unit moves into your field of view, the game engine cannot determine which unit (on your side) sees the unit that moved, and so it fires a ''name=sighted'' event without setting ''$second_unit''. This means that, for example, using ''speaker=second_unit'' inside a message tag may fail.) (Double note: it also appears that the sighted event in more recent versions of the game (1.6 and 1.7, maybe?) does not fire on enemy turns. That is, it only fires for units that become visible as a result of the motion of another unit, not for units that move into the vision of an enemy. This event is also buggy in general... it's usually better to use a moveto event with a [filter_vision] tag than to use a sighted event (and note that the combination of the two can achieve something like the old sighted event)).

; attack
: Triggers when the primary unit attacks the secondary unit.

; attack end
: Similar to '''attack''', but is triggered ''after'' the fight instead of before. Note that if either unit is killed during the fight, this event triggers before any '''die''' events.

; attacker hits
: Triggers when the the primary unit (the attacker) hits the secondary unit (the defender). The value of the WML variable '''damage_inflicted''' is set to the number of hitpoints inflicted by the attacker.

; attacker misses
: Same as ''attacker hits'', but is triggered when the attacker misses.

; defender hits
: Triggers when the primary unit (the attacker) is hit in retaliation by the secondary unit (the defender). The value of the WML variable '''damage_inflicted''' is set to the number of hitpoints inflicted by the defender.

; defender misses
: Same as ''defender hits'', but is triggered when the defender misses.

; stone
: Triggers when the primary unit is hit by an attack with the 'stones' ability (See ''stones'', [[AbilitiesWML]]) by the secondary unit (the unit with the 'stones' ability). In {{DevFeature}}, this event name is changed to "petrified".

; last breath
: Triggers when the primary unit is killed by the secondary unit, but before the death animation is triggered.

; die
: Triggers when the primary unit is killed by the secondary unit. ''Note: The primary unit is not removed from the game until the end of this event. The primary unit can still be manipulated, will block other units from taking its hex, and will still be found by standard unit filters (except [have_unit]). To prevent this behavior, you can use [kill] to remove the unit immediately.''

; capture
: Triggers when the primary unit captures a village. The village may have been previously neutral, or previously owned by another side; merely moving into your own villages does not constitute a capture.

; recruit
: Triggers when the primary unit is recruited. (That is, when a unit is recruited it will trigger this event and this event's filter will filter that unit.).

; prerecruit
: Triggers when the primary unit is recruited but before it is displayed.

; recall
: Triggers after a unit is recalled.

; prerecall
: Triggers when a unit is recalled but before it is displayed.

; advance
: Triggers just before the primary unit is going to advance to another unit.

; post advance
: Triggers just after the primary unit has advanced to another unit.

; select
: Triggers when the primary unit is selected. Also triggers when ending a move, as the game keeps the moving unit selected by selecting it again at the end of movement. ''Note: in networked multiplayer, these events are only executed by the client on which the event is triggered, leading to out of sync errors if you modify the game state in the event.''

; menu item ''X''
: Triggers when a WML menu item with id=''X'' is selected. ''Note: if the menu item has a [command], this event may be executed before or after the command; there is no guarantee.''

=== Custom events.

An event with a custom name may be invoked using the [[InternalActionsWML#.5Bfire_event.5D|[fire_event]]] tag. Normally you'll use such custom events as named subroutines to be called by events with predefined types. One common case of this, for example, is that more than one '''sighted''' events might fire the same custom event that changes the scenario objectives.

=== Optional Keys and Tags ===

These keys and tags are more complex ways to filter when an event should trigger:

==== first_time_only ====
: Whether the event should be removed from the scenario after it is triggered. This key takes a [[ConditionalActionsWML#Boolean_Values|boolean]]; for example:
: ''first_time_only=yes''
:: Default behavior if key is omitted. The event will trigger the first time it can and never again.
: ''first_time_only=no''
:: The event will trigger every time the criteria are met instead of only the first time.

==== [filter] ====
: The event will only trigger if the primary unit matches this filter.
:* [[StandardUnitFilter]]: selection criteria

==== [filter_second] ====
: Like [filter], but for the secondary unit.
:* [[StandardUnitFilter]]: selection criteria

==== [filter_attack] ====
: Can be used to set additional filtering criteria for the primary unit and the secondary unit that are not generally available in a standard unit filter. Can be used in events ''attack'', ''attacker hits'', ''attacker misses'', ''defender hits'', ''defender misses'' and ''attack end''. For more information and other filter keys, see [[FilterWML]].
:* '''name''': the name of the weapon used.
:* '''range''': the range of the weapon used.
:* '''special''': filter on the attack's special power.

==== [filter_second_attack] ====
: Like [filter_attack], but for the secondary unit.
:* '''name''': the name of the weapon used.
:* '''range''': the range of the weapon used.
:* '''special''': filter on the attack's special power.

==== [event] ====
: A special case 'action', the [event] tag may be used to create a [[#Nested Events|nested event]].

==== delayed_variable_substitution ====
: This key is only relevant inside of a [[#Delayed Variable Substitution|nested event]] and controls when variable substitution will occur in those special case actions.

=== Actions triggered by [event] ===

After the trigger conditions have been met, all action tags within the [event] tag are executed in the order they are written in.

There are 3 main types of actions:
* direct actions ([[DirectActionsWML]]) which have a direct effect on gameplay
* display actions ([[InterfaceActionsWML]]) which show something to the user
* internal actions ([[InternalActionsWML]]) which are used by WML internally

Several actions use standard filters to find out which units
to execute the command on. These are denoted by the phrases
"standard unit filter" and "standard location filter".

=== Nested Events ===

There is one special type of action: event creation. By placing an '''[event]''' tag inside another '''[event]''' tag, the nested event is spawned (created) when the parent (outer) event is encountered (when executing the contents of the parent event).

([[#Nested Event Example|See Examples]])

==== Delayed Variable Substitution ====

Variable substitution for a nested event can happen either when it is spawned by the parent event or when it is triggered itself. This is controlled with the key '''delayed_variable_substitution''' which is used in the nested event.

If this key is set to ''yes'', the variables in the nested event will contain values from the turn in which the ''nested'' event was triggered. ''This is the default behavior if the key is omitted.'' If set to ''no'', the variables in the nested event are set at the time the ''parent'' event is triggered.

This behavior can be fine tuned with a special syntax when referencing variables. Instead of the normal '''$variable''' syntax, use '''$|variable''' to cause a variable to contain values relevant to the turn in which the nested event was triggered even when '''delayed_variable_substitution''' is set to ''no''. In this way you can have a mix of variables relevant to the parent and nested event trigger times.

([[#Delayed Variable Substitution Example|See Examples]])

== Multiplayer safety ==

In multiplayer it is only safe to use WML that might require synchronization with other players because of input or random numbers (like [message] with input or options or [unstore_unit] where a unit might advance) in the following events. This is because in these cases WML needs data from other players to work right and/or do the same thing for all players. This data is only available after a network synchronization.

List of synchronized events:
* moveto
* sighted
* attack
* attack_end
* attacker hits
* attacker misses
* defender hits
* defender misses
* stone
* last breath
* die
* capture
* recruit
* prerecruit
* recall
* prerecall
* advance
* post_advance
Events fired from a WML event handler that is synchronized:
* new turn {{DevFeature}}
* side turn {{DevFeature}}
* turn X {{DevFeature}}
* side X turn {{DevFeature}}
* side X turn Y {{DevFeature}}
* turn refresh {{DevFeature}}

There is also the possibility of events that are synchronized when fired by the engine but can be non-synchronized when fired by WML tags from non-synchronized event. So when you are using them you must be extra careful. For example [unstore_unit] may trigger a unit advancement that will fire ''advance'' and ''post advance'' events.

== A Trap for the Unwary ==

It is perfectly possible (and, in fact, useful) to have multiple events with the same predefined name and thus the same trigger condition. However, it is not defined what order such events will fire in, so you need to code so the order
will not matter.

Because of the above, you need to beware of using macros to generate events. If you include a macro expanding to an event definition twice, the event will be executed twice (not once) each time the trigger condition fires. Consider this code:

#define DOUBLE
[event]
name=multiply_by_2
{VARIABLE_OP 2_becomes_4 multiply 2}
[/event]
#enddef

{DOUBLE}
{DOUBLE}

{VARIABLE 2_becomes_4 2}

[fire_event]
name=multiply_by_2
[/fire_event]

{DEBUG_MSG "$2_becomes_4 should be 4"}

After it executes, the debug message will reveal that the variable has been set to 8, not 4.

== Miscellaneous Notes and Examples ==

=== Primary/Secondary Unit Speaker Example ===

In events, the primary unit can be referred to as '''unit''' and the secondary unit can be referred to as '''second_unit''' in [message] tags using the '''speaker''' key. For example:

[event]
name=die
[message]
speaker='''second_unit'''
message= _ "Hahaha! I finally killed you!"
[/message]

[message]
speaker='''unit'''
message= _ "It's not over yet! I'll come back to haunt you!"
[/message]
[/event]

=== Nested Event Example ===

An event is created for a portal that opens on turn 10. The parent (or 'outer') event executes on turn 10 at which point the nested moveto event is created. This nested event executes when a player steps on a certain spot.

[event]
name=turn 10

[event]
name=moveto

[filter]
x,y=5,8
[/filter]

# moving to 5,8 will trigger this event only on turn 10 and after
[/event]
[/event]

An equivalent way of doing this would be to create a single moveto event with an '''[if]''' statement to check for turn number but using nested '''[event]''' tags is a convenient shortcut to accomplish this task without resorting to '''[if]''' statements.

=== Delayed Variable Substitution Example ===

This code will display the turn on which the nested ''moveto'' event happens.

[event]
name=turn 10

[event]
name=moveto
delayed_variable_substitution=yes

[filter]
x,y=5,8
[/filter]

{DEBUG_MSG "Turn $turn_number"}
[/event]
[/event]

Since this is the default behavior for the '''delayed_variable_substitution''' key, the following example is identical.

[event]
name=turn 10

[event]
name=moveto

[filter]
x,y=5,8
[/filter]

{DEBUG_MSG "Turn $turn_number"}
[/event]
[/event]

This code will always display "Turn 10" when the nested ''moveto'' event happens. This is because the variable substitution is done when the parent event is triggered and spawns the nested event, ''not'' when the nested event is triggered.

[event]
name=turn 10

[event]
name=moveto
delayed_variable_substitution=no

[filter]
x,y=5,8
[/filter]

{DEBUG_MSG "Turn $turn_number"}
[/event]
[/event]

Finally, this example is identical to the first two, in that it will display the turn on which the nested ''moveto'' event happens despite the fact that the '''delayed_variable_substitution''' key is set to ''no''. This is because the special '''$|variable''' syntax is used.

[event]
name=turn 10

[event]
name=moveto
delayed_variable_substitution=no

[filter]
x,y=5,8
[/filter]

{DEBUG_MSG "Turn $|turn_number"}
[/event]
[/event]

== See Also ==

* [[DirectActionsWML]]
* [[InternalActionsWML]]
* [[InterfaceActionsWML]]
* [[FilterWML]]
* [[ReferenceWML]]

[[Category: WML Reference]]

Talk:FormulaAI

2009-04-12T21:31:17Z

Beetlenaut:

=== Criticism ===
Sorry gentlemen, it's fun, but as for me:
* WML syntax is awkward for programming; only rather simple sample I can name, [http://www.wesnoth.org/forum/viewtopic.php?f=10&t=15764&st=0&sk=t&sd=a&start=15 Chesslike] AI, is 24K in Python and will be three times longer in WML-like language;
* It would be difficult to debug without a proper IDE;
* It needs a sort of standard library;
* New implementation is subject to bugs, syntax changes and bad performance;
* How many AIs are there and will there be notably more if you add another language no one knows, given all the mentioned factors?

=== Trying to be constructive ===

What about considering [http://en.wikipedia.org/wiki/Lua_(programming_language) Lua] as an alternative scripting language?
Porting to is could be another SoC option.
One could even dream about SoC idea - converting WML to Lua.

Additionally, I'd recommend to use "wishful thinking" to prototype simplest algorythm in this syntax and try to evaluate the work. Maybe start with porting Chesslike AI.

If it's going to be rule-based, then another thing to consider is Prolog.

=== Stupid jokes ===
Doesn't it remind:
''"Any sufficiently complicated C or Fortran program contains an ad-hoc, informally-specified bug-ridden slow implementation of half of Common Lisp."'' - [http://en.wikipedia.org/wiki/Lisp_programming_language#Quotations Philip Greenspun].

With a respect for you and your work,
: [[User:Singalen|Singalen]] 15:40, 19 March 2008 (EDT)

=== map != map ===
You have a data structure called "map", but "map" already means something else in BfW. In fact, there is a variable with that name as well. To avoid confusion, I suggest renaming that data structure to "dictionary", "keyed list", or something similar. (At least on this page. I don't mean in your code.)

SpellingMistakes

2009-04-12T21:06:02Z

Beetlenaut: /* Other (ingame help, ...) */

This page is meant to be a list of mistakes in campaigns and other texts in the en_US development version of the game.

==An Orcish Incursion==

==Descent into Darkness==

==Eastern Invasion==

==Heir to the Throne==

==Liberty==

==Northern Rebirth==

==Sceptre of Fire==

==Son of the Black Eye==

==The Hammer of Thursagan==

==The Legend of Wesmere==

'''String #91''': "'''''a'''nd I see the remains of the garrison has been taken prisoner.''"
:I think it should start with capital: "'''''A'''nd I see [...]''"

'''String #109''': "''There they are. They have dumped our gold in their treasury. We must strike quickly and leave with the gold before they bring in reinforcements''"
:There should be a final dot: "''[...] bring in reinforcements'''.'''''"

'''String #121''': "''Turnabout is fair play. Now that we've retrieved the gold, let us '''fare''' swiftly back to Wesmere. The Saurians will likely be infesting the direct route, so we will detour to the north. ''"
:I'm not sure about this one -since I'm not native English speaker-, but is it "'''''fare'''''" or "'''''far'''''"?

'''String #123''': "''To evade the saurians blocking the eastern approaches to Wesmere, Kalenz and his war-band moved to enter Wesmere Forest from a different direction ...''"
:I think there shouldn't be a white space between "''direction''" and "''...''"

'''String #201''': "''I told ye I'd be here''"
:There's not final dot: "''[...] I'd be here'''.'''''"

'''String #202''': "''It's not much of an army he is bringing with him, though''"
:There's not final dot: "''[...] with him, though'''.'''''"

'''String #207''': "''Sure, minus expenses''"
:There's not final dot: "''Sure, minus expenses'''.'''''"

'''String #217''': "''Kalenz\n [...]''"
:The rest of the string near this has this form: "'''''@'''Kalenz\n [...]''"

'''String #559''': "''[...] '''Sundered''' from his kin by their mortality, fleeing the reflections in their eyes of his lost beloved, he left his home and wandered for many a year across the Great Continent. [...]''"
:I couldn't found it in Wordreference, and after making some research, I think it's suposed to be: "'''''Asundered''' from his kin [...]''"

==The Rise of Wesnoth==

==The South Guard==

==Two Brothers==
From campaign description, missing 's': "The village's mage Bjarn send'''s''' for his brother to help, but not all goes as planned."

Perhaps an alternative phrasing would be "The village mage, Bjarn, sends..." or "Bjarn, the village mage, sends..."

==Under the Burning Suns==

==Editor==

==Tutorial==
On the turn after you recruit the elves, if you attack the quintain with Konrad, Delfador will say "Your elf used a sword...". He should say nothing, or perhaps say something along the lines of "Try attacking the quintain with one of your elves."
:It's supposed to say '''"You wouldn't do anything stupid like charging that quintain yourself again, now would you? Use the fighters you recruited first; they'll be a lot of help."''' according to the .po files. [[User:Polarina|Polarina]] 23:02, 4 April 2009 (UTC)

==Manual==

==Manpages==

==1.6 Announcement==

==Other (ingame help, ...)==
In the Display tag of the Preferences dialog, the first line says, "Toggle Full Screen". That can be slightly confusing (or at least strange) because ''all'' of the options are toggles. It should just read, "Full Screen".

==Translation code bugs==

==Unofficial campaigns==

===Invasion from the unknown===

[[Category:Troubleshooting and Bugs]]

List of Campaigns

2008-09-05T12:27:56Z

Beetlenaut: /* User Campaigns */

== Mainline Campaigns ==
[[MainlineCampaigns|Mainline Campaigns]] are included with the game, they are available via the Campaign button at the Battle for Wesnoth main menu.

{| border="1" cellpadding="0" cellspacing="0"
|-
!width="175" | Name
!| Description
!width="100" | Author
|-
|[[ATaleOfTwoBrothers|A Tale Of Two Brothers]]
| An evil mage is threatening the local village and its inhabitants. When their leader Bjarn sends for aid from his brother Arne, he is victorious, but Bjarn himself is kidnapped. Can you rescue him?
| Circon
|-
| An Orcish Incursion
| Defend the forest of the elves against the first orcs to reach the Great Continent, learning valuable tactics as you do so.
| Josh Parsons
|-
| [[TheSouthGuard|The South Guard]]
| A young Knight, Deoran, is dispatched to take command of the South Guard.. Note; This campaign is designed as an introduction to Wesnoth. The 'Civilian' difficulty level is aimed at first-time players.
| aelius
|-
| [[HeirToTheThrone|Heir to the Throne]]
| Fight to regain the throne of Wesnoth, of which you are the legitimate heir.
| Dave
|-
| [[Liberty]]
| As the shadow of civil war lengthens across Wesnoth, a band of hardy marchlanders revolts against the tyranny of Queen Asheviere. To win their way to freedom, they must defeat not just the trained blades of Wesnothian troops but darker foes including orcs and undead.
| scott
|-
| [[TheRiseOfWesnoth|The Rise of Wesnoth]]
| Lead Prince Haldric through the destruction of the Green Isle and across the Ocean to establish the very kingdom of Wesnoth itself. The confrontation with Lich-Lord Jevyan awaits...
| Shade
|-
| [[TheEasternInvasion|The Eastern Invasion]]
| There are rumors of undead attacks on the eastern border of Wesnoth. You, an officer in the Royal Army, have been sent to the eastern front to protect the villagers and find out waht is happening.
| Turin
|-
| The Hammer of Thursagan
| In the first years of the Northern Alliance, an expedition from Knalga seeks out their kin at Kal kartha and to learn the fate of the legendary Hammer of Thursagan. The perils of their journey through the wild Northern Lands, through great, pale beside the evil they will face at its end.
| ESR
|-
| [[DescentIntoDarkness|Descent Into Darkness]]
| Learn the dark arts of necromancy in order to save your people from an orcish incursion.
| esci
|-
| The Sceptre of Fire
| The land of Wesnoth's banner bold. Comes not from its own land; It comes from Dwarfdom, grim and old. Made by a runesmith's hand. So now I tell from whence it came - The Fire-sceptre great - And of the makers of the same, Their tale I now relate...
| Turin
|-
| [[SonOfThe_BlackEye|Son of the Black-Eye]]
| Your father Karun Black-Eye was the greatest orcish leader that ever lived. Now, as his son, it's up to you to thwart the selfish designs of the humans who have broken the old agreement with the orcs and are bent upon taking your lands. Unite the warrings orcish tribes, bring together the Orcish Council and call up the Great Horde to send the human-worms and their tree-shagger allies to the land of the dead!
| Benj and Taurus
|-
| [[Northern_Rebirth|Northern Rebirth]]
| For the people of Dwarven Doors the choice was stark: either drudge as downtrodden salves for the orcs until the end of their brief and miserable lives, or risk all for freedom and rise up against their cruel overlords. Little did they suspect that their struggle would be the hinge of great events that might restore the Northlands to the glory they had once known.
| Taurus
|-
| [[UnderTheBurningSuns|Under the Burning Suns]]
| In the distant future a small band of elves struggles to survive amidst the ruins of fallen empires. Lead your people out of the desert on an epic journey to find a new home.
| quartex
|}

== User Campaigns ==
[[UserCampaigns|User Campaigns]] can be downloaded via the Battle for Wesnoth addon server. After they are automatically installed they are playable via the Campaign menu.
{| border="1" cellpadding="0" cellspacing="0"
|-
!width="175" | Name
!| Description
!width="100" | Author
|-
| Alfhelm the Wise
| This is the tale of Alfhelm, called by some the Wise, son of Alfric Conqueror. This is the tale of his victories over his enemies, and his rise to power in the clans of Marauderdom. This is the tale of his journey south and his destruction of the Lavinian Empire. And this is the tale of his demise in the dark forest far to the east of his homeland.
| Turin
|-
| Attack of the Undead
| Play as a mage to protect your city from the undead.
| wsultzbach
|-
| Autumn Kingdom Prologue
| All kingdoms fall. Join Captain Aldehar as he witnesses the rise of revolution, and the changing of an era. Incomplete: 9 scenarios of 14.
| Devrailis Coland
|-
| Bad Moon Rising
| The best of intentions often do not lead to the best results. The prince was a monster, but while overthrowing him, Officer Lorenzon unwittingly unleashes an even greater evil on the world. Requires Extended Era. There are 15 scenarios playable, they still need balancing if not debugging.
| doofus-01
|-
| Capturing Mar'Than
| Play the role of Denring III as he recaptures the mysterious land of Mar'Than from usurpers. Currently contains 10 scenarios, and one story scenario.
| sjl
|-
| Children of Dragons
| Once the most feared creatures in the land of the living, the dragons are all but extinct. But their descendants are just about to make their mark on the world...
| MarkP
|-
| Dead Water
| You are Kai Krellis, a merman king, but only a child. A necromancer has arrived and is turing your subjects into undead slaves. Lead your people on a mission to convince a powerful mermaid to help you repel the invasion. The oceans near the Northern Lands are perilous, so you will need cunning and bravery to be survive, but first you need to gain the respect of your troops! (Intermediate, 10 scenarios.)
| beetlenaut
|-
| Delfadors Memoirs
| Wesnoth seems to be slipping inexorably into chaos, as marauding orcs pour south across the river Abez, and mysterious and deadly creatures roam the night. Who is the shadowy Ihiah-Malal? Can you defeat him before he destroys all life in Wesnoth? (Novice level, 12 scenarios. Not yet complete.)
| Tapik, Josh Pars
|-
| Epic of Vaniyera
| The expansionist Lavinian Legion, led by the Imperator himself, has invaded the northern forest of the Sidhe. It is up to the young Vaniyera to push its armies back from the border... (Novice level, 6 scenarios.)
| Oreb, Turin
|-
| Fall of Silvium
| You are Caius Regilius, a Tribune, of the province Silvia, located in the northmost reaches of the Lavinian Empire. You reside in the city of Silvium, capital of the province, on the border with the northern barbarians. This is the height of the Lavinian Empire - but the Empire has overextended itself. The city of Silvia lies north of the mountains of Arendia, and is sandwiched between the Marauders and the Sidhe... war is inevitable, and the province of Silvia will almost certainly fall.
| Turin
|-
| Flight to Freedom
| Lead Malakar and his Drake tribe to freedom from the humans!
| MadMax
|-
| Invasion From The Unknown - Episode I: Seeking the Light
| Long after the Fall, the last forest elves are forced to abandon their safe valley, and find themselves resorting to the dark means of necromancy in order to survive the perils and challenges of this new harsh world. May they finally free the Great Continent from its chaos, or perish in the foolish attempt of restoring peace and life to the lands. (Expert level, 13 scenarios.)
|
|-
| Invasion From The Unknown - Episode II: Armageddon
| As the shadow of Chaos covers the entire continent, an assorted group of foolish heroes prepares a counter-attack to the Empire, with one unique goal in their minds: defeat the evil Emperor, whoever it is. Lead these courageous living and non-living warriors to the victory, and learn about the lost secrets of the history. (Expert level, 13 scenarios.)
| Shadow Master
|-
| Invasion of Eliador
| A peaceful island is about to be invaded by unknown foes travelling towards the eastern shore. It is up to a family of outlaws to warn the island's inhabitants before it's too late.
| Genosuke
|-
| Legend of Wesmere
| Follow the story of the Kalenz and the Elves in Wesnoth and their fight for survival from the second orcish invasion to the times of Konrad and Delfador. (Intermediate level, 32 scenarios.)
| Santi and WhiteW
|-
| Raajal
| An Arch Mage with the power of resurrection seeks a new apprentice.
| Genosuke
|-
| Return of the Legions
| Years after the defeat of Mal Ravanal, echoes of his dreadful reigh over Wesnoth can still be heard deep in the Northlands. Lead the elves of the Silent Forest to discover the rise of another legion of the undead.
| zookeeper
|-
| Saving Elensefar
| Meneldur, elvish mariner of Elensefar, is driven to sea by the same orcs who attacked the city. He must gather an army willing to fight for him to regain Elensefar, his adpoted homeland.
| Turin
|-
| Stories of Tarlyn
| Ensure the survival of your home town as a member of it's small militia. (6 out of 10 scenarios finished)
| AI
|-
| Story of Wose
| Somewhere on the Green Isle
| Joshua
|-
| The Dark Hordes
| Lead fugitive dark sorceres Gwiti Ha'atel to mastery of the undead hordes. Eight levels so far.
| Circon (author), anyone (maintainers)
|-
| The Forgotten Legacy
| The Saurians of the Salty Swamp have been enslaved for far too long from the cruel Blackblookd clan of the Orcs. In these bitter times S'Saskin, a bloodborn, rises to lead his people to their forgotten legacy and their destiny. Unfinished, five working scenarios.
| Db0
|-
| The Griffoon Lads
| Follow the adventures of the lost warrior Jaghuar Gorgone in the street wars of the Far North.
| Gotrek860
|-
| The Heist
| A plot to steal king's treasure goes awry.
| Genosuke
|-
| The Unstoppable Legion
| The legendary legions of Zharagorn, dormant for centuries, have risen again and city after city is falling in their presence. Only Viktor, a patrol guard, stand between them and domination of the known world. (Unfinished, 11 playable scenarios)
| Chris NS
|-
| Winds of Foerroen
| Lord Daelyn, leader of the elvish kingdom of Aesh Aelon, returns from a lengthy expedition to the far eastern lands, only to discover that his kingdom is under siege by an orcish war lord and his minions. (Three scenarios)
| SaintCredence
|-
|}

[[Category:Campaigns|*]]