           Turgeon's House v4.00 - Legend of the Red Dragon IGM.

           Intended for use ONLY with DOS LORD v3.xx/4.xx.

           v3.20: Officially released Jan. 05, 2004.
           v3.30: Officially released July 14, 2004.
           v3.40: Officially released on Dec. 01, 2004.
           v4.00: Officially released on March 21, 2005.
           ===================================

           Compile Date:  March 21, 2005
           ==============================================

           Maintained by Donald Tidmore, Castle Camelot Lord Apps.
           http://www.fidotel.com/public/camelot/camelot5.htm
           Tested under LORD v3.55 and v4.07 beta.

           Created by Mike Ciesiensky, Ski Software.
             v3.00 released in April 2002 on Mike's
             web-site:  http://crystalcore.net/skisoft/.

           Primary testing was done using LORD v4.07 beta,
           on my 2.4 Ghz system running Microsoft Windows XP.
           ------------------------------------------------------


[0.0] *** TABLE OF CONTENTS ***

         -=< 0.0 >=- Well, you're here

         -=< 1.0 >=- Special Thanks to:
         -=< 2.0 >=- Technical Stuff
         -=< 3.0 >=- Turgeon's House Files Listing
         -=< 4.0 >=- Installation + Upgrading
         -=< 5.0 >=- Turgeon's House File Notes
         -=< 6.0 >=- Something's Wrong!
         -=< 7.0 >=- Registration
         -=< 8.0 >=- Other -SKI- Software Releases
         -=< 8.5 >=- The Random Events, Visits/Day Info
         -=< 9.0 >=- Future Updates Scheduled
         -=< 9.5 >=- Handling IGM Crashes and Glitches 

         -=< S.S >=- Contacting the Author, or Chris

         -=< C.C >=- Castle Camelot Lord Apps Notes

----------------------------------------------------------
Note: For IGM History, see the TurgHist.txt file.
================================================================


[1.0] ---=== SPECIAL THANKS TO: ===---

         -*> My Lord and Saviour who gave me all my talents and abilities!
         -*> Seth Able for making <L>egend <O>f the <R>ed <D>ragon!
         -*> Joseph Masters for giving his source file to Aragorn's Timer
             with his Freeware Program and letting others use his routines!
         -*> Bob Dalton + Steve Lorenz releasing DDPlus 7.1
         -*> Donald Tidmore for his helping with this release!
         -*> You for downloading it!
================================================================


[2.0] *** TECHNICAL STUFF ***

  --- The original Author: Ski Software - Mike Ciesiensky.

      IGM is updated and maintained by Donald Tidmore.
      Castle Camelot Lord Apps.

  --- The User: You, or players using the IGM on your BBS or Telnet web-
      site.

  --- This game has been extensively tested through many different
      procedures and circumstances to insure that no harm or damage may be
      caused to the system running Turgeon's House or systems connected to
      a system running Turgeon's House.  Nevertheless, the author SHALL NOT
      and WILL NOT be help liable for anything and everything that may
      happen to systems running this program or systems connected to that
      system.  To the author's knowledge no serious harm will be caused,
      but we can not guarantee that.

      The Sysop and User will assume full responsibility for the correct
      usage of this product no matter what the outcome will be.  May the
      Force be with you.

  --- The game program, support files, and documentation are copyrighted
      products of the Author.  The Author reserves all rights to these
      products and is protected by the United States of America (USA) and
      International Copyright Laws. In no way shall the components of the
      game software package be reproduced or modified in any form or method
      without prior expressly written permission from the Author.

  --- Tampering with or altering the contents or integrity of the game
      software package is prohibited. No fee may be charged by any agency
      other than the Author beyond the cost of distributing copies of
      Turgeon's House without prior expressly written permission from the
      Author.

  --- A major portion of this software comes from the DDPlus Door Driver
      Package and was written by the authors of that package. The DDPlus
      Door-driver kit has been used for the communications, interrupt
      handling and some utility functions and that part of the software
      remains copyrighted by the authors of the DDPLUS Package.
================================================================


{3.0} *** Turgeon's House Files Listing:

CCL-APPS TXT    Castle Camelot LORD Apps info file

