                               The Gateway v1.1
                                By Jason Brown
                         Maintained by Donald Tidmore

                   Written in Borland Turbo Pascal 7.0
             Used DDPlus v7.1 by Steven Lorenz and Bob Dalton
                For Legend of the Red Dragon by Michael Preslar

                   (LORD was created by Seth Able Robinson.)
                   (It is now owned by Metropolis Gameport.)

                           Version date: 11/02/2002


[LEGAL DISCLAIMER]

                         DISCLAIMER OF WARRANTY

            THIS SOFTWARE AND MANUAL ARE SOLD "AS IS" AND WITHOUT
            WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY
            OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED.  BECAUSE
            OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO
            WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS FOR
            A PARTICULAR PURPOSE IS OFFERED.  GOOD DATA PROCESSING
            PROCEDURE DICTATES THAT ANY PROGRAM BE THOROUGHLY TESTED
            WITH NON-CRITICAL DATA BEFORE RELYING ON IT.  THE USER
            MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM.  ANY
            LIABILITY OF THE SELLER WILL BE LIMITED EXCLUSIVELY TO
            PRODUCT REPLACEMENT OR REFUND OF PURCHASE PRICE.


[INTRODUCTION]
Michael Everett wanted an IGM that could run RHPs like LORD runs
IGMs, so here it is.
------------------------------------------------------------

[FILE LIST]
  Files that should be in GATE11.ZIP:

  FILE_ID.DIZ   : BBS Description File. (Gateway.diz)
  GATEWAY.TXT   : You're reading it!
  GW_WHATS.TXT  : Revisions/what's new in this version. (whatsnew.txt)
  GateCode.txt  : Info on how to program your own random happenings!
                  Previously named Codes.txt.
  RHPTRICK.TXT  : Tips and tricks for RHP programming.
 *POOL.RHP      : A Random Happening Program:
                  The Prehistoric Pool v1.10.
 *GATEWAY.EXE   : The Gateway!
 *SETUP.EXE     : Setup program for The Gateway IGM.
  HOMEPAGE.URL  : Internet Shortcut to Jason Brown's web-page,
                  and to my Castle Camelot LORD Links Page.
  -------------------------------------------------------------

  Files that are made by The Gateway in its directory:

 *GATEWAY.DAT   : Player record file.
 *GATETIME.DAT  : Time keeping file.
 *GATEWAY.CFG   : Configuration file.
 *EXTRA.CFG     : Extra config file, see [EXTRA SETUP INFO].

  ERROR.LOG     : Created in directory ran from, usually LORD's,
                  that has any errors that happen in it.

  *=Needed for program to run.

  BTW: Setup isn't really needed.  It's just nice to keep around.  <G>

  However, without it, you can't install new RHP Scripts, or remove
  ones you don't wish to use any more.  Do *NOT* rename Setup.exe.
  It has to be that filename to install the IGM properly in your
  LORD game.  Which is why it is important to use a separate
  subdirectory for this IGM.
------------------------------------------------------------

[REQUIREMENTS]
LORD version 3.25 or greater.
DOS (version 3.1 or better) or compatible operating system.
SHARE installed for multinode systems.
A Modem!  300-115,200 baud and any fossil lock baud rate up to 115,200.
  (Works well on telnet, too!)
286 or better processor (should not be a problem...)
Memory!  Very little needed to run...  never actually bothered to find out.
----------------------------------------

** Note 1:  Share.exe is not required for usage on systems using
Windows 95, Windows 98, Windows 2000/NT, Windows ME, Windows XP,
or non-Microsoft O.S.'s such as OS/2 or Linux. At least for Local
Mode play.  It may still be needed for multi-node usage of the IGM.

** Note 2:  IGM verified to work without problems under Windows ME.
   Running either LORD v4.06 or LORD v4.07 beta (January-September 2002
   compilations). **

*** Note 3: IGM was fully tested using Pentium III and IV CPUs.
------------------------------------------------------------

