                  Belgarion's LORD LADY Scripts v1.36

               By Donald Tidmore, Gordon Lewicky, Michael
             Everett, and Dan Stovall.  Copyright (C) 2002.

    All Rights Reserved by authors.  FreeWare Code/Text files.
    Archive files layout/structure altered on 04-19-2002 to new style.
              ==================================================

Master files are stored on my web-site inside this file:
    http://www.LORDlegacy.org/camelot/LORDnews/dgt-lady.zip

Associated file by Gordon Lewicky:  LORD's Lady Script Language
Odds & Ends.  Covers v4.06-v4.07 beta Script usage/discoveries
made by Gordon Lewicky and Donald Tidmore.  All text is by Gordon.
    http://www.LORDlegacy.org/camelot/LORDnews/ldyquirk.zip
================================================================

Contents/Structure:
1) Dgt-Lady.zip:  Primary file now contains only those files that
are by me, personally.  GL-Lady.zip will contain all Lady scripts
released over time by Gordon Lewicky.  Excluding those placed in
other archives, such as LdyQuirk.zip, for example.  ME-Lady.zip
will contain the three Lady scripts by Michael Everett and Dan
Stovall.
                        ==============================

I) LADY Scripts by Donald Tidmore, in order of creation:
                ** Latest Revision -- July 02, 2002: **

-- Sharpen Weapon. Sharpen.ldy - Meet an blacksmith sharpening
     weapons, and get a freebie quick weapon go-over done by him.
     Gives 3 Strength points.

-- Polish Armour. Polish.ldy - Find the blacksmith again, this time
     cleaning up armour outfits and doing repairs on them.  Get a
     quick polish job done on yours for free, and get 5 Defense points.

-- Two Gems. Gem2.ldy - Simple alteration, including recent wording
     rewrite, of Michael Preslar's basic Gem event.  I liked the
     idea of getting two gems in the Forest.  So here it is.

-- Gem Trader. GemTrade.ldy - Find Peddler Jack mixing up his magical
     potions, for sale to the Inn's bartender.  For being a pleasant
     companion, he offers you a discount deal.  For each 3 gems you
     give him, you get two potions.  And you may specify which type
     you want, and how many "deals" you want.  Up to 999 per Event.
     An event only lets you choose once. Choices are: Hitpoints,
     Strength, Defense, or Pass on Offer.

   v1.06 allows user to make several purchases if desired, until they
     run out of Usable Gems for deal-making.  
   v1.07 has an rewritten Punishment Routine.
   -------------------
   v1.08 - Added Special Deals Menu. Requires 4-gems payment to see
     options.  Code for Gem Trade for Horse, 16-gem price, tested.
     Released publicly on July 02.   v1.09a - minor bug-fix release.
   v1.09b - Rewrote Special Deals menu code.  Rewrote Horse trade
     routine, and retested all scenarios.  Finished on July 25.
   v1.09c - Fairy trade code integrated into Script's Special Deals
     section.  Fully tested and debugged as of July 26. Cost of Fairy
     is 32 Gems, plus the 4-Gem Admission Fee to Special Deals area.

   Important note:  Fairies have always been acquireable via an IGM,
   or in LORD itself by succeeding at catching one.  However, for LADY
   Scripts, the script variable &Pfa for Fairy became usable in April
   2002.  So in order to actually GET the fairy, you will have to be
   running post-March 2002 compilation of LORD v4.07 beta.  Those using
   older versions or compiles will have their gems deducted if they try
   to buy a Fairy.  But you will NOT actually get one.

   Only other contemplated work for Gem Trader is as follows:
   ----------------------------------------------------------
   (1) Try usage of v4.07-ONLY script math symbol support - which allows
       direct manipulation of an LORD stat using +/- for add/subtract, etc.
   (2) When usable, also v4.07-ONLY, have script write to Daily Happenings
       when various events take place in Peddler Jack's camp.
   (3) When usable, v4.07-ONLY, have support for displaying ANSI or SANSI
       screen at beginning or end of script.
   (4) MAYBE allow player to trade for Orphans.  However, it would penalize
       anyone trying to buy a Child who already had 50 or more Kids.


