wesnoth/doc/manual/manual.txt

Battle for Wesnoth User's Manual
================================

Preface
-------

The Battle for Wesnoth is a turn-based strategy game with a fantasy theme.

'Build up a great army', gradually turning raw recruits into hardened
veterans. In later games, recall your toughest warriors and form a
deadly host against whom none can stand! Choose units from a large pool
of specialists, and hand pick a force with the right strengths to fight
well on different terrains against all manner of opposition.

Fight to regain the throne of Wesnoth, of which you are the legitimate
heir, or use your dread power over the Undead to dominate the land of
mortals, or lead your glorious Orcish tribe to victory against the humans
who dared despoil your lands… Wesnoth has many different sagas waiting
to be played out. You can create your own custom units, and write your
own scenarios – or even full-blown campaigns. You can also challenge
your friends – or strangers – and fight in epic 'multi-player'
fantasy battles.


Getting Started
---------------

Welcome
~~~~~~~

The Land of Wesnoth is generally divided into three areas: the northlands,
which are generally lawless; the kingdom of Wesnoth and its occasional
principality, Elensefar; and the domain of the Southwest Elves.

The Kingdom of Wesnoth lies in the center of the land. Its borders are
the Great River to the north, the Lower Hills in the east and south,
the Green Swamp to the southwest, and the Ocean to the west. Elensefar,
a once-province of Wesnoth, is bordered by the Great River to the north,
a loosely defined line with Wesnoth to the east, the Bay of Pearls to
the south, and the ocean to the west. There is no government of the
Northlands. Various groups of orcs, dwarves, barbarians and even elves
populate the region. The northern and eastern borders are not defined, the
southern border is the Great River, and the western border is the Ocean.

As you travel around the land you will encounter peaceful villages
where you can heal your troops and obtain a good income to support your
army. You will also have to cross mountains and rivers, either on foot
or mounted, push through forests, hills and tundra, or brazenly cross
open grassland. In each of these areas different creatures have adapted
to live there and can travel more easily and fight better when they are
in familiar terrain. In the hills, mountains and underground caves orcs
and dwarves are most at home. In the forests the elves reign supreme
while in the oceans and rivers mermen and nagas control the

The Creatures
^^^^^^^^^^^^^

The world of Wesnoth contains several races that have joined forces into
different factions. Here, Elves and Dwarves fight side by side against
Orcs and Humans. In most campaigns, you will mostly control units from
one faction, but often you will have a recruit list with units mixed
in from other factions, and will not have some units from a faction
available. Basically, your recruit list is determined by the plot of
the campaign, not by a predetermined ruleset.

Sometimes factions make alliances with others, so you may face more than
one faction in a scenario.

Finding Your Way
~~~~~~~~~~~~~~~~

When Wesnoth first starts it displays an initial background and a column
of buttons called the Main Menu. The buttons only work with a mouse. For
the impatient, we recommend you: click the "Language" button to set
your language; then click the "Tutorial" button to run the tutorial;
and then play the campaign, "The Two Brothers" by clicking the "Campaign"
button and selecting it from the list provided.

image:images/main-menu.jpg["Main Menu"]

Tutorial::
 The tutorial is a real, but basic, game which teaches you some of
 the basic controls needed to play the game. Winning or losing is not
 important here, but learning what to do is. Click the Tutorial button to
 play. In the Tutorial you are in the role of the young prince Konrad,
 learning from the Elder Mage Delfador - pay attention or he might turn
 you into a newt.

Campaign::
 Wesnoth was primarily designed to play campaigns. Campaigns are a series
 of connected scenarios. Click this button to start a new campaign. You
 will be presented with a list of campaigns available on your computer
 (more can be downloaded if you wish). Select your campaign and click
 OK to start or Cancel to quit.
 +
 Each campaign has a difficulty level: easy, medium (normal), and hard. We
 recommend medium as this level is challenging, but not difficult. You may
 not change the difficulty during the campaign. In case you have serious
 problems fighting your way through easy difficulty, the guide about
 <<basic_strategy,Basic Strategy>> will surely help you. Once you have
 selected the difficulty, you will start with the first scenario of the
 campaign.

Multiplayer::
 Click this button to play single scenarios against one or more
 opponents. You can play the games over the internet or at your computer,
 against computer or human opponents. When you select this button a
 dialogue will appear and allow you to choose how you want to play the
 scenario. To learn more, see <<multiplayer>>.

Load::
 Click this button to load a previously saved game. You will be shown
 a dialogue listing saved games. Select the game and click Ok to load
 and continue, or Cancel to return to the Main Menu.
 +
 If you select a replay game, you can check the Replay check box. The
 loaded game will make all the moves from the beginning while you watch.

Language::
 Click this button, select your language, and click OK to use it, or
 Cancel to continue with the current language. The first time Wesnoth
 starts, it defaults to English, but once you change it, it will start
 in that language.

Preferences::
 Click here to change default settings.

Credits::
 Click this button for a list of major Wesnoth contributors. You
 may find most of them at irc.freenode.org:6667 on #wesnoth.

Quit::
 Click this button to close Wesnoth. 

Game Modes
~~~~~~~~~~

There are two basic ways to play Battle for Wesnoth:

 - Play a sequence of connected scenarios, known as a campaign, against
   the computer.
 - Play a single scenario against computer or human opponents.

Campaigns
^^^^^^^^^

