              -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
               LORD IGM: Love Shack II   **FREEWARE**

               Version 2.20  -- DOCUMENTATION

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

               ** Second version released on March 21, 2005. **

               ** Compile Date:  March 21, 2005. **
              -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

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

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/love220.zip
      http://www.filegate.net/camelot/lordfile/love220.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.
---------------------------------------------------------------

IGM is based on Trevor Herndon's Love Shack v1.40p IGM.

-==============================================================


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

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 - Love Shack II.  Recreated IGM. Released officially by Donald
        Tidmore on Dec. 30, 2003 as tribute to my friend Trevor Herndon.

v2.20 - Love Shack II.  Update released officially on March 21,
        2005.  New features: Automatically detects and fixes any
        negative LORD stats at IGM entry, and at IGM exit.  Player
        database covers 7 more LORD stats.  IGM now has two usage
        reports.  Added a Sign Registry event. Added an ANSI screen
        file.  Added Super Special Massage Event.

        Actual IGM title used in v2.00 was "The Love Shack II".  I have
        dropped "The" from the title for version 2.20. 03/20/05 Note.

        Status bar will now show "Love Shack II v2.20" during IGM usage.
======================================================================


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.

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-2005) Metropolis, Inc.
     Created by Seth Robinson.  Developed by Michael Preslar.
     All rights reserved.