-- Pretty-Stick and Ugly-Stick. Names are PretStic.ldy and UglyStic.ldy.
     The original LORD events are done by Michael Preslar together,
     and now use random selection, between 1 and 5.  Mine simply
     give 5 Charm points, or take away 5 Charm.  And I have reworded
     the encounters to my own style now.

-- High Spirits. HighSpir.ldy.  *NOTE: Primarily is for usage by
     other Script authors. Developed to test Nice Hag's feature on
     handling Temporary HP's.  Anyway, it simply gives the player
     High Spirits, and grants 200 Temporary HP.  Two gems are also
     granted to player. May be used in a BBS game if sysop wishes to
     do so.  v1.04 07/06: Granted player 10 Gems.  Older v1.02 version
     was giving them 5 gems.  Script changes are primarily done for
     testing Gem Trader updates, etc.

-- The Nice Hag. NiceHag.ldy.  Find an old lady in forest, who's
     lost. Escort her safely home.  Receive rewards from her sister
     and from Sarah.  The sister is the Old Hag.  She is Nice, ergo
     the script name.  If player has no gems, you get one new Hitpoint
     for bringing Sarah home.  If you have a gem, give it to her.
     You will be granted TWO new hitpoints.  If you choose to keep
     your gem - No reward.  Second, for all players:  You are granted
     a Free Healing.  Sarah's reward is 7 Defense points to aid you
     in your quest to find and defeat the Red Dragon.

   v1.10: Modified to award players a small amount of experience points
     for showing courtesy to old ladies.
   v1.12 uses standardized variables, and new Exp. point reward system.
   v1.14 - Revised ending display of player's Strength. Skipped v1.13 #.

-- The Charm Tax. CharmTax.ldy.  Just like people have to pay Income
     Tax in LORD, so do you have to pay Charm Tax.  If you are below
     140 Charm points, you're safe and will not be taxed.  You even
     get to see Jennie again.  All players above 140 Charm are taxed,
     at varying rates.  Each tax bracket covers 40 points, and if you
     are over 180 points, you have to pay a Back Tax penalty.  That
     is imposed in Experience points.  Top tax rate is 18 percent,
     and the top penalty rate is 8 percent.  
     * 07/02 - v1.12. Minor text wording changes.

-- The Bandit. Bandit.ldy.  You encounter a tough bandit in the forest
     and after a struggle are knocked out.  When you wake up, you
     will no longer have your Gold or Gems.  If you're really unlucky,
     during the fight your weapon is damaged to varying degree (based
     on weapon type), causing you to lose varying amount of Strength.
     All players receive wounds, causing you to lose one-half,
     three-quarters, or all but one, of your current Hitpoints.  So
     you will have to risk a new fight to get money for healing, or
     run off to the bank.  Released around May 07, 2002.
=======================================================

In Development:  No new scripts are in progress.  Most require Random
   Numbers to base script events upon, and LORD doesn't handle them
   correctly yet.

Planned Scripts - DGT:
1) Gem Trader - Will do the following.  (a) Allow customer to buy
   a Horse for Gems, if they are on foot.  Admission fee of 4 Gems
   is non-refundable, to see the "Special Deals".  Purchase price
   is set at 16 Gems.  (b) Will sell Fairy for Adm. Fee plus 32 Gems.

1-C: Special random Event, if workable, for Gem Trader:  33% chance
   that an top-notch wizard enemy shows up.  As you ride off on your
   new Horse, he casts a magic spell at you from ambush.  When your eyes
   clear from the blinding spell-light, you find yourself riding into
   Town, and hear lots of people laughing their heads off.  "What's
   up you say", and they say, "Oh boy, do you look silly riding that
   Red Holstein cow.  You look down, and yep, that's a moo-cow steed.
   And it's time to milk her!  Funny Huh?

   Has zero REAL effect to LORD play, unless one could actually change
   the Horse to a Cow.  But not all script events have to make sense.
   Eventually, script may also display an ANSI graphic of a person riding
   a Cow on-screen if this scenario happens to you.

