                          The Gateway v1.2 LORD IGM
                                By Jason Brown
                         Maintained by Donald Tidmore

                   Written in Borland Turbo Pascal 7.00
                       Updated in Borland Pascal v7.01
             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.)

                       v1.1 Version date: 11/02/2002

                        v1.2 Version date:  11/07/2003


                              [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 GATE12.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.12 - RHP Script.
 *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.
  ------------
  CCL-APPS.TXT  : Listing of info, hyperlink URLs for all LORD
                  programs created, adopted, or managed by
                  Donald Tidmore.
  -------------------------------------------------------------

  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, v1.1, or any v1.1 beta:

Unzip all files from GATE12.zip, over-writing existing Gateway files,
into sub-directory where The Gateway is installed.

Re-run Setup program and verify your IGM settings are all correct.
Edit 3rdparty.dat file to show that IGM is v1.2.
If using LordMenu, update its data files before running LORD game.

All RHP scripts used with The Gateway IGM have to be located in the
same directory the IGM is installed into.

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

Usage in RHP Scripts of @SCRIPTVERSION@ code should work with all
IGM versions.  It is a comment variable that is not executed by the
program, so it is backward-compatible with all earlier versions.

                      Notes on using v1.2 Setup Program:

  Unzip GATE12 archive into Gateway IGM directory.
  Run SETUP.EXE - from where IGM will be executed in normal LORD play.

  The top line in the Configuration Menu screen shows where SETUP.EXE
  is being executed from.  If this is NOT where you intend to run the
  IGM from, in your Lord game, please exit the program and change to
  the correct location at this time. (Then run SETUP.EXE from there.)

  By default, the LORD Path is set for C:\Internet\Lord\.  So change
  both values to what is correct for YOUR system's LORD game.

  After verifying that your Lord Path and other config settings are
  correct, use the Save Changes command.  Then verify your RHP settings
  in Extra Configuration Menu next.  Lastly, use Save Changes again,
  and Exit the SETUP.EXE program.

  Sometimes people end up with duplicate entries in 3rdparty.dat, so
  check file to see if the Gateway IGM is listed properly. That concludes
  Configuration process for a new installation, or for re-installation.
  {New section added 06-06-2003.}
-----------------------------------------------------------------


        [INSTALLATION]
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:
        ===============================
        C:\INTERNET\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 LORD path must be on the first line, and no comments are allowed
unless they are after the registration code line.

You'll notice that I (Jason) 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 `%v1.2

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

This IGM does its own maintenance each day, and does not make
any change to your LORD game's MAINT.BAT file.
=================================================================

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 or
Gateway.dat file names.

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.

=======================================================================
Since they use different file names, you may run The Gateway IGM
in same directory as my LORD IGM "The Forest Outhouse v2.10", if
you wish to do so.  The Forest Outhouse v2.20, to be released in early
November 2003, can also be run from the same directory as The Gateway
v1.2.

Just don't mix/match RHPs from one IGM with those of another IGM.  Ex.
The Gateway IGM can run Pool.rhp, but it can NOT run GemStone.rhp, which
is for The Forest Outhouse IGM.  Donald 11/07/03 Note.
-----------------------------------------------------------------


        [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.

If you wish to exchange registrations for your own LORD IGMs, that
would be fine with me.  However, all of my personal IGMs are
Freeware, so they don't require registration at all.  But like Jason,
I do appreciate being told who is using my IGMs, or my LPEdit
player editor utility.  Which was created by my teacher Charlie
Wardick.  Donald.
------------------------------------------------------------


        [COMING SOON - JASON - From v1.0 IGM]
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.  :)

As of July 2003, Jason has renewed interest in LORD programming.  So
he is making 32-bit versions using C/C++ compiler of the LordStat
and RHPTest utilities.  But neither is available except through Jason,
and both are still in beta status as of this IGM's public release date,
on Nov. 07, 2003. Donald.
------------------------------------------------------------


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

The L.O.R.D. Cavern v1.6  - IGM for LORD 3.25+ -- (CAVE16.ZIP)
         - 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.

         NOTE:  When available, the next official release of The Outlands
                Tavern will be v1.5, using OUTS15.ZIP file name.

RHPTest v1.3     - Utility program for RHP Script writers to use in
(RHPTST13.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.
-----------------------------------------------------------------


                       OTHER CASTLE CAMELOT LORD APPS:]

         See external file CCL-APPS.TXT
===================================================================


        [DISTRIBUTION SITES]      Revised 09/19/2003.
Check out these Internet sites!

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:
----------------------------------
WWW #1:   http://www.fidotel.com/public/camelot/camelot6.htm
          Castle Camelot LORD IGMs Page

          http://www.fidotel.com/public/camelot/igm-beta.htm
          LORD Beta programs d/l page.

          Primary distribution source is the LordApps directory:
          http://www.fidotel.com/public/camelot/lordapps.htm

          Official releases of The L.O.R.D. Cavern, The Gateway, The
          Gem Trader, The Forest Outhouse, The Nice Hag, Outlands
          Tavern, LORD Gambling Casino, and Ruined Castle LORD IGMs;
          and the LordStat, RHPTest, and ChasWare LORD Player Editor
          LORD utilities.

Download URL:  http://www.fidotel.com/public/camelot/Scripts/
         Current releases of L.O.R.D. Cavern RHP Sets #1 and #2,
         Outlands Tavern RHP Set #1, and LADY Script files.
         Forest Outhouse RHP Set #1 scripts are also located here.
         * Only the .ZIP files are available as of 12/04/02.

         To access individual script files, use the Scripts section
         of the Castle Camelot LORD IGMs Page.

WWW #2:   http://www.nightfallgames.com/files/ - See LORD IGMs.
          Hosted by Michael Everett.  Replacement for dead LORD
          Legacy FTP server.

WWW #3/Fidonet:  http://www.filegate.net/camelot/
          Camelot LordNews FDN. - See Lordfile directory.

Fidonet Mail:  use 1:123/450, and post to LORD Echo.  If writing
          using my name, address messages to Donald Tidmore.  You
          can also write to me in Net-Mail.

Email:  donald.tidmore@usa.net or donald.tidmore@fidotel.com
        Use ktidmore@bellsouth.net only if those two do not work.

ICQ:    Belgarion - #238685196.   Checked occasionally.
-----------------------------------------------------------------


        {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.

Thanks to Gary Hartzell for assistance in 2002 with my initial
revision work of The Gateway and Jason's other LORD programs.

If you have any bug reports or comments you can reach me at:
  Email:  jmbrown@pcisys.net - (For Jason)
          ktidmore@bellsouth.net or donald.tidmore@usa.net

  Fidonet:  Use the LORD Echo, or DoorGames echo.  Send mail to
            1:123/450 address, addressed to Donald Tidmore.
------------------------------------------------------------


                         [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.

==================== June/September 2003 Notes:
* June 2003:  Final work on version 1.1a, 1.1b, including
  revision of IGM's configuration data file. Work on RHP Language,
  covering bug fixes, analysis of 3 new RHP Codes.
=====================================================

BBS Testers info:
------------------
1) Gordon Lewicky - Email: glewicky@telus.net.  Sysop Milkyway
   !:153/307,  Milky Way, 1;153/307;  or Fidonet 1:153/0.
   Sysop of Milkyway BBS. in British Columbia, Canada.
   Telnet://milkyway.tzo.com, http://milkyway.tzo.com,
   ftp://milkyway.tzo.com -- Langley, British Columbia, Canada.

2) Michael Everett - Email: sysop@bobobbs.net.
   Sysop of Bobo's BBS.  http://www.bobobbs.net, telnet://bobobbs.net
   Nightfall Games Server: LORD Archives site
      http://www.nightfallgames.com/files/.

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

4) Charlie Wardick:  Email: chasware@cox.net, Phoenix, Arizona, USA.
   http://www.jimmyrose.com/chasware/
   telnet://chasware.thebbs.org:666 - Gutterbowl 2003, D.R.O.L. games.

