initial commit, lordsawar source, slightly modified
[lordsawar] / help / lordsawar.xml
1 <?xml version="1.0"?>
2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "
3 http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
4   <!ENTITY legal SYSTEM "legal.xml">
5 <!ENTITY app "<application>LordsAWar!</application>">
6 <!ENTITY appversion "0.1.7">
7 <!ENTITY date "November 2009">
8 <!ENTITY manrevision "0.1.7">
9 ]>
10
11 <article id="index" lang="en"> 
12
13 <articleinfo> 
14         <title>LordsAWar! User's Manual &manrevision;</title> 
15         <copyright> 
16                 <year>2008, 2009</year>
17                 <holder>Ben Asselstine</holder> 
18         </copyright>
19         <publisher> 
20                 <publishername>Ben Asselstine</publishername> 
21         </publisher> 
22         &legal; 
23         <authorgroup> 
24                 <author> 
25                         <firstname>Ben</firstname> 
26                         <surname>Asselstine</surname>
27                         <affiliation>
28                                 <orgname>LordsAWar! Development Team</orgname> 
29                                 <address>
30                                         <email>benasselstine@gmail.com</email>
31                                 </address>
32                         </affiliation>
33                 </author> 
34         </authorgroup> 
35         <releaseinfo> This manual describes version &appversion; of &app; and is licensed under the terms of the GNU Free Documentation License version 1.2.
36         </releaseinfo> 
37         <legalnotice id="feedback"> 
38                 <title>Feedback Information</title> 
39                 <para>
40                         To report a bug or make a suggestion regarding this application or this documentation, see the <ulink type="help" url="ghelp:gnome-feedback">GNOME Feedback Page</ulink>.
41                 </para>
42         </legalnotice>
43 </articleinfo>
44
45 <indexterm zone="index"> 
46         <primary>LordsAWar!</primary> 
47 </indexterm> 
48 <indexterm zone="index"> 
49         <primary>LordsAWar</primary> 
50 </indexterm> 
51 <indexterm zone="index"> 
52         <primary>Lordsawar</primary> 
53 </indexterm> 
54 <indexterm zone="index"> 
55         <primary>lordsawar</primary> 
56 </indexterm>
57
58
59 <!-- ============= Prologue ============================== -->
60 <!-- Use the Prologue section to excite the user into wanting to play
61      the gmae. -->
62 <sect1 id="lordsawar-prologue"> 
63         <title>Prologue</title> 
64         <para>
65 The entire realm is holding its breath -- war is coming, and the citizens know what that means; cities will be sacked, towns will be looted, and flags will be raised.  There will be a shortage of food supplies, high taxes, and fire burning on the horizon, if not even closer.  The best thing to do is to join the army before getting drafted.  
66 </para>
67
68         <para>
69 Several factions will vie for total control of the realm.  Talented generals will be needed to lead forces against the enemy.  Plans will be made, and lands will be conquered.  Heroes will emerge to fight on behalf of their general.  Large seige engines will be constructed and rolled to distant cities.  Great ships of war will take to the seas.   Infantry units will be sent to the front line to face the enemy in battle.
70         </para>
71
72         <para>
73 The future is uncertain.  The lords of the realm are warring.  The lords are a-war.
74         </para>
75 </sect1>
76
77 <!-- ============= Introduction ============================== -->
78 <!-- Use the Introduction section to give a brief overview of what
79      the game is and what it does. -->
80 <sect1 id="lordsawar-introduction"> 
81         <title>Introduction</title> 
82         <para>
83 &app; is a turn-based strategy game where up to eight players strive to conquer all of the cities on the map.  The player has three distinct roles in the game:
84
85           <orderedlist>
86                 <listitem>
87 The player acts as a General who controls all of military strategy elements of the game; moving armies around the map, conquering cities and managing the production of new army units.
88 </listitem>
89 <listitem>
90 The player acts as a diplomatic envoy, managing diplomatic relations with every other player.
91 </listitem>
92 <listitem>
93 The player acts as a tax collector, automatically collecting gold pieces from each city that has been conquered.  This pays for the maintenance of army units already created.  The income can also be used to buy new and different kinds of army units.
94 </listitem>
95           </orderedlist>
96 </para>
97 <para>
98 Army units are arranged into stacks of up to eight and are moved around the map through varying terrain; forest, hills, swamp, or water.  Each of the varying kinds of terrain cost the stack some of its movement points.  Some stacks may even have the ability to fly over troublesome mountains.  
99 </para>
100
101 <para>
102 Some army units are special Hero units.  Heroes sometimes emerge spontaneously in cities at the start of the player's turn.  Heroes can search ruins to obtain gold pieces or magical items, or go on special quests.  Powerful allies often accompany a hero.
103 </para>
104
105 <para>
106 The objective of the game is to conquer all of the cities on the map.  This is accomplished by producing army units in cities and making ever more powerful stacks to conquer neighbouring cities.  Strategy is employed to know which city, or player to target next, on the way to total victory.
107 </para>
108 <sect2 id="lordsawar-main-screen">
109         <title>The Main Screen at a Glance</title> 
110 <figure id="mainscreen-fig">
111 <screenshot>
112 <mediaobject>
113 <imageobject>
114 <imagedata fileref="figures/main_screen.png" format="PNG"/>
115 </imageobject>
116 </mediaobject>
117 </screenshot>
118 </figure>
119 <para>
120 <itemizedlist>
121 <listitem>
122 A - Temple
123 <para>
124 A Temple is where stacks can go to get blessed, and heroes can find quests.
125 </para>
126 </listitem>
127 <listitem>
128 B - Port
129 <para>
130 A Port is where army units can get on or off ships.
131 </para>
132 </listitem>
133 <listitem>
134 C - Selected Stack
135 <para>
136 Army units must be first selected (with left-click) to command them.  This stack has one army unit (shown by the length of the flag).
137 </para>
138 </listitem>
139 <listitem>
140 D - City
141 <para>
142 A City is a place that creates Army units, and provides valuable income.
143 </para>
144 </listitem>
145 <listitem>
146 E - Unselected Stack
147 <para>
148 This unselected stack has one army unit.
149 </para>
150 </listitem>
151 <listitem>
152 F - Ruin
153 <para>
154 A Ruin is a place a Hero can go to risk life for valuable rewards.
155 </para>
156 </listitem>
157 <listitem>
158 G - Hills
159 <para>
160 Some army units can move switfly through hills, although most cannot.
161 </para>
162 </listitem>
163 <listitem>
164 H - Mountains
165 <para>
166 No army unit can move through mountains, they must be traversed around, or flown over.
167 </para>
168 </listitem>
169 <listitem>
170 I - Forest
171 <para>
172 Some army units can move swiftly through forests, although most cannot.
173 </para>
174 </listitem>
175 <listitem>
176 J - Swamp
177 <para>
178 No army units can travel swiftly through swamp, although it can be flown over by stacks that have the gift of flight.
179 </para>
180 </listitem>
181 <listitem>
182 K - Signpost
183 <para>
184 Signposts contain information that the player can view by right-clicking on it.
185 </para>
186 </listitem>
187 <listitem>
188 L - Turn Indicator
189 <para>
190 The Turn Indicator shows what round it is, and who's turn it is.
191 </para>
192 </listitem>
193 <listitem>
194 M - Miniature Map
195 <para>
196 The Miniature Map is the zoomed out view of the entire map.
197 </para>
198 </listitem>
199 <listitem>
200 N - Zoomed-In Area
201 <para>
202 The Zoomed-In Area denote by a white box is show on the left.
203 </para>
204 </listitem>
205 <listitem>
206 O - Moves Left for the Army Unit
207 <para>
208 This value is the number of movement points the army unit has left.
209 </para>
210 </listitem>
211 <listitem>
212 P - Selected Army Unit in Stack
213 <para>
214 The button appears pushed-in, meaning that this army unit is part of the stack.  Other army units may appear to the right of this unit, in their own button.  There can be up to 8 army units in a stack.
215 </para>
216 </listitem>
217 <listitem>
218 Q - Moves Left for the Stack
219 <para>
220 This value is the number of movement points that the stack has left.
221 </para>
222 </listitem>
223 <listitem>
224 R - Movement Bonus
225 <para>
226 This graphic denotes which terrain the stack can move through swiftly.  In this case the stack has the gift of flight.
227 </para>
228 </listitem>
229 <listitem>
230 S - Water
231 <para>
232 Only army units on ships can go in the water, although some army units can fly over the water.
233 </para>
234 </listitem>
235 </itemizedlist>
236 </para>
237 </sect2>
238 <sect2 id="lordsawar-main-screen-buttons">
239         <title>A Closer Look at the Buttons</title> 
240 <para>
241 Below the mini-map, there are a set of buttons that allow the player to control stacks:
242 <figure id="mainscreen-buttons-fig">
243 <screenshot>
244 <mediaobject>
245 <imageobject>
246 <imagedata fileref="figures/main_screen_buttons.png" format="PNG"/>
247 </imageobject>
248 </mediaobject>
249 </screenshot>
250 </figure>
251 </para>
252
253 <para>
254 &app; games can contain a large number of stacks, and it's easy to forget about a stack.  These buttons help the player manage large numbers of stacks.
255 Here is what each of the buttons do:
256 <itemizedlist>
257 <listitem>
258 <figure id="mainscreen-move-stack-button-fig">
259 <screenshot>
260 <mediaobject>
261 <imageobject>
262 <imagedata fileref="figures/main_screen_move_stack_button.png" format="PNG"/>
263 </imageobject>
264 </mediaobject>
265 </screenshot>
266 </figure>
267 <para>
268 Clicking this button causes the stack to travel along it's path.
269 </para>
270 </listitem>
271 <listitem>
272 <figure id="mainscreen-select-next-stack-button-fig">
273 <screenshot>
274 <mediaobject>
275 <imageobject>
276 <imagedata fileref="figures/main_screen_select_next_stack_button.png" format="PNG"/>
277 </imageobject>
278 </mediaobject>
279 </screenshot>
280 </figure>
281 <para>
282 Clicking this button causes the next stack to be selected.
283 </para>
284 </listitem>
285 <listitem>
286 <figure id="mainscreen-park-stack-button-fig">
287 <screenshot>
288 <mediaobject>
289 <imageobject>
290 <imagedata fileref="figures/main_screen_park_stack_button.png" format="PNG"/>
291 </imageobject>
292 </mediaobject>
293 </screenshot>
294 </figure>
295 <para>
296 Clicking this button causes the stack stop here.  Clicking this button means that the stack will not be visited again as the player clicks the next-stack button for the duration of this turn.
297 </para>
298 </listitem>
299 <listitem>
300 <figure id="mainscreen-deselect-stack-button-fig">
301 <screenshot>
302 <mediaobject>
303 <imageobject>
304 <imagedata fileref="figures/main_screen_deselect_stack_button.png" format="PNG"/>
305 </imageobject>
306 </mediaobject>
307 </screenshot>
308 </figure>
309 <para>
310 Clicking this button causes the stack to be deselected.  This stack will be visited again as the player clicks the "next stack" button.
311 </para>
312 </listitem>
313 <listitem>
314 <figure id="mainscreen-center-on-stack-button-fig">
315 <screenshot>
316 <mediaobject>
317 <imageobject>
318 <imagedata fileref="figures/main_screen_center_on_stack_button.png" format="PNG"/>
319 </imageobject>
320 </mediaobject>
321 </screenshot>
322 </figure>
323 <para>
324 Clicking this button causes the map to be centered on the selected stack.
325 </para>
326 </listitem>
327 <listitem>
328 <figure id="mainscreen-diplomacy-button-fig">
329 <screenshot>
330 <mediaobject>
331 <imageobject>
332 <imagedata fileref="figures/main_screen_diplomacy_button.png" format="PNG"/>
333 </imageobject>
334 </mediaobject>
335 </screenshot>
336 </figure>
337 <para>
338 Clicking this button causes the diplomacy screen to pop up.  When other players make diplomatic proposals to you, the diplomacy button looks like this:
339 <figure id="mainscreen-diplomacy-proposed-button-fig">
340 <screenshot>
341 <mediaobject>
342 <imageobject>
343 <imagedata fileref="figures/main_screen_diplomacy_proposed_button.png" format="PNG"/>
344 </imageobject>
345 </mediaobject>
346 </screenshot>
347 </figure>
348 This makes it easy for the player to tell if there are new diplomatic actions to consider.
349 </para>
350 </listitem>
351 <listitem>
352 <figure id="mainscreen-defend-stack-button-fig">
353 <screenshot>
354 <mediaobject>
355 <imageobject>
356 <imagedata fileref="figures/main_screen_defend_stack_button.png" format="PNG"/>
357 </imageobject>
358 </mediaobject>
359 </screenshot>
360 </figure>
361 <para>
362 Clicking this button causes the stack to go into defend mode.  This will put the stack into a tent for the next turn.
363 </para>
364 </listitem>
365 <listitem>
366 <figure id="mainscreen-stack-search-button-fig">
367 <screenshot>
368 <mediaobject>
369 <imageobject>
370 <imagedata fileref="figures/main_screen_stack_search_button.png" format="PNG"/>
371 </imageobject>
372 </mediaobject>
373 </screenshot>
374 </figure>
375 <para>
376 <para>
377 Clicking this button causes the stack to explore a ruin or temple.  
378 </para>
379 <para>
380 When exploring a temple, the stack needs to be on a tile that has a temple; and clicking this button will cause the stack to be blessed (all army units will receive a bonus of 1 strength point).
381 </para>
382 <para>
383 When exploring a ruin, the stack must contain a hero.  Exploring a ruin means the hero will fight a monster in the ruin, and if successful will be given a reward.  A hero's strength and the size of the accompanying stack that the hero attacks with are factors that determine success.
384 </para>
385 </para>
386 </listitem>
387 <listitem>
388 <figure id="mainscreen-move-all-stacks-button-fig">
389 <screenshot>
390 <mediaobject>
391 <imageobject>
392 <imagedata fileref="figures/main_screen_move_all_stacks_button.png" format="PNG"/>
393 </imageobject>
394 </mediaobject>
395 </screenshot>
396 </figure>
397 <para>
398 Clicking this button causes all stacks that have a path set, to travel along their paths.
399 </para>
400 </listitem>
401 <listitem>
402 <figure id="mainscreen-end-turn-button-fig">
403 <screenshot>
404 <mediaobject>
405 <imageobject>
406 <imagedata fileref="figures/main_screen_end_turn_button.png" format="PNG"/>
407 </imageobject>
408 </mediaobject>
409 </screenshot>
410 </figure>
411 <para>
412 Clicking this button causes the player to end her turn.  This means that the player is finished moving stacks for this turn.
413 </para>
414 </listitem>
415 <listitem>
416 <figure id="mainscreen-move-stack-dir-buttons-fig">
417 <screenshot>
418 <mediaobject>
419 <imageobject>
420 <imagedata fileref="figures/main_screen_move_stack_dir_buttons.png" format="PNG"/>
421 </imageobject>
422 </mediaobject>
423 </screenshot>
424 </figure>
425 <para>
426 Clicking these buttons causes the stack to move in the given direction.  These buttons are tied to the keypad; pressing keys on the keypad activates these buttons.  Often it is preferrable to move stacks by clicking on the map instead of using these movement buttons.
427 </para>
428 </listitem>
429 </itemizedlist>
430 </para>
431 <para>
432 Some statistics appear at the bottom of the screen when a stack is not selected.  The statistics look like this:
433 <figure id="mainscreen-stat-icons-fig">
434 <screenshot>
435 <mediaobject>
436 <imageobject>
437 <imagedata fileref="figures/main_screen_stat_icons.png" format="PNG"/>
438 </imageobject>
439 </mediaobject>
440 </screenshot>
441 </figure>
442 <itemizedlist>
443 <listitem>
444 Here is what these four values mean:
445 <para>
446 <figure id="mainscreen-stat-icon-cities-fig">
447 <screenshot>
448 <mediaobject>
449 <imageobject>
450 <imagedata fileref="figures/main_screen_stat_icon_cities.png" format="PNG"/>
451 </imageobject>
452 </mediaobject>
453 </screenshot>
454 </figure>
455 The number beside this icon is the total number of cities you own.
456 </para>
457 </listitem>
458 <listitem>
459 <para>
460 <figure id="mainscreen-stat-icon-treasury-fig">
461 <screenshot>
462 <mediaobject>
463 <imageobject>
464 <imagedata fileref="figures/main_screen_stat_icon_treasury.png" format="PNG"/>
465 </imageobject>
466 </mediaobject>
467 </screenshot>
468 </figure>
469 The number beside this icon is the number of gold pieces in your treasury.  You can use the gold pieces in your treasury to purchase a new army unit production capability in a city.
470 </para>
471 </listitem>
472 <listitem>
473 <para>
474 <figure id="mainscreen-stat-icon-income-fig">
475 <screenshot>
476 <mediaobject>
477 <imageobject>
478 <imagedata fileref="figures/main_screen_stat_icon_income.png" format="PNG"/>
479 </imageobject>
480 </mediaobject>
481 </screenshot>
482 </figure>
483 The number beside this icon is the number of gold pieces that your player makes every turn through city taxes (and perhaps a magical item that has a gold bonus).
484 </para>
485 </listitem>
486 <listitem>
487 <para>
488 <figure id="mainscreen-stat-icon-upkeep-fig">
489 <screenshot>
490 <mediaobject>
491 <imageobject>
492 <imagedata fileref="figures/main_screen_stat_icon_upkeep.png" format="PNG"/>
493 </imageobject>
494 </mediaobject>
495 </screenshot>
496 </figure>
497 The number beside this icon is the number of gold pieces that your player spends per turn on army unit maintenance (also called upkeep) costs.
498 </para>
499 </listitem>
500 </itemizedlist>
501 </para>
502 </sect2>
503 </sect1>
504
505 <!-- ============ Interacting with the Map ============= -->
506 <sect1 id="lordsawar-map-interaction"> 
507         <title>Interacting with the Map Display</title> 
508 <para>
509 Knowing how to interact with the map is essential in playing this game.  These interactions are all mouse driven, and involve:
510 <itemizedlist>
511 <listitem>
512 <para>Left-clicking:</para>
513 <para>
514 Pressing and releasing the leftmost button on the mouse or touchpad.
515 </para>
516 </listitem>
517 <listitem>
518 <para>Right-clicking:</para>
519 <para>
520 Pressing and releasing the rightmost button on the mouse or touchpad.
521 </para>
522 </listitem>
523 <listitem>
524 <para>Dragging:</para>
525 <para>
526 Pressing and holding down the leftmost button on the mouse or touchpad, while moving it.
527 </para>
528 </listitem>
529 </itemizedlist>
530 </para>
531 <sect2 id="lordsawar-moving-the-map">
532         <title>Changing the Map View</title> 
533 <para>
534 It is useful to browse the map and take note of the features on the map.  There are two ways to pan your view of the map:
535 <itemizedlist>
536 <listitem>
537 <para>
538 Through the Miniature Map:
539 </para>
540 <para>
541 Using the miniature map to browse the map is frequently used to quickly change the map to show one of your cities, or one of your enemy's cities.
542 </para>
543 <para>
544 Move the mouse onto the miniature map.  The mouse pointer will become a magnifying glass that looks like:
545 <figure id="mousecursormagnifyingglass-fig">
546 <screenshot>
547 <mediaobject>
548 <imageobject>
549 <imagedata fileref="figures/mousecursor_magnifying_glass.png" format="PNG"/>
550 </imageobject>
551 </mediaobject>
552 </screenshot>
553 </figure>
554 When you left-click on the miniature map, the zoomed-in portion of the map will change to the new view.  You can also drag the view on the miniature map.
555 </para>
556 </listitem>
557 <listitem>
558 <para>
559 Through the Main Map:
560 </para>
561 <para>
562 Panning the map in this way is useful when you're interested in things that are nearby.
563 </para>
564 <para>
565 When the pointer looks like a hand:
566 <figure id="mousecursorhand-fig">
567 <screenshot>
568 <mediaobject>
569 <imageobject>
570 <imagedata fileref="figures/mousecursor_hand.png" format="PNG"/>
571 </imageobject>
572 </mediaobject>
573 </screenshot>
574 </figure>
575 you can drag the map.  When you have a stack selected, you can hold down the Shift key on the keyabord to turn the mouse pointer back into a hand.
576 </para>
577 </listitem>
578 </itemizedlist>
579 </para>
580 </sect2>
581 <sect2 id="lordsawar-inspecting-objects-on-the-map">
582         <title>Inspecting objects on the map</title> 
583 <para>
584 Right-clicking and holding down the mouse button while hovering over a stack, city, ruin, temple, or signpost will show extra information about that object.  The game option "View Enemies" prevents the inspection of enemy stacks.
585 </para>
586 <para>
587 Querying these objects for information is useful in many contexts:
588 <itemizedlist>
589 <listitem>
590 <para>
591 When playing with a hidden map, inspecting signposts can be a big help in finding new cities.
592 </para>
593 </listitem>
594 <listitem>
595 <para>
596 It is also handy to quickly query a nearby ruin to see if it is unexplored.
597 </para>
598 </listitem>
599 <listitem>
600 <para>
601 When playing with the "View Enemies" game option turned on, it is essential to inspect your enemy's stacks so that you can better gauge the threat they pose.
602 </para>
603 </listitem>
604 </itemizedlist>
605 </para>
606 </sect2>
607 <sect2 id="lordsawar-commanding-objects-on-the-map">
608         <title>Commanding objects on the map</title> 
609 <para>
610 In order to work with either a stack or a city it must first be left-clicked.  
611 </para>
612 <sect3 id="lordsawar-commanding-stacks-on-the-map">
613         <title>Commanding stacks on the map</title> 
614 <para>
615 When hovering over a stack the mouse pointer will turn into a target symbol that looks like this:
616 <figure id="mousecursortarget-fig">
617 <screenshot>
618 <mediaobject>
619 <imageobject>
620 <imagedata fileref="figures/mousecursor_target.png" format="PNG"/>
621 </imageobject>
622 </mediaobject>
623 </screenshot>
624 </figure>
625 Left-clicking on the stack will make it become visibly selected, and the mouse pointer will change to a walk symbol when you are hovering over a place on the map that can be reached by the stack.  The walk symbol looks like this:
626 <figure id="mousecursorwalk-fig">
627 <screenshot>
628 <mediaobject>
629 <imageobject>
630 <imagedata fileref="figures/mousecursor_walk.png" format="PNG"/>
631 </imageobject>
632 </mediaobject>
633 </screenshot>
634 </figure>
635 When you are hovering over a reachable area of water the mouse pointer will change to a boat symbol that looks like this:
636 <figure id="mousecursorboat-fig">
637 <screenshot>
638 <mediaobject>
639 <imageobject>
640 <imagedata fileref="figures/mousecursor_boat.png" format="PNG"/>
641 </imageobject>
642 </mediaobject>
643 </screenshot>
644 </figure>
645 Left-clicking on the map with a mouse pointer that looks either like a boat or walking-feet will cause the selected stack to travel to that location (or use up all of it's movement points trying to get there.)
646 </para>
647 <para>
648 When you press and hold down the Ctrl key on the keyboard while you have a boat symbol or a walking-feet symbol as a mouse pointer, a different mouse pointer symbol will appear that looks like a diagonal arrow:
649 <figure id="mousecursorgoto-fig">
650 <screenshot>
651 <mediaobject>
652 <imageobject>
653 <imagedata fileref="figures/mousecursor_goto.png" format="PNG"/>
654 </imageobject>
655 </mediaobject>
656 </screenshot>
657 </figure>
658 When you left-click on the map with this diagonal arrow, the path that the selected stack would use to get to that location will be shown.  The stack will not immediately move along the path.  Smart players use this feature a lot because it shows them if a particular stack can reach a given location in a single turn.
659 </para>
660 </sect3>
661 <sect3 id="lordsawar-commanding-cities-on-the-map">
662         <title>Issuing orders to cities on the map</title> 
663 <para>
664 When hovering over a city the mouse pointer turns into a castle icon that looks like this:
665 <figure id="mousecursorrook-fig">
666 <screenshot>
667 <mediaobject>
668 <imageobject>
669 <imagedata fileref="figures/mousecursor_rook.png" format="PNG"/>
670 </imageobject>
671 </mediaobject>
672 </screenshot>
673 </figure>
674 Left-clicking on the city with this castle mouse pointer will bring up the city screen.  More information on the city screen appears in the next section of this manual.
675 </para>
676 <para>
677 When the "View Production" game option is turned on, this castle icon will also appear when you hover over enemy cities.  Left-clicking on the enemy city will allow you to inspect the production capabilities of that city.
678 </para>
679 <para>
680 Sometimes cities can get full and the mouse pointer doesn't turn into a castle icon because your stacks are in the way.  You can switch the target mouse pointer to a castle mouse pointer by pressing and holding the shift key on the keyboard.
681 </para>
682 </sect3>
683 </sect2>
684 </sect1>
685 <!-- ============= Cities ============================== -->
686 <sect1 id="lordsawar-cities"> 
687         <title>Cities</title> 
688 <para>
689 Cities are important because conquering cities is the key to winning the game.  Each player typically starts with one city, with the remainder of the cities being unowned.  Each city can produce army units that the player can use to attack other cities.  Each player has a capital city that other players can target and take over for bragging rights.
690 </para>
691 <sect2 id="lordsawar-cities-what-are-they">
692         <title>What are they?</title> 
693 <para>
694 Cities appear as castles on the map display; they occupy four tiles on the screen; a two-by-two square.  Cities appear as little shields on the miniature map.
695 </para>
696
697 <para>
698 Cities have a name, a defense level, and they provide a number of gold pieces to the player's treasury every turn.
699 </para>
700 <para>
701 The income is in the form of gold pieces, which happens to be exactly what army units require as their upkeep.  Conquering more cities gives the player more money and enables the upkeep of more army units.
702 </para>
703 <para>
704 The defense level for the city is related to the number of army units that the city can produce.  It has a maximum value of 3 and a minimum value of 0 (razed). Higher defense levels improve a city's chances in battle.
705 </para>
706 <para>
707 Each city can produce one of up to four different army unit types.  After enough turns have passed the army unit shows up in the city and can be moved around the map as the player sees fit.  Changing a city's production of army units is one of the main ways that a player affects the outcome of the game.  The player can also choose to add a new army unit type to the suite of army unit types that the city can produce; which can cost a lot of gold pieces.
708 </para>
709 <para>
710 Army unit production can be viewed and modified in cities that the player owns.  The production in enemy cities can also be viewed if the game is started with the "view production" option turned on.
711 </para>
712 <para>
713 Movement in a city that the player owns is the same as moving on a road; it is the easiest mode of transportation.  Cities that are adjacent to the water act as a port; a jumping-off point for naval operations.
714 </para>
715 <para>
716 Army units located in the city fight as a single force when the city is attacked by the enemy.  Some army units will have a special fighting bonus if they are defending a city, or attacking a city.  To attack a city, move your army units to an adjacent tile and then attempt to move into the city.
717 </para>
718
719 <para>
720 Army units may not move through a foreign city without conquering it first.
721 </para>
722
723 </sect2>
724 <sect2 id="lordsawar-explain-the-city-screen">
725         <title>Explanation of the City screen </title> 
726 <para>When the player left-clicks on a city the following screen is displayed:</para>
727 <figure id="citywindow-fig">
728 <screenshot>
729 <mediaobject>
730 <imageobject>
731 <imagedata fileref="figures/city_window.png" format="PNG"/>
732 </imageobject>
733 </mediaobject>
734 </screenshot>
735 </figure>
736
737 <para>
738 The most noticeable thing in the screen is the miniature map that only shows all of the player's cities.  At a glance it shows; which cities are producing an army unit (shown by a white shield with an anvil), which ones are not (shown by a white shield without an anvil), and which city the player is currently visiting (shown by a black shield, with or without an anvil).  The player can visit another city by left-clicking on it.
739 </para>
740 <para>
741 The screen contains information about the selected city.  The title of the screen is the name of the city.  To the right of the map the defense level is shown, along with the amount of money in gold pieces that this city provides.  Next is the army unit that is currently being produced, and how many more turns until it becomes available for use.  The set of buttons in the middle of the screen represent the set of army unit types that this city can produce.
742 Below that are statistics about the army unit currently being produced.
743 </para>
744 <para>
745 The army units can be right-clicked on to get extra information about them.
746 </para>
747
748 <para>
749 A number of buttons appear at the bottom of the screen.  Here is what they do:
750 <itemizedlist>
751 <listitem>
752 <para> Stop.</para>
753 <para>
754 Stops the production army units in this city.  Stopping production is a good idea if the player's total upkeep is higher than the total income.
755 </para>
756 </listitem>
757 <listitem>
758 <para>Buy.</para>
759 <para>
760 Make a new army unit available for production in this city.  Warning: clicking this button will replace the currently selected production unit.
761 <para>
762 Buying new army units is a good idea when the player needs an army unit with a particular capability and that capability does not exist in any of the other army units that the city already produces.
763 </para>
764 </para>
765 </listitem>
766 <listitem>
767 <para>Vector.</para>
768 <para>
769 Produce the unit in this city, but have it show up elsewhere on the map.
770 Vectoring is useful when the player's "front line" is far away from this city.  It can be used to quickly get new army units into far-away battles.
771 </para>
772 </listitem>
773 <listitem>
774 <para>Raze.</para>
775 <para>
776 Burn this city to the ground, and make it uninhabitable for the rest of the game.  This operation is only available if the razing policy in the game options is set to "always".
777 <para>
778 Razing an own city is useful to prevent it from falling into enemy hands.  It is a last-ditch effort because no player can own the city after it is razed.
779 </para>
780 </para>
781 </listitem>
782 <listitem>
783 <para>Rename.</para>
784 <para>
785 Change the name of this city.
786 <para>
787 Renaming a city can be a way of taunting another player.  e.g. The Impregnable Fortress of Wog.
788 </para>
789 </para>
790 </listitem>
791 </itemizedlist>
792 </para>
793 </sect2>
794 <sect2 id="lordsawar-cities-how-they-make-critters">
795         <title>Producing new Army units</title> 
796 <para>
797 Army units come to life in cities after they have been "produced".  Every army unit takes a number of turns to be produced; typically one to four turns.  The city can produce one army unit at a time, for up to four different army unit types; these are shown as pictures in the boxes on the right side of the city screen.
798 The button that appears to be pushed-in is the army unit type that is being produced in this city.  When there is one button pushed-in, that army unit type's picture appears, with the number of turns left until the army unit appears in the city.  If none of the army unit type buttons are pushed-in, then the city isn't producing an army unit at all.
799 </para>
800 <para>
801 To select a new army unit for production, left-click on it's button.  The button will become pushed-in, and any other army unit type button will become pushed-out.  This will cause production to stop on any prior army units in this city.  This means if the player has one turn left before some dragons are produced, and then the player selects Pikemen, the dragons will not show up next turn.  The player can right-click on each army unit type button to get more information about that army unit type's capabilities.
802 </para>
803 </sect2>
804 <sect2 id="lordsawar-taking-cities">
805         <title>Taking Cities</title> 
806 <para>
807 Conquering cities is important because it leads to the player winning the game.  After fighting the forces in an enemy city and winning, the player is presented with some options about how to take the city:
808 <figure id="conquercity-fig">
809 <screenshot>
810 <mediaobject>
811 <imageobject>
812 <imagedata fileref="figures/conquer_city.png" format="PNG"/>
813 </imageobject>
814 </mediaobject>
815 </screenshot>
816 </figure>
817 <para>
818 Here is what the various buttons at the bottom of the screen mean:
819 <itemizedlist>
820 <listitem>
821 <para> Occupy.</para>
822 <para>
823 Take the city and leave the production in the new city unchanged.
824 </para>
825 </listitem>
826 <listitem>
827 <para> Pillage.</para>
828 <para>
829 Take the city and cash in the weakest army unit type that the city can produce for gold pieces.  This will prevent that army unit from being produced in that city.
830 </para>
831 </listitem>
832 <listitem>
833 <para> Sack.</para>
834 <para>
835 Take the city and cash in all except weakest army unit type that the city can produce for gold pieces.  The army units that are cashed-in will not be available for production any longer.
836 <para>
837 If this button is not available, it is because the city has fewer than two army unit types available for production.
838 </para>
839 </para>
840 </listitem>
841 <listitem>
842 <para> Raze.</para>
843 <para>
844 Don't take the city; destroy it instead.  This will make the city uninhabitable by any other player.  Other players may not appreciate this course of action.
845 </para>
846 </listitem>
847 </itemizedlist>
848 </para>
849 </para>
850 <para>
851 The easiest cities to conquer are the ones that aren't defended at all.  The player can win the city with the weakest army unit.
852 </para>
853 <para>
854 Neutral cities are typically the next easiest to conquer; they are the unowned cities on the map.  Neutral army units never stray from their castle; they never come to the aid of another neutral city nearby.  Athough neutral cities can be active in that they produce army units after an attempt to attack the city fails (this is a game option that can be turned on).
855 </para>
856 </sect2>
857 <sect2 id="lordsawar-cities-buying-production">
858         <title>Buying new production capabilities</title> 
859 <para>
860 When none of the army unit types that the city can produce are desirable, the player can purchase a new army unit type for production within the city.
861 </para>
862 <para>
863 When the player clicks on the buy button in the city screen the following screen is shown:
864 <figure id="buyproduction-fig">
865 <screenshot>
866 <mediaobject>
867 <imageobject>
868 <imagedata fileref="figures/buy_production.png" format="PNG"/>
869 </imageobject>
870 </mediaobject>
871 </screenshot>
872 </figure>
873 A list of all army units that are available for the player to purchase are shown.  Some of these army units are too costly for the player to afford, so they are inactive and appear greyed-out.  Some of these army units will already be present within the city's production suite; and these army units are also inactive and greyed-out.  Left-clicking on the army unit type button will select it, and show the price at the bottom of the screen.  Right-clicking a button will display the capabilities of that army unit type.
874 </para>
875 <para>
876 After making a selection, click on the buy button to purchase the unit.  Take special care because purchasing a new unit will replace the currently selected army unit type in the city screen!
877 </para>
878 <para>
879 Some army units are not shown in this screen because they are not purchasable at any price.  Special units like dragons or ghosts cannot be purchased, and instead must be awarded to a Hero, or already present as production in a city.
880 </para>
881 </sect2>
882 </sect1>
883
884 <sect1 id="lordsawar-units"> 
885         <title>Army Units</title> 
886 <para>
887 Army units are used to attack cities and other army units.  It is an important distinction of the game that all army units are not made alike.  One city might make Giants that have a strength of 5, while another city might produce Giants with a strength of 6.  Inspecting the statistics of an army unit will state the abilities of that particular army unit.
888 </para>
889 <sect2 id="lordsawar-how-to-read-a-units-stats">
890         <title>How to read an Army Unit's stats</title> 
891 <para>
892 When the player right-clicks on an army unit in a stack, the following information is popped up:
893 <figure id="armyunitinfo-fig">
894 <screenshot>
895 <mediaobject>
896 <imageobject>
897 <imagedata fileref="figures/army_unit_info.png" format="PNG"/>
898 </imageobject>
899 </mediaobject>
900 </screenshot>
901 </figure>
902
903 <para>
904 Here we can see a unit of Giants.  It fights with a strength of 5 (more strength is better), and has 18 movement points left of a maximum of 18.  The Giants cost the player 10 gold pieces per turn.
905 </para>
906
907 <para>
908 Below the picture of the Giants, there is an image of mountains.  This means that this army unit moves more efficiently over hills.  Other terrain movement bonus pictures are: water, flight, forest, as well as forest/hills.
909 </para>
910
911 </para>
912 </sect2>
913 <sect2 id="lordsawar-units-what-kind-of-bonuses">
914         <title>Augmenting an Army Unit's stats</title> 
915 <para>
916 Army units can get medals for fighting with distinction in battle.  Each medal confers one point of strength to the wearer.
917 </para>
918 <para>
919 Army units also have a fighting bonus that only take effect during battle.  For example, a unit of Giants fight more effectively in hills.  There are many varieties of fighting bonuses and they are all covered in more detail elsewhere in this manual.
920 </para>
921 <para>
922 Army units can have a fortification bonus that is conferred after they are put into "defend" mode.  When the enemy sees a stack with the fortified bonus, it appears to be in a small tent or tower.  The fortification bonus is one point of strength per army unit during battle.  Fortification has the added feature of masking the true size of the stack in the field to the enemy (the stack's flag is not shown).
923 </para>
924 <para>
925 Army units can visit temples and get blessed.  The blessing confers a single point of strength upon the army unit.  An army unit can only be blessed once by a temple, but may visit many different temples for many blessings.
926 </para>
927 </sect2>
928 <sect2 id="lordsawar-cities-vectoring">
929         <title>Vectoring</title> 
930 <para>
931 Vectoring is a mechanism that invisibly transports new army units from one city to another city.  This is a great convenience for quickly moving newly created army units across large distances.  The cost for this convenience is time; the new army unit remains off the map for two whole turns.  At the end of these two turns, the new unit pops up at the destination.
932 </para>
933 <para>
934 Vectoring is limited to new units, and to cities that the player already owns.  This means that you can't vector army units that have already been created, which can sometimes be a great inconvenience.   Another limitation is that a maximum of 4 cities can be vectored to a single destination city.
935 </para>
936 <para>
937 It is also possible to vector new units to a Hero's planted standard.  The flag in the ground acts like a mobile city.
938 </para>
939 <para>
940 To initiate vectoring of new army units, go to the city screen for the city you want to vector from, and click on the "Vector..." button.  In the vectoring screen, click on the "Vector" button and then click on the destination city on the miniature map.
941 </para>
942 </sect2>
943 </sect1>
944 <!-- ============= Combat ============================== -->
945 <sect1 id="lordsawar-combat"> 
946         <title>Combat</title> 
947 <para>
948 Battles usually happen when attempting to capture a city, although it can also happen outside of a city "in the field" with one stack attacking another.
949 </para>
950 <sect2 id="lordsawar-entering-combat">
951         <title>Entering combat</title> 
952 <para>
953 The player initiates combat by moving a stack to a tile immediately adjacent to a foreign city or a stack, and then attemping to move the stack onto the foreign city or stack.  The cursor will change from a pair of walking feet, into a sword or into a heart if the diplomacy game option is turned on, and the foreign stack or city is a friend).  More information about diplomacy can be found elsewhere in this manual.
954 </para>
955 <para>
956 When attacking a city, the player needs to attack one of the four corners of the city; it doesn't make a difference if that corner contains an enemy stack or not.  All of the army units in the city will fight as a single force against the attacking stack.  When an army unit attacks another stack from a city, it only attacks with the other army units in it's stack, and not that of the entire city.
957 </para>
958 <para>
959 There is a military advisor that can help the player decide if a given combat should be entered into or not.  After the stack has moved adjacent to it's target, and the cursor icon is a sword (or a heart), press the shift key; the cursor will change to a question mark.  When the player left-clicks when the question mark is being shown, the military advisor will prognosticate on the outcome.  Beware that the military advisor doesn't see the future, and is offfering advice that the player can choose to accept or ignore.
960 The military advisor is a game option that has to be turned on when the game is created to be available in the game.
961 </para>
962 </sect2>
963 <sect2 id="lordsawar-combat-order-of-battle">
964         <title>Fighting Order</title> 
965 <para>
966 When combat is entered, all of the combatant army units line up for battle.  The two frontmost army units duel each other until one of them dies; the army unit that remains standing fights the next enemy army unit.  This continues until a player has no army units left to fight with.
967 </para>
968 <para>
969 The player has some control over how the army units line up for battle: it is called the fight order.  The fight order is controlled by the army unit type of the combatants; this is why scouts often fight prior to heroes.  The fight order can be seen by opening up the fight order dialog:
970 <figure id="fightorderdialog-fig">
971 <screenshot>
972 <mediaobject>
973 <imageobject>
974 <imagedata fileref="figures/fight_order.png" format="PNG"/>
975 </imageobject>
976 </mediaobject>
977 </screenshot>
978 </figure>
979 To change the order of a given army unit type, drag and drop it to another place in the list.  Imagine your opponent's surprise when you protect your fodder units by having your elephants fight first!
980 </para>
981 </sect2>
982 <sect2 id="lordsawar-combat-bonuses">
983         <title>Bonuses</title> 
984 <para>
985 Army units have other capabilities that are not shown when the player right-clicks on them.  One of these extra capabilities is the fighting bonus which can be seen in the Army Bonus dialog:
986 <figure id="armybonusdialog-fig">
987 <screenshot>
988 <mediaobject>
989 <imageobject>
990 <imagedata fileref="figures/army_bonus.png" format="PNG"/>
991 </imageobject>
992 </mediaobject>
993 </screenshot>
994 </figure>
995 Whereas the Pikemen that are produced in a city might have a strength of 5, the standard Pikemen army unit has a strength of 4.  More importantly it has a strength bonus when fighting in the open (on grass, not in hills, forest, etc.).  All Pikemen have this fighting bonus, and the bonus is not shown anywhere except in this army bonus dialog.
996
997 An army unit can have any of the following fighting bonuses:
998 <itemizedlist>
999 <listitem>
1000 <para>+1 str in open, +2 str in open</para>
1001 <para>
1002 The army unit is stronger when fighting while standing on grass.
1003 When the army unit is fighting on grass, it fights as an army unit that has one or two points more strength than it was produced with.
1004 </para>
1005 </listitem>
1006 <listitem>
1007 <para>+1 str in woods.</para>
1008 <para>
1009 The army unit is stronger when fighting while standing in a forest.
1010 When the army unit is fighting in the forest, it fights as an army unit that has one more point of strength than it was produced with.
1011 </para>
1012 </listitem>
1013 <listitem>
1014 <para>+1 str in hills.</para>
1015 The army unit is stronger when fighting while standing in hills.
1016 When the army unit is fighting in the hils, it fights as an army unit that has one more point of strength than it was produced with.
1017 <para>
1018 </para>
1019 </listitem>
1020 <listitem>
1021 <para>+1 str in city, +2 str in city.</para>
1022 The army unit is stronger when defending a city.
1023 When the army unit is fighting in a city, it fights as an army unit that has one or two more points of strength than it was produced with.
1024 <para>
1025 </para>
1026 </listitem>
1027 <listitem>
1028 <para>+1 stack in hills.</para>
1029 <para>
1030 All army units in the stack are stronger when fighting in the hills.
1031 When the army unit is fighting in the hills, all of the army units it is fighting with have one more point of strength than they were produced with.
1032 </para>
1033 </listitem>
1034 <listitem>
1035 <para>Cancel city bonus.</para>
1036 <para>
1037 The city bonus is related to the natural defensive abilities of the city.  When a city produces more kinds of units (e.g. up to 4 different kinds), the city bonus is higher for that city.  The city bonus can be entirely nullified by bringing into battle a single army unit that has this particular fighting ability.
1038 </para>
1039 </listitem>
1040 <listitem>
1041 <para>-1 enemy stack.</para>
1042 <para>
1043 This army unit nullifies one point of strength from each of the army units it is attacking.
1044 </para>
1045 </listitem>
1046 <listitem>
1047 <para>+1 stack, +2 stack.</para>
1048 <para>
1049 All army units in the stack are stronger when fighting.
1050 When the army unit is fighting, all of the army units it is fighting with have one more point of strength than they were produced with.
1051 </para>
1052 </listitem>
1053 <listitem>
1054 <para>cancel hero.</para>
1055 <para>
1056 This army unit nullifies any fighting bonuses an ememy Hero brings to the battle.
1057 </para>
1058 </listitem>
1059 <listitem>
1060 <para>cancel non-hero.</para>
1061 <para>
1062 This army unit nullifies any fighting bonuses an ememy army unit (except for a hero) brings to the battle.
1063 </para>
1064 </listitem>
1065 </itemizedlist>
1066 </para>
1067 </sect2>
1068 <sect2 id="lordsawar-combat-stacks">
1069         <title>Stacks</title> 
1070 <para>
1071 Stack composition is a key factor in winning the game.  There is no such thing as the perfect stack in &app;; only an ideal stack for a given task.  The wise player will make careful choices about which army units will be included in any given stack.
1072 </para>
1073 <para>
1074 Generally it is best to maximize the total number of strength points in the stack.  However if a stack of strong army units cannot move very far, the player might be more wise to construct a weaker stack that will reach the target in a more timely manner.
1075 </para>
1076 <para>
1077 It generally makes sense to have army units that have city fighting bonuses to reside in cities.  The trade-off here is that these armies are unsuited to traveling overland to attack remote cities; the player also needs to create units that are offensively suited.  The player can only afford so many army units at any given time.
1078 </para>
1079 </sect2>
1080 <sect2 id="lordsawar-combat-example-in-field">
1081         <title>Example of combat in the field</title> 
1082 <para>
1083 Here the yellow player wishes to attack the red player.  The yellow player has selected a stack that has one Orcish Mob unit.  The yellow player wishes to attack the enemy Light Infantry unit to the southeast.  Either the yellow player will succeed in destroying the red unit, or the yellow unit will die trying.
1084 <figure id="fight-one-on-one-fig">
1085 <screenshot>
1086 <mediaobject>
1087 <imageobject>
1088 <imagedata fileref="figures/fight_one_vs_one.png" format="PNG"/>
1089 </imageobject>
1090 </mediaobject>
1091 </screenshot>
1092 </figure>
1093 <para>
1094 The yellow player commits to the battle by left-clicking on the red army unit withe sword cursor.  The battle ensues:
1095 <figure id="fighting-one-on-one-fig">
1096 <screenshot>
1097 <mediaobject>
1098 <imageobject>
1099 <imagedata fileref="figures/fighting_one_vs_one.png" format="PNG"/>
1100 </imageobject>
1101 </mediaobject>
1102 </screenshot>
1103 </figure>
1104 Here is the fight screen.  The attacker is always depicted on the bottom of the fight window, while the defender is always shown on the top.  The shields of both players is shown, along with the army units fighting.  The progress bar indicates how many hitpoints each of the army units have left.  Every army unit has precisely two hitpoints, and strength is used as the main determinator if the aunit is hit or not.  In this battle the Orcish Mob is unscathed as it dispatches the single unit of Light Infantry.
1105 </para>
1106 <para>
1107 The battle finishes, and the yellow unit of Orcish Mob succeds in killing the unit of red's Light infantry.  The red player loses the unit of Light Infantry:
1108 <figure id="fought-one-on-one-fig">
1109 <screenshot>
1110 <mediaobject>
1111 <imageobject>
1112 <imagedata fileref="figures/fought_one_vs_one.png" format="PNG"/>
1113 </imageobject>
1114 </mediaobject>
1115 </screenshot>
1116 </figure>
1117 </para>
1118 </para>
1119 </sect2>
1120 <sect2 id="lordsawar-combat-example-in-city">
1121         <title>Example of combat in a city</title> 
1122 <para>
1123 Here the yellow player wishes to attack the red player.  The yellow player has selected a stack that has one Orcish Mob unit.  The yellow player wishes to attack the enemy city to the northwest.  Either the yellow player will succeed in capturing the red city, or the yellow unit will die trying.
1124 <figure id="fight-one-on-two-fig">
1125 <screenshot>
1126 <mediaobject>
1127 <imageobject>
1128 <imagedata fileref="figures/fight_city_one_vs_two.png" format="PNG"/>
1129 </imageobject>
1130 </mediaobject>
1131 </screenshot>
1132 </figure>
1133 <para>
1134 The yellow player commits to the battle by left-clicking on the red city with the sword cursor.  The battle ensues:
1135 <figure id="fighting-one-on-two-fig">
1136 <screenshot>
1137 <mediaobject>
1138 <imageobject>
1139 <imagedata fileref="figures/fighting_city_one_vs_two.png" format="PNG"/>
1140 </imageobject>
1141 </mediaobject>
1142 </screenshot>
1143 </figure>
1144 Here is the fight screen.  The Orcish mob has just dispatched a single enemy army unit, and has lost a single hitpoint in doing so.  The battle is now down to two units of Light Infantry, and a single injured unit of Orcish Mob.
1145 </para>
1146 <para>
1147 The battle finishes, and the yellow unit of Orcish Mob does not succeed in killing the remaining enemy units, an as a result the unit Orcish Mob dies.  The red player retains the city:
1148 <figure id="fought-one-on-two-fig">
1149 <screenshot>
1150 <mediaobject>
1151 <imageobject>
1152 <imagedata fileref="figures/fought_city_one_vs_two.png" format="PNG"/>
1153 </imageobject>
1154 </mediaobject>
1155 </screenshot>
1156 </figure>
1157 </para>
1158 </para>
1159 </sect2>
1160 </sect1>
1161 <!-- ============= Heroes ============================== -->
1162 <sect1 id="lordsawar-heroes"> 
1163         <title>Heroes</title> 
1164 <para>
1165 Heroes are special army units that can do fun and interesting things in &app;.  Every player starts out with a single hero that will carry that player's battle standard.  Subsequent heroes may emerge during the course of the game; their showing up will cost the player gold pieces, and they may have some allies who accompany them.  Typically new heroes will not offer their services to players who do not have many gold pieces in their treasury.
1166 </para>
1167 <sect2 id="lordsawar-heroes-why-they-rock">
1168         <title>Using Heroes to your advantage</title> 
1169 <para>
1170 Heroes have a natural command bonus that gives a strength bonus to all other army units fighting in the hero's stack.  The command bonus increases for more experienced heroes.  It is a good strategy to have other army units to travel with heroes.  The command bonus means that all army units in the stack fight with greater strength; the larger command the hero has, the more powerful the other army units in the stack will act in battle.
1171 </para>
1172 <para>
1173 Heroes can increase levels as experience is gained in battle.  When a new level is attained a hero can increase it's strength, it's movement points, or it's sight (when playing a scenario with fog of war).  Powerful heroes are hard to kill, and are often targeted by other players.
1174 </para>
1175 <para>
1176 Heroes can find and carry useful items.  Items can give the hero more strength in battle, or a larger command bonus; they can also give the player a gold bonus (per city), or double the movement of all army units in the hero's stack, or give the stack the gift of flight.  Heroes can drop items to give to other heroes.  A wise player will distribute powerful objects among heroes.
1177 </para>
1178 <para>
1179 Heroes can make special use of the player's battle standard; it can be planted in the ground and army units can be vectored to it from far-off cities.  This can only be done with the player's own standard, and not with a standard belonging to an opponent.  It is good strategy to retain ownership of the player's battle standard, so that it can be employed at a crucial stage of the game.
1180 </para>
1181 <para>Unlike other army units, heroes do not cost the player anything to keep per turn.</para>
1182 </sect2>
1183 <sect2 id="lordsawar-heroes-exploring ruins">
1184         <title>Exploring ruins</title> 
1185 <para>
1186 Ruins appear as white dots on the miniature map, and as a grey stone building occupying one tile on the large map screen.  Heroes can visit ruins and explore them; this is accomplished by moving the hero's stack onto the ruin, and clicking the search button (the magnifying glass).
1187 </para>
1188 <para>
1189 It is a dangerous thing for a hero to search a ruin!  The hero will likely encounter a monster, and the hero may or may not survive the battle.  Successfully exploring a ruin will yield a treasure to the hero.  The hero will sometimes be rewarded  with gold pieces, sometimes with a magical item, and sometimes with powerful ally army units.
1190 Once a ruin is explored, it cannot be explored again.
1191 </para>
1192 </sect2>
1193 <sect2 id="lordsawar-heroes-quests">
1194         <title>Going on Quests</title> 
1195 <para>
1196 Heroes can visit temples and obtain quests.  Temples appear as white dots on the miniature map, and as a brown shrine occupying one tile on the large map screen.  A temple is visited by moving the hero's stack onto the temple and then clicking the search button (the magnifying glass).
1197 </para>
1198 <para>
1199 A quest is a mission to complete a particular task in the game.  The hero is well rewarded for completing a quest.  Quests come in many varieties:
1200 <itemizedlist>
1201 <listitem>
1202 <para>Hero Assassination Quest</para>
1203 <para>
1204 The hero is tasked with dispatching another hero in the game.
1205 </para>
1206 </listitem>
1207 <listitem>
1208 <para>Kill Enemy Stacks Quest</para>
1209 <para>
1210 The hero is tasked with killing a specific number of a specific player's army units.
1211 </para>
1212 </listitem>
1213 <listitem>
1214 <para>City Occupation Quest</para>
1215 <para>
1216 The hero is tasked with capturing a particular city, and occupying it.
1217 </para>
1218 </listitem>
1219 <listitem>
1220 <para>City Sacking Quest</para>
1221 <para>
1222 The hero is tasked with capturing a particular city, and sacking it.
1223 </para>
1224 </listitem>
1225 <listitem>
1226 <para>City Razing Quest</para>
1227 <para>
1228 The hero is tasked with capturing a particular city, and razing it.
1229 </para>
1230 </listitem>
1231 <listitem>
1232 <para>Kill Army Unit Type Quest</para>
1233 <para>
1234 The hero is tasked with killing a particular kind of army unit -- e.g. a unit of Ghosts.  The army unit can belong to any player.
1235 </para>
1236 </listitem>
1237 <listitem>
1238 <para>Plunder Quest</para>
1239 <para>
1240 The hero is tasked with plundering a specific amount of gold pieces by pillaging and sacking cities.
1241 </para>
1242 </listitem>
1243 </itemizedlist>
1244 </para>
1245 <para>
1246 Upon completing a quest, the hero is rewarded with a large number of gold pieces, or a magical item, or some powerful allies.
1247 </para>
1248 <para>
1249 Some quests can expire, freeing the hero to obtain another quest.
1250 </para>
1251 <para>
1252 There is a game option that controls how often a hero can obtain a quest from a temple.  If the "one quest per player" policy is chosen, it means that the player can only have one hero on a quest at any given time.  Every player could potentially have a questing hero, except for the neutral player who doesn't have heroes.  The alternative questing policy is to allow one quest per hero.  This means that each player can have many heroes on quests simultaneously.
1253 </para>
1254 </sect2>
1255 </sect1>
1256 <sect1 id="lordsawar-movement"> 
1257         <title>Movement</title> 
1258 <para>
1259 Every army unit has a number of movement points that get replenished every turn.  These army units are arranged into stacks, and they move over various kinds of terrain on the map.  The army unit in the stack that has the lowest number of movement points governs how far the stack can move.  Army units can have terrain bonsues that help the stack move more effectively over a specific kind of terrain.
1260 </para>
1261 <sect2 id="lordsawar-movement-over-land">
1262         <title>Traveling over land</title> 
1263 <para>
1264 Stacks are usually moved over land, and movement can be more effective or less effective depending on the kind of terrain the stack is moving on.  The different kinds of terrain are:
1265 <itemizedlist>
1266 <listitem>roads,</listitem>
1267 <listitem>hills,</listitem>
1268 <listitem>swamp,</listitem>
1269 <listitem>forest,</listitem>
1270 <listitem>grass,</listitem>
1271 <listitem>water,</listitem>
1272 <listitem>and mountains.</listitem>
1273 </itemizedlist>
1274 </para>
1275 <para>
1276 Stacks that move on roads, or cities move with the greatest ease.  Grass is the next easiest terrain feature to move through.  Some stacks may have army units that provide a movement bonus that makes the whole stack move faster through forest, or hills.  Mountains are usually impassable, unless the stack can fly.  Swamps are always difficult to move through.
1277 </para>
1278 </sect2>
1279 <sect2 id="lordsawar-movement-over-water">
1280         <title>Traveling over water</title> 
1281 <para>
1282 Naval operations can be a crucial avenue to victory in the game.  To begin naval operations, simply move a stack into the water.  The stack's remaining movement points will be completely sapped with the effort of putting into the water.  During the next turn, the stack will have 18 movement points; this is how far a boat can move in &app;.  When the stack eventually moors back onto land, all of the remaining movement points will again be sapped with the effort.
1283 </para>
1284 <para>
1285 Stacks can get into and out of the water at different places on the map:
1286 <itemizedlist>
1287 <listitem>
1288 at a city that is adjacent to water,
1289 </listitem>
1290 <listitem>
1291 at a port (a black anchor on the map),
1292 </listitem>
1293 <listitem>
1294 and at a bridge.
1295 </listitem>
1296 </itemizedlist>
1297 </para>
1298 <para>
1299 Battle on the open seas is an encumbering experience for land-loving army units!  Those army units fight with similar effectiveness when on a boat.  Flying units will fight with their regular veracity, not being encumbered by the walls of a ship.
1300 </para>
1301 <para>
1302 When a hero dies on the water, the items belonging to that hero are lost to the sea forever.
1303 </para>
1304 </sect2>
1305 <sect2 id="lordsawar-resting-bonus">
1306         <title>Resting</title> 
1307 <para>
1308 There is a resting bonus that gives a stack more movement points if it didn't use all of it's movement points in the previous turn.  If a stack has 2 or more movement points at the end of the player's turn it receives 2 extra movement points next turn.  If a stack has 1 movement point at the end of the player's turn, it retains that point into the next turn.
1309 </para>
1310 </sect2>
1311 </sect1>
1312 <sect1 id="lordsawar-diplomacy"> 
1313         <title>Diplomacy</title> 
1314 <sect2 id="lordsawar-diplomacy-advantages">
1315         <title>Using Dimplomacy to your advantage</title> 
1316 </sect2>
1317 <sect2 id="lordsawar-diplomacy-explaining-the-report">
1318         <title>Explanation of the Diplomatic Report</title> 
1319 </sect2>
1320 </sect1>
1321 <sect1 id="lordsawar-options"> 
1322         <title>Options</title> 
1323 <sect2 id="lordsawar-scenario-options">
1324         <title>Scenario options</title> 
1325 <para>
1326 Here are the options that are settable at the start of a game:
1327 <figure id="gameoptions-fig">
1328 <screenshot>
1329 <mediaobject>
1330 <imageobject>
1331 <imagedata fileref="figures/game_options.png" format="PNG"/>
1332 </imageobject>
1333 </mediaobject>
1334 </screenshot>
1335 </figure>
1336 <itemizedlist>
1337 <listitem>
1338 <para>View Enemies</para>
1339 <para>
1340 When this option is turned on, the player can right-click on enemy stacks in the large map screen and see their contents.
1341 </para>
1342 </listitem>
1343 <listitem>
1344 <para>View Production</para>
1345 <para>
1346 When this option is turned on, the player can right-click on enemy cities in the large map screen and see their production.
1347 </para>
1348 </listitem>
1349 <listitem>
1350 <para>Quests</para>
1351 <para>
1352 This option controls how often heroes can visit temples to obtain quests.  This option can have one of the following values:
1353 <itemizedlist>
1354 <listitem>
1355 <para>No Questing</para>
1356 <para>
1357 No heroes can obtain quests at temples.
1358 </para>
1359 </listitem>
1360 <listitem>
1361 <para>One Quest Per Player</para>
1362 <para>
1363 Only one hero can obtain a quest from a temple.  If one hero has a quest, another hero belonging to the same player cannot obtain a quest.
1364 </para>
1365 </listitem>
1366 <listitem>
1367 <para>One Quest Per Hero</para>
1368 <para>
1369 Each hero that the player owns can obtain a quest from a temple.  A single hero cannot have two or more quests.
1370 </para>
1371 </listitem>
1372 </itemizedlist>
1373 </para>
1374 </listitem>
1375 <listitem>
1376 <para>Hidden Map</para>
1377 <para>
1378 When this option is turned on, the map is turned black and the player's stacks must explore the map to uncover it.  This option is also known as fog of war.
1379 </para>
1380 </listitem>
1381 <listitem>
1382 <para>Diplomacy</para>
1383 <para>
1384 When this option is turned on, the player is not automatically at war with all other players; instead some of them are allies and cannot be attacked without diplomatic consequences.
1385 </para>
1386 </listitem>
1387 <listitem>
1388 <para>Neutral Cities</para>
1389 <para>
1390 This option controls the behaviour of neutral cities.  This option can be one of three values:
1391 <itemizedlist>
1392 <listitem>
1393 <para>Average</para>
1394 <para>
1395 Neutral cities are manned by the weakest army unit they can produce.
1396 </para>
1397 </listitem>
1398 <listitem>
1399 <para>Strong</para>
1400 <para>
1401 Neutral cities are manned by the strongest army unit they can produce.
1402 </para>
1403 </listitem>
1404 <listitem>
1405 <para>Active</para>
1406 <para>
1407 Neutral cities start to produce army units after they resist an attacked by a player.
1408 </para>
1409 </listitem>
1410 </itemizedlist>
1411 </para>
1412 </listitem>
1413 <listitem>
1414 <para>Cusp Of War</para>
1415 <para>
1416 For this option to be available, the diplomacy option must first be turned on.
1417 When this option is turned on, all computer players will declare war on human players at an early stage within the game.
1418 </para>
1419 </listitem>
1420 <listitem>
1421 <para>Razing Cities</para>
1422 <para>
1423 This option governs when the player may raze cities.  It can have one of three values:
1424 <itemizedlist>
1425 <listitem>
1426 <para>Always Allowed</para>
1427 <para>
1428 The player can always raze cities.
1429 </para>
1430 </listitem>
1431 <listitem>
1432 <para>On Capture</para>
1433 <para>
1434 The player may only raze cities when it is conquered in battle.
1435 </para>
1436 </listitem>
1437 <listitem>
1438 <para>Never</para>
1439 <para>
1440 The player may never raze cities (not even in the city screen).
1441 </para>
1442 </listitem>
1443 </itemizedlist>
1444 </para>
1445 </listitem>
1446 <listitem>
1447 <para>Intense Combat</para>
1448 <para>
1449 Use a slightly different calculation for battles that makes gaps in strength less evident.
1450 </para>
1451 </listitem>
1452 <listitem>
1453 <para>Quick Start</para>
1454 <para>
1455 This option gives players some cities to start off with so that the early stages of the game can be skipped.  Quick Start has two modes:
1456 <itemizedlist>
1457 <listitem>
1458 <para>Evenly Divided</para>
1459 <para>
1460 Each player gets the same number of cities.  No neutral cities remain.
1461 </para>
1462 </listitem>
1463 <listitem>
1464 <para>Enemy Head Start</para>
1465 <para>
1466 Each computer player gets a few extra cities.  The number of extra cities depends on the total number of cities.  Human players keep a single city.
1467 </para>
1468 </listitem>
1469 </itemizedlist>
1470 </para>
1471 </listitem>
1472 <listitem>
1473 <para>Military Advisor</para>
1474 <para>
1475 Make the military advisor available.  This means the player can get advice on a battle by pressing the Shift key and left-clicking on an adjacent target.
1476 </para>
1477 </listitem>
1478 <listitem>
1479 <para>Random Turns</para>
1480 <para>
1481 Change the order that the players get to take their turn.  This option changes the order every round of the game.
1482 </para>
1483 </listitem>
1484 </itemizedlist>
1485 </para>
1486 </sect2>
1487 </sect1>
1488 <sect1 id="lordsawar-keyboard-commands"> 
1489         <title>Keyboard Commands</title> 
1490 <para>
1491 Here is a list of all of the keyboard shortcuts in &app;.  Please note that L means lowercase L, while Shift+L means uppercase L.
1492 </para>
1493 <itemizedlist>
1494 <listitem>
1495 <para>Alt+L</para>
1496 <para>
1497 Load a game.
1498 </para>
1499 </listitem>
1500 <listitem>
1501 <para>Alt+S</para>
1502 <para>
1503 Save game.
1504 </para>
1505 </listitem>
1506 <listitem>
1507 <para>Ctrl+L</para>
1508 <para>
1509 Show the game lobby (networked play).
1510 </para>
1511 </listitem>
1512 <listitem>
1513 <para>I (the letter eye)</para>
1514 <para>
1515 Open the fight-order dialog.
1516 </para>
1517 </listitem>
1518 <listitem>
1519 <para>M</para>
1520 <para>
1521 Move all stacks that have a path set.
1522 </para>
1523 </listitem>
1524 <listitem>
1525 <para>X</para>
1526 <para>
1527 Change the contents of the sign the stack is standing on.
1528 </para>
1529 </listitem>
1530 <listitem>
1531 <para>Q</para>
1532 <para>
1533 Disband the selected stack.
1534 </para>
1535 </listitem>
1536 <listitem>
1537 <para>Escape</para>
1538 <para>
1539 Deselect the selected stack and don't come back to it.
1540 </para>
1541 </listitem>
1542 <listitem>
1543 <para>Enter</para>
1544 <para>
1545 Select the next stack in the list.
1546 </para>
1547 </listitem>
1548 <listitem>
1549 <para>R</para>
1550 <para>
1551 Resign from the game.
1552 </para>
1553 </listitem>
1554 <listitem>
1555 <para>A</para>
1556 <para>
1557 Show the Army Report.
1558 </para>
1559 </listitem>
1560 <listitem>
1561 <para>K</para>
1562 <para>
1563 Show the City Report.
1564 </para>
1565 </listitem>
1566 <listitem>
1567 <para>G</para>
1568 <para>
1569 Show the Gold Report.
1570 </para>
1571 </listitem>
1572 <listitem>
1573 <para>N</para>
1574 <para>
1575 Show the Production Report.
1576 </para>
1577 </listitem>
1578 <listitem>
1579 <para>W</para>
1580 <para>
1581 Show the Winning Report.
1582 </para>
1583 </listitem>
1584 <listitem>
1585 <para>D</para>
1586 <para>
1587 Show the Diplomacy Report.
1588 </para>
1589 </listitem>
1590 <listitem>
1591 <para>=</para>
1592 <para>
1593 Show the active quest.
1594 </para>
1595 </listitem>
1596 <listitem>
1597 <para>, (comma)</para>
1598 <para>
1599 Have the selected hero pick-up or drop items at this location.
1600 </para>
1601 </listitem>
1602 <listitem>
1603 <para>F</para>
1604 <para>
1605 Have the selected hero plant the player's standard at this location.
1606 </para>
1607 </listitem>
1608 <listitem>
1609 <para>U</para>
1610 <para>
1611 Show the hero levels dialog.
1612 </para>
1613 </listitem>
1614 <listitem>
1615 <para>Z</para>
1616 <para>
1617 Have the hero search this location.
1618 </para>
1619 </listitem>
1620 <listitem>
1621 <para>F11</para>
1622 <para>
1623 Toggle fullscreen mode.
1624 </para>
1625 </listitem>
1626 <listitem>
1627 <para>Ctrl+P</para>
1628 <para>
1629 Show the game preferences dialog.
1630 </para>
1631 </listitem>
1632 <listitem>
1633 <para>. (period)</para>
1634 <para>
1635 Show the ruin status dialog.
1636 </para>
1637 </listitem>
1638 <listitem>
1639 <para>O (the letter oh)</para>
1640 <para>
1641 Show the list of army unit types and their bonuses.
1642 </para>
1643 </listitem>
1644 <listitem>
1645 <para>T</para>
1646 <para>
1647 Show the list of items and their bonuses.
1648 </para>
1649 </listitem>
1650 <listitem>
1651 <para>S</para>
1652 <para>
1653 Show the bonuses of army units in the selected stack.
1654 </para>
1655 </listitem>
1656 <listitem>
1657 <para>H</para>
1658 <para>
1659 Show the historical report for cities.
1660 </para>
1661 </listitem>
1662 <listitem>
1663 <para>E</para>
1664 <para>
1665 Show the historical events report.
1666 </para>
1667 </listitem>
1668 <listitem>
1669 <para>J</para>
1670 <para>
1671 Show the historical gold report.
1672 </para>
1673 </listitem>
1674 <listitem>
1675 <para>Y</para>
1676 <para>
1677 Show the historical winning report.
1678 </para>
1679 </listitem>
1680 <listitem>
1681 <para>T</para>
1682 <para>
1683 Show some statistics regarding the player's battle record.
1684 </para>
1685 </listitem>
1686 <listitem>
1687 <para>Alt+E</para>
1688 <para>
1689 End the turn.
1690 </para>
1691 </listitem>
1692 <listitem>
1693 <para>Shift+G</para>
1694 <para>
1695 Toggle a grid on the map.
1696 </para>
1697 </listitem>
1698 <listitem>
1699 <para>C</para>
1700 <para>
1701 Show the city production window.
1702 </para>
1703 </listitem>
1704 <listitem>
1705 <para>B</para>
1706 <para>
1707 Show the city production window.
1708 </para>
1709 </listitem>
1710 <listitem>
1711 <para>P</para>
1712 <para>
1713 Show the city production window.
1714 </para>
1715 </listitem>
1716 <listitem>
1717 <para>V</para>
1718 <para>
1719 Show the city vectoring window.
1720 </para>
1721 </listitem>
1722 <listitem>
1723 <para>keypad keys</para>
1724 <para>
1725 The number keys on the keypad will move the selected stack in the given direction.
1726 </para>
1727 </listitem>
1728 </itemizedlist>
1729 </sect1>
1730 <sect1 id="lordsawar-multiplayer"> 
1731         <title>Multi-player play</title> 
1732 <sect2 id="lordsawar-hot-seat">
1733         <title>Hot-seat Play</title> 
1734 <para>
1735 Playing a game in hostseat mode is the traditional way to play &app;.  The idea here is that there are two or more human players, and when it's their turn they are said to be in the "hot-seat"; they get to move their stacks.  The other players are usually not allowed to watch the player in the hot-seat make their moves, although it certainly can be fun to do so.  When the player is finished the turn, the "end-turn" button is pressed and the next player is notified that it is now their turn.
1736 </para>
1737 <para>
1738 A hotseat game begins with all players agreeing on the scenario options, and then conducting their turns in order until there's a winner.
1739 </para>
1740 <para>
1741 Playing a hotseat game is advantageous when all players are near the same computer.  
1742 </para>
1743 </sect2>
1744 <sect2 id="lordsawar-pbm-play">
1745         <title>Playing By Email</title> 
1746 <para>
1747 Playing a game by email is advantageous when players aren't near the same computer and they take a long time to finish a turn.
1748 </para>
1749 <para>
1750 It works by assigning one person as the "game-master", who players receive their games from via email.  When a player receives a &app; game from the game-master, it means it is their turn to move.  The player saves the game out of their email program, and then loads the game using the "Load Game" button in the main menu of &app;.  The player then conducts their turn in the normal fashion by moving stacks around the map.  When the "end turn" button is pressed, the player is asked to save a "turn-file".  The turn-file is saved, and then the player is expected to attach this file to an email and send it to the game master.  The player then waits to receive another game from the game-master.
1751 </para>
1752 <para>
1753 The game-master uses the "lordsawar-pbm" program to process turn-files from players.  The program takes two filenames on the command-line:
1754 <para>
1755 <itemizedlist>
1756 <listitem>
1757 The turn-file that was received from the play who has finished their move.
1758 </listitem>
1759 <listitem>
1760 The saved-game file that was sent to the player who has finished their move.
1761 </listitem>
1762 </itemizedlist>
1763 </para>
1764 After the program is executed, the saved-game file is now ready for the next player.  The game-master mails the saved-game file to the next player.
1765 </para>
1766 <para>
1767 The game-master notifies all of the players when the game is over, and when a human player is vanquished.
1768 </para>
1769 <para>
1770 One of the disadvantages of playing a game by mail is that players can't watch other players as they move.
1771 </para>
1772 </sect2>
1773 <sect2 id="lordsawar-network-play">
1774         <title>Network Play</title> 
1775 <para>
1776 Network play allows players to enjoy a game of &app; over the internet.  Players who play in a network game can watch their opponents move their stacks around the map, and can even chat with their opponents as they do so. 
1777 </para>
1778 <para>
1779 Network play works by having one player start a new game that other players will connect to.  The player who starts the game is said to be on the server.  Before the game starts, the map, number of players and game options are chosen by the player who serving the game.  If the server stops running &app;, or her connection to the internet is temporarily severed, the game will cease to function.  The other players can connect to the server by specifying it's IP address.  These other players are said to be clients of the server.
1780 <para>
1781 Common networking problems can arise when clients try to connect to servers.  Often a particular port on a firewall needs to be opened so that communication can be established.  For &app; the port that needs to be opened is 14998.
1782 </para>
1783 </para>
1784 <para>
1785 Players of a network game can join and leave at any time, but beware that the game stops for everyone if a player is absent and it is their turn to move.
1786 </para>
1787 <para>
1788 After the game server is running, the lobby screen is shown.  Clients also see this screen when they connect to the game server.  Here is what the lobby looks like:
1789 <figure id="gamelobby-fig">
1790 <screenshot>
1791 <mediaobject>
1792 <imageobject>
1793 <imagedata fileref="figures/game_lobby.png" format="PNG"/>
1794 </imageobject>
1795 </mediaobject>
1796 </screenshot>
1797 </figure>
1798 </para>
1799 <para>
1800 The lobby screen has three main portions: the chat window, the seats, and the map.  The figure shows two people (ben and benny) playing a five-sided game with a map that has 80 cities.  Benny is responsible for playing for one human player, while Ben is responsible for playing all other players, one of which is human and the rest are computer players.  It is currently benny's turn to move The Sirians.
1801 <para>
1802 As clients connect to the server, they appear in the People list of the chat window.  To send a message to all other players, type in a message into the box next to "Send:" and press the Enter key.  As clients leave, their name gets removed from the People list.
1803 </para>
1804 <para>
1805 To play the game, players need to "sit down" at a seat.  This is accomplished by clicking the "Seated" checkbox beside the shield of the player the person wants to play as.  After this happens the player may choose to change their name.  This is accomplished by clicking on "The Sirians" (for example), and typing in a new name and pressing the Enter key.
1806 </para>
1807 <para>
1808 The map portion of the game lobby is there to familiarize the players with the map that this scenario is using.  Players can use this information to choose which seat they will sit down in.  Perhaps there is value in starting in a city that is farther away from human opponents.  The map is not shown when the scenario is using a hidden map.
1809 </para>
1810 <para>
1811 Players can choose to leave this lobby window can stay open for the duration of the game for chatting purposes, or to monitor the availability of opponents.  Other clients who are only observing the game will keep this window open to watch the progress of the game as it unfolds.  Observers will watch the map change, and see the turn indicator cycle through the players, and they can chat with the players about what they see happening in the game.
1812 </para>
1813 </para>
1814 </sect2>
1815 </sect1>
1816 </article>