2)  Applies to ALL of my Lady scripts.   When scripts can write to the
    Daily Happenings Log, everyone will know that something embarassing
    happened to a player in an Script event.  Problems:  Any script
    that uses variables introduced in LORD version 4.07 would only be
    usable in that version, meaning that I (and other script authors)
    would have to maintain two sets of scripts.  One set using script
    commands that run properly in LORD 4.05-4.06, and one that only
    works in LORD 4.07+.

3) Sexy-Sam(antha).  Ideas still in flux. Primarily for guys, but ladies
   will be covered as well - eventually.  Sequel to Gem Trader.  Will add
   an "parental advisory" to latter when this one is released.  Peddler
   Jack tells the guys, as they leave his camp: "Watch out warrior, my
   daughter Samantha is out there somewhere lying in wait for men.  She's
   uncontrollable, perpetually horny, and absolutely irresistable to
   men.  Her sex appeal and physical beauty rivals that of the Goddess
   Aphrodite, of Ancient Greece.  So she grabs any man who she finds,
   except for me, of course, (-- being her father, I'm safe --) and has
   her way with them.  If you're lucky, you'll survive OK.  Some poor
   souls do come down with HIV or Herpes."

   For Ladies:  You may just find Samantha and gossip about men.  Or
   you may get a chance to be seduced by her father, Peddler Jack.
   He not only does great potion deals, but is also quite the HUNK!!
   And yes, you will not be able to turn him down.  You think Seth
   the Bard is the cat's meow?  Well Jack taught Seth everything he
   knows about pleasing a Lady.

4) Sexy Witch/Warlock -- Charm Horse Deal:  You meet either a gorgeous
   young witch with the most awesome body you've ever seen, or a hunky
   warlock who leaves the ladies drooling.  OK, they preserve their
   youth by obtaining charm points from warriors while giving them the
   best sex they've ever had -- in LORD.  If you're on horseback already,
   you simply lose some charm points.  If you are on foot, they will
   sell you a Horse for 20 Charm (if Charm <= 200) or 30 Charm (if
   Charm > 200).  Have not decided when to try writing this one.

5) Planned expansions, not sure when I'll do them:
   a) In Polish Armour - Blacksmith will still give free cleaning,
      which gives you some Defense points.  He asks if you'll pay
      him some Gems. Say yes, and your armour is made like new
      again, from magic and plain elbow grease.  Results in extra
      Defense points, based on user's Game Level.
   b) In Sharpen Weapon - Blacksmith normally gives your weapon a
      quick repair job.  Swords are sharpened a bit, Longbow gets
      new String, etc.  You get some Strength points for free.  Pay
      him some Gems, and he makes the weapon like new.  Result is
      more Strength, based on Level.

      Probable fee will be 5 Gems, with maximum reward of 30 points
      approximately for Level 12 player.  If user chooses the Gems
      payment option, their free points are included in the new
      Strength/Defense point reward.
======================================================================

II) Scripts by Gordon Lewicky.  April-June 2002.  Bundled inside
   DGT-Lady.zip as GL-Lady.zip.  Each script is posted are posted
   to Scripts directory on my web-site, along with GL-Lady.zip.

-- TaxMan - TaxMan.ldy.  Deals with LORD's continual problem with
   Gold overflow issue, by assessing an 50% Income Tax on all
   players who have 1 Billion in combined Gold.  Gold in Hand +
   Gold in Bank.  Decreases to assess an 10% tax on everyone else
   who is below 1 Billion, and above 1 Million.  Those below 1
   Million are not taxed, and survive the audit. Try visiting Jennie
   afterward.

