Ŀ
                               LEMONADE!                                    
*                     Copyright 2004 - BBSFiles.com                          *
*                                                                            *
*                              original                                      *
                     COPYRIGHT 1990,96 T&J Software                         
                                                                            
                                                                            
                      VERSION 4.30     02/16/97                             

BY:

 Tom & Jane Wildoner

LATEST VERSION:
===============
Please visit http://BBSFiles.com for the latest version of this program.

LEGALITIES:
===========
THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.

DISTRIBUTION:
=============
You may make this file available for downloading from your BBS or you may
upload it to any BBS of your choice, provided that you do not make any
changes to the contents of the archive (ZIP file). The archive and its
individual contents may not be used by any service that charges any money
whatsoever, without the written permission of the author.

PROGRAM DESCRIPTION:
====================
LEMONADE is a fairly simple game. Your mother has given you $1.00 to get
your lemonade stand started. The object of the game is to sell as many
glasses of lemonade as possible in a set number of days.

After the user hits the 'N' key he will be shown today's weather forecast.
He will then be prompted to enter how many glasses he wants to make followed
by how much to charge per glass.

The weather and temperature have a direct bearing on how many glasses will
be sold. If it rains, none will be sold.

Once you have a score on the TOP TEN listing, you have to beat your old
score to remake the list. This door resets the scores every month.

NOTE:
=====
a public registration key is included

When you register, you will receive a new LEMON.KEY file. The user is
limited to 4 GAME DAYS until registerd. The user is limited to just
ONE play per day until registered.

INSTALLATION:
=============
Run Lemonade with the command line UTILITY to bring up an options
menu to easily install and reset the game!

Example:   LEMON UTILITY

CONFIGURATION:
=============
Example configuration file for PCBOARD.SYS
------------------------------------------
C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)

Example configuration file for USERS.SYS
----------------------------------------
C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)

Example configuration file for DOOR.SYS
---------------------------------------
C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)

Example configuration file for USERINFO.DAT
-------------------------------------------
C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)
NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT

Example configuration file for CALLINFO.BBS
-------------------------------------------
C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)

Example configuration file for DORINFOx.DEF
-------------------------------------------
C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
                          where 'x' is the BBS Node number.
