85e56f83bd32c7e03d14aba1ae9334971b3313b2
[super-star-trek.git] / sst-doc.xml
1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE book PUBLIC 
3     "-//OASIS//DTD DocBook XML V4.1.2//EN" 
4     "docbook/docbookxx.dtd"[
5 <!ENTITY sst-site      "http://sst.berlios.de/">
6 <!ENTITY retro         "http://catb.org/~esr/retro/">
7 ]>
8 <book>
9 <bookinfo>
10 <title>Super Star Trek</title>
11
12 <authorgroup>
13 <author>
14   <firstname>David</firstname>
15   <surname>Matuzsek</surname>
16 </author>
17 <author>
18   <firstname>Paul</firstname>
19   <surname>Reynolds</surname>
20 </author>
21 <author>
22   <firstname>Tom</firstname>
23   <surname>Almy</surname>
24 </author>
25 <author>
26   <firstname>Stas</firstname>
27   <surname>Sergeev</surname>
28 </author>
29 <author>
30   <firstname>Eric</firstname>
31   <othername>Steven</othername>
32   <surname>Raymond</surname>
33 </author>
34 </authorgroup>
35
36 <legalnotice>
37 <para>Permission is hereby granted for the copying, distribution,
38 modification and use of this program and associated documentation
39 for recreational purposes, provided that all references to the
40 authors are retained.  However, permission is not and will not be
41 granted for the sale or promotional use of this program or program
42 documentation, or for use in any situation in which profit may be
43 considered an objective, since it is the desire of the authors to
44 respect the copyrights of the originators of Star Trek.</para>
45 </legalnotice>
46 </bookinfo>
47
48
49 <dedication>
50 <literallayout format='linespecific' class='monospaced'>
51                 SSSSS   U   U   PPPPP   EEEEE   RRRRR
52                 S       U   U   P   P   E       R   R
53                 SSSSS   U   U   PPPPP   EEEE    RRRRR
54                     S   U   U   P       E       R  R
55                 SSSSS   UUUUU   P       EEEEE   R   R
56
57
58                  SSSSSSS  TTTTTTTT     A     RRRRRRR
59                 SSSSSSSS  TTTTTTTT    AAA    RRRRRRRR
60                SS            TT       AAA    RR     RR
61                SSSSSSS       TT      AA AA   RR     RR
62                 SSSSSSS      TT      AA AA   RRRRRRRR
63                       SS     TT     AAAAAAA  RRRRRRR
64                       SS     TT     AAAAAAA  RR   RR
65                SSSSSSSS      TT    AA     AA RR    RR
66                SSSSSSS       TT    AA     AA RR     RR
67     
68     
69     
70                 TTTTTTTT RRRRRRR   EEEEEEEEE KK     KK
71                 TTTTTTTT RRRRRRRR  EEEEEEEEE KK    KK
72                    TT    RR     RR EE        KK   KK
73                    TT    RR     RR EEEEEE    KKKKKK
74                    TT    RRRRRRRR  EEEEEE    KKKKK
75                    TT    RRRRRRR   EE        KK  KK
76                    TT    RR   RR   EE        KK   KK
77                    TT    RR    RR  EEEEEEEEE KK    KK
78                    TT    RR     RR EEEEEEEEE KK     KK
79
80
81                      Produced For Your Enjoyment
82
83                                  By
84
85                             David Matuszek
86                                  and
87                             Paul Reynolds
88
89                         With Modifications By
90                               Don Smith
91
92                             Resurrected By
93                                Tom Almy
94
95                           Curses Interface By
96                               Stas Sergeev 
97
98                 SST 2K polishing and historical research by
99                              Eric S. Raymond
100 </literallayout>
101 </dedication>
102
103 <chapter><title>Introduction</title>
104 <para>The Organian Peace Treaty has collapsed, and the Federation is at war
105 with the Klingon Empire.  Joining the Klingons against the Federation
106 are the members of the <quote>Romulan Star Empire.</quote>  As commander of the
107 Starship U.S.S. Enterprise, your job is to wipe out the Klingon
108 invasion fleet and make the galaxy safe for democracy.</para>
109
110 <para>Your battleground is the entire galaxy, which for convenience is
111 divided up into eight rows of eight quadrants each, like a
112 checkerboard.  Rows are numbered from top to bottom, and columns are
113 numbered left to right, so quadrant 1 - 8 would be in the upper right
114 hand corner of the galaxy.</para>
115
116 <para>During battle you will be concerned only with those enemies that
117 occupy the same quadrant as yourself.  Quadrants are divided up into
118 sectors: ten rows of ten sectors each. Sectors are numbered in the
119 same way as quadrants, so the sector in the upper right corner is
120 sector 1 - 10.  You have a short-range scanner which allows you to
121 look at the entire quadrant in a single display.</para>
122
123 <para>Enemies recharge during your absence.  If you leave a quadrant
124 containing a weakened enemy, when you return to that quadrant he will
125 be strong again.  Also, each time you enter a quadrant, the positions
126 of everthing in the quadrant (except your ship) are randomized, to
127 save you the trouble of trying to remember where everything in the
128 quadrant is.  Notice that this refers only to the positions of things
129 in the quadrant&mdash;the numbers of each kind of thing are not changed
130 (except for black holes and the Super-commander, which move around
131 the galaxy).  If you kill something, it stays dead.</para>
132
133 <para>The Romulans are not as serious a threat to the Federation as the
134 Klingons.  For one thing, there are not as many of them.  For
135 another, the Romulans are not as treacherous.  However, Romulans are
136 not to be trifled with, especially when you are in violation of the
137 Romulan Neutral Zone.</para>
138
139 <para>There are two kinds of Klingons: Ordinary Klingons, which are
140 bad enough, and Klingon Commanders, which are even worse.  Commanders
141 are about three times stronger than ordinary Klingons.  Commanders are
142 more resistant to your weapons.  Commanders can move about during
143 battle while Ordinary Klingons stay put.  And finally, Commanders have
144 a thing called a <quote>long-range tractor beam</quote> which they can
145 use, at random intervals, to yank you away from what you are doing
146 into their quadrant, to do battle with them.  There is also a special
147 commander, called the <quote>Super-commander.</quote> This character
148 is so bad he is reserved for the Good, Expert, and Emeritus games.
149 Fortunately, there is just one Super-commander in a game.  In addition
150 to the undesirable traits of Commanders, he can move from quadrant to
151 quadrant at will, seeking out and destroying your starbases and any
152 helpful planets he runs across.  He also has a spy planted aboard your
153 ship, giving him valuable information about your condition.  Using
154 this information, he can do dastardly things like tractor beam your
155 ship when you are in bad shape.  And once you've been tractor beamed
156 by the Super-commander &mdash;</para>
157
158 <para>But the advantages are not all on the side of the enemy.  Your ship
159 is more powerful, and has better weapons.  Besides, in the this
160 galaxy there are from two to five starbases, at which you can stop to
161 refuel and lick your wounds, safe from phaser attack or tractor
162 beams.  But you had best not dally there too long, since time is not
163 on your side.  The Klingons are not just after you; they are
164 attacking the entire Federation.  There is always a finite <quote>time
165 left,</quote> which is how much longer the Federation can hold out if you
166 just sit on your fat behind and do nothing.  As you wipe out
167 Klingons, you reduce the rate at which the invasion fleet weakens the
168 Federation, and so the time left until the Federation collapses may
169 actually increase.  Since Klingons are the main threat to the
170 Federation, the Romulans do not figure into the <quote>time left.</quote>  In
171 fact, you need not kill all the Romulans to win.  If you can get all
172 the Klingons, the Federation will abide forever, and you have won the
173 game.</para>
174
175 <para>Space is vast, and it takes precious time to move from one place to
176 another.  In comparison, other things happen so quickly that we
177 assume they take no time at all. Two ways that time can pass are when
178 you move, or when you issue a command to sit still and rest for a
179 period of time.  You will sometimes want to do the latter, since the
180 various devices aboard your starship may be damaged and require time
181 to repair.  Of course, repairs can be made more quickly at a starbase
182 than than can in flight.</para>
183
184 <para>In addition to Klingons, Romulans, and starbases, the galaxy
185 contains (surprise) stars.  Mostly, stars are a nuisance and just get
186 in your way.  You can trigger a star into going nova by shooting one
187 of your photon torpedoes at it.  When a star novas, it does a lot of
188 dammage to anything immediately adjacent to it.  If another star is
189 adjacent to a nova, it too will go nova.  Stars may also occasionally
190 go supernova; a supernova in a quadrant destroys everything in the
191 quadrant andmakes the quadrant permanently uninhabitable.  You may
192 <quote>jump over</quote> a quadrant containing a supernova when you
193 move, but you should not stop there.</para>
194
195 <para>Supernovas may happen spontaneously, without provocation.  If a
196 supernova occurs in the same quadrant you are in, your starship has an
197 <quote>emergency automatic override</quote> which picks some random
198 direction and some random warp factor, and tries to throw you clear of
199 the supernova. If the supernova occurs in some other quadrant, you
200 just get a warning message from starfleet about it (provided, of
201 course, that your subspace radio is working).</para>
202
203 <para>Also a few planets are scattered through the galaxy.  These can
204 sometimes be a great help since some of them will have <quote>dilithium
205 crystals,</quote> which are capable of replenishing the ship's energy
206 supply.  You can either beam down to the planet surface using the
207 transporter, or take the shuttle craft <quote>Galileo</quote>.</para>
208
209 <para>Finally, each quadrant will contain from zero to three black
210 holes.  These can deflect or swallow torpedoes passing near them. They
211 also swallow enemy ships knocked into them.  If your ship enters one
212 &mdash;</para>
213
214 <para>Star Trek is a rich game, full of detail.  These instructions are
215 written at a moderate level&mdash;no attempt has been made fully to
216 describe everything about the game, but there is quite a bit more
217 here than you need to get started.  If you are new to the game, just
218 get a rough idea of the kinds of commands available, and start
219 playing.  After a game or two you will have learned everthing
220 important, and the detailed command descriptions which follow will be
221 a lot more meaningful to you.</para>
222
223 <para>You have weapons: phasers and photon torpedoes. You have a defense:
224 deflector shields.  You can look at things: long-range scaners,
225 short-range scanners, and a star chart.  You can move about, under
226 warp drive or impulse power.  You can also dock at a starbase, rest
227 while repairs are being made, abandon ship, self destruct, or give up
228 and start a new game.</para>
229
230 <para>The Klingons are waiting.</para>
231
232 </chapter>
233 <chapter><title>Starting the Game</title>
234
235 <para>The program will ask you some setup questions.  You can give it 
236 command-line arguments that will be treated as answers.  Any token
237 may be abbreviated to a unique prefix.</para>
238
239 <para>The first question concerns whether you want a regullar,
240 tournament, or saved game.  For discussion, see the <link
241 linkend="freeze">description of the freeze command</link>.</para>
242
243 <para>The second question will concern the length of the game.  
244 Longer games include more enemies.</para>
245
246 <para>The third question will set the game's difficulty level.
247 You should probably start out at the novice level, even if you are
248 already familiar with one of the other versions of the Star Trek
249 game&mdash;but, of course, the level of game you play is up to you.  If
250 you want to start at the Expert level, go ahead.  It's your funeral.
251 The Emeritus game is strictly for masochists.</para>
252
253 <para>The fourth question, new in SST2K, sets your game options.  A
254 blank answer enables all SST2K features.  The option 'plain' disables
255 a number of features (Tholians, planets &amp; dilithium, Thingies
256 shooting back, deep-space-probes, Klingon ramming and movement,
257 time-warping through black holes), approximating the original CDC 6600
258 FORTRAN game from UT Austin.  The option 'almy' approximates Tom
259 Almy's C translation from 1979, disabling Thingies shooting back and
260 time-warping through black holes.</para>
261
262 </chapter>
263 <chapter><title>How To Issue Commands</title>
264
265 <para>When the game is waiting for you to enter a command it will
266 print out</para>
267
268 <screen>
269         COMMAND>
270 </screen>
271
272 <para>You may then type in your command.  All you have to remember for each
273 command is the mnemonic. For example, if you want to move straight up
274 one quadrant, you can type in the mnemonic (case insensitive)</para>
275
276 <screen>
277         move
278 </screen>
279
280 <para>and the computer will prompt you with</para>
281
282 <screen>
283         Manual or automatic- 
284 </screen>
285
286 <para>Say you type in <quote>manual</quote>. The computer then responds</para>
287
288 <screen>
289         X and Y displacements- 
290 </screen>
291
292 <para>Now you type in <quote>0 1</quote> which specifies an X movement of zero and a Y
293 movement of one.</para>
294
295 <para>When you have learned the commands, you can avoid being prompted
296 simply by typing in the information without waiting to be asked for
297 it. For example, in the above example, you could simply type in</para>
298
299 <screen>
300         move manual 0 1
301 </screen>
302
303 <para>and it will be done.  Or you could type in</para>
304
305 <screen>
306         move manual
307 </screen>
308
309 <para>and when the computer responds with the displacement prompt, you
310 can type in</para>
311
312 <screen>
313         0 1
314 </screen>
315
316 <para>and it will understand.</para>
317
318 <para>You can abbreviate most mnemonics.  For <quote>move</quote>, you can use any
319 of</para>
320
321 <screen>
322         move mov mo m
323 </screen>
324
325 <para>successfully.  For your safety, certain critical commands (such as to
326 abandon ship) must be written out in full.  Also, in a few cases two
327 or more commands begin with the same letter, and in this case that
328 letter refers to a particular one of the commands; to get the other,
329 your abbreviation must be two or more characters long.  This sounds
330 complicated, but you will learn the abbreviations qGuickly enough.</para>
331
332 <para>What this all boils down to is:</para>
333
334 <orderedlist>
335 <listitem><para>You can abbreviate practically anything</para></listitem>
336 <listitem><para>If you forget, the computer will prompt you</para></listitem>
337 <listitem><para>If you remember, you can type it all on one line</para></listitem>
338 </orderedlist>
339
340 <para>If you are part way through entering a command and you change your
341 minde, you can cancel the command by typing -1 as one of the
342 parameters, with the exception of the manual move command.</para>
343
344 <para>If anything is not clear to you, experiment.  The worst you can do is
345 lose a game or two.</para>
346
347 </chapter>
348 <chapter><title>List of Commands</title>
349
350 <sect1><title>Short-Range Scan</title>
351
352 <literallayout>
353 Mnemonic:  SRSCAN
354 Shortest abbreviation:  S
355 Full commands:  SRSCAN
356                 SRSCAN NO
357                 SRSCAN CHART
358 </literallayout>
359
360 <!-- This is new in SST 2K -->
361 <para>If you are using the screen-oriented interface, this command is
362 suppressed; instead, a short-range scan will always be present on the
363 screen.</para>
364
365 <para>The short-range scan gives you a considerable amount of information
366 about the quadrant your starship is in.  A short-range scan is best
367 described by an example.</para>
368
369 <screen>
370          1 2 3 4 5 6 7 8 9 10
371       1  * . . . . R . . . .  Stardate      2516.3
372       2  . . . E . . . . . .  Condition     RED  
373       3  . . . . . * . B . .  Position      5 - 1, 2 - 4
374       4  . . . S . . . . . .  Life Support  DAMAGED, Reserves=2.30
375       5  . . . . . . . K . .  Warp Factor   5.0
376       6  . K .   . . . . * .  Energy        2176.24
377       7  . . . . . P . . . .  Torpedoes     3
378       8  . . . . * . . . . .  Shields       UP, 42% 1050.0 units
379       9  . * . . * . . . C .  Klingons Left 12
380      10  . . . . . . . . . .  Time Left     3.72
381 </screen>
382
383 <para>The left part is a picture of the quadrant.  The E at sector 2 -
384 4 represents the Enterprise; the B at sector 3 - 8 is a starbase.
385 There are ordinary Klingons (K) at sectors 5 - 8 and 6 - 2, and a
386 Klingon Commander (C) at 9 - 9.  The (GULP)
387 <quote>Super-commander</quote> (S) is occupies sector 4 - 4, and a
388 Romulan (R) is at 1 - 6.  A planet (P) is at sector 7 - 6.  There are
389 also a large number of stars (*). The periods (.) are just empty
390 space&mdash;they are printed to help you get your bearings.  Sector 6
391 - 4 contains a black hole ( ).</para>
392
393 <para>The information on the right is assorted status information. You
394 can get this alone with the STATUS command.  The status information
395 will be absent if you type <quote>N</quote> after SRSCAN.  Otherwise
396 status information will be presented.</para>
397
398 <para>If you type <quote>C</quote> after SRSCAN, you will be given a
399 short-range scan and a Star Chart.</para>
400
401 <para>Short-range scans are free.  That is, they use up no energy and no
402 time.  If you are in battle, doing a short-range scan does not give
403 the enemies another chance to hit you.  You can safely do a
404 short-range scan anytime you like.</para>
405
406 <para>If your short-range sensors are damaged, this command will only show
407 the contents of adjacent sectors.</para>
408 </sect1>
409 <sect1><title>Status Report</title>
410
411 <literallayout>
412 Mnemonic:  STATUS
413 Shortest abbreviation: ST
414 </literallayout>
415
416 <!-- This is new in SST 2K --> 
417 <para>If you are using the screen-oriented interface, this command is
418 suppressed; instead, a full status report will always be present on the
419 screen.</para>
420
421 <para>This command gives you information about the current state of your
422 starship as follows:</para>
423
424 <variablelist>
425 <varlistentry>
426 <term>STARDATE</term>
427 <listitem>
428 <para>The current date. A stardate is the same as a day.</para>
429 </listitem>
430 </varlistentry>
431 <varlistentry>
432 <term>CONDITION</term>
433 <listitem>
434 <para>There are four possible conditions:</para>
435     <variablelist>
436     <varlistentry>
437     <term>DOCKED</term>
438     <listitem><para>docked at starbase.</para></listitem>
439     </varlistentry>
440     <varlistentry>
441     <term>RED</term>
442     <listitem><para>in battle.</para></listitem>
443     </varlistentry>
444     <varlistentry>
445     <term>YELLOW</term>
446     <listitem><para>low on energy (&lt;1000 units)</para></listitem>
447     </varlistentry>
448     <varlistentry>
449     <term>GREEN</term>
450     <listitem><para>none of the above</para></listitem>
451     </varlistentry>
452     </variablelist>
453 </listitem>
454 </varlistentry>
455 <varlistentry>
456 <term>POSITION</term>
457 <listitem>
458 <para>Quadrant is given first, then sector</para>
459 </listitem>
460 </varlistentry>
461 <varlistentry>
462 <term>LIFE SUPPOR</term>
463 <listitem>
464 <para>If <quote>ACTIVE</quote> then life support systems are functioning
465 normally. If on <quote>RESERVES</quote> the number is how many stardates your
466 reserve food, air, etc. will last&mdash;you must get repairs made or get to
467 starbase before your reserves run out.</para>
468 </listitem>
469 </varlistentry>
470 <varlistentry>
471 <term>WARP FACTOR</term>
472 <listitem>
473 <para>What your warp factor is currently set to.</para>
474 </listitem>
475 </varlistentry>
476 <varlistentry>
477 <term>ENERGY</term>
478 <listitem>
479 <para>The amount of energy you have left. If it drops to zero, you die.</para>
480 </listitem>
481 </varlistentry>
482 <varlistentry>
483 <term>TORPEDOES</term>
484 <listitem>
485 <para>How many photon torpedoes you have left.</para>
486 </listitem>
487 </varlistentry>
488 <varlistentry>
489 <term>SHIELDS</term>
490 <listitem>
491 <para>Whether your shields are up or down, how strong they are
492 (what percentage of a hit they can deflect), and shield energy.</para> 
493 </listitem>
494 </varlistentry>
495 <varlistentry>
496 <term>KLINGONS LEFT</term>
497 <listitem>
498 <para>How many of the Klingons are still out there.</para>
499 </listitem>
500 </varlistentry>
501 <varlistentry>
502 <term>TIME LEFT</term>
503 <listitem>
504 <para>How long the Federation can hold out against the
505 present number of Klingons; that is, how long until the end
506 if you do nothing in the meantime.  If you kill Klingons
507 quickly, this number will go up&mdash;if not, it will go down.  If
508 it reaches zero, the federation is conquered and you lose.</para>
509 </listitem>
510 </varlistentry>
511 </variablelist>
512
513 <para>Status information is free&mdash;it uses no time or energy, and
514 if you are in battle, the Klingons are not given another chance to hit
515 you.</para>
516
517 <para>Status information can also be obtained by doing a short-range scan.
518 See the SRSCAN command for details.</para>
519
520 <para>Each item of information can be obtained singly by requesting it.
521 See REQUEST command for details.</para>
522
523 </sect1>
524 <sect1><title>Long-Range Scan</title>
525
526 <literallayout>
527 Mnemonic:  LRSCAN
528 Shortest abbreviation:  L
529 </literallayout>
530
531 <!-- This is new in SST 2K --> 
532 <para>If you are using the screen-oriented interface, this command is
533 suppressed; instead, a long-range scan will always be present on the
534 screen.</para>
535
536 <para>A long-range scan gives you general information about where you are
537 and what is around you.  Here is an example output.</para>
538
539 <screen>
540     Long-range scan for Quadrant 5 - 1
541        -1  107  103
542        -1  316    5
543        -1  105 1000
544 </screen>
545
546 <para>This scan says that you are in row 5, column 1 of the 8 by 8 galaxy.
547 The numbers in the scan indicate how many of each kind of thing there
548 is in your quadrant and all adjacent quadrants.  The digits are
549 interpreted as follows.</para>
550
551 <informaltable>
552 <tgroup cols='2'>
553 <tbody>
554 <row>
555   <entry>Thousands digit:</entry>
556   <entry>1000 indicates a supernova (only)</entry>
557 </row>
558 <row>
559   <entry>Hundreds digit:</entry>
560   <entry>number of Klingons present</entry>
561 </row>
562 <row>
563   <entry>Tens digit:</entry>
564   <entry>number of starbases present</entry>
565 </row>
566 <row>
567   <entry>Ones digit:</entry>
568   <entry>number of stars present</entry>
569 </row>
570 </tbody>
571 </tgroup>
572 </informaltable>
573
574 <para>For example, in your quadrant (5 - 1) the number is 316, which
575 indicates 3 Klingons, 1 starbase, and 6 stars.  The long-range
576 scanner does not distinguish between ordinary Klingons and Klingon
577 command ships.  If there is a supernova, as in the quadrant below and
578 to your right (quadrant 6 - 2), there is nothing else in the
579 quadrant. </para>
580
581 <para>Romulans possess a <quote>cloaking device</quote> which prevents
582 their detection by long-range scan.  Because of this fact, Starfleet
583 Command is never sure how many Romulans are <quote>out there</quote>.
584 When you kill the last Klingon, the remaining Romulans surrender to
585 the Federation.</para>
586
587 <para>Planets are also undetectable by long-range scan.  The only way to
588 detect a planet is to find it in your current quadrant with the
589 short-range sensors.</para>
590
591 <para>Since you are in column 1, there are no quadrants to your left. The
592 minus ones indicate the negative energy barrier at the edge of the
593 galaxy, which you are not permitted to cross.</para>
594
595 <para>Long-range scans are free.  They use up no energy or time, and can be
596 done safely regardless of battle conditions.</para>
597 </sect1>
598 <sect1><title>Star Chart</title>
599
600 <literallayout>
601 Mnemonic:  CHART
602 Shortest abbreviation:  C
603 </literallayout>
604
605 <para>As you proceed in the game, you learn more and more about what things
606 are where in the galaxy. When ever you first do a scan in a quadrant,
607 telemetry sensors are ejected which will report any changes in the
608 quadrant(s) back to your ship, providing the sub-space radio is
609 working. Spock will enter this information in the chart. If the radio
610 is not working, Spock can only enter new information discovered from
611 scans, and information in other quadrants may be obsolete.</para>
612
613 <para>The chart looks like an 8 by 8 array of numbers.  These numbers are
614 interpreted exactly as they are on a long-range scan. A period (.) in
615 place of a digit means you do not know that information yet.  For
616 example, ... means you know nothing about the quadrant, while .1.
617 menas you know it contains a base, but an unknown number of Klingons
618 and stars.</para>
619
620 <para>Looking at the star chart is a free operation.  It costs neither time
621 nor energy, and can be done safely whether in or out of battle.</para>
622
623 </sect1>
624 <sect1><title>Damage Report</title>
625
626 <literallayout>
627 Mnemonic:  DAMAGES
628 Shortest abbreviation:  DA
629 </literallayout>
630
631 <para>At any time you may ask for a damage report to find out what devices
632 are damaged and how long it will take to repair them.  Naturally,
633 repairs proceed faster at a starbase.</para>
634
635 <para>If you suffer damages while moving, it is possible that a subsequent
636 damage report will not show any damage.  This happens if the time
637 spent on the move exceeds the repair time, since in this case the
638 damaged devices were fixed en route.</para>
639
640 <para>Damage reports are free.  They use no energy or time, and can be done
641 safely even in the midst of battle.</para>
642
643 </sect1>
644 <sect1><title>Move Under Warp Drive</title>
645
646 <literallayout>
647 Mnemonic:  MOVE
648 Shortest abbreviation:  M
649 Full command:  MOVE MANUAL &lt;displacement&gt;
650                MOVE AUTOMATIC &lt;destination&gt;
651 </literallayout>
652
653 <para>This command is the usual way to move from one place to another
654 within the galaxy.  You move under warp drive, according to the
655 current warp factor (see <quote>WARP FACTOR</quote>).</para>
656
657 <para>There are two command modes for movement: MANUAL and AUTOMATIC.
658 The manual mode requires the following format:</para>
659
660 <screen>
661         MOVE MANUAL &lt;deltax&gt; &lt;deltay&gt;
662 </screen>
663
664 <para>&lt;deltax&gt; and &lt;deltay&gt; are the horizontal and vertical
665 displacements for your starship, in quadrants; a displacement of one
666 sector is 0.1 quadrants.  Specifying &lt;deltax&gt; and &lt;deltay&gt;
667 causes your ship to move in a straight line to the specified
668 destination. If &lt;deltay&gt; is omitted, it is assumed zero. For
669 example, the shortest possible command to move one sector to the right
670 would be</para>
671
672 <screen>
673         M M .1
674 </screen>
675
676 <para>The following examples of manual movement refer to the short-range
677 scan shown earlier.</para>
678
679 <screen>
680   Destination Sector    Manual Movement command
681         3 - 1                   M M -.3 -.1
682         2 - 1                   M M -.3
683         1 - 2                   M M -.2 .1
684         1 - 4                   M M 0 .1
685   (leaving quadrant)            M M 0 .2
686 </screen>
687
688 <para>The automatic mode is as follows:</para>
689
690 <screen>
691         MOVE AUTOMATIC &lt;qrow&gt; &lt;qcol&gt; &lt;srow&gt; &lt;scol&gt;
692 </screen>
693
694 <para>&lt;para&gt;where &lt;qrow&gt; and &lt;qcol&gt; are the row and column
695 numbers of the destination quadrant, and &lt;srow&gt; and &lt;scol&gt;
696 are the row and column numbers of the destination sector in that
697 quadrant.  This command also moves your ship in a straight line path
698 to the destination.  For moving within a quadrant, &lt;qrow&gt; and
699 &lt;qcol&gt; may be omitted. For example, to move to sector 2 - 9 in
700 the current quadrant, the shortest command would be</para>
701
702 <screen>
703         M A 2 9
704 </screen>
705
706 <para>To move to quadrant 3 - 7, sector 5 - 8, type</para>
707
708 <screen>
709         M A 3 7 5 8
710 </screen>
711
712 <para>and it will be done.  In automatic mode, either two or four numbers
713 must be supplied.</para>
714
715 <para>Automatic mode utilizes the ship's <quote>battle computer.</quote>  If the
716 computer is damaged, manual movement must be used.</para>
717
718 <para>If warp engines are damaged less than 10 stardates (undocked) you can
719 still go warp 4.</para>
720
721 <para>It uses time and energy to move.  How much time and how much energy
722 depends on your current warp factor, the distance you move, and
723 whether your shields are up.  The higher the warp factor, the faster
724 you move, but higher warp factors require more energy.  You may move
725 with your shields up, but this doubles the energy required.</para>
726
727 <para>You can move within a quadrant without being attacked if you just
728 entered the quadrant or have been attacked since your last move
729 command.  This enables you to move and hit them before they
730 retaliate.</para>
731
732 </sect1>
733 <sect1><title>Warp Factor</title>
734
735 <literallayout>
736 Mnemonic:  WARP
737 Shortest abbreviation:  W
738 Full command:  WARP &lt;number&gt;
739 </literallayout>
740
741 <para>Your warp factor controls the speed of your starship.  The larger the
742 warp factor, the faster you go and the more energy you use.</para>
743
744 <para>Your minimum warp factor is 1.0 and your maximum warp factor is 10.0
745 (which is 100 times as fast and uses 1000 times as much energy).  At
746 speeds above warp 6 there is some danger of causing damage to your
747 warp engines; this damage is larger at higher warp factors and also
748 depends on how far you go at that warp factor.</para>
749
750 <para>At exactly warp 10 there is some probability of entering a
751 so-called <quote>time warp</quote> and being thrown foward or backward
752 in time.  The farther you go at warp 10, the greater is the
753 probability of entering the time warp.</para>
754
755 </sect1>
756 <sect1><title>Impulse Engines</title>
757
758 <literallayout>
759 Mnemonic:  IMPULSE
760 Shortest abbreviation:  I
761 Full command:  IMPULSE MANUAL &lt;displacement&gt;
762                IMPULSE AUTOMATIC &lt;destination&gt;
763 </literallayout>
764
765 <para>The impulse engines give you a way to move when your warp engines are
766 damaged.  They move you at a speed of 0.95 sectors per stardate,
767 which is the equivalent of a warp factor of about 0.975, so they are
768 much too slow to use except in emergencies.</para>
769
770 <para>Movement commands are indicated just as in the <quote>MOVE</quote> command.</para>
771
772 <para>The impulse engines require 20 units of energy to engage, plus 10
773 units per sector (100 units per quadrant) traveled. It does not cost
774 extra to move with the shields up.</para>
775
776 </sect1>
777 <sect1><title>Deflector Shields</title>
778
779 <literallayout>
780 Mnemonic:  SHIELDS
781 Shortest abbreviation:  SH
782 Full commands:  SHIELDS UP
783                 SHIELDS DOWN
784                 SHIELDS TRANSFER &lt;amount of energy to transfer&gt;
785 </literallayout>
786
787 <para>Your deflector shields are a defensive device to protect you from
788 Klingon attacks (and nearby novas).  As the shields protect you, they
789 gradually weaken.  A shield strength of 75%, for example, means that
790 the next time a Klingon hits you, your shields will deflect 75% of
791 the hit, and let 25% get through to hurt you.</para>
792
793 <para>It costs 50 units of energy to raise shields, nothing to lower them.
794 You may move with your shields up; this costs nothing under impulse
795 power, but doubles the energy required for warp drive.</para>
796
797 <para>Each time you raise or lower your shields, the Klingons have another
798 chance to attack.  Since shields do not raise and lower
799 instantaneously, the hits you receive will be intermediate between
800 what they would be if the shields were completely up or completely
801 down. </para>
802
803 <para>You may not fire phasers through your shields.  However you may
804 use the <quote>high-speed shield control</quote> to lower shields,
805 fire phasers, and raise the shields again before the Klingons can
806 react.  Since rapid lowering and raising of the shields requires more
807 energy than normal speed operation, it costs you 200 units of energy
808 to activate this control.  It is automatically activated when you fire
809 phasers while shields are up.  You may fire photon torpedoes, but they
810 may be deflected considerably from their intended course as they pass
811 through the shields (depending on shield strength).</para>
812
813 <para>You may transfer energy beteen the ship's energy (given as
814 <quote>Energy</quote> in the status) and the shields.  The word
815 <quote>TRANSFER</quote> may be abbreviated <quote>T</quote>.  The
816 ammount of energy to transfer is the number of units of energy you
817 wish to take from the ship's energy and put into the shields.  If you
818 specify an negative number, energy is drained from the shields to the
819 ship.  Transfering energy constitutes a turn.  If you transfer energy
820 to the shields while you are under attack, they will be at the new
821 energy level when you are next hit.</para>
822
823 <para>Enemy torpedoes hitting your ship explode on your shields (if they
824 are up) and have essentially the same effect as phaser hits.</para>
825
826 </sect1>
827 <sect1><title>Phasers</title>
828
829 <literallayout>
830 Mnemonic:  PHASERS
831 Shortest abbreviation:  P
832 Full commands:  PHASERS AUTOMATIC &lt;AMOUNT TO FIRE&gt; &lt;NO&gt;
833                 PHASERS &lt;AMOUNT TO FIRE&gt; &lt;NO&gt;
834                 PHASERS MANUAL &lt;NO&gt; &lt;AMOUNT 1&gt; &lt;AMOUNT 2&gt;...&lt;AMOUNT N&gt; 
835 </literallayout>
836
837 <para>Phasers are energy weapons. As you fire phasers at Klingons, you
838 specify an <quote>amount to fire</quote> which is drawn from your
839 energy reserves.  The amount of total hit required to kill an enemy is
840 partly random.  but also depends on skill level.</para>
841
842 <para>The average hit required to kill an ordinary Klingon varies from 200
843 units in the Novice game to 250 units in the Emeritus game.
844 Commanders normally require from 600 (Novice) to 700 (Emeritus).  The
845 Super-commander requres from 875 (Good) to 1000 (Emeritus). Romulans
846 require an average of 350 (Novice) to 450 (Emeritus).</para>
847
848 <para>Hits on enemies are cumulative, as long as you don't leave the
849 quadrant. </para>
850
851 <para>In general, not all that you fire will reach the Klingons.  The
852 farther away they are, the less phaser energy will reach them. If a
853 Klingon is adjacent to you, he will receive about 90% of the phaser
854 energy directed at him; a Klingon 5 sectors away will receive about
855 60% and a Klingon 10 sectors away will receive about 35%. There is
856 some randomness involved, so these figures are not exact. Phasers
857 have no effect beyond the boundaries of the quadrant you are in.</para>
858
859 <para>Phasers may overheat (and be damaged) if you fire too large a burst
860 at once. Firing up to 1500 units is safe.  From 1500 on up the
861 probability of overheat increases with the amount fired.</para>
862
863 <para>If phaser firing is automatic, the computer decides how to
864 divide up your &lt;amount to fire&gt; among the Klingons present.  If
865 phaser firing is manual, you specify how much energy to fire at each
866 Klingon present (nearest first), rather than just specifying a total
867 amount.  You can abreviate <quote>MANUAL</quote> and
868 <quote>AUTOMATIC</quote> to one or more letters; if you mention
869 neither, automatic fire is usually assumed.</para>
870
871 <para>Battle computer information is available by firing phasers manually,
872 and allowing the computer to prompt you.  If you enter zero for the
873 amount to fire at each enemy, you will get a complete report, without
874 cost.  The battle computer will tell you how much phaser energy to
875 fire at each enemy for a sure kill.  This information appears in
876 parentheses prior to the prompt for each enemy.  Since the amount is
877 computed from sensor data, if either the computer or the S.R. sensors
878 are damaged, this information will be unavailable, and phasers must
879 be fired manually.</para>
880
881 <para>A safety interlock prevents phasers from being fired through
882 the shields.  If this were not so, the shields would contain your fire
883 and you would fry yourself.  However, you may utilize the
884 <quote>high-speed shield control</quote> to drop shields, fire
885 phasers, and raise shields before the enemy can react.  Since it takes
886 more energy to work the shields rapidly with a shot, it costs you 200
887 units of energy each time you activate this control.  It is
888 automatically activated when you fire phasers while the shields are
889 up. By specifying the &lt;no&gt; option, shields are not raised after
890 firing.</para>
891
892 <para>Phasers have no effect on starbases (which are shielded) or on
893 stars.</para>
894
895 </sect1>
896 <sect1><title>Report</title>
897
898 <literallayout>
899 Mnemonic:  REPORT
900 Shortest abbreviation: REP
901 </literallayout>
902
903 <para>This command supplies you with information about the state of the
904 current game.  Its purpose is to remind you of things that you have
905 learned during play, but may have forgotten, and cannot otherwise
906 retrieve if you are not playing at a hard-copy terminal.</para>
907
908 <para>You are told the following things:</para>
909
910 <itemizedlist>
911 <listitem><para>The length and skill level of the game you are playing</para></listitem>
912 <listitem><para>The original number of Klingons</para></listitem>
913 <listitem><para>How many Klingons you have destroyed</para></listitem>
914 <listitem><para>Whether the Super-Commander has been destroyed</para></listitem>
915 <listitem><para>How many bases have been destroyed</para></listitem>
916 <listitem><para>How many bases are left</para></listitem>
917 <listitem><para>What bases (if any) are under attack; your subspace radio
918 must have been working since the attack to get this 
919 information.</para></listitem>
920 <listitem><para>How many casualties you have suffered</para></listitem>
921 <listitem><para>How many times you have called for help.</para></listitem>
922 </itemizedlist>
923
924 <para>This same information is automatically given to you when you start to
925 play a frozen game.</para>
926
927 </sect1>
928 <sect1><title>Computer</title>
929
930 <literallayout>
931 Mnemonic:  COMPUTER
932 Shortest abbreviation: CO
933 </literallayout>
934
935 <para>This command allows using the ship's computer (if functional) to
936 calculate travel times and energy usage.</para>
937
938 </sect1>
939 <sect1><title>Photon Torpedoes</title>
940
941 <literallayout>
942 Mnemonic:  PHOTONS
943 Shortest abbreviation:  PHO
944 Full commands:  PHOTONS &lt;NUMBER&gt; &lt;TARG1&gt; &lt;TARG2&gt; &lt;TARG3&gt;
945 </literallayout>
946
947 <para>Photon torpedoes are projectile weapons&mdash;you either hit what you aim
948 at, or you don't.  There are no <quote>partial hits</quote>.</para>
949
950 <para>One photon torpedo will usually kill one ordinary Klingon, but it
951 usually takes about two for a Klingon Commander.  Photon torpedoes
952 can also blow up stars and starbases, if you aren't careful.</para>
953
954 <para>You may fire photon torpedoes singly, or in bursts of two or three.
955 Each torpedo is individually targetable.  The computer will prompt
956 you, asking for the target sector for each torpedo.  Alternately, you
957 may specify each target in the command line.</para>
958
959 <para>Photon torpedoes cannot be aimed precisely&mdash;there is always some
960 randomness involved in the direction they go.  Photon torpedoes may
961 be fired with your shields up, but as they pass through the shields
962 they are randomly deflected from their intended course even more.</para>
963
964 <para>Photon torpedoes are proximity-fused.  The closer they explode to the
965 enemy, the more damage they do.  There is a hit <quote>window</quote> about one
966 sector wide.  If the torpedo misses the hit window, it does not
967 explode and the enemy is unaffected.  Photon torpedoes are only
968 effective within the quadrant.  They have no effect on things in
969 adjacent quadrants.</para>
970
971 <para>If more than one torpedo is fired and only one target sector is
972 specified, all torpedoes are fired at that sector.  For example, to
973 fire two torpedoes at sector 3 - 4, you type</para>
974
975 <screen>
976      PHO 2 3 4           (or)           PHO 2 3 4 3 4
977 </screen>
978
979 <para>To fire torpedoes at, consecutively, sectors 2 - 6, 1 - 10, and 4 -
980 7, type</para>
981
982 <screen>
983      PHO 3 2 6 1 10 4 7
984 </screen>
985
986 <para>There is no restriction to fire directly at a sector.  For example,
987 you can enter</para>
988
989 <screen>
990        PHO 1 3 2.5
991 </screen>
992
993 <para>to aim between two sectors.  However, sector numbers must be 1 to 10
994 inclusive.</para>
995
996 </sect1>
997 <sect1><title>Dock at Starbase</title>
998
999 <literallayout>
1000 Mnemonic:  DOCK
1001 Shortest abbreviation:  D
1002 </literallayout>
1003
1004 <para>You may dock your starship whenever you are in one of the eight
1005 sector positions immediately adjacent to a starbase.  When you dock,
1006 your starship is resupplied with energy, shield energy photon
1007 torpedoes, and life support reserves.  Repairs also proceed faster at
1008 starbase, so if some of your devices are damaged, you may wish to stay
1009 at base (by using the <quote>REST</quote> command) until they are
1010 fixed.  If your ship has more than its normal maximum energy (which
1011 can happen if you've loaded crystals) the ship's energy is not
1012 changed.</para>
1013
1014 <para>You may not dock while in standard orbit around a planet.</para>
1015
1016 <para>Starbases have their own deflector shields, so you are completely
1017 safe from phaser attack while docked.  You are also safe from
1018 long-range tractor beams.</para>
1019
1020 <para>Starbases also have both short and long range sensors, which you can
1021 use if yours are broken. There's also a subspace radio to get
1022 information about happenings in the galaxy. Mr. Spock will update the
1023 star chart if your ask for it while docked and your own radio is dead.</para>
1024
1025 </sect1>
1026 <sect1><title>Rest</title>
1027
1028 <literallayout>
1029 Mnemonic:  REST
1030 Shortest abbreviation:  R
1031 Full command:  REST &lt;NUMBER OF STARDATES&gt;
1032 </literallayout>
1033
1034 <para>This command simply allows the specified number of stardates to go
1035 by.  This is useful if you have suffered damages and wish to wait
1036 until repairs are made before you go back into battle.</para>
1037
1038 <para>It is not generally advisable to rest while you are under attack by
1039 Klingons.</para>
1040
1041 </sect1>
1042 <sect1><title>Call Starbase for Help</title>
1043
1044 <literallayout>
1045 Mnemonic:  MAYDAY
1046 (No abbreviation)
1047 </literallayout>
1048
1049 <para>[Originally, this command was called <quote>HELP</quote>, but
1050 these days that might be misconstrued as an attempt to browae built-in
1051 documentation! In some later versions it was CALL.]</para>
1052
1053 <para>When you get into serious trouble, you may call a starbase for
1054 help.  Starbases have a device called a <quote>long-range transporter
1055 beam</quote> which they can use to teleport you to base.  This works
1056 by dematerializing your starship at its current position and
1057 re-materializing it adjacent to the nearest starbase.  Teleportation
1058 is instantaneous, and starbase supplies the required energy&mdash;all
1059 you have to do is let them know (via subspace radio) that you need to
1060 be rescued.</para>
1061
1062 <para>This command should be employed only when absolutely necessary.  In
1063 the first place, calling for help is an admission on your part that
1064 you got yourself into something you cannot get yourself out of, and
1065 you are heavily penalized for this in the final scoring.  Secondly,
1066 the long-range transporter beam is not reliable&mdash;starbase can always
1067 manage to dematerialize your starship, but (depending on distance)
1068 may or may not be able to re-materialize you again.  The long-range
1069 transporter beam has no absolute maximum range; if you are in the
1070 same quadrant as a starbase, you have a good chance (about 90%) of
1071 re-materializing successfully.  your chances drop to roughly 50-50 at
1072 just over 3 quadrants.</para>
1073
1074 </sect1>
1075 <sect1><title>Abandon Ship</title>
1076
1077 <literallayout>
1078 Mnemonic:  ABANDON
1079 (no abbreviation)
1080 </literallayout>
1081
1082 <para>You may abandon the Enterprise if necessary.  If there is still a
1083 starbase in the galaxy, you will be sent there and put in charge of a
1084 weaker ship, the Faerie Queene.</para>
1085
1086 <para>The Faerie Queene cannot be abandoned.</para>
1087
1088 </sect1>
1089 <sect1><title>Self-Destruct</title>
1090
1091 <literallayout>
1092 Mnemonic:  DESTRUCT
1093 (no abbreviation)
1094 </literallayout>
1095
1096 <para>You may self-destruct, thus killing yourself and ending the game.  If
1097 there are nearby Klingons, you may take a few of them with you (the
1098 more energy you have left, the bigger the bang).</para>
1099
1100 <para>In order to self-destruct you must remember the password you typed in
1101 at the beginning of the game.</para>
1102
1103 </sect1>
1104 <sect1><title>Quit Game</title>
1105
1106 <literallayout>
1107 Mnemonic:  QUIT
1108 (no abbreviation)
1109 </literallayout>
1110
1111 <para>Immediately cancel the current game; no conclusion is reached.  You
1112 will be given an opportunity to start a new game or to leave the Star
1113 Trek program.</para>
1114
1115 </sect1>
1116 <sect1><title>Sensor-Scan</title>
1117
1118 <literallayout>
1119 Mnemonic:  SENSORS
1120 Shortest abbreviation:  SE
1121 </literallayout>
1122
1123 <para>Utilizing the short-range sensors, science officer Spock gives you a
1124 readout on any planet in your quadrant.  Planets come in three
1125 classes: M, N, and O.  Only class M planets have earth-like
1126 conditions.  Spock informs you if the planet has any dilithium
1127 crystals.  Sensor scans are free.</para>
1128
1129 </sect1>
1130 <sect1><title>Enter Standard Orbit</title>
1131
1132 <literallayout>
1133 Mnemonic:  ORBIT
1134 Shortest abbreviation:  O
1135 </literallayout>
1136
1137 <para>To land on a planet you must first be in standard orbit.  You achieve
1138 this in a manner similar to docking at starbase.  Moving to one of
1139 the eight sector positions immediately adjacent to the planet, you
1140 give the orbit command which puts your ship into standard orbit about
1141 the planet.  Since this is a maneuver, a small amount of time is
1142 used; negligible energy is required.  If enemies are present, they
1143 will attack.</para>
1144
1145 </sect1>
1146 <sect1><title>Transporter Travel</title>
1147
1148 <literallayout>
1149 Mnemonic:  TRANSPORT
1150 Shortest abbreviation:  T
1151 </literallayout>
1152
1153 <para>The transporter is a device which can convert any physical object
1154 into energy, beam the energy through space, and reconstruct the
1155 physical object at some destination.  Transporting is one way to land
1156 on a planet.  Since the transporter has a limited range, you must be
1157 in standard orbit to beam down to a planet.  Shields must be down
1158 while transporting.</para>
1159
1160 <para>The transport command is used to beam a landing party onto a planet
1161 to mine <quote>dilithium crystals</quote>.  Each time the command is given the
1162 landing party (which you lead) moves from the ship to the planet, or
1163 vice-versa.</para>
1164
1165 <para>You are advised against needless transporting, since like all
1166 devices, the transporter will sometimes malfunction.</para>
1167
1168 <para>The transporter consumes negligible time and energy.  Its use does
1169 not constitute a <quote>turn</quote>.</para>
1170
1171 </sect1>
1172 <sect1><title>Shuttle Craft</title>
1173
1174 <literallayout>
1175 Mnemonic:  SHUTTLE
1176 Shortest abbreviation:  SHU
1177 </literallayout>
1178
1179 <para>An alternate way to travel to and from planets.  Because of limited
1180 range, you must be in standard orbit to use the shuttle craft, named
1181 "Galileo".  Shields must be down.</para>
1182
1183 <para>Unlike transporting, use of the shuttle craft does constitute a
1184 <quote>turn</quote> since time is consumed.  The time naturally
1185 depends on orbit altitude, and is equal to 3.0e-5 times altitude.
1186 Shuttling uses no ship energy.</para>
1187
1188 <para>You should use the same travel device going from the planet to the
1189 ship as you use to go from the ship to the planet. However it is
1190 possible to transport to the planet and have the Galileo crew come
1191 and pick your landing party up, or to take the Galileo to the planet
1192 and then transport back, leaving the shuttle craft on the planet.</para>
1193
1194 </sect1>
1195 <sect1><title>Mine Dilithium Crystals</title>
1196
1197 <literallayout>  
1198 Mnemonic:  MINE
1199 Shortest abbreviation:  MI
1200 </literallayout>
1201
1202 <para>Once you and your mining party are on the surface of a planet which
1203 has dilithium crystals, this command will dig them for you.</para>
1204
1205 <para>Mining requires time and constitutes a <quote>turn</quote>.  No
1206 energy is used.  Class M planets require 0.1 to 0.3 stardates to mine.
1207 Class N planets take twice as long, and class O planets take three
1208 times as long.</para>
1209
1210 <para>Dilithium crystals contain enormous energy in a form that is readily
1211 released in the ship's power system.  It is an excellent idea to mine
1212 them whenever possible, for use in emergencies.  You keep the
1213 crystals until the game is over or you abandon ship when not at a
1214 starbase.</para>
1215
1216 </sect1>
1217 <sect1><title>Load Dilithium Crystals</title>
1218
1219 <literallayout>  
1220 Mnemonic:  CRYSTALS
1221 Shortest abbreviation:  CR
1222 </literallayout>
1223
1224 <para>This is a very powerful command which should be used with caution.
1225 Once you have dilithium crystals aboard ship, this command will
1226 instruct engineering officer Scott and Mr. Spock to place a raw
1227 dilithium crystal into the power channel of the ship's
1228 matter-antimatter converter.  When it works, this command will
1229 greatly boost the ship's energy.</para>
1230
1231 <para>Because the crystals are raw and impure, instabilities can occur in
1232 the power channel.  Usually Scotty can control these.  When he
1233 cannot, the results are disastrous. Scotty will use those crystals
1234 that appear to be most stable first.</para>
1235
1236 <para>Since using raw dilithium crystals for this purpose entails
1237 considerable risk, Starfleet Regulations allow its use only during
1238 "condition yellow".  No time or energy is used.</para>
1239
1240 </sect1>
1241 <sect1><title>Planet Report</title>
1242
1243 <literallayout>  
1244 Mnemonic:  PLANETS
1245 Shortest abbreviation:  PL
1246 </literallayout>
1247
1248 <para>Mr. Spock presents you a list of the available information on planets
1249 in the galaxy.  Since planets do not show up on long-range scans, the
1250 only way to obtain this information is with the <quote>SENSORS</quote> command.</para>
1251
1252 </sect1>
1253 <sect1 id="freeze"><title>Freeze</title>
1254
1255 <literallayout> 
1256 Mnemonic:  FREEZE
1257 (no abbreviation)
1258 Full command:  FREEZE &lt;FILE NAME&gt;
1259 </literallayout>
1260
1261 <para>The purpose of the FREEZE command is to allow a player to save the
1262 current state of the game, so that it can be finished later.  A
1263 plaque may not be generated from a frozen game. A file with the
1264 specified &lt;file name&gt; and type '.TRK' is created (if necessary) in
1265 the current directory, and all pertinent information about the game
1266 is written to that file. The game may be continued as usual or be
1267 terminated at the user's option.</para>
1268
1269 <para>To restart a game created by the <quote>FREEZE</quote> command,
1270 the user need only type <quote>FROZEN</quote> in response to the
1271 initial question about the type of game desired, followed by the
1272 &lt;file name&gt;.</para>
1273
1274 <para>NOTE: A <quote>tournament</quote> game is like a frozen game,
1275 with the following differences.  (1) Tournament games always start
1276 from the beginning, while a frozen game can start at any point.  (2)
1277 Tournament games require only that the player remember the name or
1278 number of the tournament, while the information about a frozen game
1279 must be kept on a file. Tournament games can be frozen, but then they
1280 behave like regular frozen games.</para>
1281
1282 <para>A point worth noting is that 'FREEZE' does not save the seed for the
1283 random number generator, so that identical actions after restarting
1284 the same frozen game can lead to different results.  However,
1285 identical actions after starting a given tournament game always lead
1286 to the same results.</para>
1287
1288 </sect1>
1289 <sect1><title>Request</title>
1290
1291 <literallayout>  
1292 Mnemonic:  REQUEST
1293 Shortest abbreviation:  REQ
1294 Full command:  REQUEST &lt;ITEM&gt;
1295 </literallayout>
1296
1297 <!-- This is new in SST 2K --> 
1298 <para>If you are using the screen-oriented interface, this command is
1299 suppressed; instead, a full status report will always be present on the
1300 screen.</para>
1301
1302 <para>This command allows you to get any single piece of information
1303 from the &lt;STATUS&gt; command.  &lt;ITEM&gt; specifies which
1304 information as follows:</para>
1305
1306 <informaltable> 
1307 <tgroup cols='3'>
1308 <thead>
1309 <row>
1310   <entry>Information</entry>
1311   <entry>Mnemonic for &lt;item&gt;</entry>
1312   <entry>Shortest Abbreviation</entry>
1313 </row>
1314 </thead>
1315 <tbody>
1316 <row><entry>STARDATE</entry>    <entry>DATE</entry>      <entry>D</entry></row>
1317 <row><entry>CONDITION</entry>   <entry>CONDITION</entry> <entry>C</entry></row>
1318 <row><entry>POSITION</entry>    <entry>POSITION</entry>  <entry>P</entry></row>
1319 <row><entry>LIFE SUPPORT</entry><entry>LSUPPORT</entry>  <entry>L</entry></row> 
1320 <row><entry>WARP FACTOR</entry> <entry>WARPFACTOR</entry><entry>W</entry></row>
1321 <row><entry>ENERGY</entry>      <entry>ENERGY</entry>    <entry>E</entry></row>
1322 <row><entry>TORPEDOES</entry>   <entry>TORPEDOES</entry> <entry>T</entry></row>
1323 <row><entry>SHIELDS</entry>     <entry>SHIELDS</entry>   <entry>S</entry></row>
1324 <row><entry>KLINGONS LEFT</entry><entry>KLINGONS</entry> <entry>K</entry></row>
1325 <row><entry>TIME LEFT</entry>   <entry>TIME</entry>     <entry>TI</entry></row>
1326 <row><entry>BASES LEFT</entry>   <entry>BASES</entry>   <entry>BA</entry></row>
1327 </tbody>
1328 </tgroup>
1329 </informaltable>
1330
1331 </sect1>
1332 <sect1><title>Experimental Death Ray</title>
1333
1334 <literallayout>
1335 Mnemonic:  DEATHRAY
1336 (No abbreviation)
1337 </literallayout>
1338
1339 <para>This command should be used only in those desperate cases where
1340 you have absolutely no alternative.  The death ray uses energy to
1341 rearrange matter.  Unfortunately, its working principles are not yet
1342 thoroughly understood, and the results are highly
1343 unpredictable.</para>
1344
1345 <para>The only good thing that can result is the destruction of all
1346 enemies in your current quadrant.  This will happen about 70% of the
1347 time.  Only enemies are destroyed; starbases, stars, and planets are
1348 unaffected.</para>
1349
1350 <para>Constituting the remaining 30% are results varying from bad to
1351 fatal.</para>
1352
1353 <para>The death ray requires no energy or time, but if you survive, enemies
1354 will hit you.</para>
1355
1356 <para>The Faerie Queene has no death ray.</para>
1357
1358 <para>If the death ray is damaged in its use, it must be totally replaced.
1359 This can only be done at starbase.  Because it is a very complex
1360 device, it takes 9.99 stardates at base to replace the death ray.
1361 The death ray cannot be repaired in flight.</para>
1362
1363 </sect1>
1364 <sect1><title>Launch Deep Space Probe</title>
1365
1366 <literallayout>
1367 Mnemonic:  PROBE
1368 Shortest abbreviation:  PR
1369 Full command:  PROBE &lt;ARMED&gt; MANUAL &lt;displacement&gt;
1370                PROBE &lt;ARMED&gt; AUTOMATIC &lt;destination&gt;
1371 </literallayout>
1372
1373 <para>The Enterprise carries a limited number of Long Range Probes. These
1374 fly to the end of the galaxy and report back a count of the number of
1375 important things found in each quadrant through which it went. The
1376 probe flies at warp 10, and therefore uses time during its flight.
1377 Results are reported immediately via subspace radio and are recorded
1378 in the star chart.</para>
1379
1380 <para>The probe can also be armed with a NOVAMAX warhead. When launched
1381 with the warhead armed, the probe flies the same except as soon as it
1382 reaches the target location, it detonates the warhead in the heart of
1383 a star, causing a supernova and destroying everything in the
1384 quadrant. It then flies no further. There must be a star in the
1385 target quadrant for the NOVAMAX to function. </para>
1386
1387 <para>The probe can fly around objects in a galaxy, but is destroyed if it
1388 enters a quadrant containing a supernova, or if it leaves the galaxy.</para>
1389
1390 <para>The target location is specified in the same manner as the MOVE
1391 command, however for automatic movement, if only one pair of
1392 coordinates are specified they are assumed to be the quadrant and not
1393 the sector in the current quadrant!</para>
1394
1395 <para>The Faerie Queene has no probes.</para>
1396
1397 </sect1>
1398 <sect1><title>Emergency Exit</title>
1399
1400 <literallayout>
1401 Mnemonic:  EMEXIT
1402 Shortest abbreviation:  E
1403 </literallayout>
1404
1405 <para>This command provides a quick way to exit from the game when you
1406 observe a Klingon battle cruiser approaching your terminal.  Its
1407 effect is to freeze the game on the file 'EMSAVE.TRK' in your current
1408 directory, erase the screen, and exit.</para>
1409
1410 <para>Of course, you do lose the chance to get a plaque when you use this
1411 maneuver.</para>
1412
1413 </sect1>
1414 <sect1><title>Ask for Help</title>
1415
1416 <literallayout>
1417 Mnemonic:  HELP
1418 Full command:  HELP &lt;command&gt;
1419 </literallayout>
1420
1421 <para>This command reads the appropriate section from the SST.DOC file,
1422 providing the file is in the current directory.</para>
1423
1424 </sect1>
1425 </chapter>
1426 <chapter><title>Miscellaneous Notes</title>
1427
1428 <para>Starbases can be attacked by either commanders or by the
1429 <quote>Super-Commander</quote>.  When this happens, you will be
1430 notified by subspace radio, provided it is working.  The message will
1431 inform you how long the base under attack can last.  Since the
1432 <quote>Super-Commander</quote> is more powerful than an ordinary
1433 commander, he can destroy a base more quickly.</para>
1434
1435 <para>The <quote>Super-Commander</quote> travels around the galaxy at
1436 a speed of about warp 6 or 7.  His movement is strictly time based;
1437 the more time passes, the further he can go.</para>
1438
1439 <para>Scattered through the galaxy are certain zones of control,
1440 collectively designated the <quote>Romulan Neutral Zone</quote>.  Any
1441 quadrant which contains Romulans without Klingons is part of the
1442 Neutral Zone, except if a base is present.  Since Romulans do not show
1443 on either the long-range scan or the star chart, it is easy for you to
1444 stumble into this zone.  When you do, if your subspace radio is
1445 working, you will receive a warning message from the Romulan, politely
1446 asking you to leave.</para>
1447
1448 <para>In general, Romulans are a galactic nuisance.</para>
1449
1450 <para>The high-speed shield control is fairly reliable, but it has been
1451 known to malfunction.</para>
1452
1453 <para>You can observe the galactic movements of the
1454 <quote>Super-Commander</quote> on the star chart, provided he is in
1455 territory you have scanned and your subspace radio is working.</para>
1456
1457 <para>Periodically, you will receive intelligence reports from
1458 starfleet command, indicating the current quadrant of the
1459 <quote>Super-Commander</quote>.  Your subspace radio must be working,
1460 of course.</para>
1461
1462 <para>Each quadrant will contain from 0 to 3 black holes.  Torpedoes
1463 entering a black hole disappear.  In fact, anything entering a black
1464 hole disappears, permanently.  If you can displace an enemy into one,
1465 he is a goner.  Black holes do not necessarily remain in a quadrant.
1466 they are transient phenomena.</para>
1467
1468 <para>Commanders will ram your ship, killing themselves and inflicting
1469 heavy damage to you, if they should happen to decide to advance into
1470 your sector.</para>
1471
1472 <para>You can get a list of commands by typing
1473 <quote>COMMANDS</quote>.</para>
1474
1475 </chapter>
1476 <chapter><title>Scoring</title>
1477
1478 <para>Scoring is fairly simple.  You get points for good things, and you
1479 lose points for bad things.</para>
1480
1481 <para>You gain&mdash;</para>
1482
1483 <orderedlist>
1484 <listitem><para>10 points for each ordinary Klingon you kill,</para></listitem>
1485 <listitem><para>50 points for each commander you kill,</para></listitem>
1486 <listitem><para>200 points for killing the <quote>Super-Commander</quote>,</para></listitem>
1487 <listitem><para>20 points for each Romulan killed,</para></listitem>
1488 <listitem><para>1 point for each Romulan captured.</para></listitem>
1489 <listitem>
1490 <para>100 times your average Klingon/stardate kill rate.  If you lose
1491 the game, your kill rate is based on a minimum of 5 stardates.</para>
1492 </listitem>
1493 <listitem>
1494 <para>You get a bonus if you win the game, based on your rating:</para>
1495 <para>Novice=100, Fair=200, Good=300, Expert=400, Emeritus=500.</para>
1496 </listitem>
1497 </orderedlist>
1498
1499 <para>You lose&mdash;</para>
1500
1501 <orderedlist>
1502 <listitem><para>200 points if you get yourself killed,</para></listitem>
1503 <listitem><para>100 points for each starbase you destroy,</para></listitem>
1504 <listitem><para>100 points for each starship you lose,</para></listitem>
1505 <listitem><para>45 points for each time you had to call for help,</para></listitem>
1506 <listitem><para>10 points for each planet you destroyed,</para></listitem>
1507 <listitem><para>5 points for each star you destroyed, and</para></listitem>
1508 <listitem><para>1 point for each casualty you incurred.</para></listitem>
1509 </orderedlist>
1510
1511 <para>In addition to your score, you may also be promoted one grade in rank
1512 if you play well enough.  Promotion is based primarily on your
1513 Klingon/stardate kill rate, since this is the best indicator of
1514 whether you are ready to go on to the next higher rating.  However,
1515 if you have lost 100 or more points in penalties, the required kill
1516 rate goes up. Normally, the required kill rate is 0.1 * skill *
1517 (skill + 1.0) + 0.1, where skill ranges from 1 for Novice to 5 for
1518 Emeritus.</para>
1519
1520 <para>You can be promoted from any level.  There is a special
1521 promotion available if you go beyond the <quote>Expert</quote> range.
1522 You can also have a certificate of merit printed with your name, date,
1523 and Klingon kill rate, provided you are promoted from either the
1524 <quote>Expert</quote> or <quote>Emeritus</quote> levels. This
1525 <quote>plaque</quote> requires a 132 column printer. You may need
1526 print the certificate to a file, import it into your word processor,
1527 selecting Courier 8pt font, and then print in <quote>landscape
1528 orientation</quote>.</para>
1529
1530 </chapter>
1531 <chapter><title>Handy Reference Page</title>
1532
1533 <literallayout format='linespecific' class='monospaced'>
1534  ABBREV    FULL COMMAND                           DEVICE USED
1535  ------    ------------                           -----------
1536  ABANDON   ABANDON                                shuttle craft
1537  C         CHART                                  (none)
1538  CO        COMPUTER                               computer
1539  CR        CRYSTALS                               (none)
1540  DA        DAMAGES                                (none)
1541  DEATHRAY  DEATHRAY                               (none)  
1542  DESTRUCT  DESTRUCT                               computer
1543  D         DOCK                                   (none)
1544  E         EMEXIT                                 (none)
1545  FREEZE    FREEZE &lt;FILE NAME&gt;                     (none)
1546  I         IMPULSE &lt;MANUAL&gt; &lt;DISPLACEMENT&gt;        impulse engines
1547            IMPULSE AUTOMATIC &lt;DESTINATION&gt;        impulse engines and computer
1548  L         LRSCAN                                 long-range sensors
1549  MAYDAY    MAYDAY (for help)                      subspace radio
1550  MI        MINE                                   (none)
1551  M         MOVE &lt;MANUAL&gt; &lt;DISPLACEMENT&gt;           warp engines
1552            MOVE AUTOMATIC &lt;DESTINATION&gt;           warp engines and computer
1553  O         ORBIT                                  warp or impulse engines
1554  P         PHASERS &lt;TOTAL AMOUNT&gt;                 phasers and computer
1555            PHASERS AUTOMATIC &lt;TOTAL AMOUNT&gt;       phasers, computer, sr sensors
1556            PHASERS MANUAL &lt;AMT1&gt; &lt;AMT2&gt; ...       phasers
1557  PHO       PHOTONS &lt;NUMBER&gt; &lt;TARGETS&gt;             torpedo tubes 
1558  PL        PLANETS                                (none)
1559  PR        PROBE &lt;ARMED&gt; &lt;MANUAL&gt; &lt;DISPLACEMENT&gt;  probe launcher, radio 
1560            PROBE &lt;ARMED&gt; AUTOMATIC &lt;DESTINATION&gt;  launcher, radio, computer
1561  REP       REPORT                                 (none)
1562  REQ       REQUEST                                (none)
1563  R         REST &lt;NUMBER OF STARDATES&gt;             (none)
1564  QUIT      QUIT                                   (none)
1565  S         SRSCAN &lt;NO or CHART&gt;                   short-range sensors
1566  SE        SENSORS                                short-range sensors
1567  SH        SHIELDS &lt;UP, DOWN, or TRANSFER&gt;        deflector shields
1568  SHU       SHUTTLE                                shuttle craft
1569  ST        STATUS                                 (none)
1570  T         TRANSPORT                              transporter
1571  W         WARP &lt;FACTOR&gt;                          (none)
1572
1573  L. R. Scan:   thousands digit:   supernova
1574                hundreds digit:    Klingons
1575                tens digit:        starbases
1576                ones digit:        stars
1577                period (.):        digit not known (star chart only)
1578
1579 Courses are given in manual mode in X - Y displacements; in automatic
1580     mode as destination quadrant and/or sector.  Manual mode is default.
1581 Distances are given in quadrants.  A distance of one sector is 0.1 quadrant.
1582 Ordinary Klingons have about 400 units of energy, Commanders about
1583     1200.  Romulans normally have about 800 units of energy, and the
1584     (GULP) "Super-Commander" has about 1800.
1585 Phaser fire diminishes to about 60 percent at 5 sectors.  Up to 1500
1586     units may be fired in a single burst without danger of overheat.
1587 Warp 6 is the fastest safe speed.  At higher speeds, engine damage
1588     may occur.  At warp 10 you may enter a time warp.
1589 Shields cost 50 units of energy to raise, and double the power
1590     requirements of moving under warp drive.  Engaging the high-speed
1591     shield control requires 200 units of energy.
1592 Warp drive requires (distance)*(warp factor cubed) units of energy
1593     to travel at a speed of (warp factor squared)/10 quadrants per stardate.
1594 Impulse engines require 20 units to warm up, plus 100 units per
1595      quadrant.  Speed is just under one sector per stardate.
1596 </literallayout>
1597
1598 </chapter>
1599 <chapter><title>Game History and Modifications</title>
1600
1601 <sect1><title>Origins</title>
1602
1603 <para>The original Star Trek seems to have been written by Mike
1604 Mayfield at the beginning of the 1970s.  His first version was in
1605 BASIC for a Sigma 7 in 1971; in 1972 he rewrote it in Hewlett Packard
1606 BASIC. The source is <ulink
1607 url="&sst-site;www/historic/mayfield.basic">available</ulink> on the
1608 SST2K website. In January 1975 it became part of the DECUS library
1609 under the name <ulink
1610 url='http://www.trailing-edge.com/~shoppa/decus/110174.html'>SPACWR</ulink>.</para>
1611
1612 <para>While some people claim to have recollections of playing Trek
1613 games in the late 1960s, the earlier ones seem actually to have been
1614 variants of
1615 <ulink url='http://en.wikipedia.org/wiki/Spacewar!'>
1616 SPACEWAR</ulink>, the earlier space-combat game on the
1617 PDP-1. Mayfield <ulink
1618 url='http://www3.sympatico.ca/maury/games/space/star_trek.html'>wrote
1619 in 2000</ulink> that he invented the Trek-style galactic grid, and the
1620 evidence seems to back that up.  Some of the confusion probably stems 
1621 from the fact that Mayfield's original and several early descendants 
1622 were distributed under the name SPACWR.</para>
1623
1624 <para>Many different versions radiated from Mayfield's original; most
1625 og the ones in BASIC are descended from a SPACWR version that David
1626 Ahl published in <citetitle>101 BASIC Computer Games</citetitle>,
1627 July 1973. This was a port of Mayfield's version obtained from the HP
1628 Contributed Programs library.  </para>
1629
1630 <para>Our SST2K is descended from a Taurus BASIC program by Grady
1631 Hicks dated 5 April 1973. This does not appear to have been derived
1632 from Ahl's SPACWR. The header says "GENERAL IDEA STOLEN FROM
1633 PENN. U.", and the game has several features not present in SPACEWR:
1634 notably, the Death Ray, ramming, and the Klingon summons to surrender.
1635 And, of course, it predates Ahl's book.  The source is <ulink
1636 url="&sst-site;www/historic/UT-Trek.basic">available</ulink> on the
1637 SST2K website.</para>
1638
1639 <para>Dave Matuszek, Paul Reynolds et. al. at UT Austin played the
1640 Hicks version on a CDC6600, but disliked the long load time and
1641 extreme slowness of the BASIC program. (David Matuszek notes that the
1642 Hicks version he played had a habit of throwing long
1643 quotes from Marcus Aurelius at the users, a feature he found
1644 intolerable on a TTY at 110 baud.  It must, therefore, have been
1645 rather longer than  the one we have.)  The Austin crew proceeded to
1646 write their own Trek game, loosely based on the Hicks version, in
1647 CDC6600 FORTRAN.  At that time, it was just called "Star Trek"; the
1648 "Super" was added by later developers. In the rest of this history
1649 we'll call it the "UT FORTRAN" version.</para>
1650
1651 <para>At the time the UT FORTRAN source was last translated to C it emitted
1652 the message "Latest update-21 Sept 78".  Thus, it actually predated
1653 (and may have influenced) the best-known BASIC version, the "Super
1654 Star Trek" published by David Ahl in his November 1978 sequel
1655 <citetitle>BASIC Computer Games</citetitle>.</para>
1656
1657 <para>This 1978 "Super Star Trek" had been reworked by Robert Leedom and
1658 friends from (according to Leedom) Mayfield's HP port. There is
1659 internal evidence to suggest that at least some features of Leedom's
1660 SST may have derived from the UT FORTRAN version.  In particular, Dave
1661 Matuszek recalls implementing command words to replace the original
1662 numeric command codes, a feature Leedom's SST also had but the
1663 1973 and 1975 SPACWRs did not.</para>
1664
1665 <para>One signature trait of the UT FORTRAN game and its descendants
1666 is that the sectors are 10x10 (rather than the 8x8 in Mike Mayfield's
1667 1972 original and its BASIC descendants).  The UT FORTRAN version also
1668 preserves the original numbered quadrants rather than the
1669 astronomically-named quadrants introduced in Ahl's SST and its
1670 descendants.</para>
1671
1672 <!-- Dave thinks his Fortran Star Trek used the clockface for quadrant -->
1673 <!-- navigation. -->
1674
1675 <para>Eric Allman's BSD Trek game is one of these, also descended from
1676 the UT FORTRAN version via translation to C.  However, the mainline version
1677 (now SST2K) has had a lot more stuff folded into it over the years
1678 &mdash; deep space probes, dilithium mining, the Tholian Web, and so
1679 forth.</para>
1680 </sect1>
1681
1682 <sect1><title>Tom Almy's story</title>
1683
1684 <para>Back in (about) 1977 I got a copy of the Super Star Trek game for
1685 the CDC 6600 mainframe computer. Someone had converted it to PDP-11
1686 Fortran but couldn't get it to run because of its size. I modified
1687 the program to use overlays and managed to shoehorn it in on the 56k
1688 byte machine.</para>
1689
1690 <para>I liked the game so much I put some time into fixing bugs, mainly
1691 what could be called continuity errors and loopholes in the game's
1692 logic. We even played a couple tournaments.</para>
1693
1694 <para>In 1979, I lost access to that PDP-11. I did save the source code
1695 listing. In 1995, missing that old friend, I started converting the
1696 program into portable ANSI C. It's been slow, tedious work that took
1697 over a year to accomplish.</para>
1698
1699 <para>In early 1997, I got the bright idea to look for references to
1700 <quote>Super Star Trek</quote> on the World Wide Web. There weren't
1701 many hits, but there was one that came up with 1979 Fortran sources!
1702 This version had a few additional features that mine didn't have,
1703 however mine had some feature it didn't have. So I merged its features
1704 that I liked. I also took a peek at the DECUS version (a port, less
1705 sources, to the PDP-10), and some other variations.</para>
1706
1707 <para>Modifications I made:</para>
1708
1709 <para>Compared to original version, I've changed the
1710 <quote>help</quote> command to <quote>call</quote> and the
1711 <quote>terminate</quote> command to <quote>quit</quote> to better
1712 match user expectations. The DECUS version apparently made those
1713 changes as well as changing <quote>freeze</quote> to
1714 <quote>save</quote>. However I like <quote>freeze</quote>.</para>
1715
1716 <para>I added EMEXIT from the 1979 version.</para>
1717
1718 <para>That later version also mentions srscan and lrscan working when
1719 docked (using the starbase's scanners), so I made some changes here
1720 to do this (and indicating that fact to the player), and then
1721 realized the base would have a subspace radio as well &mdash; doing a
1722 Chart when docked updates the star chart, and all radio reports will
1723 be heard. The Dock command will also give a report if a base is under
1724 attack.</para>
1725
1726 <para>It also had some added logic to spread the initial positioning of
1727 bases. That made sense to add because most people abort games with
1728 bad base placement.</para>
1729
1730 <para>The experimental deathray originally had only a 5% chance of success,
1731 but could be used repeatedly. I guess after a couple years of use, it
1732 was less <quote>experimental</quote> because the 1979 version had a 70% success
1733 rate. However it was prone to breaking after use. I upgraded the
1734 deathray, but kept the original set of failure modes (great humor!).</para>
1735
1736 <para>I put in the Tholian Web code from the 1979 version.</para>
1737
1738 <para>I added code so that Romulans and regular Klingons could move in 
1739 advanced games. I re-enabled the code which allows enemy ships to
1740 ram the Enterprise; it had never worked right. The 1979 version
1741 seems to have it all fixed up, but I'm still not overly happy with
1742 the algorithm.</para>
1743
1744 <para>The DECUS version had a Deep Space Probe. Looked like a good idea
1745 so I implemented it based on its description.</para>
1746
1747 </sect1>
1748 <sect1><title>Stas Sergeev's story</title>
1749
1750 <para>I started from an older Tom Almy version and added features I had
1751 seen in other mainframe variants of the game, I wrote a screen-oriented 
1752 interface for it based on the curses library.</para>
1753
1754 <itemizedlist>
1755 <listitem>
1756 <para>The Space Thingy can be shoved, if you ram it, and can fire back if 
1757 fired upon.</para>
1758 </listitem>
1759 <listitem>
1760 <para>The Tholian can be hit with phasers.</para>
1761 </listitem>
1762 <listitem>
1763 <para>When you are docked, base covers you with an almost invincible shields 
1764       (a commander can still ram you, or a Romulan can destroy the base,
1765       or a SCom can even succeed with direct attack IIRC, but this rarely 
1766       happens).</para>
1767 </listitem>
1768 <listitem>
1769 <para>SCom can't escape from you if no more enemies remain (without this, 
1770       chasing SCom can take an eternity).</para>
1771 </listitem>
1772 <listitem>
1773 <para>Probe target you enter is now the destination quadrant. Before I don't 
1774       remember what it was, but it was something I had difficulty using.</para>
1775 </listitem>
1776 <listitem>
1777 <para>Secret password is now autogenerated.</para>
1778 </listitem>
1779 <listitem>
1780 <para>Victory plaque is adjusted for A4 paper rather than 132-column greenbar
1781 :-)</para>
1782 </listitem>
1783 <listitem>
1784 <para>Phasers now tells you how much energy needed, but only if the computer 
1785 is alive.</para>
1786 </listitem>
1787 <listitem>
1788 <para>Planets are auto-scanned when you enter the quadrant.</para>
1789 </listitem>
1790 <listitem>
1791 <para>Mining or using crystals in presense of enemy now yields an attack.
1792 There are other minor adjustments to what yields an attack
1793 and what does not.</para>
1794 </listitem>
1795 <listitem>
1796 <para>Ramming a black hole is no longer instant death.  There is a
1797 chance you might get timewarped instead.</para>
1798 </listitem>
1799 <listitem>
1800 <para>"freeze" command reverts to "save", most people will understand this
1801 better anyway.</para>
1802 </listitem>
1803 <listitem>
1804 <para>Screen-oriented interface, with sensor scans always up.</para>
1805 </listitem>
1806 </itemizedlist>
1807
1808 <para>My changes got merged into SST2K in 2005, and I work on it now.</para>
1809
1810 </sect1>
1811 <sect1><title>Eric Raymond's story</title>
1812
1813 <para>I played the FORTRAN version of this game in the late 1970s on a
1814 DEC minicomputer.  In the late 1980s Dave Matuszek and I became
1815 friends; I was vaguely aware that he had had something to do with the
1816 original Star Trek game.  In October 2004, sitting in Dave's living
1817 room, we got to talking about the game and I realized it would make a
1818 great exhibit for the <ulink
1819 url='&retro;'>Retrocomputing Museum</ulink>.</para>
1820
1821 <para>A few quick web searches later we found Tom Almy's page.  We
1822 downloaded his code and Dave verified that that it was a direct
1823 descendent of UT Super Star Trek &mdash; even though it had been translated
1824 to C, he was able to recognize names and techniques from the FORTRAN
1825 version he co-wrote.</para>
1826
1827 <para>This game became an open-source project; see the <ulink
1828 url='http://developer.berlios.de/projects/sst/'>project
1829 site</ulink>.</para>
1830
1831 <para>After I launched the Berlios project, Stas Sergeev contacted me.
1832 We worked together to merge in his changes.</para>
1833
1834 <para>Modifications I've made:</para>
1835
1836 <itemizedlist>
1837 <listitem><para>
1838 I converted the flat-text SST.DOC file to XML-Docbook so it can be
1839 webbed. (That's what you're reading now.)
1840 </para></listitem>
1841 <listitem><para>
1842 The command-help code needed a rewrite because the flat-text form of
1843 the documentation is now generated from XML and doesn't have the
1844 easily recognizable section delimiters it used to.  I wrote a script
1845 to filter that flat-text form into an sst.doc that's easy to parse for
1846 command descriptions, and changed some logic in sst.c to match.
1847 </para></listitem>
1848 <listitem><para>
1849 I've cleaned up a lot of grubby FORTRANisms in the code internals --
1850 used sizeof(), replaced magic numeric constants with #defines,
1851 that sort of thing.
1852 </para></listitem>
1853 <listitem><para>
1854 I fixed a surprising number of typos in the code and documentation.
1855 </para></listitem>
1856 <listitem><para>
1857 All the game state now lives in one big structure that can be
1858 written to and read from disk as one blob.  The write gives it an
1859 an identifiable magic number and the thaw logic checks for same. 
1860 </para></listitem>
1861 <listitem><para>
1862 I made the internal pager work, and in the process got rid of a number
1863 of platform dependencies in the code.
1864 </para></listitem>
1865 <listitem><para>
1866 The HELP/CALL/SOS command is now MAYDAY.
1867 </para></listitem>
1868 <listitem><para>
1869 Status report now indicates if dilithium crystals are on board.
1870 </para></listitem>
1871 <listitem><para>
1872 At Dave's prompting, restored the Space Thingy's original elusive behavior.
1873 </para></listitem>
1874 <listitem><para>
1875 Clean separation of game engine from the UI code, improving Stas
1876 Sergeev's excellent work on the curses interface.
1877 </para></listitem>
1878 </itemizedlist>
1879
1880 <para>Here are some good pages on the history of Star Trek games:</para>
1881
1882 <itemizedlist>
1883 <listitem><para>
1884 <ulink url='http://www.dunnington.u-net.com/public/startrek/'>http://www.dunnington.u-net.com/public/startrek/</ulink>
1885 </para></listitem>
1886 <listitem><para>
1887 <ulink url='http://www3.sympatico.ca/maury/games/space/star_trek.html'>http://www3.sympatico.ca/maury/games/space/star_trek.html</ulink>
1888 </para></listitem>
1889 <listitem><para>
1890 <ulink url='http://www.cactus.org/%7Enystrom/startrek.html'>http://www.cactus.org/%7Enystrom/startrek.html</ulink>
1891 </para></listitem>
1892 </itemizedlist>
1893
1894 </sect1>
1895 <sect1><title>Authors' Acknowledgments</title>
1896
1897 <para>These are the original acknowledgments by Dave Matuszek and Paul
1898 Reynolds:</para>
1899
1900 <para>The authors would like to thank Professor Michael Duggan for his
1901 encouragement and administrative assistance with the development of
1902 the Star Trek game, without which it might never have been completed.</para>
1903
1904 <para>Much credit is due to Patrick McGehearty and Rich Cohen, who assisted
1905 with the original design of the game and contributed greatly to its
1906 conceptual development.</para>
1907
1908 <para>Thanks are also due to Carl Strange, Hardy Tichenor and Steven Bruell
1909 for their assistance with certain coding problems.</para>
1910
1911 <para>This game was inspired by and rather loosely based on an earlier
1912 game, programmed in the BASIC language, by Jim Korp and Grady Hicks.
1913 It is the authors' understanding that the BASIC game was in turn
1914 derived from a still earlier version in use at Penn State University.</para>
1915
1916 </sect1>
1917 <sect1><title>References</title>
1918
1919 <orderedlist>
1920 <listitem><para><citetitle>Star Trek</citetitle> (the original television
1921 series), produced and directed by Gene Rodenberry.</para></listitem>
1922
1923 <listitem><para><citetitle>Star Trek</citetitle> (the animated
1924 television series), produced by Gene Rodenberry and directed by Hal
1925 Sutherland.  Also excellent, and not just kiddie fare.  If you enjoyed
1926 the original series you should enjoy this one (unless you have some
1927 sort of a hangup about watching cartoons).</para></listitem>
1928
1929 <listitem><para><citetitle>The Making of Star Trek</citetitle>, by
1930 Steven E. Whitfield and Gene Rodenberry.  The best and most complete
1931 readily available book about Star Trek.  (Ballantine
1932 Books)</para></listitem>
1933
1934 <listitem><para><citetitle>The World of Star Trek</citetitle>, by
1935 David Gerrold.  Similiar in scope to the above book.
1936 (Bantam)</para></listitem>
1937
1938 <listitem><para><citetitle>The Star Trek Guide</citetitle>, third revision 4/17/67, by Gene
1939 Roddenberry.  The original writer's guide for the television
1940 series, but less comprehensive than (3) above.
1941 (Norway Productions)</para></listitem>
1942
1943 <listitem><para><citetitle>The Trouble With Tribbles</citetitle>, by
1944 David Gerrold.  Includes the complete script of this popular show.
1945 (Ballantine Books)</para></listitem>
1946
1947 <listitem><para><citetitle>Star Trek</citetitle>, <citetitle>Star Trek
1948 2</citetitle>, ..., <citetitle>Star Trek 9</citetitle>, by James
1949 Blish.  The original shows in short story form.
1950 (Bantam)</para></listitem>
1951
1952 <listitem><para><citetitle>Spock Must Die</citetitle>, by James Blish.
1953 An original novel, but rather similar to the show <citetitle>The Enemy
1954 Within</citetitle>.  (Bantam)</para></listitem>
1955
1956 <listitem><para>Model kits of the Enterprise and a <quote>Klingon
1957 Battle-Cruiser</quote> by AMT Corporation are available at most hobby
1958 shops.</para></listitem>
1959 </orderedlist>
1960
1961 </sect1>
1962 </chapter>
1963 </book>