-- Goofy Events #1 - Goofy1.ldy.  Contains three Lady scripts named
   DragonPoop, Horny, and SexChange.  Find the Red Dragon's poop
   and fall in it.  Various results including death.  Horny: gives
   player second chance to send Romantic Mail.  SexChange:  You
   made the fairies angry, spying on them.  Punishment is sex change.

   06/13/02: Version 1.10 - Grizelda added to Goofy Events.  She
   just LOVES kids, BUT the ones she loves are YOURS.  So she steals
   your kids (if you have below 11 you're SAFE), along with any that
   Doofus normally had stashed in the Orphanage to sell to people
   for Adoption.  Player also loses extra Forest fights each stolen
   Child had been giving them.

-- Doofus, Gem Trader Supreme - Gnome.ldy.  Meet an wily old gnome
   who just LOVES to collect gems.  He'll give you a great deal on
   gems. What can you get?  A beating if you try to swindle him and
   get caught.  Behave yourself, be honest, and get Hitpoints,
   Strength, Defense, Charm.  Hey what's that?  You have more? OK,
   pay admission price.  Get a Horse or an Orphan.  Psst.  Ask for
   the Secret Deals, to find the hay-eater or the cute child.

   06/13/02 Revision:  Grizelda added to Doofus script.  If you have
   more than 10 Kids and try to buy even more, well bad news.  Some
   of your kids just got kidnapped by her.  You lose some daily
   forest fights.

-- Count - Count.ldy - See the LdyQuirk.zip archive.  Designed to
   show other Lady Script authors, originally me, how random number
   generation is Supposed to work in LORD, and how it Actually works.
   Done as an Lady Script, and as an C/C++ program.

-- In separate archive, Ldyquirk.zip, see Gordon's review of quirks
   and oddities in LADY script engine/language. Also contains Count.ldy
   and Count.Cpp/Exe files - to illustrate how LORD's LADY script
   engine doesn't generate Random numbers properly. May 2002: Added
   Charlie Wardick's Pcount.pas/exe programs. They illustrate how
   Random numbers can be properly generated in Pascal language.
=====================================================================

III) Scripts by Michael Everett and Dan Stovall.
   Packaged in ME-Lady.zip, inside dgt-lady.zip.

-- Golden Tree. GoldTree.ldy - A gnome you encounter under a tree
   grants you either a Bag of Gold, or you get some Defense points.

-- Blue Fairy. BlueFary.ldy - Find a blue fairy.  Rewards are Gold,
   Strength, Defense, or Forest Fight. One reward per event.

-- Ruined Castle. RuinCast.ldy - (By Dan Stovall.) Find an old ruined
   castle deep in the forest.  Choices: Go inside, look around, or
   leave area.  Inside castle, may get Gold, Experience, or Max Hitpoints
   from the resident Spirit.  Outside castle, on walk around, you can
   find an lost Child, some Gems, an Horse, or nothing.  If you choose
   to Leave area, one choice gives you new Forest Fights.

All three are fully tested, and work reliably.  None will over-balance
your LORD game by giving excessive rewards.  That applies to all
scripts done by myself and Gordon Lewicky as well.
================================================================

Requirements:  1) User MUST use LORD v4.05pb, v4.06, or v4.07 Beta.
   None of the Lady Scripts Variables are usable in other old LORD
   versions.  2) Willingness to use these scripts.  Naturally <G>.
   3) An interest in giving your BBS' LORD games more random events.

Testing Notes:  Scripts by Gordon Lewicky and Donald Tidmore are
   designed using LORD v4.07 beta, and are tested by Gordon on his
   v4.06 BBS LORD game.  Our scripts are only released publicly when
   we are satisfied they work as intended.  Scripts by Michael
   Everett and his cousin were tested by them over past year's time
   on a v4.06 LORD game.  They've also been tested and brought up
   to LORD 4.07 standards by myself, and tested by me and Gordon
   using LORD 4.07 beta.
=====================================================================

For convenience of end user, copies of my LORD.ldy, test.ldy, and
events.ldy files are included.  However, the test.ldy and Events.ldy
files may ONLY be used with LORD v4.07.  They are NOT usable with
earlier LORD versions.  All files included inside Events.ldy are
official LORD scripts, by Michael Preslar.

It is up to each user of this Scripts collection to decide how to
use them.  The files will be need to be revised to meet each person's
needs, as it is likely not everyone wants to run every single Lady
script there is.  And so far that is approaching 3 dozen.