[UPGRADING]
To upgrade an existing Gateway IGM setup, simply unzip the distribution
archive for the new version into the Gateway IGM directory.  Use
the Overwrite Existing files function of PKUNZIP, WINZIP, or whichever
compressed file manager program you are using.
    Re-run the IGM's setup program and confirm that your settings are
correct.  That's all you need to do for upgrade process.

Note:  You will need either PKZIP v2.50, WinZIP, WinRAR, or some
other compression utility program that handles the PKZIP v2.50
compression formats.  You can get Winzip from http://www.winzip.com/.
====================================================================

[UPGRADING]
From v1.0, v1.0b:
Unzip all files from Gate11.zip, over-writing existing Gateway files,
into sub-directory where The Gateway is installed.

All RHP scripts used with The Gateway IGM have to be located in the
same directory the IGM is installed into.  Re-run Setup.exe and
verify that your settings are correct.

Script authors who use @DEFENSE@, @SKILLUSE@, etc., codes from this
update are reminded that they must use @VERSION@ 1.1 in their scripts.
-----------------------------------------------------------------


[INSTALLATION]
Note: If you have The L.O.R.D. Cavern, all you have to do is copy
      LORDCAVE.CFG in your LORD Cavern directory to GATEWAY.CFG in
      your Gateway directory and then use Setup to install (option 'I').

Put the files in the zip in a directory off of your LORD directory.
May I suggest naming the directory "GATEWAY"?  Then run SETUP.
Press 'C' to configure first.  Then press 'S' to configure EXTRA.CFG.

This is so you can add RHP programs (see [EXTRA SETUP INFO]).  You
also use it to change/set the number of Searches per day.  The rest
shouldn't be too hard to figure out.  Just answer all the questions.

(The Gateway is Freeware, but please register anyway so I will know
who is using my LORD IGM.)

Installing (pressing 'I' after leaving the configure menu) will put
the run lines into 3RDPARTY.DAT, and an announcement that The Gateway
has been installed in the daily happenings.  For those of you who want
to edit GATEWAY.CFG yourself, here's a listing of it:

GATEWAY.CFG Listing:

D:\BBS\LORD\
Unregistered BBS
Unregistered
Sysop
Sysop #1
000000

Line 1: Path to LORD with trailing backslash (the \ key).
Line 2: Your BBS name (or Telnet web-site name)
Line 3: Your real first name
Line 4: Your real last name
Line 5: Your handle (optional).  Displayed at start up instead of
        your real name, can include LORD codes.
Line 6: Not used by The Gateway, but something must be here.

The path must be on the first line, and no comments are allowed unless
they are after the registration code.

You'll notice that I said it'll use non-standard COM ports in the
File_id.Diz, but there's not a configuration setting for that.

That's because it gets all that stuff from LORD's Node*.Dat file.
As long as LORD is set up right, this will be set up right in that
respect.  I wish more IGMs used that Node*.Dat, too...
-------------------------------------------------------

These are the lines put in 3RDPARTY.DAT by The Gateway:

<path to gateway>\GATEWAY.EXE *
`@T`4he `@G`4ateway

Just in case you wanted to know.  :^)
------------------------------------------------------------

Special Notes:  The Gateway will work fine in an IGMs directory
with other IGMs, *AS LONG* as the others do NOT use an Setup.exe
or Extra.cfg file.  They also can't use the Gatetime.dat file name.

The L.O.R.D. Cavern, Outlands Tavern, and The Gateway IGMs each use
the same filenames for the Config program, and IGM config data file.
It is mandatory that each of the three IGMs be in a separate directory.

Do NOT try to use either IGM with Setup.exe file renamed.  Each IGM is
hard-coded to use setup.exe.

For backup purposes ONLY, user can copy extra.cfg to GW-extra.cfg name,
for example.  If you do this, remember to update the file whenever you
have re-run the Setup program.
-----------------------------------------------------------------


[EXTRA SETUP INFO]
Please only use SETUP to add RHPs.  There's a special format that
the lines need to be in.  It's much easier using SETUP anyway, because
it automatically finds all RHPs in your Gateway directory that are for
the Gateway, and then lets you add only those ones.  :)  It's option 'E'
under the main menu.
------------------------------------------------------------