THOUSE4  EXE    Turgeon's House LORD IGM
THOUSE4  TXT    Turgeon's House documentation
THOUSE4  DIZ    File_ID diz for IGM

=============   Created/Updated during IGM usage:
  TURGEON  DAT    IGM Config file
  TURGTIME DAT    Time/date use file (Binary)
  TURGPLAY DAT    IGM Player Database (Binary)
  TURG-USE TXT    IGM Usage Reports disk file (Text)
                  Contains two usage reports.

Note: Please do NOT use LORD color codes in ANY field
      in the TURGEON.DAT igm configuration file.
================================================================


[4.0] *** INSTALLATION + UPGRADING***

    ** READ THIS!!!! **  Player Database Change: 03/21/05
    ======================================================
    As of March 21th, 2005, Turgeon's House will now be
    usable by all players up to FIVE times per day.

    Once an IGM event has been used it can NOT be used
    again until the next LORD game day.

    The player database was updated with nine more variables,
    which will prevent re-usage of an IGM event once it has
    been used.  IOW, you will be able to re-enter the igm
    multiple times, but can only eat Food in the kitchen ONCE.

    The TURGEON.DAT igm configuration file now has SIX lines.
    The last line is Max Visits/Day.  It may be set by the
    sysop/end-user to any value between 1 and 5.  Any other
    values will be rejected by the IGM.

    After you update to version 4.00, you should delete your
    old TURGPLAY.DAT file *IF* you have used the IGM previously
    on the day that you are doing the IGM update.  Otherwise,
    the normal daily maintenance will take care of the player
    database file deletion as usual each day.

    DO NOT try to use THOUSE4 REPORT command until you have used
    version 4.00 and have created a new player database file. If
    you do, with an older database file, the IGM will not work
    properly and will crash with an Run-Time Error message.
    -----------------------------------------------------------

    Turgeon's House v4.00 does not use ANY data file which was
    in use by earlier versions.  All older data files can, and
    should, be deleted from your IGM directory during the new
    installation.

    Turgplay.dat and Turgtime.dat replaced the old thmaint.dat
    file.  And Turgeon.dat replaced the old thouse3.cfg file.
    Both of those old files can be deleted.  The structure of
    turgeon.dat and thouse3.cfg are NOT compatible with each
    other.      End of notes.
    ============================================================


      1) Unzip THOUSE40.ZIP into a LORD subdirectory overwriting all
         existing igm files from prior official/beta versions.

         The IGM can also be run from the main LORD directory. None
         of the IGM data files will conflict with LORD data files,
         except for the igm's file_id.diz data file.

         1-A)  v3.30/v3.40 Note: The previous Turgeon's House
         releases are not usable on a BBS unless the IGM is
         installed and accessed from the LORD directory. The
         IGM has to have direct access to LORD's node*.dat files,
         or it will simply not run when used remotely from a BBS.

         What does that mean? Simply that those two versions do not
         work properly on a BBS if igm is not running from the LORD
         directory.  A glitch in the DDPlus tool-kit is hard-coded
         to look only in the current directory for the BBS's node
         dat files, and if it does not find them, the IGM quits working
         and returns players back to LORD's Other Places menu.

         Solution: Update to version 4.00 of Turgeon's House.
       -------------------------------------------------------------

      2) Follow these instructions:

               [ INSTALLATION - Using THOUSE40.ZIP: ]

         - Unzip the IGM files into the LORD Directory or into
           a sub-directory under the LORD game.  Overwrite any
           pre-existing IGM files if you are using a beta version.

         - If updating from version v3.xx, all of the old IGM
           data files can be deleted, such as thouse.exe and
           thmaint.dat.

         - From the DOS C:\ prompt, type: THOUSE4 INSTALL and
           press the ENTER key.

         - Answer all of the installation questions which are
           shown in dialog window boxes.  You will be asked for
           your First and Last names, your Sysop Handle, your
           BBS/Web-site Name, the LORD directory path, and the
           Turgeon's House IGM directory path.

         - The program will update the 3rdparty.dat file and
           lognow.txt file, then tell you when it is finished
           with installation.  Exit program at that time.

         - You can use a mouse with the dialog boxes after
           you have typed in the information the IGM asks for.


               [ CONFIG Update - Using THOUSE40.ZIP: ]
         - At this time, as of v4.00, you may change Sysop
           Handle and Max Visits/Day settings, using the CONFIG
           command.  When you are prompted, tell the program
           what you want to use for either field.  The IGM will
           not allow you to enter a value greater than 5 for
           Max Visits/Day.


               [ UN-INSTALL - Using THOUSE40.ZIP: ]
         - Respond to the dialog boxes and the IGM will
           un-install itself.  Some IGM data files will be
           auto-deleted, and you can delete the other Turgeon's
           HOUSE files manually if desired afterwards.


               [ USAGE REPORTS - Using THOUSE40.ZIP: ]
         - Currently the IGM creates one IGM Usage Report,
           or updates it, after each IGM usage.

         - From DOS, when the IGM is NOT running in LORD,
           type THOUSE4 REPORT and wait a few seconds. The
           IGM will update the Usage Report file (Turg-use.txt)
           and then display it on-screen.

    ============================================================

    [ UPGRADING: IN LORD DIRECTORY - or in IGM directory ]
      - Change to the appropriate directory.  Unzip files from
        the THOUSE40.ZIP or THOUSE40.ZIP archive, using overwrite
        mode.

      - TYPE THOUSE4 INSTALL at the DOS Prompt.  Since all of the
        IGM data files are new ones, you have to use the INSTALL
        command to install the IGM.

      - Follow on-screen directions, and you will be finished quickly.

      - It is always a good idea to visually verify your 3rdparty.dat
        file after installing or uninstalling this or any other IGM.

      - You are now Finished!

      - Your new Configuration file is named Turgeon.dat.
      - The IGM Player database file is named TurgPlay.dat.
      - The IGM time/date use file is named TurgTime.dat.
        It is what determines whether the IGM does new game
        day processing when a player enters the IGM from LORD.
      - The IGM Usage Reports file is named Turg-use.txt.

        The IGM does not write any of its data files in the LORD
        directory, unless that is where you installed it.
        ----------------------------------------------------

      - The IGM's entry lines written to your 3rdparty.dat file are in
        this fashion.  Alter Lord color codes to your own preference.