*ALL* scripts in the Official LORD game's Events.ldy, included as
DT_events.ldy, require LORD v4.07.  They either use new Lady script
variables introduced in v4.07, or utilize new techniques in
manipulating character stats.  Either change makes them unusable by
older LORD games.  To avoid overwriting official LORD files, my own
test.ldy and LORD.ldy files are renamed to dt_test.ldy and dt_LORD.ldy
for bundling with this archive.
=======================================================================

For further information on a specific script, read the script.
And/or run it in your LORD game.

Auxiliary file:  If you're interested in knowing about ways to
obtain Temporary Hitpoints in LORD or in various IGMs that I have
knowledge of, read the Temp_HP.txt file.  And if you want to submit
other IGMs info, please send it to me via Email, or via message
on Fidonet's LORD Echo.

If you wish to have an Lady script you have written released
publicly send it to me.  Indicate if you wish it included inside
dgt-lady.zip, or if you want it distributed in a separate archive.
-------------------------------------------------------------------

Simple Installation Instructions:
-------------------------------------
1) Preferably, unzip everything, including included .zip files,
   into an TEMP directory underneath your LORD game.
2) BACK up your current game's LORD.ldy and Events.ldy files.
   I normally use .BKP extensions for such backups myself.
3) Merge scripts in this archive into your LORD.ldy and Events.ldy
   as you see fit.  I suggest keeping non-standard scripts out of
   Events.ldy.  DO NOT attempt to use included scripts inside
   dt_events.ldy if you are NOT using LORD v4.07 beta.
4) Play LORD and test each script.  Then use them in regular play.
   It is suggested that sysops should evaluate each script for use
   publicly by their BBS's game users.  Scripts such as HighSpir.Ldy
   were not written for wide-spread usage.
-------------------------------------

Testing Lady Scripts:
1) Open Start.bat in a text editor, Wordpad, etc.  Find the LORD.exe
   command line and add /DEBUG to it.  Save the file.
2) Alter LORD.ldy to use each script you wish to run, changing the
   &rnd number to the total # of scripts you use.  Scripts that
   are commented out - with ; - do not have to be counted. Save file.
3) Repeat process with Test.ldy - Usable only with LORD v4.07 beta.

4) Start LORD, go into forest.  To run Events randomly, press 3.
   May not work in older versions of LORD.  To run a SPECIFIC script,
   usable ONLY in LORD v4.07, press X.  That runs test.ldy, from
   which you can select the script you want to run/test.
5) Lady.log:  Generated by LORD each time an Event is run.  Contains
   diagnostic info on how they were processed.  If LORD game hangs
   during a script, send this file to the script's author. In an
   .ZIP file.  Is ONLY made while the /DEBUG is included in Start.bat.

Sysops who do NOT want their player selecting Random events on purpose
have to remove /DEBUG from their game.  Pre v4.02 LORD games will not
have this feature.  Lady.log can quickly becoming very big, so
periodically it has to be either deleted or renamed.  It is recreated
the next time an script is executed by LORD.
--------------------------------

Feedback:  Positive comments preferred <G>.
----------------------------------------------------------------
Me:  donald.tidmore@usa.net, ktidmore@bellsouth.net, or Fidonet:
     1:123/450.  I'm available on the LORD and DoorGames echoes.

     http://www.LORDlegacy.org/camelot/ - Castle Camelot site.
     http://www.LORDlegacy.org/kiteria/ - Kiteria's Korner! site.
     http://www.filegate.net/camelot/ - Official Fidonet LORD FDN.

Gordon:  glewicky@dowco.com -- Sysop Milkyway !:153/307
 Milky Way, 1;153/307;  or Fidonet 1:153/0.

Michael Everett and cousin -- sysop@bobobbs.net.  Not available
   via Fidonet.  http://www.bobobbs.net

Charlie Wardick:  chasware2002@earthlink.net.  Available in
    various Fidonet echoes including DoorGames and LORD.

To reach LORD's author, use mpreslar@mailcity.com.  Or other
    methods accessible on his web-site: http://www.LORDlegacy.org .
    He is available on most/all Fidonet echoes that pertain to
    LORD, BBS door games, etc.
