                             Star Trek Enhanced
                           The Klingon Incursion
                               by Gary Crunk

NOTICE!!! Please Read ALL of this... I know, most people don't like to read
          instructions... But if you do read it, it will help you to get
          the game running on your BBS faster and without any hassles.

-=[ Software ]=------------------------------------------------------------

    This game was written in Turbo Pascal 7 for DOS.  This game must be run
    as a DOS Door.  As well, it does require the player to play in ANSI
    Color.  

    So if your BBS can run DOS Doors, then this program "Should" work.

    This game will also work on a Multi-Node BBS.  The game is usually
    called using NetFoss (Especially if it's a Telnet BBS).  See the
    example command line for Mystic BBS as an example.

-=[ Operating System ]=----------------------------------------------------

    This program will run under DOSBOX or if on Windows XP, you can run
    CMD.EXE, change to the directory and run Startrek /L.

    When installing this on Windows XP BBS Door, it will run under NetFoss.

-=[ Legal Disclaimer ]=----------------------------------------------------

   I have taken precautions to insure that no harm or damage will
occur on the computer systems operating this door.  However, I
will NOT be held liable for whatever may happen on your computer
system or to any computer systems which connects to your own as a result of
operating this door.  The user assumes full responsibility for the correct
operation of this software package, whether harm or damage results from
software error, hardware malfunction, or operator error.  NO warranties are
offered, expressly stated or implied, including without limitation or
restriction any warranties of operation for a particular purpose and/or
merchant ability.  If you do not agree with this then do NOT use this
program.  In other words, if it doesnt work or messes up things, do not
blame me...

-=[ About the Game ]=------------------------------------------------------

    This program is based on an OLD computer program called Star Trek.  I
    had my version I would run on my company's computer system, and it was
    all on Punch Cards.. Yes.. I am that old.  You play the game on an
    8x8 Galactic Grid where Klingons are spread about along with a few
    Star-Bases.  Much like to Old Game, you still Navigate around, find
    Klingons and Phaser/Torpedo them. You can also "Dock" with a Starbase
    to Refuel and Repair your ship.

    Now is where the game gets Enhanced.  There are Planets around that
    you can Orbit. There are many new functions, like the ability to
    get up from your chair on the bridge, and walk around the ship...
    If you are docked with a Starbase, you can walk around the starbase
    and talk with people, get items etc.  If you are in orbit around a
    planet, you can either Shuttle down or Beam Down, walk around, talk
    with people, get things, but careful, while on planets you can still
    be attacked there by Klingon Warriors... so Bring a Phaser otherwise
    it will be Hand to Hand Combat!

    You also maintain an Inventory of items.  The ship runs on Energy,
    and so do you... You have an Energy Level, and if that falls to
    Zero, you die.  So you have to Get Food and Eat Food to keep up
    your energy (Critical in Ground Fighting).

    When talking to others, you may be given a mission like finding
    medicines for a plague, you must find the planet, talk to others
    to Get the Medicine, then bring it back to the afflicted planet.

    So there is a whole new "Adventure" inside the game, it's not just
    flying around in space shooting Klingon Warships...

    You "CAN" play it and win without ever getting up from the captains
    chair, and play it in standard play mode... Note also, the game
    plays on a limited time frame, meaning at the beginning of the game,
    you are given xxx number of star dates to defeat ### Klingons.  BUT...
    if you are walking around the ship/starbase/planet, that time Stops
    so you can take all the time you want while walking around.

-=[ Installation ]=--------------------------------------------------------

    Please follow these Instructions so you can get this running properly
    on your BBS.

    1) Make a directory on your system that is reachable by your BBS
    such as in Mystic   c:\mystic\doors\startrek

    2) Extract the contents of this .ZIP file to that directory you
    just created, Make sure that the ROOM and SAVE folder are there!

    So you should have something like this:

      C:\MYSTIC\DOORS\STARTREK\
                              \ROOM
                              \SAVE
      The ROOM Directory will have all of the ROOM###.ANS files
      The SAVE Directory should be Empty.  When a user Saves the
      game, that file goes here.  Also, if they enter a Captains
      Log, it will also go there...
      The STARTREK directory will have all other files.

    3) There are 2 files there called ADOOR0.CFG and ADOOR1.CFG...
    Edit these files and update them for your system...

