              -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
                   LORD IGM: THE LOVE SHACK II   **FREEWARE**
                        Version 2.00  -- DOCUMENTATION

               ** IGM rewrite started on Nov. 14, 2003. **
               ** First version released on Dec. 30, 2003.  **
              -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

AUTHOR:  Donald Tidmore
Email:   donald.tidmore@usa.net or donald.tidmore@fidotel.com (primary)
         gtidmore@hiwaay.net (secondary)
         ktidmore@bellsouth.net (use ONLY if unable to use primary addresses.)

Original Author:  Trevor Herndon (Love Shack v1.40p)

ICQ:     Belgarion - #238685196.  Used occasionally.

Web:     http://www.fidotel.com/public/camelot/camelot5.htm
         Castle Camelot LORD Links Page
         --  http://www.fidotel.com/public/camelot/lordapps.htm
         Castle Camelot LORD Apps Page
         --  http://www.fidotel.com/public/camelot/camelot6.htm
         Castle Camelot LORD IGMs Page

URL:  http://www.fidotel.com/public/camelot/Lordapps/love200.zip
      http://www.filegate.net/camelot/lordfile/love200.zip

Fidonet: 1:123/450
         http://www.filegate.net/camelot/
         Camelot LordNews FDN. Official Fidonet distrbution site.

Address: 1111 Berenice Street, Tuscumbia, Alabama 35674-3503
         United States of America.
=================================================================


-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
1.0  DISCLAIMER:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

The Love Shack II is a rewrite from scratch, based upon template used
from my Gem Trader LORD IGM.  It is (a) an tribute to my friend of
several years, Trevor Herndon, and (b) a new programming challenge
to work on for me.

It is based on Love Shack v1.40p, as much as possible.  I did not try to
do an exact duplicate.  That is impossible to do.  But this new IGM
does work, for the most part, just like Trevor's original program.

IGM History:
------------
v1.00 - Trevor Herndon.  Release date unknown.
v1.10 - Trevor Herndon. Last actual release by him, sometime in 1995.
v1.20 - RTE200 patch update of love.exe and config.exe.
        Released on Trevor's behalf on Sept. 18, 2001.
v1.30 - Docs update.  Released officially on Jan. 21, 2002.
v1.40 - Hex-edit patch update of IGM, by a friend. Unlocked usability
        of the Massage Parlor. Side effect: Sign Registry does not work.
        Released officially March 18, 2003.
-------------------------
v2.00 - The Love Shack II.  Recreated IGM. Released officially by Donald
        Tidmore on Dec. 30, 2003 as tribute to my friend Trevor Herndon.
======================================================================

This is a BBS game written as a hobby.  The only warranty given is
that the program will take up a small amount of disk space on your
computer's hard drive, and will run under all versions of Legend of
the Red Dragon that support IGMs.
=========================

NO OTHER WARRANTY IS HEREBY EXPRESSED, IMPLIED, OR SUGGESTED.
USE OF THIS PROGRAM IS AT YOUR OWN RISK.

THE LOVE SHACK II IS A *FREEWARE* 'IN GAME MODULE' (IGM) FOR LEGEND OF
THE RED DRAGON (LORD).

  LORD (Legend of the Red Dragon) is a multi-player battle game
  created for Bulletin Board Systems (BBS).

     (c) Copyright 1992-1997 Robinson Technologies
     (c) Copyright 1998,1999 (2000-2003) Metropolis, Inc.
     Created by Seth Robinson.  Developed by Michael Preslar.
     All rights reserved.

This IGM is being tested under LORD v4.07 beta
(using the Dec. 04, 2003 compilation).  It has also been tested
by other beta testers using other, older versions of LORD.

No support whatsoever is offered for the IGM's usage under Lord/X
since I have no knowledge of how Linux works.  And Lord/32 at present
does not run IGMs at all, so no support is possible for the IGM in
connection with anything other than DOS LORD.
============================================================


