home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / LEMON42.ZIP / LEMON.DOC < prev    next >
Encoding:
Text File  |  1996-05-06  |  15.3 KB  |  334 lines
  1. ┌────────────────────────────────────────────────────────────────────────────┐
  2. │                               LEMONADE!                                    │
  3. │                     COPYRIGHT 1990,96 T&J Software                         │
  4. │                                                                            │
  5. │ One of the T&J Software Collection of multi-BBS door programs. Supporting  │
  6. │ PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire, UltraBBS, Telegard, TriBBS,  │
  7. │ Remote Access, Wildcat! IM, PCBoard/M, and many other BBS formats.         │
  8. │                                                                            │
  9. │                      VERSION 4.20     05/02/96                             │
  10. └────────────────────────────────────────────────────────────────────────────┘
  11.  Tom & Jane Wildoner         VOICE SUPPORT at (717) 325-9480
  12.  397 West Broadway           *between 6:00 and 8:00 p.m. Eastern Time
  13.  Jim Thorpe, PA 18229        BBS SUPPORT at (717) 325-9481 3 Nodes
  14.                              INTERNET: tjsoft@postoffice.ptd.net
  15.                              FIDO: 1:268/400 Freq TJSOFT for info!
  16.                              FTP: ftp.europa.com /outgoing/DOORS/tj-software
  17.                              FTP: ftp.thekeep.com /TJ-Software
  18.  
  19. LATEST VERSION:
  20. ===============
  21. Please call the T&J BBS for the latest version of this program.
  22.  
  23. LEGALITIES:
  24. ===========
  25. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  26. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  27. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  28. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  29. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  30. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  31.  
  32. DISTRIBUTION:
  33. =============
  34. You may make this file available for downloading from your BBS or you may
  35. upload it to any BBS of your choice, provided that you do not make any
  36. changes to the contents of the archive (ZIP file). The archive and its
  37. individual contents may not be used by any service that charges any money
  38. whatsoever, without the written permission of the author.
  39.  
  40. PROGRAM DESCRIPTION:
  41. ====================
  42. LEMONADE is a fairly simple game. Your mother has given you $1.00 to get
  43. your lemonade stand started. The object of the game is to sell as many
  44. glasses of lemonade as possible in a set number of days.
  45.  
  46. After the user hits the 'N' key he will be shown today's weather forecast.
  47. He will then be prompted to enter how many glasses he wants to make followed
  48. by how much to charge per glass.
  49.  
  50. The weather and temperature have a direct bearing on how many glasses will
  51. be sold. If it rains, none will be sold.
  52.  
  53. Once you have a score on the TOP TEN listing, you have to beat your old
  54. score to remake the list. This door resets the scores every month.
  55.  
  56. NOTE:
  57. =====
  58. When you register, you will receive a new LEMON.KEY file. The user is
  59. limited to 4 GAME DAYS until registerd. The user is limited to just
  60. ONE play per day until registered.
  61.  
  62. INSTALLATION:
  63. =============
  64. Run Lemonade with the command line UTILITY to bring up an options
  65. menu to easily install and reset the game!
  66.  
  67. Example:   LEMON UTILITY
  68.  
  69. CONFIGURATION:
  70. =============
  71. Example configuration file for PCBOARD.SYS
  72. ------------------------------------------
  73. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  74. T&J Software        <=-  (Change this to your BBS name)
  75. Tom                 <=-  (The Sysop's first name)
  76. Wildoner            <=-  (The Sysop's last name)
  77.  
  78. Example configuration file for USERS.SYS
  79. ----------------------------------------
  80. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  81. T&J Software        <=-  (Change this to your BBS name)
  82. Tom                 <=-  (The Sysop's first name)
  83. Wildoner            <=-  (The Sysop's last name)
  84.  
  85. Example configuration file for DOOR.SYS
  86. ---------------------------------------
  87. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  88. T&J Software        <=-  (Change this to your BBS name)
  89. Tom                 <=-  (The Sysop's first name)
  90. Wildoner            <=-  (The Sysop's last name)
  91.  
  92. Example configuration file for USERINFO.DAT
  93. -------------------------------------------
  94. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  95. T&J Software        <=-  (Change this to your BBS name)
  96. Tom                 <=-  (The Sysop's first name)
  97. Wildoner            <=-  (The Sysop's last name)
  98. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  99.  
  100. Example configuration file for CALLINFO.BBS
  101. -------------------------------------------
  102. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  103. T&J Software        <=-  (Change this to your BBS name)
  104. Tom                 <=-  (The Sysop's first name)
  105. Wildoner            <=-  (The Sysop's last name)
  106.  
  107. Example configuration file for DORINFOx.DEF
  108. -------------------------------------------
  109. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  110.                           where 'x' is the BBS Node number.
  111. T&J Software        <=-  (Change this to your BBS name)
  112. Tom                 <=-  (The Sysop's first name)
  113. Wildoner            <=-  (The Sysop's last name)
  114.  
  115. Example Batch File
  116. ==================
  117. A sample batch file is included and is similer to the following:
  118.    ECHO OFF
  119.    CD\DOORS\LEMON           <=- Switch to the door's Directory.
  120.    LEMON LEMON.CFG          <=- Execute the door program and pass the
  121.                                 configuration filename to the program.
  122.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  123.    BOARD                    <=- Restart BBS.
  124.  
  125. This Door is multi-node  compatible so you may run more than 1 node from
  126. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  127. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  128. variables, (q.v.)
  129.  
  130. Environment Variables
  131. =====================
  132. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  133. variables. Non-PCBoard systems may also use these variables by including
  134. the following in either your BBS batch or AUTOEXEC.BAT
  135.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  136.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  137. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  138. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  139. .CFG file for multi-node operation!
  140.  
  141. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  142. command line.  For example:
  143.  
  144.      LEMON LEMON.CFG /5
  145. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  146.      LEMON LEMON.CFG /%IRQ%
  147.  
  148. This tells the program to use IRQ 5 instead of the standard IRQ.
  149.  
  150.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  151.  systems. Seems Novell also uses the / character so something went screwy
  152.  somewhere. So I added the * (asterisk) which may be used instead of the /
  153.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  154.  and are interchangeable.
  155.  
  156. When specifying the location of the system file on line 1 of the doors .CFG
  157. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  158. and %wcnodeid%. Some examples:
  159.  PCBoard: 
  160.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  161.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  162.  
  163.  Wildcat!:
  164.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  165.  
  166. Non-PCBoard systems may use the PCB environment variables by setting them
  167. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  168.  SET PCBDRIVE=C:
  169.  SET PCBDIR=\BBSDIR
  170.  SET PCBNODE=1
  171.  
  172. Fossil Driver Support
  173. ---------------------
  174. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  175. Fossil driver instead of the standard COM ports, just put /FD on the command
  176. line when running the door. For example:
  177.      MYDOOR MYDOOR.CFG /FD
  178. indicates that a Fossil driver is present and should be used. If no Fossil
  179. driver is detected, DoorFrame will print a message to that effect and exit
  180. the door gracefully.
  181.  
  182. Sysop Keys
  183. ==========
  184. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  185.          written to DOOR.SYS and USERS.SYS
  186. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  187.          and/or written to DOOR.SYS and USERS.SYS
  188. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  189. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  190.          and/or written to DOOR.SYS and USERS.SYS
  191. F8    -  Returns the caller involuntarily to the BBS.
  192. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  193.          and/or written to DOOR.SYS and USERS.SYS
  194. F10   -  Activates SysOp CHAT mode within the DOOR.
  195. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  196. UP    -  Give the caller extra time while in the DOOR.  
  197. DN    -  Subtract time from the caller while in the DOOR. 
  198. HOME  -  HELP key for Status Line options.
  199. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  200. ALT-X -  PCBoard will exit after current caller logs off. Value is
  201.          passed to PCBoard. Not available on non-PCBoard systems.
  202.  
  203. RESET.NO File:
  204. ==============
  205. By creating a file in the Lemonade directory called RESET.NO the door
  206. will not reset monthly.
  207.  
  208. DONATED.BY File:
  209. ================
  210. By creating a file called DONATED.BY and placing a persons name in the
  211. file, the door will give a credit line to the person for donating to
  212. register the game.
  213.  
  214. SYSOP.CFG FILE:
  215. ===============
  216. Your SYSOP.CFG file should contain ALL the items listed below. You can use
  217. your text editor to edit the provided file.
  218.  
  219. c:\wc30\bull\bull1.scr
  220. c:\wc30\bull\bull1.bbs
  221. 25
  222. 3
  223.  
  224. LINE   1: PATH to your color bulletin.
  225. LINE   2: PATH to your ASCII bulletin.
  226. LINE   3: How many GAME DAYS per play.
  227. LINE   4: How many plays per day.
  228.  
  229. The file MUST have all 4 lines!
  230.  
  231. LOCAL PLAY:
  232. ==========
  233. Simply run Lemonade using the command line LOCAL. This will give you the
  234. option to play door locally using several different people or logon
  235. names.
  236.  
  237. Example: LEMON LOCAL
  238.  
  239. MAINTENANCE!:
  240. ============
  241. None required. The door will reset the scores every month.
  242.  
  243. ADVANCED HELP:
  244. =============
  245. Please consult the TJHELP.TXT file.
  246.  
  247. VERSION HISTORY:
  248. ===============
  249. Version 0.30 BETA..... BETA release. 8/1/90
  250. Version 1.00 ......... First release. 8/9/90
  251. Version 1.10 ......... Fixed remote screen bug associated with using
  252.                        this program under a LIVECAT environment.
  253.                        Fixed an exponential bug associated with very
  254.                        high scores.
  255. Version 1.20 ......... Fixed a small problem in the amount a person
  256.                        can charge per glass of lemonade. It is now very
  257.                        unlikely that anybody can sell a glass of
  258.                        lemonade if they charge more than 50 cents per
  259.                        glass.
  260. Version 1.30 ......... Cleaned up the code to stop the generation of
  261.                        ERROR #6 (number being to large). Program now
  262.                        will only allow users to make 1000 glasses/day
  263.                        and will not allow them to charge more than 100
  264.                        cents per glass.
  265.                        Added bulletin generation outside of the main
  266.                        EXE file. This will give me some room in the code
  267.                        for some future additions.
  268. Version 1.40 ......... Maintenance release to show new BBS name and
  269.                        number. 8/17/91
  270. Version 1.45 ......... Minor BUG fix in the number of glasses.
  271.                        09/01/91
  272. Version 2.00 ......... Now supports WC 2.x and 3.x! Added an internal
  273.                        bulletin generator. Make door stand alone, no
  274.                        need for BRUN45 module. Now programmed using the
  275.                        Microsoft BASIC PDS v7.1. Added the SETUP command
  276.                        line (no external SETUP program needed) --
  277.                        Added maintenance routine and more SysOp
  278.                        configuration options.
  279.                        09/16/91
  280. Version 2.10 ......... Fix for unlocked com ports (Wildcat 3.x only).
  281. Version 3.00 ......... Door recompiled using new door routines. An
  282.                        overall facelift was done. Nicer bulletins.
  283.                        04-25-1992
  284. Version 3.10 ......... Door recompiled using newer door routines.
  285.                        05-17-1992
  286. Version 3.20 ......... Sorry, used the wrong bulletin routines! You must
  287.                        now beat your old score before your score is added
  288.                        to the bulletin. 05-21-92
  289. Version 3.30 ......... Updated to newest door routines. Added the RESET
  290.                        program to the main code via a command string.
  291.                        05-24-92
  292. Version 3.40 ......... Updated to the newest routines. Now supports
  293.                        fossil drivers and the short DOOR.SYS which is
  294.                        created by some BBS packages. The bulletins are
  295.                        now a lot sharper!  11-30-1992
  296. Version 3.50 ......... Added support for COM1-15, better support for
  297.                        WC! IM and PCB/M versions, dropped support for
  298.                        CHAIN.TXT, ENTER prompt now waits for ENTER to
  299.                        be pressed, added better internal error
  300.                        handling routines, new bulletins, increased the
  301.                        max number of glasses you can make to 60,000
  302.                        and also increased the price you may charge,
  303.                        sysop may now set local screen blanking, sysop
  304.                        status line blanking and keyboard timeout.
  305.                        8-30-1993
  306. Version 4.00 ......... Updated to DoorFrame v3.1 routines and added
  307.                        better support for fossil drivers. Added RIP
  308.                        detection that will setup an 80x25 text window
  309.                        for RIP callers. Adjusted bulletin routines,
  310.                        players must now beat their old score to be
  311.                        listed in the TOP TEN (no more duplicate score
  312.                        listing). A util will be added in the near
  313.                        future to listed the top ten most money makers,
  314.                        the player records now contain total plays, and
  315.                        total money made for each user. 01-29-95
  316. Version 4.10 ......... Removed a "shell" command that was causing some
  317.                        problems on certain networks. Recompiled using
  318.                        the latest DoorFrame routines. Added a RESET.NO
  319.                        file for not resetting monthly. Added a DONATED.BY
  320.                        file for giving credit to the person who registered
  321.                        the door. Recompiled the utility program to make
  322.                        things a bit easier.  10-11-95
  323. Version 4.20 ......... Removed all RIP support. Fixed a bug in the
  324.                        routines that checked how many times per day
  325.                        a player played. Increased the number of game
  326.                        days available in unregistered status. 05-02-96
  327.  
  328. REGISTERING:
  329. ============
  330. That's all there is to it! If you have any problems or questions
  331. please feel free to call the T&J BBS at (717)325-9481.
  332.  
  333. See the enclosed registration form for ordering!  (REGISTER.TXT)
  334.