Campaigns can take a long time to complete. Typical campaigns have about
10-20 scenarios. The main advantage with campaigns is that they allow
you to develop your army. As you complete each scenario, the remaining
units at the end are saved for you to use in the next scenario. If you
choose not to use a unit at all during a scenario it is carried over to
the next, so you don't lose units you don't use.

The campaign is the primary form in which Wesnoth is intended to be
played, is probably the most enjoyable, and is the recommended way for
new players to learn the game.

Scenarios
^^^^^^^^^

A single scenario takes about 30 minutes to 2 hours to complete. This is
the fastest way to play, but your units are not saved and you cannot use
campaign units. You can play scenarios against the computer or against
other players either over the internet or at your computer. Scenarios
are accessed through the "Multiplayer" button on the main menu.

[[multiplayer]]
Multiplayer
+++++++++++

Multiplayer games are played against other players via the Internet
(you can also run them on your LAN if you have one). These games are
co-ordinated through the Wesnoth campaign server. Multiplayer games can
take anywhere from 1 hour to 10 hours, depending on how many players
there are (and the size of the map). The average time is between 3 to
7 hours. Games can be saved and loaded as many times as you like. So,
it's possible for some games to last 1 or 2 weeks, even though the play
time is only a few hours. You cannot carry over units in multiplayer
from one scenario to the next, so building up your army's strength is
possible only within the scenario.

You can host multiplayer games with your client or connect to the
official Wesnoth game server and setup your game there. If you host a
game with your client, other players need to be able to connect to your
port 15000 using TCP. If you are behind a firewall, you will probably
need to change your firewall settings to allow incoming connections to
port 15000, and tell your firewall to forward such traffic to the machine
hosting the game. You should not need to make firewall changes to join
games hosted on a public server or by someone else.

Official and user setup servers are listed at
http://wesnoth.org/wiki/MultiplayerServers[Multiplayer servers].

Hotseat
+++++++

Hotseat games are similar to Multiplayer games except everyone plays at
the same computer by taking turns in the 'hotseat'. Hotseat games will
take about the same time to play as games played over the Internet.

Human vs AI
+++++++++++

You can also play any of the campaign scenarios against AI opponents
rather than human players. This can be a good way to become familiar
with the various maps that are used for multiplayer games before playing
against real opponents. It can also be used as a simple way to explore
the capabilities of units from the different factions by choosing which
faction you will play and which faction your opponents are in these games.

[[game_screen]]
The Game Screen
^^^^^^^^^^^^^^^

Regardless of whether you are playing a scenario or a campaign, the
basic layout of the game screen is the same. The majority of the screen
is filled with a map which shows all of the action that takes place
in the game. Around the map are various elements which provide useful
information about the game and are described in more detail below.

Across the top of the screen from left to right are the following items:

  1. Menu button
  2. Actions button
  3. Turn counter
  4. Your gold
  5. Your total villages
  6. Your total units
  7. Your upkeep
  8. Your income
  9. Current hex type
 10. Current hex position

Down the right of the screen from top to bottom are:

  1. Full map, scaled
  2. Time of day indicator
  3. Unit profile for last selected unit
  4. End Turn button

Recruit and Recall
^^^^^^^^^^^^^^^^^^

When you first start a scenario or campaign you will only have a few units
on the map. One of these will be your commander (identified by a little
crown icon). Your commander is usually placed in a castle on a special
hex called a keep. Whenever your commander is on a keep (not only your
own, but also the keep of any enemy castles you capture) and you have
enough gold, you can recruit units for your army. In later scenarios you
can recall experienced units that survived earlier scenarios. From here,
you can start to build your army to conquer the enemy.

The first thing you will probably want to do is recruit your first
unit. Press `Ctrl-R` (or right click on an empty castle hex and select
"Recruit") and you will be able to recruit a unit from a list of all
the units available to you. Each recruit is placed on an empty castle
square. Once you have filled the castle, you cannot recruit any more
until units move off. Your opponent's commander is similarly placed
on its castle keep and will begin by recruiting its troops -- so don't
dilly-dally looking at the scenery, there's a battle to be won.

At the end of each successful scenario, all your remaining troops are
automatically saved. At the start of the next scenario you may recall
them in a similar way to recruiting. Recalled troops are often more
experienced than recruits and usually a better choice.

Your Army
^^^^^^^^^

All game types use the same soldiers, called units. Each unit is
identified by Race, Level, and Class. Each unit has strengths and
weaknesses, based on their Resistance, current Terrain, and Level. Full
details are in the UnitTables and MoveTypeTables.

Life and Death - Experience
^^^^^^^^^^^^^^^^^^^^^^^^^^^

As your troops gain battle experience, they will learn more skills
and become stronger. They will also die in battle, so you'll need to
recruit and recall more when that happens. But choose wisely, for each
has strengths and weaknesses a cunning opponent will quickly exploit.

Money
^^^^^

Your army does not fight for free. It costs you money to recruit units
and money to maintain them. You start each scenario with money carried
over from previous scenarios (although each scenario ensures you have
at least a minimum amount of gold to start if you didn't carry over
enough from previous scenarios) and can gain more by meeting scenario
objectives quickly and, during a scenario, by controlling villages. Each
village you control will give you two gold pieces income per turn. When
you first start a scenario it is usually worthwhile to gain control of
as many villages as you can to ensure you have sufficient income to wage
war. You can see your current gold and current income at the top of the
screen as described in the section on the <<game_screen,game screen>>.