2.0  INTRODUCTION:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  ======================= Program Description/Setting:
  Visit the Love Shack II, the brand new place to party down.
  Players can use IGM up to 8 times per day, depending on value
  selected by sysop during installation.

  Food Menu - Now offers two new meals - "Belgarion's Surprise Chili"
  and "Kiteria's Cheesebuger" - comes with Fries.  Prices are now
  higher than v1.40p IGM used, but all rewards are enhanced to compensate.

  Drink Menu - Same drink names as always.  Prices are now based on a
  variable formula, depending on the drink wanted, and your Game Level.
  All rewards and penalties from getting drinks are level-based as well,
  but are limited sometimes to ensure the player doesn't get too much
  for the amount of Gold paid to the bartender.

  Dates: Some hard to spell names from v1.40p were changed.  Price of
  dates is a standard amount, based on player's game level.  Some special
  dialogue comes into play for four of the dates.  Try them and see what
  it is sometime.  Hints: Two of the babes are ancient gals from history.
  And two of the hunks are also famous.  One from mythology, and the
  other possibly is from another planet.

  Massage Parlor - You can either visit the Master, who is the Old Man
  from the Forest;  or you can visit the Therapists.  Male players get
  to visit Violet.  Female players see Archon the Bard.

  IGM does not try to keep track of whether Violet is married or not.
  Neither does it do penalties for married players getting laid by
  any characters in the IGM.

  Sign Registry - does not work on my system using v1.40p.  Will be
  restored to IGM in next version, sometime in early 2004.

  Stats screen - Shows most of the Lord stats one usually wants
  to know about, including actual numbers for Skill Points.

  IGM Usage Reports:  One is shown at present to all players, and
  includes data on who has Bought Food, Bought Drinks, or Bought
  Dates during the day, and their Visits today.  Other report is
  available only to the end-user/sysop.  It only tracks Player's
  LORD Name and their IGM Visits.

  ATM Service:  Make Gold deposits or withdrawals.

  If you are at the bar, and run out of money, you can dash on
  over to the ATM from the Bar.  And while at the Bar, if you decide
  you are hungry, you can scoot straight over to a Table.  Likewise,
  after buying a meal, you may scoot directly over to the Bar also.

  Love Shack II -- Configuration Process:
  ======================================
  1) Run LSHACK Config.  Follow on-screen instructions.

  -- Max Visits per Day.  Range is 1-8, default is 2.
  -- Sysop's Lord name - Needed by code governing displaying
     the List Customers screen during IGM exit.

  -- The IGM's 3rdparty.dat entry should look like this, minus LORD
     Color codes:            THE LOVE SHACK II v2.00

  -- Always double-check the values in LSHACK.DAT to be sure you
  are using the correct values for each LORD game you have, if there
  is more than one.
  ====================================================================

  Configuration Change:
  Run LSHACK CONFIG.  Answer the prompts to change either Sysop Handle
  or Max Visits per Day fields.

  IGM Removal:
  Run LSHACK REMOVE and follow the on-screen instructions.

  Brand new installation:
  This igm is stand-alone from the original Love Shack IGM.  I've
  chosen filenames that make logical sense for this particular igm.

  Like Gem Trader, it is designed to work with other Lord IGMs in
  the same directory though - provided there is no filename conflicts.

  IF any other IGM, none of which I am aware of, uses one or more of
  these files -- LSHACK.DAT, LOVE-USE.TXT, and SHACKUSE.DAT --, this
  IGM *MUST* be installed in its own directory to work correctly.

  Run LSHACK INSTALL and follow the instructions shown on-screen.
  Verify entries made to 3rdparty.dat and lognow.txt files.
  Then start playing LORD with the IGM.
  ===============================================================

3.0  FILES:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
The following files are included within THE LOVE SHACK II archive:

LSHACK   DIZ     1094  12-30-03  The Love Shack II DIZ file
LSHACK   EXE   255632  12-30-03  The Love Shack II v2.00 IGM
LSHACK   TXT    23478  12-30-03  The Love Shack II - IGM documentation

FILE_ID.DIZ  - Description file (LSHACK.diz)
CCL-APPS.TXT - Info on all of my LORD Programming projects.
LOVEREPT.BAT - Runs LSHACK REPORT command for sysop user.

* - Files created during IGM installation, or after each usage in LORD:
=======================================================================
* LSHACK.DAT -   Created by IGM when it is installed.  Stores LORD Path,
                 IGM path, Sysop Name, Sysop Handle, BBS Name, and
                 Max Visits/Day fields.

* LOVETIME.DAT - Used to keep track of change in Day, Month or Year,
                 so IGM knows internally when to reset its data files
                 for a new day's game usage.

* SHACKUSE.DAT - Binary player database. Tracks all activity
                 inside IGM by every player.

* LOVE-USE.TXT - Disk file listing content of SHACKUSE.DAT.
                 Created automatically when IGM is used by sysop or
                 the end-user.  Created when LSHACK REPORT command
                 is entered from DOS Prompt.  Req'd: SHACKUSE.DAT file.
====================================================================