Here is an Example of one of my ADOOR1.CFG Files
============================================
DORINFO
C:\mystic\Temp1
Another F-ing BBS
Gary Crunk
TELNET

C:\Mystic\Doors\startrek\
0
0
0
0
============================================

    Line 1 is the dropfile type (DOORSYS,DOOR32,DORINFO,TRIBBS,WWIV,etc).
           You don'e need to say DORINFO1 or DORINFO12... etc... Just DORINFO
             The dropfile type may be any one of the follwing:
               DOOR32 (DOOR32.SYS)
               DOORSYS (DOOR.SYS)
               DORINFO (DORINFO1.DEF ... DORINFO##.DEF)
               WWIV (CHAIN.TXT),
               TRIBBS(TRIBBS.SYS)
               SPITFIRE(SFDOORS.DAT)
               PCBOARD12(PCBOARD.SYS)
               PCBOARD14(PCBOARD.SYS)

    SPECIAL NOTE:  I would recommend ONLY Using DORINFO!
                   User Names could be messed up if you use
                   any other Drop File!

    Line 2 is the full path to the dropfile for this node. Do NOT
           specify dropfile name on this line.
    Line 3 is the system name.
    Line 4 is the name of the system operator.
    Line 5 is the locked baud rate if applicable or TELNET if using
           a telnet connection.
    Line 6 is the full path to the directory where the door is located.
           Do NOT specify the door name, only the directory path.
    Lines 7-10 are reserved for future use, but must be present.

    This file must be present for the program to launch. You may specify the
    configuration file name and path with command line switch /C.
    Example: startrek.exe /H%1 /Cc:\bbs\doors\adoor%2.cfg

    You must have a seperate configuration file for each node on your system!
    For example, if you run a system with 8 Nodes, you will need
    ADOOR0.CFG, ADOOR1.CFG, ADOOR2.CFG .... ADOOR8.CFG
    Making sure that in each .CFG, the proper pointer to Drop File Location
    is at.  In Mystic BBS, this is C:\Mystic\TEMP0 .... C:\Mystic\TEMP8

    You MUST Create an ADOOR#.CFG for EACH Node you run.  If you run 100 Nodes,
    then you will need 100 ADOOR#.CFG edited to point to where that Node's
    DropFile will reside...

    You should also have ADOOR0.CFG if you are logging onto your BBS Locally,
    this will handle the Local aspect...

-=[ Setting up your BBS to Run the Door Game ]=------------------------------

                            COMMAND LINE OPTIONS
                            ____________________

    The following command line switches may be used:
        /H  Handle or ComPort to use. (Required!)
        /C  Configuration File (Required!)
        /T  Telnet Mode (I dont use this for Mystic, you may need to..)
        /L  Local Mode (Use this to play at the DOS Prompt Locally)
        /N  Node Number (Required!)
        /G  Game Module (IGM) (Not Used)
        /S  Security Level (Not Used)
        /W  Wildcat5/Winserver Switch (Not Used)
        /M  Maintenance Mode (Not Used)
        /Z  Time Left in Minutes. (Useful for limiting time in door) (Not Used)
        /?  Shows available switches

    EleBBS Example: c:\elebbs\doors\startrek\StarTrek.EXE /H*W /Cc:\bbs\doors\adoor*N.cfg

    Mystic BBS Example:
      (D3) Exec DOOR32 Program
      Data: c:\mystic\netfoss\nf.bat /N%3 /H%0 c:\mystic\doors\startrek\start.bat %0 %3

    Note: For Linux users, I do not know how to use DOS Doors on Linux/PI...
          If you can run DosEmu or QEMU, you will have to figure out
          how to run the Door with the appropriate required switches such as /H and /N

    For my BBS, I have a batch file inside c:\mystic\doors\startrek  called
    start.bat.  Here is the contents:
==============================================
Echo Off
c:
cd c:\mystic\doors\startrek
startrek.exe /H%1 /Ce:\doorsrv\doors\startrek\adoor%2.cfg
REM This now creates the Players Scores to a file called stscores.txt
REM You can then copy that (or not) to your Scores or Bulletins...
playered scores
copy stscores.txt c:\doorsrv\text\bullet10.asc
==============================================

    The /H parameter must be specified when not operating in local mode.
    If no command line switches are used, the program defaults to local mode.

    4. NOW that you've done all of that... <Whew>... Log onto your BBS
    either Locally or via Telnet... And Run the Door Menu you've created..
    That should be it.

    IF you run into a problem or an error when you run
    the door, it probably means that the PLAYER.DAT file has not been created
    properly... Here is how to fix the problem...
      a) Go to your DOS Prompt and CD to the Startrek Directory.
      b) Rename PLAYER.DAT to PLAYER.BAK
      c) Run PLAYERED.EXE
      d) This will create a New PLAYER.DAT file with 1 record...
      e) KEEP Record Number 0 there and Empty...
      f: ADD a New Record.  Say Not-Empty
         Add your BBS Login Handle (Exactly as you have it on your BBS)
         Fill in other fields, or leave them blank until done...
      g: Exit the program, and then Reload your BBS and Log On and try
         play again.

    5. If you want to Generate the Scores in your nightly maintenance
    program, simply tell it to run PLAYERED SCORES.

    6. I am leaving the "Feedback" function in this release so you can
    get feedback from your players/users.. and if you want, you can pass
    that info to me... It helps to fix any glitches/mistakes in the game.