Save and Load
^^^^^^^^^^^^^

At the start of each scenario, you have the option to save it. If you
are defeated, you may load it and try again. Once you have succeeded,
you will again be asked to save the next scenario and play that. If you
have to stop playing during a scenario, you can save your turn and load
it again later. Just remember, a good BFW player never needs to save
during a scenario. However, most beginners tend to do so rather often.


Playing
-------

Controls
~~~~~~~~

These are the default control keys. You can change them to your taste
using the Preferences menu.

.Controls and hotkeys
`--------------`--------------------------------------------------------------
F1             The Battle for Wesnoth Help
Arrow keys     Scroll
Left click     Select unit, move unit
Right click    Main menu, cancel action
Middle click   Center on pointer location
Escape         Exit game, exit menu, cancel message
Ctrl-r         Recruit unit
Ctrl-Shift-r   Repeat last recruit
Alt-r          Recall unit
u              Undo last move (only deterministic moves can be undone)
r              Redo move
m              Message another player (in multiplayer)
M              Message your allies (in multiplayer)
Alt-m          Message everyone in the game (in multiplayer)
Alt-c          View chat log
n              Cycle through units that have movement left
N              Cycle through units that have movement left, in reverse order
Space          End unit turn and cycle to next unit that has movement left
Shift-Space    Make currently selected unit hold position (end its movement)
Alt-Space      End this player's turn
Ctrl-Space     End turn
Ctrl-v         Show enemy moves (where the enemy can move next turn)
Ctrl-b         Show potential enemy moves, if your units were not on the map
Ctrl-j         Show scenario objectives
Ctrl-f         Toggle full screen/windowed mode
Ctrl-a         Toggle accelerated game mode
Ctrl-g         Toggle grid
Ctrl-c         Clear onscreen labels
Ctrl-s         Save game
Ctrl-o         Load game
Ctrl-l         Toggle mouse scrolling 
Ctrl-p         Go to Preferences menu
Ctrl-q         Quit game
/              Search (find label or unit by name)
t              Continue interrupted unit move
+              Zoom in
-              Zoom out
0              Reset zoom to default
Ctrl-n         Rename unit
1-7            Show how far currently selected unit can move in that many turns
l              Move to leader unit
d              Describe current unit
Ctrl-d         View defensive ratings of current unit against attacks
Ctrl-g         Toggle grid
Alt-k          Toggle shroud
S              Update shroud now
Shift-d        Delay shroud updates
Alt-l          Attach a text label to a terrain hex
L              Set team label
Alt-s          Show status table
s              Show statistics
Alt-u          Show unit list
Ctrl-t         Show terrain table
Ctrl-m         Toggle muting of game sounds
:              Command mode
------------------------------------------------------------------------------

Gold
~~~~

Each side is given some amount of gold to begin with, and receives 2
gold pieces per turn, plus 1 more gold piece for every village that side
controls. In a campaign, starting gold is the greater of 80% of the gold
you ended the previous scenario with, and a minimum amount defined by
the scenario, which is typically lower as the difficulty level increases.

Recruiting and Recalling
^^^^^^^^^^^^^^^^^^^^^^^^

image:images/recruit.jpg["Recruit dialog"]

The major use for gold is to build your army by recruiting new units
or recalling units from previous scenarios in a campagin. Units may be
recruited or recalled when the leader is on a keep whose castle has at
least one vacant castle hex.

 - Right-click in an empty castle hex and select Recruit to recruit new
   units from the list that is presented. The cost to Recruit depends on
   the unit, but is usually between 10 and 20 gold.
 - Right-click in an empty castle hex and select Recall to recall units
   from previous scenarios. Recalling costs 20 pieces of gold per unit. See
   <<unit_recall,recalling units>> for more information.

Upkeep
^^^^^^

Each unit also has an upkeep cost. The upkeep cost is generally equal to
the level of the unit, unless the unit has the "Loyal" trait (<<traits,see
below>>). Units that are not initially recruited - i.e. the leader or
those that join voluntarily - usually have the Loyal trait. Upkeep is
only paid if the total upkeep of a side's units is greater than the
number of villages that side controls. Upkeep paid is the difference
between the number of villages and the upkeep cost.

Income
^^^^^^

So, the formula for determining the income per turn is

  2 + villages - maximum(0, upkeep - villages)

where upkeep is equal to the sum of the levels of all your non-loyal
units.

If the upkeep cost is greater than the number of villages+2 then the
side starts losing gold, if it is equal, no income is gained or lost.

Units
~~~~~

Battle for Wesnoth has hundreds of unit types which are characterised by
a relatively large number of statistics. In addition, individual units
can have specific <<traits>> that make them subtly different from other
units of the same type. Finally, campaign designers can add unique units
to their campaigns to further expand the options available to players.

The basic statistics for a unit include its hit points (HP), the number of
movement points it has, and the weapons it can use and the damage they
do. In addition, units have other characteristics, such as alignment
and special abilities, that are described in more detail below.

Alignment
^^^^^^^^^

Every unit has an alignment: lawful, neutral, or chaotic. Alignment
affects how units perform at different times of day. Neutral units are
unaffected by the time of day. Lawful units do more damage during the
day and less at night. Chaotic units do more damage at night and less
during the day.