4.0  INSTALLATION:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
    1. Unzip LOVE200.ZIP into a LORD sub-directory, or into main
       LORD directory.  As long as no other IGM uses LSHACK.* name,
       or any of the data file's names, it will co-exist with other
       LORD igms without any problem. The Docs files can be renamed,
       if needed, if there is any file-name conflict.  *But Love-use.txt
       and the .DAT files can NOT be renamed.  They are hard-coded inside
       the IGM.

         http://www.fidotel.com/public/camelot/LordApps/love200.zip

    2. From DOS Prompt, type:  LSHACK INSTALL

       Follow on-screen instructions, and IGM will be installed into
       your LORD game.  IGM announces itself in lognow.txt, and adds
       its entry lines to 3rdparty.dat.  That concludes installation.

    3. If using LordMenu utility, remember to re-run Lordmenu.exe and
       update the 3rdalt.txt menu file.  Otherwise, when you enter
       LORD you would not see an entry to run THE LOVE SHACK II v2.0x from
       in the Other Places Menu screen.

                                IGM Removal:
    1. Change to where you installed the IGM.  Type: LSHACK REMOVE
       Follow instructions, and IGM will be removed from 3rdparty.dat,
       and the LSHACK.dat file will be deleted.

    2. Delete the IGM's files unless you think you may want to keep
       them around.  That concludes IGM removal process.  Also delete
       files like LOVETIME.dat and SHACKUSE.DAT, unless you think you'll
       re-install the IGM at a later time.
===================================================================

Minus LORD color codes, which in general I personally don't use much
myself - or I tweak to my own favorite colors, - this is what the IGM
command lines in 3rdparty.dat should look like.  Each person installs
programs their own way, so your directory path will usually be different:

C:\INTERNET\LORD\SHACK\LSHACK.EXE /N* /GC:\INTERNET\LORD
THE LOVE SHACK II v2.00

(The actual description entry in 3rdparty.dat will contain LORD
color codes.  The codes can be changed to your own preference. )

----------------------------------------------------------------------
Note:  While using this IGM, you may NOT rename any of these files:
       LSHACK.DAT, LOVETIME.DAT, SHACKUSE.DAT, LSHACK.EXE, and
       LOVE-USE.TXT.

       Renaming files will result in IGM usage problems, or keep the
       IGM from working at all.  Plus, doing so is a violation of the
       conditions for obtaining technical support.  I do not promise
       to provide support to people who disregard these directions.
======================================================================

LordMenu information:  To acquire LordMenu v1.30 LORD utility, contact
me via Email.  Or contact Lloyd Hannesson at dasme@dasme.org.  Program
may also be downloaded via web browser from his web-site.
    http://www.dasme.org/techn/index.php

It is also available from various other sources on the Internet,
such as http://www.filegate.net/camelot/lordfile/.

Specific URL:  http://www.dasme.org/techn/files/lrdmnu13.zip
    LordMenu was created by Robert Fogt, and turned over through me
    to Lloyd in early 2002.  Who provides all support for it.

    (2) http://www.fidotel.com/public/camelot/LordApps/lrdmnu13.zip
===============================================================

REQUIREMENTS:
  1. Any version of LORD that supports IGMs.   Testing is being done
     solely with LORD v4.07 beta - but will be used by other beta
     testers using other LORD versions.

  2. DOS 6.x or later versions.  Probably works with DOS v3.xx forward
     as well, but I can't say for sure.

  3. IGM is usable whether LORD is registered or not, as currently
     written.
------------------------------

TESTING:  Done under Microsoft Windows Millenium Edition.
================================================================


5.0  DISTRIBUTION/UPDATES/REVIEWS:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
1. http://www.fidotel.com/public/camelot/camelot6.htm
   Castle Camelot LORD IGMs Page.

   http://www.fidotel.com/public/camelot/lordapps.htm
   Castle Camelot LORD Apps page

   http://www.fidotel.com/public/camelot/igmpage.htm
   Revamped Trentsoft LORD IGMs Page

   http://www.fidotel.com/public/camelot/Lordapps/love200.zip

2. http://www.filegate.net/camelot/lordfile/
   Camelot LordNews FDN - Lord Files directory.

3. Fidonet #: 1:123/450 - Donald Tidmore, updater.

4. http://www.nightfallgames.com/files/ - Michael Everett's
   new LORD Archive web-site.  New primary source for all LORD
   programs that I have in my Lord programs collection.