-=[ Modification of the Game ]=--------------------------------------------

  There are Other Programs I am including with this.  I used them to create
  and manage the .DAT files used by the program during/for game play.  IF
  you use them, please Backup all .DAT files to another location just in
  case you make a mistake or damage them.

PLAYERED.EXE.  You can use this program, though it's simplistic, you can
use it to Edit Players. It is also used with the SCORES parameter to
generate a scores.txt file.

NOTE:  RECORD ZERO(0) must Always be there!
  Leave Record Zero(0) alone and leave it as it is...  Leave the "Empty"
  field set to One (1).

If you wanted to Delete a User, Edit their record and place a Zero (0)
in the "Empty" field.  This way, the next time a new player plays, their
info will be placed in that record #.  Sure, the player you deleted can
still log on and play, it will just create a new player record...

You cannot actually "Delete" a record, merely render it "Empty"
so when a new player plays it, they will "Take-Over" that record numer
you marked as Empty (0).  You can also use the program to "Cheat" and
give a user more money or inventory items.

Things that can go into the Inventory, and can be "Used" are:
  Dylithium Crystals     Anti-Matter Pod     50 Photon Torpedoes
  Steak Dinner           Andorian Ale        Turkey Dinner
  Burger and Fries       Food Rations        K.F.C.
  Pizza                  Andorian Gulash     Subway Sub
  Space Suit             Hot Weather Gear    Cold Weather Geat
  20 Credits             50 Credits          Medical Tricorder
  Hypo Spray             Phaser              Communicator
  Phaser Rifle           100 Credits         Portable Shield
  Portable Transporter   Andorial Ale        Titanium
  Gold                   Copper              Tungsten Steel
  Rigel Flu Vaccine      Andorian Hics Cure  Tellar Cancer Cure
  Vulcan Ponfar Vaccine  Photon Grenade      Shield Belt
  Amulet                 Ice Grenade