-------------------------------------------------------------------

Disclaimer:
-----------
Each script is released publicly once the author has tested it.
Each member of the LADY Script Team tests each other's scripts.
Charlie Wardick is an associate member.

The scripts are warranteed as follows:  1) They work on OUR LORD games.
2) They don't screw up a LORD game's fair play environment, or seriously
affect the LORD game's outcome.  3) They will take up some disk space,
but with multi-Gigabyte drives, you'll never notice that probably.

Each script has been, or will be, tested on the Arena BBS, on Everett's
BBS, and on Lewicky's BBS.  Betas of our scripts are usually only
released to LADY Script Team members - they sometimes can crash the
LORD game, if a script code section isn't fully debugged.

When observed, any problems with LORD v4.07 and its Lady Script
engine are sent to Michael Preslar for him to handle.
---------------------------------------------------------------------

LORD Crash Notes:  If LORD crashes while running an Event, the
following actions must be taken by the stand-alone user or Sysop.

1) The character you used will still be listed as ON Now.  Can only
   be changed via Player Editor -- IF your LORD game is registered.
   Non-registered player will be unable to use that character until
   the next day.
2) Portions of LORD, and specifically the script that crashed, remain
   in memory.  So an system reboot is recommended.  Returning to LORD
   without a reboot will work for awhile.  But if the original script
   has not been fixed, and is run again, LORD will crash again.

If the script is by me, Gordon, or Everett, send an email to us,
detailing your problem, and we'll check into it.  If the script
that crashes is distributed by Preslar, write to him.  If you
are using Lady.log script logging, zip up the log file, and send
it with your feedback message.

Note on Lady.Log:  Check file size periodically, and delete file
when it becomes real big.  If you use Count.Ldy to check Random
Numbers generation, you can end up with a 5+ MEGABYTE Lady log file.
File will be recreated by LORD the next time a LADY script is run.
===================================================================

Note for Script writers:
------------------------
I suggest using Wordpad to edit an script as you are testing it.
You have to save changed files to the LORD directory in order for
LORD to run them.  Changes may NOT be saved while a script is
being executed, as the Windows O.S. locks in-use files from
tampering by outside programs.  For changes to be used by LORD, the
edited files HAVE to be saved into your LORD directory.

LORD usually will immediately access script updates if they are
updated by an Windows program.  However, if you are using two DOS
sessions, what is changed in one session, is not noticed by LORD game
running in the other session.  LORD has to be exited and restarted
for script changes to be tested and executed in this situation.
======================================================================

Script Alteration:
------------------
User may customize our scripts as you desire, for your own PERSONAL
usage.  If the script is severely altered, you MAY NOT use it in a
public forum with our names included.  That is illegal and unethical.

NO Scripts bearing our names may be distributed anywhere if you have
modified them, UNLESS you receive our permission to do so.

Distribution of these scripts is forbidden by others to Internet
sites.  All distribution online must be done by the script's authors,
or you are guilty of copyright infringement.  Users may distribute
this archive, UN-ALTERED, to another BBS if they wish to do so.

No distribution of our Script programs is allowed via Fidonet by
others, without my express consent.  Or that of the script's author.
Donald.
=====================================================================

Online/Fidonet distribution:
----------------------------
As they are released/updated, all Lady scripts distributed by myself
are stored online in this location.
-- http://www.LORDlegacy.org/camelot/Scripts/.

When updated on my Fidonet Camelot LORDNews FDN site, all LORD
programs are posted here:
-- http://www.filegate.net/camelot/Lordfile/.

The last posted archive to check (on the FDN) is dgtlad13.zip.
=====================================================================

See dgt-proj.txt and dgt-plan.txt for info on my other LORD
programming projects, and upcoming Lady Scripts.  History file
for changes to dgt-lady.zip archive stored in dgt_hist.txt file.
======================================================================

Dgt_lady.txt was created on March 22, 2002.  Copyright @ 2002 by
Donald Tidmore.    Last update:  July 26, 2002 at 10:54 pm.