C:\INTERNET\LORD\TURGEON\THOUSE4.EXE /N* /Gc:\internet\lord
`0Turgeon's House `!v4.00
================================================================


[5.0] *** TURGEON'S HOUSE FILE NOTES ***

      - Turgeon's House changes users stats in the 'Player.Dat' file.
        There is always a chance of a screw-up, so backup often.

      - LORD has been known to sometimes corrupt its own data files,
        including player.dat.  So it just makes sense to periodically
        make backups of important data files.

      - Under no circumstance, does this IGM EVER change your
        LORD registration status. LORD v4.07 beta's 2004
        compilations have a nasty habit of forgetting that a LORD
        game has been registered, either during Daily Maintenance,
        or after an IGM has been used.  I have been unable to get
        any 2005 compilations, so I can't say if the problem has
        been fixed, as of late March 2005.

      - Turgeon's House has been extensively tested through many
        different Procedures and Circumstances.

      - If the player catches a Fairy in the closet, the IGM will update
        the temporary INFO.<node-num> file that LORD passed to it.

      - As of Feb. 12, 2005, if a player enters the IGM with negative LORD
        stats, they are automatically repaired. Player is notified of which
        stats had to be reset, and what they are reset to.

      - As of Feb. 10, 2005, players may view the IGM's History Notes text
        file from the IGM's main menu.  File will scroll downward as data
        is looked at or read.

      - As of Feb. 21, 2005, there are two usage reports in use by the IGM.
        Both are view-able in the TURG-USE.TXT data file.  Use the
        THOUSE4 REPORT command to quickly and easily view it.

      - For details on what was done between Turgeon's House v3.40
        and v4.00, you can read the TURGHIST.TXT file.  It can be
        read from the IGM's main menu as you start using it in LORD.

        You can also read it using Vern Buerg's LIST utility, or
        the Microsoft Windows' Wordpad program. To get LIST, see
        http://www.buerg.com/ which is the Buerg Software site.
================================================================