5. ICQ Shared Files.  I keep current copies of dgt-lady.zip, and
   archives for my LORD IGM/utility programs in the ICQ directory.
   As long as I'm online, and you have Shared Files activated, you
   can download files from my system.

   If something is listed as BETA, check with me before installing it.
   Some new compilations aren't tested right away, and might not work
   properly.
======================================================================


6.0  FEATURES:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
    User may do the following in Love Shack II IGM.

    -- View current LORD stats upon IGM exit.
    -- Buy one Meal per day.
    -- Buy one Drink at the bar per day.
    -- Obtain one Date per day.
    -- The Massages:  Whether you use the Master or the Therapists,
       you only get ONE massage a day.
    -- Use ATM service to deposit/withdraw Gold.

    You can make repeat visits to the IGM but once an igm feature is
    used, it is off-limits to you until the next day.

    Note: Stats screen gives accurate reporting of Skill points and
    Skill use points when they exceed 40, unlike LORD itself. If a
    Skill is 40+ points, the word (MASTERED) is shown beside it.

Limitations:
  1.  Per day, you are limited to between 1 and 8 visits, depending
      on what the sysop/user chooses for Max Visits variable.
=======================================================


7.0  SPECIAL THANKS TO:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Gordon Lewicky  - He taught me most of what I know about LADY Script
                  programming, and has done diagnostic work on all of
                  my complex LADY Scripts when they had glitches.
Jason Brown     - For entrusting me with his LORD IGMs and utilities
                  as their co-author, maintainer, and updater.
                  Also for several long years of LORD friendship.
Charlie Wardick - My primary programming teacher.  For over a year
                  of training in how to write LADY scripts in a
                  logical manner, and then in relearning Pascal
                  language and usage of Turbo/Borland Pascal.
Chris MacPherson - For entrusting me with update of his Pawn Shop IGM.

And to all of my other friends who have gone through my evolution
as a LORD games programmer since February 2002, by testing my new
Lady scripts, and LORD IGM/utility beta compilations, over those
many months.  Oh yeah, and most of all, for putting up with my
tendency to write occasionally LONG email messages to them <G>.
==================================================================

Beta Testers:  Gordon Lewicky, Michael Everett, Paul Koukos, Jason
         Brown, Joe Kinjin, Charlie Wardick, Chris MacPherson, and
         Rob McGee.  And a few others here and there.
==================================================================


8.0  DEDICATION:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
This IGM is dedicated to my friend Trevor Herndon, who created the
original Love Shack IGM many years ago.
==================================================================


9.0  RELEASE INFO - Trevor's original IGM:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
* Love Shack v1.00 - no data known on Trevor's first release.

* Love Shack v1.10 - 1995 release by Trevor Herndon.

* Love Shack v1.20 - RTE200 patch update.  Released in Sept. 2001.
    Release done on Trevor's behalf.

* Love Shack v1.30 - Docs update - Released January 2002.
    Officially approved re-release of the RTE200 patch.

* Love Shack v1.40p - Released for Trevor Herndon March 18, 2003.
     Hex-edit patch that made the Massage Parlor feature fully usable.
     Done with Trevor's permission.  Supported by myself for Trevor.
     Note: Sign Registry component does not work with this version.
==================================================================

The original Love Shack IGM was created by Trevor around 1995 using
DDPlus v7.1 and Borland Turbo Pascal v7.0.  Due to theft of his
computer system and computer files in 1998, Trevor Herndon is unable
to provide any support or registrations for his LORD programs today.

All of them are fully usable to varying degree now, on modern Pentium
II+ based systems, after being RTE200-patched in 2002 by myself, with
Trevor's permission and authorization.

----------------------------------------
Love Shack II is designed with the following programming software:
   Borland Pascal v7.01, ChasWare Library Routines by Charlie Wardick,
   The Atlantis Networking Game Library v1.00 by Jimmy Rose, and
   portions of Techno's TurboJock Toolkit -- used in the IGM's Config
   functions.
===================================================================


10.0               CASTLE CAMELOT LORD Apps:          {12/30/2003}
                   - See the enclosed CCl-APPS.TXT file.

    Summary listing of my Current LORD program release versions:
    ------------------------------------------------------------
LORDST17.ZIP  - LordStat v1.7.    LORD Utility by Jason Brown.
    http://www.fidotel.com/public/camelot/Lordapps/lordst17.zip

OUTS14.ZIP    - The Outlands Tavern v1.4.  LORD IGM by Jason Brown.
    http://www.fidotel.com/public/camelot/Lordapps/outs14.zip