T&J Software        <=-  (Change this to your BBS name)
Tom                 <=-  (The Sysop's first name)
Wildoner            <=-  (The Sysop's last name)

Example Batch File
==================

   ECHO OFF
   CD\DOORS\LEMON           <=- Switch to the door's Directory.
   LEMON LEMON.CFG          <=- Execute the door program and pass the
                                configuration filename to the program.
   CD\PCB                   <=- Go back to PCB DIR when user exits door.
   BOARD                    <=- Restart BBS.

This Door is multi-node  compatible so you may run more than 1 node from
the same .CFG file provided the path to your system file (DORINFOx.DEF,
CALLINFO.BBS, etc) is exactly the same unless you are using environment
variables, (q.v.)

Environment Variables
=====================
PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
variables. Non-PCBoard systems may also use these variables by including
the following in either your BBS batch or AUTOEXEC.BAT
  SET PCBDRIVE=C:               <- Drive letter of your BBS files
  SET PCBDIR=\BBSDIR            <- Path to your BBS files
Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
.CFG file for multi-node operation!

To specify a non-standard IRQ, put the IRQ number after the .CFG on the
command line.  For example:

     LEMON LEMON.CFG /5
or using the PCBDRIVE procedure:   SET IRQ=5   and use
     LEMON LEMON.CFG /%IRQ%

This tells the program to use IRQ 5 instead of the standard IRQ.

  Had reports of conflicts when using non-standard IRQ's on Novell/Netware
 systems. Seems Novell also uses the / character so something went screwy
 somewhere. So I added the * (asterisk) which may be used instead of the /
 in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
 and are interchangeable.

When specifying the location of the system file on line 1 of the doors .CFG
file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
and %wcnodeid%. Some examples:
 PCBoard: 
   USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
   USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS

 Wildcat!:
   USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%

Non-PCBoard systems may use the PCB environment variables by setting them
in either AUTOEXEC.BAT or in the batch that runs the door. For example:
 SET PCBDRIVE=C:
 SET PCBDIR=\BBSDIR
 SET PCBNODE=1

Fossil Driver Support
---------------------
DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
Fossil driver instead of the standard COM ports, just put /FD on the command
line when running the door. For example:
     MYDOOR MYDOOR.CFG /FD
indicates that a Fossil driver is present and should be used. If no Fossil
driver is detected, DoorFrame will print a message to that effect and exit
the door gracefully.

Sysop Keys
==========
F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
         written to DOOR.SYS and USERS.SYS
F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
         and/or written to DOOR.SYS and USERS.SYS
F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
         and/or written to DOOR.SYS and USERS.SYS
F8    -  Returns the caller involuntarily to the BBS.
F9    -  Toggles the local display On/Off. Value is passed to PCBoard
         and/or written to DOOR.SYS and USERS.SYS
F10   -  Activates SysOp CHAT mode within the DOOR.
ESC   -  Deactivates CHAT mode.  DOOR is resumed.
UP    -  Give the caller extra time while in the DOOR.  
DN    -  Subtract time from the caller while in the DOOR. 
HOME  -  HELP key for Status Line options.
ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
ALT-X -  PCBoard will exit after current caller logs off. Value is
         passed to PCBoard. Not available on non-PCBoard systems.

RESET.NO File:
==============
By creating a file in the Lemonade directory called RESET.NO the door
will not reset monthly.

DONATED.BY File:
================
By creating a file called DONATED.BY and placing a persons name in the
file, the door will give a credit line to the person for donating to
register the game.

SYSOP.CFG FILE:
===============
Your SYSOP.CFG file should contain ALL the items listed below. You can use
your text editor to edit the provided file.

c:\wc30\bull\bull1.scr
c:\wc30\bull\bull1.bbs
25
3

LINE   1: PATH to your color bulletin.
LINE   2: PATH to your ASCII bulletin.
LINE   3: How many GAME DAYS per play.
LINE   4: How many plays per day.

The file MUST have all 4 lines!

LOCAL PLAY:
==========
Simply run Lemonade using the command line LOCAL. This will give you the
option to play door locally using several different people or logon
names.

Example: LEMON LOCAL

MAINTENANCE!:
============
None required. The door will reset the scores every month.

ADVANCED HELP:
=============
Please consult the TIPS.TXT file.

VERSION HISTORY:
===============
Version 0.30 BETA..... BETA release. 8/1/90
Version 1.00 ......... First release. 8/9/90
Version 1.10 ......... Fixed remote screen bug associated with using
                       this program under a LIVECAT environment.
                       Fixed an exponential bug associated with very
                       high scores.
Version 1.20 ......... Fixed a small problem in the amount a person
                       can charge per glass of lemonade. It is now very
                       unlikely that anybody can sell a glass of
                       lemonade if they charge more than 50 cents per
                       glass.
Version 1.30 ......... Cleaned up the code to stop the generation of
                       ERROR #6 (number being to large). Program now
                       will only allow users to make 1000 glasses/day
                       and will not allow them to charge more than 100
                       cents per glass.
                       Added bulletin generation outside of the main
                       EXE file. This will give me some room in the code
                       for some future additions.
Version 1.40 ......... Maintenance release to show new BBS name and
                       number. 8/17/91
Version 1.45 ......... Minor BUG fix in the number of glasses.
                       09/01/91
Version 2.00 ......... Now supports WC 2.x and 3.x! Added an internal
                       bulletin generator. Make door stand alone, no
                       need for BRUN45 module. Now programmed using the
                       Microsoft BASIC PDS v7.1. Added the SETUP command
                       line (no external SETUP program needed) --
                       Added maintenance routine and more SysOp
                       configuration options.
                       09/16/91
Version 2.10 ......... Fix for unlocked com ports (Wildcat 3.x only).
Version 3.00 ......... Door recompiled using new door routines. An
                       overall facelift was done. Nicer bulletins.
                       04-25-1992
Version 3.10 ......... Door recompiled using newer door routines.
                       05-17-1992
Version 3.20 ......... Sorry, used the wrong bulletin routines! You must
                       now beat your old score before your score is added
                       to the bulletin. 05-21-92
Version 3.30 ......... Updated to newest door routines. Added the RESET
                       program to the main code via a command string.
                       05-24-92
Version 3.40 ......... Updated to the newest routines. Now supports
                       fossil drivers and the short DOOR.SYS which is
                       created by some BBS packages. The bulletins are
                       now a lot sharper!  11-30-1992
Version 3.50 ......... Added support for COM1-15, better support for
                       WC! IM and PCB/M versions, dropped support for
                       CHAIN.TXT, ENTER prompt now waits for ENTER to
                       be pressed, added better internal error
                       handling routines, new bulletins, increased the
                       max number of glasses you can make to 60,000
                       and also increased the price you may charge,
                       sysop may now set local screen blanking, sysop
                       status line blanking and keyboard timeout.
                       8-30-1993
Version 4.00 ......... Updated to DoorFrame v3.1 routines and added
                       better support for fossil drivers. Added RIP
                       detection that will setup an 80x25 text window
                       for RIP callers. Adjusted bulletin routines,
                       players must now beat their old score to be
                       listed in the TOP TEN (no more duplicate score
                       listing). A util will be added in the near
                       future to listed the top ten most money makers,
                       the player records now contain total plays, and
                       total money made for each user. 01-29-95
Version 4.10 ......... Removed a "shell" command that was causing some
                       problems on certain networks. Recompiled using
                       the latest DoorFrame routines. Added a RESET.NO
                       file for not resetting monthly. Added a DONATED.BY
                       file for giving credit to the person who registered
                       the door. Recompiled the utility program to make
                       things a bit easier.  10-11-95
Version 4.20 ......... Removed all RIP support. Fixed a bug in the
                       routines that checked how many times per day
                       a player played. Increased the number of game
                       days available in unregistered status. 05-02-96
Version 4.30 ......... Minor code optimization. 02-16-97

REGISTERING:
============
visit http://BBSFiles.com to purchase a "vanity" key