[6.0] *** SOMETHING'S WRONG!! ***
        - My IGM says I'm lacking a THMAINT.DAT file, or Thouse3.cfg file.

          Answer: If that happens, then simply re-install the IGM.

          You are using a version that is no longer directly supported.
          Thouse3.cfg was replaced by Turgeon.dat.  And the thmaint.dat
          file was replaced by turgplay.dat and turgtime.dat.

          To recreate the IGM configuration file, run THOUSE4 INSTALL
          or THOUSE4 CONFIG.  To recreate the player database file,
          just re-enter the IGM in a LORD game session.

        ----------------------------------------------------------------
        - IF using more than one LORD game on system, there is possibility
          of having one game's IGM Config file corrupt the one used by
          another LORD game.  Visually check file to verify it is for the
          right Lord game directory.
================================================================


[7.0] *** REGISTRATION ***

        - Turgeon's House is freeware
        - You do not have to register this program!
          <For those of you who are slow>
        - If you want to give my money you can.
        - This is Dedicated to all those people who are TIRED of getting
          IGM's that are trashy and not freeware.  Then the Programmer
          has the Audacity to charge an Arm and a Leg for their Trash!
        - I have nothing against Programmers like that, I just ask that
          they make better IGM's and other programs, or at least not
          charge for them!

        - To report a bug, please e-mail the info to
          ktidmore@bellsouth.net or gtidmore@hiwaay.net

        - If you are another LORD IGM author, it would always be
          nice to have registered copies of one of your IGMs.

        - Without exception, all Castle Camelot LORD Apps are Freeware.
          I write/update LORD programs as a hobby and as a programming
          challenge. Donald.
================================================================


[8.0] *** OTHER -SKI- SOFTWARE RELEASES ***

  - I'm currently looking into doing a TEOS IGM.  Keep an eye out on my
    web-site for any news on this.  E-Mail me if you have ideas.

  - There has been one other OLD release from -SKI- SoftWare and that is
    a door game called Crime Boss <v1.10 was the latest version>.  This
    game is probably no longer around.  I don't even have the source
    any more.
================================================================


[8.5] *** The Random Events, Visits/Day Info: ***

  As of March 21th, 2005, the IGM may be configured for usage between
  1 and 5 times per day.  When you exit the IGM, there are two random
  events which MAY execute.  There is a 25% chance for each event of it
  running, if you meet their requirements.  At least two more random
  events will be added in later versions.

  The events will run ONLY for a legitimate user of the IGM. Someone
  who tries to use the IGM more times than are allowed is denied
  access to the Random Events, and they do not get to see the
  ending Stats and Usage Reports screens.

  In the future, when the IGM is updated to cover Turgeon coming
  home and catching burglars, those varmints will risk death at
  his hands.  And Fairies MAY not save them in that situation.
  ------------------------------------------------------------

  If you have a Horse, random event #1 will never execute. IF it
  does, you win a horse.  If you have 32,000 or more kids, then
  random event #2 will not execute. Otherwise, if it runs, you
  get to adopt an Orphan Child.  Neither event will run at all
  if you have used up your legitimate IGM Visits.
================================================================