CAVERHP1.ZIP - The LORD Cavern RHP Set #1
    http://www.fidotel.com/public/camelot/Scripts/caverhp1.zip

CAVERHP2.ZIP - The LORD Cavern RHP Set #2
    http://www.fidotel.com/public/camelot/Scripts/caverhp2.zip

CAVERHP3.ZIP - The LORD Cavern RHP Set #3
    http://www.fidotel.com/public/camelot/Scripts/caverhp3.zip

DGT-LORD.ZIP - Belgarion's LORD IGMs Play Guides.
    http://www.fidotel.com/public/camelot/dgt-lord.zip

DGT-LADY.ZIP - Belgarion's LORD Lady Scripts v1.47.
    http://www.fidotel.com/public/camelot/Scripts/dgt-lady.zip

OTRHP1.ZIP - The Outlands Tavern RHP Set #1 v1.16
    http://www.fidotel.com/public/camelot/Scripts/otrhp1.zip

LPEDIT10.ZIP - ChasWare LORD Player Editor v1.00. -- LORD Utility.
    http://www.fidotel.com/public/camelot/Lordapps/lpedit10.zip

FORHP1.ZIP - The Forest Outhouse RHP Pack v1.00
    http://www.fidotel.com/public/camelot/Scripts/forhp1.zip

RUIN20.ZIP - The Ruined Castle v2.00 LORD IGM.
    http://www.fidotel.com/public/camelot/LordApps/ruin20.zip

LORDGC21.ZIP - LORD Gambling Casino v2.10 LORD IGM.
    http://www.fidotel.com/public/camelot/LordApps/lordgc21.zip

HAG214.ZIP - The Nice Hag v2.14 LORD IGM.  (Official Release)
    http://www.fidotel.com/public/camelot/LordApps/hag214.zip

CAVE16.ZIP - The L.O.R.D. Cavern v1.6 LORD IGM.  (Official Release)
   -- http://www.fidotel.com/public/camelot/LordApps/cave16,zip

GATE12.ZIP - The Gateway v1.2 LORD IGM.  (Official Release)
   -- http://www.fidotel.com/public/camelot/LordApps/gate12.zip

OUTH220.ZIP - The Forest Outhouse v2.20 LORD IGM.  (Official Release)
   -- http://www.fidotel.com/public/camelot/LordApps/outh220.zip

RHPTST13.ZIP - The RHP ToolKit v1.3 LORD Utilities.  (Official Release)
   -- http://www.fidotel.com/public/camelot/LordApps/rhptst13.zip

FORHP1.ZIP - The Forest Outhouse RHP Pack v1.05 -- 11/08/2003 release
    http://www.fidotel.com/public/camelot/Scripts/forhp1.zip

GEMTR220.ZIP - The Gem Trader v2.20 LORD IGM. (Official Release)
    http://www.fidotel.com/public/camelot/LordApps/gemtr220.zip

PAWN300.ZIP - The Pawn Shop v3.00 LORD IGM. (Official Release)
    http://www.fidotel.com/public/camelot/LordApps/pawn300.zip

PAWN310.ZIP - The Pawn Shop v3.00 LORD IGM. (Official Release)
    http://www.fidotel.com/public/camelot/LordApps/pawn310.zip

LOVE200.ZIP - The Love Shack II v2.00 LORD IGM. (Official Release)
    http://www.fidotel.com/public/camelot/LordApps/love200.zip
    -- v2.00 was officially released on Dec. 30, 2003.
=========================================================================


11.0  SUMMARY
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Your comments, questions, suggestions are welcome and appreciated.  I'd
like to know that people are actually using my IGM. :)  I've put a lot
of work into it and I hope it is appreciated.
    -Donald Glenn Tidmore
======================================================================


IGM Crashes:  If you experience a crash while using the IGM, please
send me a capture log of your BBS session which most comm programs
and Telnet clients are able to generate.  Zip it up in an archive
using Winzip, PKzip or some other ZIP-compatible utility, and send
it to me at donald.tidmore@fidotel.com (or ktidmore@bellsouth.net).

Also include copy of the IGM's data files such as SHACKUSE.DAT.  Copies of
the LORD game's play*.dat files, if included, will help with analyzing what
caused your IGM crash.  Please also send your LORD game's ERROR.LOG file if
it records error messages created by Love Shack II.

When trying to identify cause of a problem, there is no such thing as
too much info to study.
=======================================================================

LSHACK.txt -- End of documentation.

Created Lshack.txt, on Nov. 15, 2003, using Gemtrade.txt as template.

Updated on December 30, 2003.


