From 6585c244c063c47b92b7ea9a20afbf9027bd0c81 Mon Sep 17 00:00:00 2001 From: "Eric S. Raymond" Date: Fri, 23 Aug 2013 11:00:50 -0400 Subject: [PATCH] Make the documentation masters easier to read. --- vms-empire.xml | 209 ++++++++++++++++++++++++++++++------------------- 1 file changed, 128 insertions(+), 81 deletions(-) diff --git a/vms-empire.xml b/vms-empire.xml index 72c0e40..2698db3 100644 --- a/vms-empire.xml +++ b/vms-empire.xml @@ -102,25 +102,28 @@ which are fairly useless. INTRODUCTION -Empire is a war game played between you and the user. The world + +Empire is a war game played between you and the computer. The world on which the game takes place is a square rectangle containing cities, land, and water. Cities are used to build armies, planes, and ships which can move across the world destroying enemy pieces, exploring, and capturing more cities. The objective of the game is to destroy all the enemy pieces, and capture all the cities. + The world is a rectangle 60 by 100 squares on a side. The world -consists of sea (.), land (+), uncontrolled -cities (*), computer-controlled cities (X), and cities that you -control (O). -The world is displayed on the player's screen during -movement. (On terminals with small screens, only a portion of -the world is shown at any one time.) -Each piece is represented by a unique -character on the map. With a few exceptions, you can -only have one piece on a given location. On the map, you -are shown only the 8 squares adjacent to your units. -This information is updated before and during each of your moves. -The map displays the most recent information known. +consists of sea (.), land (+), uncontrolled cities (*), +computer-controlled cities (X), and cities that you control +(O). + +The world is displayed on the player's screen during movement. +(On terminals with small screens, only a portion of the world is shown +at any one time.) Each piece is represented by a unique character on +the map. With a few exceptions, you can only have one piece on a +given location. On the map, you are shown only the 8 squares adjacent +to your units. This information is updated before and during each of +your moves. The map displays the most recent information +known. + The game starts by assigning you one city and the computer one city. Cities can produce new pieces. Every city that you own produces more pieces for you according @@ -129,6 +132,7 @@ game is to issue the Automove command until you decide to do something special. During movement in each round, the player is prompted to move each piece that does not otherwise have an assigned function. + Map coordinates are 4-digit numbers. The first two digits are the row, the second two digits are the column. @@ -243,80 +247,96 @@ column. The second column shows the map representation for your units. + The third shows the representations of enemy units. + Moves is the number of squares that the unit can move in a single round. + Hits is the amount of damage a unit can take before it is destroyed. + Strength is the amount of damage a unit can inflict upon an enemy during each round of an attack. + Cost is the number of rounds needed for a city to produce the piece. + The number in parenthesis is the cost for a city to produce the first unit. + Each piece has certain advantages associated with it that can make it useful. One of the primary strategic aspects of this game is deciding which pieces will be produced and in what quantities. -Armies can only move on land, and are the only piece that can -move on land. Only armies can capture cities. -This means that you must produce armies in order to win the -game. Armies have a 50% chance of capturing a city when they -attack. (Attacking one's own city results in the army's -destruction. Armies that move onto the sea will drown. -Armies can attack objects at sea, but even if they win, they -will drown.) Armies can be carried by troop transports. -If an army is moved onto a troop transport, then whenever -the transport is moved, the army will be moved with the + +Armies can only move on land, and +are the only piece that can move on land. Only armies can capture +cities. This means that you must produce armies in order to win the +game. Armies have a 50% chance of capturing a city when they attack. +(Attacking one's own city results in the army's destruction. Armies +that move onto the sea will drown. Armies can attack objects at sea, +but even if they win, they will drown.) Armies can be carried by +troop transports. If an army is moved onto a troop transport, then +whenever the transport is moved, the army will be moved with the transport. You cannot attack any piece at sea while on a transport. -Fighters move over both land and sea, and they move 8 squares -per round. Their high speed and great mobility make fighters -ideal for exploring. However, fighters must periodically land -at user-owned cities for refueling. A fighter can travel 32 -squares without refeuling. Fighters are also shot down if they -attempt to fly over a city which is not owned by the user. -Patrol boats are fast but lightly armored. Therefore -they are useful for patrolling ocean waters and exploring. -In an attack against a stronger boat, however, patrol boats -will suffer heavy casulties. -Destroyers are fairly heavily armored and reasonably quick -to produce. Thus they are useful for destroying enemy transports -which may be trying to spread the enemy across the face of the -world. -When a submarine scores a hit, 3 hits are exacted instead of 1. -Thus submarines can inflict heavy damage in a fight against -heavily armored boats. Notice that healthy submarines will -typically defeat healthy destroyers two-thirds of the time. -However, a submarine will defeat a fighter about two-thirds -of the time, while a destroyer will defeat a fighter three-fourths -of the time. -Troop transports are the only pieces that can carry armies. -A maximum of six armies can be carried by a transport. -On any world containing a reasonable amount of water, -transports will be a critical resource in winning the game. -Notice that the weakness of transports implies they need -protection from stronger ships. -Aircraft carriers are the only ships that can -carry fighters. Carriers carry a maximum of the number -of hits left of fighters. Fighters are refueled when they -land on a carrier. -Battleships are similar to destroyers except that they are -much stronger. + +Fighters move over both land and +sea, and they move 8 squares per round. Their high speed and great +mobility make fighters ideal for exploring. However, fighters must +periodically land at user-owned cities for refueling. A fighter can +travel 32 squares without refeuling. Fighters are also shot down if +they attempt to fly over a city which is not owned by the user. + +Patrol boats are fast but lightly +armored. Therefore they are useful for patrolling ocean waters and +exploring. In an attack against a stronger boat, however, patrol +boats will suffer heavy casulties. + +Destroyers are fairly heavily +armored and reasonably quick to produce. Thus they are useful for +destroying enemy transports which may be trying to spread the enemy +across the face of the world. + +When a submarine scores a hit, 3 +hits are exacted instead of 1. Thus submarines can inflict heavy +damage in a fight against heavily armored boats. Notice that healthy +submarines will typically defeat healthy destroyers two-thirds of the +time. However, a submarine will defeat a fighter about two-thirds of +the time, while a destroyer will defeat a fighter three-fourths of the +time. + +Troop transports are the only +pieces that can carry armies. A maximum of six armies can be carried +by a transport. On any world containing a reasonable amount of water, +transports will be a critical resource in winning the game. Notice +that the weakness of transports implies they need protection from +stronger ships. + +Aircraft carriers are the only +ships that can carry fighters. Carriers carry a maximum of the number +of hits left of fighters. Fighters are refueled when they land on a +carrier. + +Battleships are similar to +destroyers except that they are much stronger. Satellites are only useful for reconaissance. They can not be attacked. They are launched in a random diagonal orbit, and stay up for 50 turns. They can see one square farther than other objects. -All ships can move only on sea. Ships can also dock in a + +All ships can move only on the sea. Ships can also dock in a user-owned city. Docked ships have damage repaired at the rate of 1 hit per turn. Ships which have suffered a lot of damage will move more slowly. -Because of their ability -to be repaired, ships with lots of hits such as Carriers and -Battleships have an additional advantage. -After suffering minor damage while destroying enemy shipping, -these ships can sail back to port and be quickly repaired before -the enemy has time to replenish her destroyed shipping. + +Because of their ability to be repaired, ships with lots of hits +such as Carriers and Battleships have an additional advantage. After +suffering minor damage while destroying enemy shipping, these ships +can sail back to port and be quickly repaired before the enemy has +time to replenish her destroyed shipping. + The following table gives the probability that the piece listed on the side will defeat the piece listed at the top in a battle. (The table assumes that both pieces are undamaged.) @@ -391,6 +411,7 @@ of damage. MOVEMENT FUNCTIONS + There are a variety of movement functions. The movement functions of pieces can be specified in user mode and edit mode. Cities can have movement functions set for each type of piece. @@ -399,9 +420,11 @@ then every time that type of piece appears in the city, the piece will acquire that movement function. Be forewarned that moving loaded transports or loaded carriers into a city can have undesirable side effects. + Normally, when a movement function has been specified, the piece will continue moving according to that function until one of the following happen: + An enemy piece or unowned city appears next to the piece. In this case @@ -468,9 +491,9 @@ armies respectively. Grope -This function causes a piece to explore. The piece heads toward the nearest -unseen square of the map on each of its moves. Some attempt is made to -explore in an optimal fashion. +This function causes a piece to explore. The piece heads toward +the nearest unseen square of the map on each of its moves. Some +attempt is made to explore in an optimal fashion. @@ -526,37 +549,45 @@ non-intuitive. + As examples of how to use these movement functions, typically when I have a new city on a continent, I set the Army function of the -city to attack. Whenever an army is produced, it merrily goes off -on its way exploring the continent and moving towards unowned cities -or enemy armies or cities. +city to attack. Whenever an army is +produced, it merrily goes off on its way exploring the continent and +moving towards unowned cities or enemy armies or cities. + I frequently set the ship functions for cities that are far from the front to automatically move ships towards the front. -When I have armies on a continent, but there is nothing to explore -or attack, I move the army to the shore and use the transport -function to have that army hop aboard the first passing transport. + +When I have armies on a continent, but there is nothing to +explore or attack, I move the army to the shore and use the transport function to have that army hop aboard +the first passing transport. COMMANDS + There are three command modes. The first of these is "command mode". In this mode, you give commands that affect the game as a whole. In the second mode, "move mode", you give commands to move your pieces. The third mode is "edit mode", and in this mode you can edit the functions of your pieces and examine various portions of the map. -All commands are one character long. The full mnemonic names are -listed below as a memorization aid. -The mnemonics are somewhat contrived because there are so few -characters in the English language. Too bad this program isn't -written in Japanese, neh? + +All commands are one character long. The full mnemonic names +are listed below as a memorization aid. The mnemonics are somewhat +contrived because there are so few characters in the English language. +Too bad this program isn't written in Japanese, neh? + In all command modes, typing "H" will print out a screen of help information, and typing <ctrl-L> will redraw the screen. COMMAND MODE + In command mode, the computer will prompt you for your orders. The following commands can be given at this time: + Automove @@ -683,10 +714,12 @@ displayed, ships are preferred to fighters and armies. MOVE MODE + In move mode, the cursor will appear on the screen at the position of each piece that needs to be moved. You can then give commands to move the piece. Directions to move are specified by the following keys: + QWE @@ -694,11 +727,15 @@ following keys: ZXC -The arrow and keypad keys on your terminal, if any, should also work. + +The arrow and keypad keys on your terminal, if any, should also +work. + These keys move in the direction of the key from S. The characters are not echoed and only 1 character is accepted, so there is no need for a <Return>. Hit the <Space> bar if you want the piece to stay put. + Other commands are: @@ -808,24 +845,29 @@ displayed. + Attacking something is accomplished by moving onto the square of the unit you wish to attack. Hits are traded off at 50% probability of a hit landing on one or the other units until one unit is totally destroyed. There is only 1 possible winner. -You are "allowed" to do fatal things like attack your -own cities or other pieces. If you try to make a fatal -move, the computer will warn you and give you a chance to + +You are "allowed" to do fatal +things like attack your own cities or other pieces. If you try to +make a fatal move, the computer will warn you and give you a chance to change your mind. + You cannot move onto the edge of the world. EDIT MODE + In edit mode, you can move around the world and examine pieces or assign them new functions. To move the cursor around, use the standard direction keys. Other commands are: + Build @@ -937,8 +979,10 @@ in the city are displayed. + Note that you cannot directly affect anything inside a city with the editor. + HINTS @@ -971,6 +1015,7 @@ ideas you can try that may make the game more interesting. HISTORY + According to A Brief History of Empire , the ancestral game was written by @@ -1017,7 +1062,9 @@ a "movie". BUGS + No doubt numerous. + Satellites are not completely implemented. You should be able to move to a square that contains a satellite, but the program won't let you. Enemy satellites should not cause your pieces to awaken. -- 2.43.0