5) Rob McGee.  Email: robmc@easystreet.com.
   http://x-bit.org - The X-Bit BBS.

6) Joe Kinjin.  Email: kinjin@tampabay.rr.com.  Anime Madness BBS sysop
   http://www.anime-madness.com/

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


        { IGM Support Notice: }
  Since I do not use a Linux-based computer, I can not provide support
  for this program if you are using the LORD/x beta, beyond the normal
  DOS LORD IGM support level.

  As of October 31, 2003, LORD/32 for Windows remains in beta #2.  It
  does NOT support IGM usage.  When it does, and is stable for Local
  Mode usage for people like myself, I will test L.O.R.D. Cavern, The
  Gateway, The Outlands Tavern IGMs;  the LordStat and RHP Toolkit LORD
  utilities;  my LPEdit LORD player editor utility;  and The Gem Trader,
  The Nice Hag, The Forest Outhouse, The L.O.R.D. Gambling Casino, and
  The Pawn Shop LORD IGMs -- to see if any changes need to be made, in
  order to provide Lord/32 support for them.
  ---------------------------------

  In summary, this program may be used with DOS LORD versions and will
  be fully supported.  Limited support may be available eventually for
  LORD/32 users, running my LORD programs. It depends on whether Michael
  Preslar releases details on how IGMs are to interact differently, if
  at all, when they are run by either LORD/X or LORD/32.
==========================================================================


v1.3 Update Plan:
===================
At some point, The Gateway will be recoded to use the A.N.G.E.L. bbs door
tool-kit, instead of DDPlus.  No other IGM changes are planned for this
IGM.   09/11/03.
========================================================================

[END]    11/02/2002 -- v1.1 official release.

         11/07/2003 -- v1.2 official release

Revision Notes -- File updated on:  November 07, 2003.