The two "day" and "night" phases are differentiated as Morning, Afternoon
and First Watch, Second Watch, by the positions of the sun and moon in
the time of day graphic.

The following table shows the effects of different times of the day on
the damage dealt by lawful and chaotic units:

.Time of the day and damage
`-----`---------------------`-------`------
Turn  Day-phase             Lawful  Chaotic
-------------------------------------------
1     Dawn                  --      --
2     Day (morning)         +25%    -25%
3     Day (afternoon)       +25%    -25%
4     Dusk                  --      --
5     Night (first watch)   -25%    +25%
6     Night (second watch)  -25%    +25%
-------------------------------------------

For example: consider a fight between a Lawful and a Chaotic unit when
both have a base damage of 12. At dawn and dusk, both will do 12 points
of damage if they hit. During Morning or Afternoon, the Lawful unit will
do (`12 \* 1.25`) or 15 points, while the Chaotic unit will do (`12 \*
0.75`) or 9 points. During First or Second Watch, the Lawful unit would
do 9 points compared to the Chaotic unit's 15.

If an equivalent Neutral unit were fighting, it would always do 12 points
of damage regardless of the hour.

[[traits]]
Traits
^^^^^^

Units have traits which reflect aspects of their character. Traits are
assigned randomly to units when they are created. Most units receive
two traits.

The possible traits for most units are as follows:

Intelligent::
  Requires 20% less experience to advance a level (Trolls do not get this
  trait).
Quick::
   Has one extra movement point, but 5% fewer hitpoints.
Resilient::
  Increases hitpoints by 4 plus 1 hitpoint per level of the unit.
Strong::
  Does 1 extra damage per strike in melee, and has 1 extra hitpoint

There are also some traits that are assigned only for certain units or
only for units of a certain race. These are:

Dextrous::
  Does 1 extra damage per strike in ranged combat (Elves).
Healthy::
  Allows the unit to rest-heal even when not resting (Dwarves).
Fearless::
  Does not suffer from a negative attack bonus during its unfavourable
  time of day (Trolls, Walking Corpses).

There are also some traits that are not assigned randomly.
These traits can either be assigned by the scenario designer or are always
assigned based on the unit type:

Loyal::
  Has zero upkeep cost.
Undead::
  Immune to poison and drain (Undead).
Mechanical::
  Immune to poison, drain and plague (Mechanical units).

Unit Specialties
^^^^^^^^^^^^^^^^

Certain units have special attacks. These are listed below:

Backstab::
  This attack deals double damage if there is an enemy of the target on
  the opposite side of the target, and that unit is not incapacitated
  (e.g. turned to stone).
Berserk::
  Whether used offensively or defensively, this attack presses the
  engagement until one of the combatants is slain, or 30 rounds of
  attacks have occurred.
Charge::
  This attack deals double damage to the target. It also causes this
  unit to take double damage from the target's counterattack.
Drain::
  This unit drains health from living units, healing itself for half
  the amount of damage it deals (rounded down).
Firststrike::
  This unit always strikes first with this attack, even if they are
  defending.
Magical::
  This attack always has a 70% chance to hit regardless of the defensive
  ability of the unit being attacked.
Marksman::
  When used offensively, this attack always has at least a 60% chance
  to hit.