[9.0] *** Future Updates Scheduled:

    * Scheduled later this year in 2005 - no timetable.

  1) Fairies in closet event: Ask for Skill Use Points Replenishment
  for your current Skill Class.  If they are agree-able, all of your
  normal Skill Uses for the current skill will be renewed.  Plus one
  additional Use point like LORD does at the start of each new game day.

  The Fairies would grant one NEW Skill use point, for the player's CURRENT
  Skill Class, if he/she has not used any of their day's Skill Use Points.
  Otherwise, fairy would replenish their day's Skill Use Points, for the
  current Skill Class, to what LORD allows them to have, based on their
  current Skill Points.

  2) Random event after weapons trade.  If player is unlucky (clumsy)
  they will drop their new weapon, and hurt their feet.  Will cause
  Hit-Points and Strength Points loss.

  3) Random event in kitchen.  Player eats or drinks something, and then
  gets a stomach-ache.  They throw up, make a mess (which they fail to
  clean up) and they as a result lose Charm and Hit-Points.

  I may code it to skip penalties if player chooses to clean up the
  kitchen.

  4) Random event.  Player will risk loss of perhaps 25% of their Gold
  and Gems while they are exploring the house.

  5) Random event.  You are inside the house and Turgeon comes home and
  finds you.  Have not decided if player will risk death.  They will
  be beaten up at the least, and lose all but 1 Hit-Point, most likely.

  6) Random event in Attic.  The Old Lady may have gotten lonely over
  time, and perhaps she will flirt with you.  If Lord is not in Clean Mode,
  then player will get Laid.  As with Turgeon encounter, I have not made
  specific plans on either event's details, as of v4.00's release.

  7) Creation of one or more new rooms in house.  No details thought of
  yet.  Currently IGM consists of Porch, Foyer, Living Room, Hallway,
  Bedroom, Kitchen, and Attic.  I may create a Bathroom, and perhaps a
  Library - where Turgeon may leave something valuable for people to claim.

  ------------------------------------------
  8) Turgeon comes home, and finds a player who has burglarized his
  house.  They may normally face a server beating.  If they have
  violated the Max Visits/Day rule, they probably will be killed.

  Punishments probably will include 10-20 percent loss in Experience
  Points, and a 10-20 percent loss in Max Hit-Points. Both penalties
  may only be assessed one time per day.  IF player is killed, Fairies
  will NOT be allowed to save them probably.


Timetable: Generally I wait about 2-3+ months between IGM
development cycles.  Next work will probably be mid-Spring or
early Summer 2005.
=================================================================


[9.5] *** Handling IGM Crashes and Glitches:

What to do if IGM malfunctions:

Contact me via email or on Fidonet's Lord Echo with details
on the problem.  If you don't have Email or Fidonet access, you
can contact me via postal mail:

    Donald Tidmore, 1111 Berenice Street, Tuscumbia, AL (Alabama)
    35674-3504, U.S.A.

I would need to be able to try to reproduce the problem, so it
would be helpful to have an archive containing all of the IGM
data files, along with selected LORD data files - player.dat,
playext?.dat, lognow.txt, logold.txt primarily.  If you are
able to save a screen snapshot showing the problem, then send
that to me as a JPG graphics file.  If you have a BBS capture
log, produced by most comm and telnet programs, please send
me the portion that applies to your usage of Turgeon's House.

This IGM does not write anything to LORD's error.log file, since
the ANGEL toolkit was not designed to do that.

If you see RunTime Error message, write down the details to send
to me, or make a snapshot picture of the screen, if you can do so.

I have found that the PAINT problem distributed with MS Windows
works just fine for making those screen snapshot graphics files.
If you are unused to how it works, here are some quick notes.

When you want to save a screen, you press the SHIFT key + the Print Scrn
key.  You have to press both keys at the same time.  That copies the screen
to the Windows clip-board.  Open PAINT and use its Paste command.  Then
save the file as a JPG graphics file.  I can handle long filenames.
==============================================================


[S.S] *** Contacting the Author, or Chris: ***

  Effective September 2003, I assumed authorship and support
  of Turgeon's House from Mike, and I have been handling the
  IGM's support since that time. Donald.

  Fixed spelling errors in file on 03/18/2005.
  ==================================================

Contacting Donald Tidmore:
-- web:  www.fidotel.com/public/camelot/  - Castle Camelot web-site
         www.fidotel.com/public/kiteria/  - Kiteria's Korner! site
         www.filegate.net/camelot/        - Camelot LordNews FDN site

-- E-mail:  donald.tidmore@usa.net, gtidmore@hiwaay.net, or
            donald.tidmore@fidotel.com.  Use ktidmore@bellsouth.net
            IF the other three don't work for you.


Contacting IGM's original author, Mike Ciesiensky, Jr.:

-= web: crystalcore.net/skisoft
-= e-mail: skidog@crystalcore.net
===============================================================


[C.C] *** Castle Camelot LORD Apps Notes: ***

-- See CCL-APPS.TXT file inside THOUSE40.ZIP distribution archive
   for information on my other Lord igms and utilities projects.

Online copy of file is updated periodically:
   http:/www.fidotel.com/public/camelot/ccl-apps.txt

===========================================================

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

Edited Docs on:  March 21, 2005 at 09:07 pm.