[UN-INSTALLING]
Note: To reset The Gateway, run SETUP and press 'R'.

Now why would you want to un-install <G>?  Well, run SETUP, press
'U'. Unless it's in an IGM extender's files.  Then use the expander
to uninstall The Gateway.  IGME is great with that... Wait!  I
mentioned something not written by me!  Oh, no!  Seriously, it's a
great program. Look in to it...

==================================================
Provided the user is running LORD v3.50 - v4.00a - by Seth Robinson;
or v4.02 - v4.07 - by Michael Preslar;  LORD will automatically handle
as many IGMs as you wish to install.  However, unless you are using
the LordMenu utility, any IGMs installed over 24 will result in user
having the Other Places menu scroll upward until the command prompt
appears.  Use of LordMenu v1.30 - by Lloyd Hannesson - allows you to
list installed IGMs in a two columns per line menu.
--   http://www.dasme.org/techn/files/lrdmnu13.zip (LordMenu v1.30)
-----------------------------------------------------------------


[USING IT]
Just select The Gateway in the other places.  It will do maintenance
automatically when the first person for the day enters, and it doesn't
take that long.  A menu will be brought up showing the installed RHPs,
just use the keys shown.
------------------------------------------------------------


[REGISTRATION]
None, this program is freeware!  However, please notify me that
you are using it.  I like to know who is running my IGMs. Jason.
------------------------------------------------------------


[COMING SOON]
As BBS's kind of fizzled out, there's not much in that area.  :(  I'm
toying with ways to bring more BBS like elements to the web, though.
Also adding an RHP system to The Outlands Tavern, just for fun.  :)
------------------------------------------------------------


[OTHER PRODUCTS]
Here is the other LORD stuff that I've done!

