/* $Id: MANUAL,v 1.19 2004/09/11 05:49:03 gakusho Exp $ */

The Battle For Wesnoth Manual

If you are new to Battle for Wesnoth you might want to read the GettingStarted guide first.


Controls

 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
 z:              Zoom in
 x:              Zoom out
 c:              Reset zoom to default
 u:              Undo last move (only deterministic moves can be undone)
 r:              Redo move
 n:              Cycle through units that have movement left
 1-7:            Show how far currently selected unit can move in that many turns
 space:          End unit turn and cycle to next unit that has movement left
 l:              Move to leader unit
 ctrl-f:         Toggle fullscreen/windowed mode
 ctrl-r:         Recruit unit
 ctrl-shift-r:   Repeat last recruit
 alt-r:          Recall unit
 ctrl-a:         Toggle accelerated game mode
 d:              Describe current unit
 ctrl-d:         View defensive ratings of current unit against attacks
 ctrl-t:         View how the current unit behaves in various terrain
 ctrl-s:         Save game
 ctrl-l:         Load game

	  
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.
 * red if you control this unit, but it has already used all its movement this turn
 * blue if the unit is an ally, but you cannot move it 

Enemy units have no orb on the top of their energy bar. (In older versions < 0.5.2 there was a black orb on the top of energy bar of enemy units)


Description

The game takes place over a series of battles, or scenarios. Each scenario pits your troops against the troops of an adversary. Each side begins with one leader in their keep.


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.

Each unit also has a upkeep cost. The upkeep cost is generally equal to the level of the unit (but see the 'Loyal' trait below). Units that are not recalled or recruited - i.e. that lead the side or join the side voluntarily - do not have a upkeep cost associated with them. 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. 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 units that have been recalled and recruited.


Recruiting and recalling

Units may be recruited with gold, as long as the leader is on a keep, and there is at least one vacant castle hex in the castle the leader is in. Right-click and select Recruit to recruit new troops.

After you complete a scenario, all surviving will be available to you next scenario. Right-click and select Recall to re-recruit units from previous scenarios. Recalling costs 20 pieces of gold.

You can first highlight free castle tile and then proceed with recruit, this way you can choose the tile for recruited unit to appear, this works for recruiting and recalling.

You are not able to move a unit on the turn you recruit or recall that unit.


Unit specialties

Unit specialties are described under Unit Description in-game.


Traits

Units have traits which reflect aspects of their character. Traits are assigned randomly to units when they are created. Each unit receives two traits. The possible traits are as follows:

 Loyal:         The unit never has a upkeep cost above 1.
 Strong:        The unit does extra damage in close combat, and has a few more hitpoints.
 Quick:         The unit has one extra movement point, but a few less hitpoints.
 Resilient:     The unit has more hitpoints.
 Intelligent:   The unit requires less experience to advance a level.


Moving

When a unit is clicked on, all the places it can move to on the current turn become lit up, while everywhere it can't move is greyed. You can then click on the hex you want it to move to. Moving onto a village that is neutral or owned by an enemy will take ownership of it. If you select destination which beyond reach in your turn the unit will enter 'goto-mode' and continue moving towards destination thru next turn(s). You can easily undo goto movements in the beginning of your turn, goto can be broken by selecting unit and choosing new destination.

You may not move through enemy unit's adjacents hexes (their Zone of Control) without stopping.


Fighting

If you move next to an enemy unit, you may attack them. Click on your unit that is next to an enemy unit, and click on the enemy you want to attack. Every unit has one or more weapons they 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 attack back with its ranged weapon, if it has one.

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 his sword every time it hits, and he can strike 4 blows with it in one exchange. This is generally written as 5-4.

Every unit has a chance of being hit based on the terrain they are on. Units in castles and villages have a lower chance of being hit. Elves in forest have a low chance of being hit.


Alignment

Every unit has an alignment: lawful, neutral, or chaotic. Their alignment affects how they perform at different times of day. The following table illustrates the different times of the day:

 | turn |  day-phase |
 ---------------------
 |  1   |    dawn    |
 |  2   |    day     |
 |  3   |    day     |
 |  4   |    dusk    |
 |  5   |    night   |
 |  6   |    night   |

Units that are Lawful deal 25% more damage at day, and 25% less damage at night. Units that are Chaotic deal 25% more damage at night, and 25% less damage at day. Neutral units have their fighting unaffected by the day/night cycle. Note also that in-game, the two "day" and "night" phases are differentiated as Morning, Afternoon and First Watch, Second Watch.


Healing

Injured units in villages will recover 8 hitpoints every turn. Injured units that are adjacent to units with the 'heal' or 'cure' abilities will also heal. Units next to unit(s) with the 'heal' ability will heal a maximum of 4 hitpoints per turn, and 8 hitpoints per turn for unit(s) with the 'cure' ability. However the more units around a unit that can heal, the less each one will be healed. Maximum healing for a unit is 8 hitpoints, and thus a Troll residing in a village will only recover 8 hitpoints, not 16. Nor will a unit inside a village get extra healing from adjacent healers.

'Heal' prevents poisoning to cause damage while 'cure' removes poisoning. When poisoning is cured unit does not gain hitpoints on that turn.


Experience

Units are awarded experience for fighting, and after obtaining enough experience, they will advance a level, and become more powerful.


Multiplayer

You can host multiplayer game with your client or connect to wesnoth game server and setup your game there. If you host game with your client other players need to be able to connect your port 15000 (TCP).

Public servers:

 server.wesnoth.org        for stable releases of the game
 devsrv.wesnoth.org        for testing releases of the game
 devsrv.wesnoth.org:14999  for CVS versions of the game


Setting up multiplayer game

Step1: select multiplayer from main screen, select to host game with your client or join server and create game

Step2: select map and configure game settings (fog of war, shroud, gold per village)

Step3: configure players (teams/alliances, starting gold, faction) and then wait for all players set to 'network player' to join the game, you will see "network player" replaced with their nicknames as they join.

Step4: click [I'm Ready].