This IGM was tested under LORD v4.07 beta (using the Dec. 04, 2003
and Sept. 08, 2004 compilations).  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 - Includes two new meals that I created:  "Belgarion's
  Surprise Chili" and "Kiteria's Cheesebuger" - which comes with
  French Fries.  Prices are higher than Love Shack v1.40p used, but
  all rewards, and some losses, 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 Love Shack 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 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.
  There are some additional adventures available if you are
  studying Thieving Skills.

  IGM does not give a player married to Violet special privileges,
  when they get a massage from her.   There are no penalties for
  married players who get laid by characters in the IGM.

  Sign Registry - Added to Love Shack II on Feb. 19, 2005.

  ANSI screen - Added to Love Shack II in February 2005.  Based
  on the original IGM's ANSI, modified by me using TheDraw. Thanks
  to Stephen Gibbs for polishing and cleaning up the ANSI file.

  Stats screen - Shows most of the Lord stats one usually wants
  to know about, including actual numbers for Skill Points.
  Reports user's status as to whether they've been Laid, had a
  Drink yet, had Food yet, or had a Massage yet.

  IGM Usage Reports:  They are shown at IGM Exit to all players,
  and they include data on who has Bought Food, Bought Drinks, or
  Bought Dates during the day, and their Visits today.  The Usage
  Reports disk file (LOVE-USE.TXT) is available only to the
  end-user/sysop, and can be best accessed using the LSHACK REPORT
  command.

  The second usage report covers Experience Points, Max Hit-Points,
  Strength Points, Defense Points, Charm Points, Forest Fights, and
  regular HitPoints.  The LOVE-USE.TXT file is updated to contain
  both of these IGM usage reports, as of Feb. 12, 2005.

  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 that you are hungry, you can scoot straight over to a
  Table.  Likewise, after buying a meal, you may scoot directly
  over to the Bar.


  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:       Love Shack II v2.20

  -- During installation, you will be asked if you want to have
     the version data in the 3rdparty.dat entry for the IGM.

  -- 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 Sysop Handle
  and/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
  specific igm.  Like my Gem Trader IGM, it is designed to work
  in a directory shared with other IGMs.  You can also run it
  from the LORD directory.

  If there is another IGM that has any files that Love Shack II
  uses, you have to keep the two IGMs in separate directories.
  All of the filenames used by this IGM are hard-coded into the
  IGM and they can not be changed by the user.

  These files are mandatory - You must have them in order to use
  the IGM.  LSHACK.DAT, LSHACK.EXE.  To use LOVE-USE.TXT, you must
  have a SHACKUSE.DAT file.  LOVETIME.DAT and SHACKUSE.DAT are
  created automatically when the IGM is used in a LORD game.

  The IGM handles maintenance at the start of each new game day
  internally, and does not use LORD's maint.bat file.


  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.


  Notes added 02/03/05:
  -----------------------
  Regarding usage of the dialog boxes.  The simplest way to use
  them is that pressing ENTER key accepts the data you have written
  say for the BBS name question.  You can also use your mouse to
  click on the YES or OK buttons.  Lastly, you can use ALT+Y
  keys to answer a Yes/No prompt affirmatively.  You can use ALT+N
  similarly to answer No to a question prompt.

  The install process is set up now to ask you if you want to have
  version data included in the 3rdparty.dat igm entry lines.

  If you say YES, the IGM name line will look like this:

  `!Love Shack II `0v2.20

  If you answer NO, then it will simply say:  `!Love Shack II

  As noted elsewhere, you can change the LORD color codes to
  your own preferences, or remove them entirely.  But you will have
  to do that yourself manually using a program like Qedit or Wordpad.
  ===============================================================


  Seven player database variables were added to the IGM on
  February 12, 2005.  IF for some reason, you are updating from
  an older IGM release (2.00) or one of the beta versions, you
  will need to delete SHACKUSE.DAT before you re-run the IGM
  again in LORD.  The database file deletion only has to be
  done one time.  Do not use LSHACK REPORT until after a new
  player database file has been created in a LORD IGM session.
===============================================================


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

Unzip all files inside LoveWork.zip to get these files:

LOVE2    ANS   Love Shack II's ANSI file
LSHACK   DIZ   Love Shack II DIZ file (same as File_Id.diz)
LSHACK   EXE   Love Shack II v2.20 IGM
LSHACK   TXT   Love Shack II documentation (this file)

FILE_ID.DIZ  - Description file (LSHACK.diz)
CCL-APPS.TXT - Info on all of my LORD Programming projects.


* - Files created during IGM installation, or after each usage
    in a LORD IGM session:
=======================================================================
* LSHACK.DAT -  Created by IGM when it is installed.  Stores the
                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.

* LSREGIST.TXT - Text file containing IGM's new Registry.  Users will have
                 their LORD name and a 50-space comment on each registry
                 entry line.  File does not use Lord Color codes.

Note: If you still have the old loverept.bat batch file you can
delete it.  It is no longer needed by this IGM.
====================================================================


4.0  INSTALLATION:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
    1. Unzip LOVE220.ZIP into a LORD sub-directory, or into main
       LORD directory.  As long as no other IGM uses LSHACK.*
       file names, or any of the IGM's 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, LoveTime.dat,
       Lshack.dat, and Shackuse.dat files can NOT be renamed. They
       are hard-coded inside the IGM, and can not be changed by the user.

       http://www.fidotel.com/public/camelot/LordApps/love220.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 its data files, such as 3rdalt.txt.  Otherwise, when
       you enter LORD you would not see an entry to run THE LOVE
       SHACK II v2.20 in the Other Places Menu screen. (Or it might
       still show an older version was in use.)


                                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 I sometimes don't use in 3rdparty.dat,
or I change to different colors occasionally, this is what the IGM command
lines should look like.  Each person installs programs their own way, so
your directory path will probably be different:

C:\INTERNET\LORD\SHACK\LSHACK.EXE /N* /GC:\INTERNET\LORD
Love Shack II v2.20

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


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.  Nothing in the IGM will EVER change the status of
     your LORD registration.
------------------------------

TESTING:  Done under Microsoft Windows Millenium Edition, and
          under Microsoft Windows XP Home, SP1.
================================================================


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/love220.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.

I quit using ICQ in early 2004.  Under Microsoft Windows XP, I
found the program was too annoying to easily tolerate having it
around.  It kept adding itself to the Taskbar and doing other
things that I got tired of.
===============================================================


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.

    Unless the IGM is configured for ONE use/day by the sysop or
    end-user, you may make repeat visits to the IGM.  Once an event
    has been used, it is not usable again until the next LORD game
    day.

    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.

    The IGM will automatically repair any negative LORD stats it
    finds in the player's LORD record data during IGM entry and
    IGM exit processes, notifying the player as to which LORD
    data fields were fixed.

    Sign Registry:  End-user/sysop will need to manually trim
    the number of entries in the file occasionally.  Code is
    set up to display the entire file on multiple screens, as
    needed, as of 02-19-2005.

Limitations:
  1.  You are limited to between 1 and 8 visits per day,
      depending on what the sysop/user chooses for the IGM's
      Max Visits/Day configuration 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.

Stephen Gibbs - For assistance with my work on this IGM, and with
                the Hiding In the Shadows and Turgeon's House IGMs.

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,
         Rob McGee, Stephen Gibbs, and Daryl Stout.  And a few
         others here and there including Russell Tiedt.
===============================================================


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:

                   - See the enclosed CCl-APPS.TXT file.

A copy is kept on the Castle Camelot web-site, but is not always
completely up-to-date.

    http://www.fidotel.com/public/camelot/ccl-apps.txt
====================================================================


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 data files such as the play*.dat files,
if included, will help with analyzing what caused your IGM crash.

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

If you get a RunTime Error Message, send me a JPG screen snapshot
showing what it records.  If it refers to the player database
file, you can resume using the IGM normally after deleting the
shackuse.dat data file.

Do NOT ever run the IGM with any of its data files
write-protected.  That will definitely cause an IGM crash.
=======================================================================

LSHACK.txt -- End of documentation.

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

Copyright 2003-2005. Donald Glenn Tidmore. Castle Camelot LORD Apps.

Revised on:    March 21, 2005 at 12:48 am.