The L.O.R.D. Cavern v1.5  - IGM for LORD 3.25+ - 12 different random
         actions, great comm routines (works on several systems other
         IGMs won't), intro ANSI, and some really rare happenings!
         The Random Happening Program (RHP) language lets you make
         your own random happenings!  Now allows sysop handles.  Node
         0 and DigiBoard support, comm routines refined.  Freeware,
         as of v1.4.  Now includes built-in limits on rewards and
         penalties, to reduce its impact on LORD's "fair play" doctrine.
         Includes some brand new random actions, All new riddles and
         questions for the Troll and Riddler.  And much more.

The L.O.R.D. Cavern RHP Set #1 - 5 RHP programs for The L.O.R.D. Cavern!
(CAVERHP1.ZIP)              The Lost City of Darborne, The Waterfall, The
                            Old Magician, The Diamond Mine, and The
                            Canyon.  v1.3a+ (some require v1.3c+).

The L.O.R.D. Cavern RHP Set #2 - 5 MORE RHP programs for The L.O.R.D.
(CAVERHP2.ZIP)              Cavern!  The Bats, The Flower Patch, A Random
                            Hobbit, The Mushroom Patch, and The Cavern
                            Women.  All written by users!  v1.3b+ (some
                            require v1.3c+).

LordStat v1.7 - Bulletin generator for LORD 3.15+ - 11 different bulletins
(LORDST17.ZIP)  to spice up your LORD game!  Helps users to pick and
                choose who to attack, and tells who is the best warrior in
                the Realm!  Now also tells users where others are in the
                Realm, sleeping in the Inn, Field, or in an IGM!  New
                bulletin lists the installed IGMs!  Lets you not use any
                of the bulletins you don't want to, and has an easy to use
                built in SETUP program!  Now has the ability to have custom
                bulletins made!  Includes Renegade, Wildcat! and
                RemoteAccess pause code support.  Freeware.

The Outlands Tavern v1.4 - IGM for LORD 3.50+ - Great IGM for LORD!  Lets
(OUTS14.ZIP)       users talk and PARTY!  Best of all, users can stay
                   overnight in the Tavern, for a fee, and be safer than in
                   LORD's Inn!  There's still a chance someone might get
                   them!  New BackRoom will spice up the stay and includes
                   support for BADWORDS.DAT!  Also has RHP support!
                   Freeware.   Restored Taste Punch event. Added defensive
                   skill technique usage to Player Fights.

RHPTest v1.2     - Utility program for RHP Script writers to use in
(RHPTST12.ZIP)     testing their Scripts outside of the LORD IGM
                   they are written for.  Allows some evaluation of
                   how they work without your having to start playing
                   a LORD game session.
--------------------------------------------------

Stones! v1.2 - A LORD2 IGM by Jason Brown.  Support and development was
    taken over in June 2002 by Max Larivee.  Contact Max at
    fieldsoft@hotmail.com with any questions about Stones! v1.20.
-----------------------------------------------------------------


[DISTRIBUTION SITES]
Check out these Internet sites!

FTP:  None used by Jason Brown.
WWW: http://www.pcisys.net/~jmbrown/
My World Wide Web page includes links to other pages, like Seth Able's!

Email: jmbrown@pcisys.net -OR- farlander@mailandnews.com
--------------------------------------------------------

Current distribution sites update:
----------------------------------
FTP:      ftp://ftp.lordlegacy.org/lordlegacy/igms/
WWW #1:   http://www.lordlegacy.org/camelot/camelot6.htm
          Castle Camelot LORD IGMs Page

Download URL:  http://www.lordlegacy.org/camelot/LordApps/

Fidonet:  http://www.filegate.net/camelot/lordfile/
          Camelot LordNews FDN

Fidonet Mail:  use 1:123/450, and post to LORD Echo.  If writing
          using my name, address messages to Donald Tidmore.
Email:    ktidmore@bellsouth.net - OR- donald.tidmore@usa.net

=========================================
Official Release Sites Info: (10-19-2002)
-- Will create LordApps subdirectory on Castle Camelot web-site.
   It and Jason's web-site will be primary source for this IGM.
   Secondary, primary sources will be Lord Legacy FTP server,
   and the Camelot LordNews FDN.
-----------------------------------------------------------------


[CLOSING]
Thanks to Michael Everett for the idea and beta testing
(telnet://bobobbs.net -- Email:  sysop@bobobbs.net).

Thanks to Seth Able Robinson for writing LORD and releasing the
PLAYER.DAT structure.

If you have any bug reports or comments you can reach me at:
  Internet: jmbrown@pcisys.net
------------------------------------------------------------


[REVISIONS - September 2002]
Updated program version references for L.O.R.D. Cavern, LordStat,
The Outlands Tavern, and The Gateway.  Added info for RHPTest, Stones!,
and L.O.R.D. Cavern RHP Set #2.  Updated email contact information.

Thanks to Michael Everett, Gary Hartzell, Gordon Lewicky, Charlie
Wardick, and Paul Koukos for their assistance in beta testing
updated versions in summer 2002.

Special thanks to Charlie Wardick for lessons in learning PASCAL again,
learning how to use Turbo Pascal, and learning LORD programming.
=====================================================

BBS Testers info:
------------------
1) Gordon Lewicky - Email: glewicky@dowco.com.  Sysop Milkyway
   !:153/307,  Milky Way, 1;153/307;  or Fidonet 1:153/0.
   Sysop of Milkyway BBS. in British Columbia, Canada.

2) Michael Everett - Email: sysop@bobobbs.net.
   Sysop of Bobo's BBS.  http://www.bobobbs.net, telnet://bobobbs.net

3) Paul Koukos - Email:  444@hellasbbs.com
   Sysop of Hellas BBS.   http://hellasbbs.com, telnet://hellasbbs.com

4) Gary Hartzell.  Email: gary.hartzell@verizon.net.
5) Charlie Wardick:  Email: chasware@cox.net, Phoenix, Arizona.

Thanks to Michael Preslar for keeping LORD alive through v4.06
and v4.07 beta.
=================================================================

[END]    11/02/2002.