Plague::
  When a unit is killed by a Plague attack, that unit is replaced with
  a unit identical to and on the same side as the unit with the Plague
  attack. (This doesn't work on Undead units or units in villages.)
Poison::
  This attack poisons the target. Poisoned units loose 8 HP every turn
  until they are cured or are reduced to 1 HP. (Poison can not, of itself,
  kill a unit.)
Slow::
  This attack slows the target. Slow reorders the attacks allowing the
  attacker to strike one more time until the defender an fight. Slowed
  units move at half normal speed, do not emit a zone of control,
  and always lose initiative in fights. [Effect on damage? Needs to
  be clarified.]
Stone::
  This attack turns the target to stone. Units that have been turned to
  stone may not move or attack (or be attacked).
Swarm::
  The number of strikes of this attack decreases when the unit is
  wounded. The number of strikes is proportional to the % of HP/maximum
  HP the unit has. For example, a unit with 3/4 of its maximum HP will
  get 3/4 of the number of strikes.

Abilities
^^^^^^^^^

Some units have abilities that either directly affect other units,
or have an effect on how the unit interacts with other units. These
abilities are listed below:

Ambush::
  This unit can hide in forest, and remain undetected by its
  enemies. Enemy units cannot see this unit when it is in forest, except
  for any turn immediately after this unit has attacked, or if there
  are enemy units next to this unit.
Cures::
  This unit combines herbal remedies with magic to heal units more
  quickly than is normally possible on the battlefield. This unit will
  care for all adjacent friendly units that are injured at the beginning
  of each turn. A unit cared for by a curer may heal up to 8 HP per
  turn. A curer may heal a total of 18 HP per turn, for all units it
  cares for. A curer can cure a unit of poison, although that unit will
  receive no additional healing on the turn it is cured of poison.
Heals::
  Allows the unit to heal adjacent friendly units at the beginning of
  each turn. A unit cared for by a healer may heal up to 4HP per turn. A
  healer may heal a total of 8HP per turn, for all units it cares for. A
  poisoned unit cannot be cured of its poison by a healer, and must seek
  the care of a village or a unit that can cure.
Illuminates::
  This unit illuminates the surrounding area, making lawful units fight
  better, and chaotic units fight worse. Any units adjacent to this unit
  will fight as if it were dusk when it is night, and as if it were day
  when it is dusk.
Leadership::
  This unit can lead friendly units that are next to it, making them
  fight better. Adjacent friendly units of lower level will do more
  damage in battle. When a unit adjacent to, of a lower level than,
  and on the same side as a unit with Leadership engages in combat,
  its attacks do 25% more damage times the difference in their levels.
Nightstalk::
  This unit becomes invisible during night. Enemy units cannot see this
  unit at night, except for any turn immediately after this unit has
  attacked, or if they are next to this unit.
Regenerates::
  This unit will heal itself 8HP per turn. If it is poisoned, it will
  remove the poison instead of healing.
Skirmisher::
  This unit is skilled in moving past enemies quickly, and ignores all
  enemy Zones of Control. (Exception: if you stop in an enemy zone of
  control, your remaining movement will be set to 0 even if you are
  a skirmisher.)
Steadfast::
  This unit's resistances are doubled, up to a maximum of 50%, when
  defending. Vulnerabilities are not affected.
Submerge::
  This unit can hide in deep water, and remain undetected by its
  enemies. Enemy units cannot see or attack this unit when it is in deep
  water, except for any turn immediately after this unit has attacked,
  or if there are enemy units next to this unit.
Teleport::
  This unit may teleport between any two friendly villages using one of
  its moves.

Experience
^^^^^^^^^^

Units are awarded experience for fighting. After obtaining enough
experience, they will advance a level and become more powerful. The
amount of experience gained depends on the level of the enemy unit and
the outcome of the battle: if a unit kills its opponent, it receives 8
experience points per level of the enemy (4 if the enemy is level 0),
while units that survive a battle without killing their opponents are
awarded 1 experience point per level of the enemy. In other words:

.Experience bonuses for killing or fighting enemies of different levels
`------------`-----------`-------------
enemy level  kill bonus  fighting bonus
---------------------------------------
0            4           0
1            8           1
2            16          2
3            24          3
4            32          4
5            40          5
6            48          6
---------------------------------------

[[unit_recall]]
Recalling units
^^^^^^^^^^^^^^^

After you complete a scenario, all surviving units will be available to
recall in the next scenario. You are not able to move or attack with
a unit on the turn you recruit or recall that unit. A Recalled unit
retains its previous Level, Experience Points, (sometimes) any magic
items acquired, and will arrive with full hitpoints.

Moving
~~~~~~

Clicking on a unit identifies all the places it can move on its current
turn by dimming unreachable hexes (pressing the number keys 2-7 will
identify the additional hexes that can be reached in that number of
turns in a similar manner). While in this mode, moving the cursor over
a hex will identify the path your unit will take towards that hex as
well as additional information on the defensive bonus of your unit on
that hex and, if it will take more than one turn, the number of turns
it will take your unit to arrive. If you do not wish to move the unit
this mode can be cancelled by selecting a different unit (by clicking
on the new unit or using the `n` or `N` keys) or by right-clicking
(Command-click on a Mac) anywhere on the map. The <<orbs>> on the top
of a unit's energy bar provide a quick way to see which of your units
have already moved or can move further in the current turn.

If you decide to move the selected unit, click on the hex you want to
move to and your unit will move towards that space. If you select a
destination which is beyond reach in the current turn, the unit will
move as far as it can in the current turn and enter 'goto-mode'. In
'goto-mode' your unit will continue moving towards its destination in
subsequent turns. You can easily undo goto movements at the beginning
of your next turn; you may also change a unit's destination by selecting
that unit and choosing a new destination.

Moving onto a village that is neutral or owned by an enemy will take
ownership of it and end your move for that unit.

Most units exert a Zone of Control which affects the hexes your unit can
reach and the path your unit takes. These restrictions are automatically
reflected in both the path that is displayed for your unit and the hexes
it may move to on the current turn.

Zone of Control
^^^^^^^^^^^^^^^

A unit's Zone of Control extends to the six hexes immediately adjacent
to the unit, and units that move into an enemy zone of control are
forced to stop. Units with the skirmisher ability ignore enemy zones of
control and are able to move through them freely without being forced
to stop. Level 0 units are considered too feeble to generate a zone of
control and all units are able to move through the hexes around an enemy
level 0 unit freely.

[[orbs]]
Orbs
^^^^

On the top of the energy bar shown next to each unit of yours is an
orb. This orb is:

 - green if you control the unit and it hasn't moved this turn,
 - yellow if you control the unit and it has moved this turn, but could
   still move further or attack,
 - red if you control the unit, but it has used all its movement this
   turn, or
 - blue if the unit is an ally you do not control. 

Enemy units have no orb on the top of their energy bar.

Planchets, Team Colors, and Hero Icons
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Below each unit there will normally be a colored planchet or base. The
color identifies its team; in a campaign game, the human-player color is
red. The team color will also show up in parts of the unit's clothing,
or possibly on a shield insignia.

Usually the planchet will be a solid disk, looking like an ellipse
because of the angle of view. Sometimes (usually on a level 0 unit),
you will see a planchet that looks like helicopter blades; this indicates
that the unit has no Zone of Control.

Some campaigns use a star-shaped planchet to indicate leaders; others use
a shield-shaped hero icon next to the unit's upper-right corner. Still
others have no specific hero indicator at all. Which (if any) is used
is a stylistic choice left to campaign designers.

Fighting
~~~~~~~~

If you move next to an enemy unit, you may attack it. Click on your
unit that is next to an enemy unit, and click on the enemy you want to
attack - this will bring up a window that presents further options for
the fight. Every unit has one or more weapons it can attack with. Some
weapons, such as swords, are melee weapons, and some weapons, such as
bows, are ranged weapons.

If you attack with a melee weapon, the enemy you attack will be able to
strike back at you with its melee weapon. If you attack with a ranged
weapon, the enemy will be able to strike back with its ranged weapon. If
an enemy does not have a weapon of the same type as the one you attack
with, they will be unable to strike back and do any damage to you in
that fight.

Different types of attacks do different amounts of damage, and a certain
number of strikes may be made with each weapon. For instance, an Elvish
Fighter does 5 points of damage with its sword every time it hits,
and can strike 4 blows with the sword in one exchange. This is written
as 5-4, meaning 5 damage per hit, and 4 strikes.

Every unit has a chance of being hit based on the terrain it is in. For
instance, units in castles and villages have a lower chance of being
hit, and Elves in forest have a low chance of being hit. To see a unit's
defense rating (i.e. chance not to be hit) in terrain, click on the unit,
and then mouse over the terrain you're interested in, and the defense
rating will be displayed as a percentage value in the status pane,
as well as shown over the terrain hex.

You can obtain additional information, including the chance that
the attacker and defender will be killed, by clicking on the "Damage
Calculations" button in the fight window.

Attack types
^^^^^^^^^^^^

 - *Blade*: Weapons with a cutting edge, used to chop pieces of meat from
   a foe. Examples: dagger, scimitar, saber, drake claws.
 - *Piercing*: Weapons with a sharp point and either a long handle
   or a missile, used to perforate foe's body and damage internal
   organs. Examples: Knight or infantry pike, arrow.
 - *Impact*: Weapons having neither a sharp point nor a cutting edge,
   but heavy enough to break an enemy's bones. Examples: mace, staff,
   Troll fist.
 - *Cold*: Weapons based on cold or ice missiles. Example: A wizard's
   ice bolt.
 - *Fire*: Weapons using fire to roast the foe like a chicken. Example:
   A drake's fire breath.
 - *Holy*: Magical weapons blessed by a deity. Example: A white mage's
   magic attack.

Resistance
^^^^^^^^^^

Each unit is more or less vulnerable to the different attack types. 6
figures in the unit description show strength and weakness of the unit
against the 6 attack types. A positive resistance figure indicates
that the unit will suffer less damages from the attack type. A negative
resistance figure indicates that the unit is especially vulnerable to
this attack type.

Examples: Drake scales protect them from most of attack types except from
piercing weapon and cold weapon. Human Cavalry units are generally well
protected except from piercing attacks which are their weak point. Undead
are very resistant to blade and piercing weapon but very vulnerable to
impact attacks and holy attacks.

Use the best attack type against enemy units.

Healing
~~~~~~~

A unit may be healed a maximum of 8 hitpoints per turn. A unit that
does not move or fight during a turn is _resting_ and will recover 2
hitpoints. Hitpoints recovered through _resting_ are added on top of
hitpoints recovered through healing so it is possible for a unit to
recover up to a total of 10 hit points per turn.

There are two basic ways for a unit to be healed:

 - Resting in a village. The unit will heal 8 hitpoints every turn.
 - Being adjacent to units with the 'heals' abilitiy. The number of
   hitpoints healed is specified in the unit's ability description. This
   is invariably 'heals +4' or 'heals +8'.

Regeneration
^^^^^^^^^^^^

Trolls and Woses have the ability to heal themselves naturally through
regeneration. They will heal 8 points each turn if they are injured. Note
that because all units may only heal a maximum of 8 points per turn,
Trolls and Woses gain no additional benefit from being on a village or
next to a healing unit.

Poison
^^^^^^

Some attacks can inflict poison damage on your unit. When this happens
you will take 8 damage each turn until it is cured. Poison can be
cured by resting on a village or being next to a unit with the 'cures'
ability. Units with the 'heals' ability can only prevent the poison from
causing damage that turn, not cure it. When poison is cured the unit does
not gain or lose hitpoints on that turn due to healing/poisoning. A unit
can not be healed normally until it is cured of poisoning.

Some other hints about healing:

 - A unit may take several turns to be fully healed.
 - Healers (Elvish Shaman, Elvish Druid, Elvish Shyde, White Mage, Mage
   of Light, Paladin) heal all wounded units around them, so you can keep
   units close to the battle without losing them.
 - Healers will first heal their own units and then all friendly ones.
 - Healers do not heal enemy units.
 - Healers cannot heal themselves, but see next point.
 - Use your healers in pairs, so they can heal each other if needed.
 - Healers can heal the same unit and speed up healing.
 - Trolls and Woses cannot regenerate other units.
 - Trolls and Woses cure themselves from poison as a village does.
 - Trolls and Woses can be healed by healers and a village.


Strategy and Tips
-----------------

[[basic_strategy]]
Basic Strategy
~~~~~~~~~~~~~~

The following basic combat principles and tips are intended to help
starting off your career as a wesnothian battle veteran. The minor
concrete examples are somewhat tied to the "Heir to the Throne" campaign.

Don't waste units
^^^^^^^^^^^^^^^^^

Do not send wounded units to a sure death. Once a unit loses more than
half of its hit points (HP), you should seriously consider retreating it
to safety and either station it in a village for healing or give him to
the care of a healer (like Elvish Shamans or White Mages). Healers are
very useful!

This is for practical reasons: a heavily wounded unit cannot hold back
or kill the enemy. During attack and counterattack, it most often will
perish. Further, by sending it to its sure death, its gathered experience
points (XP) are lost. Recruiting a replacement may be impossible because
the leader is not in its keep or because funds are running low. Even if
you can recruit a replacement, it is most often far away from the battle
front. So don't waste your units.

Out of the enemy's reach
^^^^^^^^^^^^^^^^^^^^^^^^

How do you guard wounded units? They are best guarded by being out of
the adversary's reach. No enemy can attack them if enemies cannot even
come near them. The next section about zone of control (ZOC) shows how
to restrict the enemy's moves.

In the Action menu, you can select "Show Enemy Moves" to highlight all
possible hexes your adversary can actually move to. This takes your zone
of control into account. Thus you can check that your near death unit,
which is behind, indeed cannot be attacked as the enemy cannot move
close to it.

When your armies meet, you may want to try to be the first to attack. So
try to end your move out of striking range of the enemy army. He cannot
attack but most likely will close into your striking range.

[[zoc]]
Shield with your zone of control (ZOC)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Every unit of level 1 or higher maintains a zone of control (ZOC) covering
all 6 neighboring hexes. This means that once an enemy moves into one of
the six neighboring tiles, it is forced to halt and its movement phase
ends (only enemies with the rare skirmisher ability ignore this).

Because of ZOC, an enemy may not slip between two units which are
aligned on a north-south or diagonal line and have exactly 1 or 2 hexes
between them. By combining these pairs into a long wall or using them in
different directions, you can prevent the enemy from reaching a wounded
unit behind. He has to defeat the units imposing the ZOC first. If the
enemy can barely reach it, even a single unit may shield a small region
behind itself.

Maintain a defensive line
^^^^^^^^^^^^^^^^^^^^^^^^^

By lining up many units directly adjacent or with at most 1 hex space
between them, you can build up a powerful defensive line. Note that,
because Wesnoth uses hexes, a east-to-west "line" is not a straight
line but a zig-zag curve. The north south line and the diagonals are the
"real" lines.

Coming from one side, the enemy may attack any single of your units
in the line with only 2 of his units at a time. As a rule of thumb,
a healthy unit without particular weakness can withstand an attack from
two normal enemy units without getting killed.

Unfortunately, your line often has to bend to form a wedge or to fit
the terrain. At these corner points, 3 enemy units may attack. This
also happens at the ends of a line if the line is too short. Use units
with high hit point on proper terrain or with proper resistances to hold
these weak points. These are the most likely to be killed, so use units
with no or few experience points (XP) for this purpose.

Lining your troops up also prevents the enemy from surrounding any one
of them. For ZOC reasons, a unit with one enemy behind and in front
is trapped.

Rotate your troops
^^^^^^^^^^^^^^^^^^

When a unit in the front line is heavily damaged you can move him safely
behind your defensive line. To hold up the line, you will most likely
have to replace him with a reserve, so hold a couple of units in back
of the front line. If you have healers, damaged units in the second line
will quickly recover.

Note that your units can pass through hexes containing your own troops.

Use the terrain
^^^^^^^^^^^^^^^

Try to position your troops so that they are attacking from a hex with
high defense against an enemy in a hex with low terrain. Note that
different units work better on different terrains. This way, terrain
often dictates where you line up your units.

For example, you may position your elves at the end of the forest so
that attacking orcs must stand on grassland while your elves enjoy the
high forest defenses.

Attacking and choosing your targets
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Advancing and attacking is of course the most interesting part of your way
to victory. Kill or weaken enemies in your path and move your defensive
line forward. This can become tricky as the enemy gets to attack back
on his turn.

Often, you will throw several units at a single enemy unit to finish
him off, but these were forming your defensive line which is now partly
broken. Maybe this doesn't matter because you are out of reach of the
next enemy unit. Maybe it does because you only managed to weaken a
very strong enemy and next turn, he is going to strike back. Perhaps a
Horseman can deliver the killing blow.

Striking first is an advantage because it allows you the choice of which
units will face off. Take advantage of enemy weakness: e.g. direct your
ranged attacks against foes without ranged weapons. Take advantage of
weaknesses like Horsemen's vulnerability to pierce. But remember that
they get to attack back on their turn, so you might have weaknesses he
may exploit.

For example, Horsemen can hold up the line against Orcish Grunts and
Troll Whelps very well because they have some resistances against blade
and impact. But your Horseman may quite quickly fall to Orcish Archers
and Goblin Spearmen.

It usually pays off if you can definitively kill (or almost kill) the
faced unit. If you are unsure of finishing off the enemy in one turn,
ensure that your unit can weather the return attacks, or that you're
willing to lose that unit. To withstand the enemies strikes next turn,
it is often wise to attack with the weapon that deals the least damage
to you. So use your ranged weapons if the enemy has no ranged attack. The
computers default choice only looks for the most damage you deal out.

Time of Day
^^^^^^^^^^^

Remember that Lawful units like humans fight better at daytime and Chaotic
units like orcs or undead fight better at night. Ideally you want to
first meet the enemy when you are strong and/or he is weak. When the
enemy has its strong time, it often pays off to strengthen your lines
and hold a favorable defensive position. When its weak time is about to
arise, your advance will push forth.

For example, elves might hold out a forest during a nightly orcish
onslaught and advance on sunrise. You may even note that the computer
AI actively retreats his orcs during day.

Experience
^^^^^^^^^^

Over the course of a campaign, it is critical that you build up a seasoned
force. Later scenarios will assume you have level 2 and 3 units available
for recall.

Your units gain most experience points (XP) from killing an enemy unit
(8XP per level of the unit killed). As such, it often makes sense to
have your higher level units weaken an enemy, but cede the kill to a
unit more in need of the XP. Healers in particular are often weak in
combat and often need to 'steal' kills in this way to advance levels.

At the beginning (when you probably have no high level units), try to
give most kills to a small handful of your units. This will fast-track
them to becoming Level 2 units, and they can then shepherd others.

Don't neglect to earn your leader experience. You need to keep him safe,
but if you coddle him too much he will be too low level to survive future
scenarios anyway.

Getting the Most Fun Out of the Game
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Remember, the idea of a game is to have fun! Here are some recommendations
from the development team on how to get the most fun out of the game:

 - Consider playing the campaign on "Medium" difficulty level, especially if
	you have prior experience with strategy games. We feel you'll find it
	much more rewarding.
 - Don't sweat it too much when you lose some units. The campaign was
	designed to accommodate the player losing some units along the way.
 - Don't abuse saved games. Long ago, Wesnoth only allowed saving the game
   at the end of a scenario. Mid-scenario saving was added as a
   convenience to use if you had to continue the game another day,
   or to protect against crashes. We do not recommend loading mid-scenario
   saved games over and over because your White Mage keeps getting
   killed. Learn to protect your White Mage instead, and balance
   risks! That is part of the strategy.
 - If you must load a saved game, we recommend going back to the start
   of the scenario, so that you choose a new strategy that works, rather
   than simply finding random numbers that favor you.
 - But remember, the aim is to have fun! You may have different tastes
   than the developers, so do what you enjoy most! If you enjoy loading
   the saved game every time you make a mistake, looking for the 'perfect'
   game where you never lose a unit, by all means, go right ahead!

At the start of a scenario
^^^^^^^^^^^^^^^^^^^^^^^^^^

 - First, read the scenario objectives. Sometimes you do not have to
   kill enemy leaders; instead it is enough that you survive for a
   certain number of turns, or pick up a particular object
 - Look at the map: the terrain, the position of your leader and the
   other leader(s).
 - Then, begin to recruit units. Cheap units are useful to soak up the
   first wave of an enemy's attack; advanced units can then be brought
   in as support. Fast units can be used as scouts, for exploring the
   map and to quickly conquer villages.

During the scenario
^^^^^^^^^^^^^^^^^^^

 - Try to capture and keep control of as many villages as possible to
   keep the gold coming in
 - Keep units in packs so the enemy cannot attack from as many sides, and
   so you can outnumber each enemy unit. Put your units in a line so that
   the enemy cannot attack any one of your units from more than two sides.
 - Different units have different strengths and weaknesses depending
   on terrain and who they are attacking; right click on units and select
   "Describe unit" to learn more
 - You can use lower level units as cannon fodder, to slow down
   enemy. e.g. you can use them to block enemy reaching your important units
 - You can cause damage to enemies with advanced units and then finish
   them with lower level units - to give them more experience (and finally
   make them advance to next level)
 - When you have a White Mage (advances from Mage) or Druid (advances
   from Shaman), put it in the middle of a circle of units to heal them
   as they move across the map (Shamans can do this too, but not as well)
 - Losing units is expected, even advanced units
 - Time of day really matters:
    * lawful units do more damage at day and less damage at night
    * chaotic units do more damage at night and less damage at day
    * remember to always check the time of day on the right side of the
      screen. Plan ahead - think about what it's going to be next turn as
      well as this turn.
 - Some units are resistant or vulnerable to different kind of
   attacks. Mounted units are weak vs pierce attacks. Fire and holy
   attacks destroy undead. To see how much a unit resists an attack
   type, right click on the unit, select "Unit Description", then select
   "Resistance". It will show you how resistant a unit is to different
   types of attacks.

Healing
^^^^^^^

An important part of succeeding at Battle for Wesnoth is keeping your
units healthy. When your units take damage you can heal them by moving
them onto villages or next to special healing units (e.g. the Elvish
Shaman and White Mage). Some other units you will encounter, such as
Trolls, have the ability to heal themselves naturally.

Winning a scenario
^^^^^^^^^^^^^^^^^^

 - Advanced units are needed to quickly kill enemy commanders, and to
   avoid losing lots of units.
 - The quicker you win a scenario, the more gold you get; you will get
   more gold from winning early than from all of the map's villages for
   the rest of the turns.
 - Killing all enemy leaders usually gives instant victory. 

More general tips
^^^^^^^^^^^^^^^^^

 - After slaughtering scenarios (where you take lots of punishment) there
   are usually "breathing room" scenarios where you can rather easily
   gain some gold and experience (advanced units)
 - Advanced units have higher upkeep than lower level units (1 gp per
   level), loyal units are an exception.


Glossary
--------

ZOC:-
	<<zoc,Zone Of Control>>.

// vim: set syntax=asciidoc: