This is the documentation file for trek2 uploaded to CIX on July 5th 1989
-------------------------------------------------------------------------

Documentation written (first draft!) FJL 05 Jul 89. Email uab1018@dircon.UUCP


The idea of the game is to use the starship "Enterprise" to zap a number of 
Klingon starships which are attacking the galaxy. You have to complete this 
task before a certain date or they (the Klingons) will win.

The galaxy consists of an 8 by 8 grid of quadrants which in turn are divided 
into an 8 by 8 grid of sectors. Each sector can be occupied by a star, a 
Klingon, a Starbase, the Enterprise or nothing.

The enterprise is equipped with long and short range scanners. The long range 
scan gives information about adjacent quadrants in the form:

002 | 003 | 014
202 | 005 | 102
002 | 004 | 007

The figure in the center represents the current quadrant, and the others are 
the quadrants surrounding it. Each figure consists of three digits. The first 
is the number of Klingons in the quadrant, the second is the number of 
starbases and the third is the number of stars.

A short range scan looks something like this:

------------------------------------------------       *                                          
STARDATE           3004
          *        *                              CONDITION          *RED*
                                 >!<              QUADRANT           3,4
      <*>                                         SECTOR             4,2
                     +K+    *                     PHOTON TORPEDOES   5
            +K+                                   TOTAL ENERGY       1476
                  *                               SHIELDS            1000
                                  *               KLINGONS REMAINING 9
------------------------------------------------

The information down the right shows your general status.

The screen to the left is the short range scan. It shows your current 
quadrant. Objects shewn on it are:

*   - a star.                   <*> - the enterprise.
+K+ - a Klingon warship.        >!< - a starbase

The game is controlled by you issuing commands. These are as follows:

NAV - Navigate.

      This is how you move the enterprise around the galaxy.

      You will be asked a direction and warp factor.
      the direction is entered as a number               4  3  2
      on a circular vector arrangement (for               \ | /
      want of a better phrase. Intermediate             5 - * - 1
      values are allowed (e.g. 1.5 is half                / | \
      way between 1 and 2. Values may                    6  8  7
      approach 9, which is the same as 1.                      
                                                         COURSE
  
     A warp factor of one moves the enterprise by one quadrant. A warp factor 
     of two moves it by two quadrants, and 0.5 moves it by half a quadrant (or 
     8 sectors).

SRS - Short range scan.

      Performs a short range scan.

LRS - Performs a long range scan. Logical.

PHA - Phasors.

     Zap any Klingons in the quadrant with energy. You enter the amount of 
     energy you wish to use up in this exercise. If you don't use enough to 
     deplete the Klingon's shield he will survive and fire back!

TOR - Photon Torpedo.

     Enter the direction (1..9 again) to fire a torpedo and see if you can bag 
     a Klingon! If you hit one it will be destroyed. If you miss, the Klingon 
     will be offended and start firing at you.

SHE - Shield control.

     This assigns energy to the Enterprises shields. This energy is depleted 
     by the Klingons firing at it. When it's all gone the Enterprise won't 
     last long. Energy used in the shields cannot be used for phasors or 
     navigation so you have to make a choice!

DAM - Damage control.

     The Enterprise can be shot at and damaged or bits can just fall apart 
     (like Z88 keyboards?). When something is damaged you can't use it until 
     it's repaired (Logical again). The DAM command shows the status of 
     several key components of the Enterprise. If the status of something is 
     less than zero then it is out of action.

COM - Use the ship's computer. This is full of goodies which will be
      explained if you type <RETURN> when asked for a computer command.


Notes:

Starbases

You start the game with 3000 units of energy, 10 photon torpedo and an 
Enterprise in full working order. The starbases contain lots of energy and 
torpedoes, and have people who can fix the enterprise if you bend it. In order 
to re-fuel/re-arm/re-pair you must dock with a starbase. To do this you simply 
move to an adjacent sector.

Navigation

You cannot navigate the Enterprise through a star, starbase or klingon (not in 
this physical model anyway!). You are also not allowed to stray out of the 
galaxy. If you are about to collide with something the warp engines will shut 
down automatically.


                                       