ROOMEDIT.EXE: I used this program to write the game. It describes a Room,
  what directions they can travel, What person is in the room and the TALK
  Record they are assigned (See TALKEDIT.EXE) and what they HAVE and WANT.
  It also describes the room as having Oxygen, is too Hot or Cold.
  The Directions and Beam / Shuttle entries should point to ROOM Numbers
  that are in the Database where the person will go to next.  If they are
  not allowed to go that direction, Enter a Zero(0) there.  Please do NOT
  change any of the existing rooms unless you are going to create a NEW
  room.  Then change the Direction # to point to that Room#.

  If you DO add a room, you must also create a ROOM#.ANS in \ROOM folder
  to display.  IF the room has a Person that is able to be Talked to,
  you have to indicate the persons Name, and then the TALK Record # to
  go to (See TALKEDIT).  You must also find and edit (it's an ANSI File)
  the .MAP file of where this room is.  So if you ADD a room to Andoria,
  you must edit ANDORIA.MAP to reflect the new room.

TALKEDIT.EXE:  i used this program also to write the game.  It maintains
  the database of any conversations... If you've created a room, or Added
  a person to talk to in RoomEdit.Exe, then that should point to a Record
  number in Talk. If you Add a record, keep the record number in mind so
  you can put that record number inn RoomEdit.exe.
    a) Person in Room: Name of the Person to be talked to.
    b) Person HAS to Give/Trade.  This is an Item that can go into the
       captains inventory.
    c) Enter up to 3 Lines of text of what the person says to the captain
    d) Player Response #1 is actually a Menu Item Selection...
       If the player chooses this entry, you can jump to another Talk #
       and continue the conversation.
       Same with Player Answers #2, #3 and #4.
    e) Person WANTS in Buy/Trade:  This is what the Captain has in Inventory
       if the captain HAS the item (Must match spelling perfectly) then
       the person will Ask the Captain if they want to trade HAS for WANTS.
       if the captain does NOT have the WANTS item, then that the ask for
       Trade will not happen.
    f) I would go through the database and look how things are done...
       You can have a complex conversation happen and based on the players
       response will go to a different Talk record to continue the
       conersation.  If you want to END a conversation, simply enter a Zero(0)
       in the Want Talk Record do we go to field.

   Using RoomEdit and TalkEdit is a good way to Expand the "Walking Around"
   aspect of the game. But remember to be careful.  I would make copies
   of the original .DAT files ROOM.DAT and TALK.DAT files in case you make
   a mistake.  Also, if you to Add Rooms, make sure you Add Room#.ans and
   also edit the appropriate *.MAP to reflect the new room.

   You ARE limited on the number of Planets you can create rooms on. You
   could add rooms to the Enterprise, but they have to be located off of
   the Turbolift or branch off of an already existing room such as
   Engineering has a Aux-Control room...

   If you DO change an exitisting room by adding a new direction/room,
   then you should edit that ROOM# Ansi file to reflect the "Scene".. For
   example, if you add a Room going North on Vulcan Room53, then edit
   the ANSI file ROOM53.ANS to show a Path going North...

-=[ Conclusion ]=--------------------------------------------------------

I think thats about it... Please contact me at garycrunk@amtimes.com or
at my BBS (Telnet)  anotherbbs.bbsindex.com.

If you Really like the program, and feel generous, you can always send
a donation of any amount you want on Paypal to garycrunk@amtimes.com. If
you send a donation, also Email me.  If you send more than $10.00, and
if you want, Email me directly at garycrunk@amtimes.com with your BBS
Name and Your Name and BBS Address and your donation amount...

I will Personalize a copy of Startrek.exe for you so when users play,
it will have that information displayed... A personalize copy of the game
just for you... and Email the program to you, so make sure it's a good
Email address that can accept attachments.

Many thanks and your Feedback is Welcome.

Gary Crunk
Another F-ing BBS (anotherbbs.bbsindex.com) Port 23
Big Box of Raspberry PI (bigboxofpi.bbsindex.com) Port 2323
Quazar BBS Door Server (quazarbbs.dtdns.net Port 992)
http://www.anotherbbs.bbsindex.com
http://www.garycrunk.com
http://www.amtimes.com
