home *** CD-ROM | disk | FTP | other *** search
/ CD Shareware Magazine 1997 January / CD_shareware_1-97.iso / DOS / COMUNICA / SCRAM41.ZIP / SCRAMBLE.DOC < prev    next >
Encoding:
Text File  |  1996-09-01  |  13.6 KB  |  293 lines
  1.  
  2.                      ┌──────────────────────────────┐
  3.                      │==============================│
  4.                      │       S C R A M B L E !      │
  5.                      │==============================│
  6.                      │                              │
  7.                      │COPYRIGHT 1991,96 T&J SOFTWARE│
  8.                      └──────────────────────────────┘
  9.  
  10.         One of the T&J Software Collection of multi-BBS door programs.
  11.  
  12.                        VERSION 4.10      09-01-1996
  13.  
  14.                                     By
  15.  
  16.  Tom & Jane Wildoner         VOICE SUPPORT at (717) 325-9480
  17.  397 West Broadway           *between 6:00 and 8:00 p.m. Eastern Time
  18.  Jim Thorpe, PA 18229        BBS SUPPORT at (717) 325-9481 3 Nodes
  19.                              INTERNET: tjsoft@postoffice.ptd.net
  20.                              FIDO: 1:268/400 Freq TJSOFT for info!
  21.                              FTP: ftp.europa.com /outgoing/DOORS/tj-software
  22.                              FTP: ftp.thekeep.com /TJ-Software
  23.                              FTP: ftp.tjsoft.com /pub
  24.                              WWW: http://www.tjsoft.com
  25.  
  26. ─────────────────────────────────────────────────────────────────────────────
  27.                                LEGALITIES
  28.                                ~~~~~~~~~~
  29.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  30.       WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  31.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  32.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  33.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  34.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  35.       OR BREACH OF ANY WARRANTY.
  36. ─────────────────────────────────────────────────────────────────────────────
  37.                                  SUPPORT
  38.                                  ~~~~~~~
  39. Please feel free to call me at my BBS number or voice number.
  40. ─────────────────────────────────────────────────────────────────────────────
  41.                                DISTRIBUTION
  42.                                ~~~~~~~~~~~~
  43. You may make this file available for downloading from your BBS or you may
  44. upload it to any BBS of your choice, provided that you do not make any
  45. changes to the contents of the archive (ZIP file). The archive and its
  46. individual contents may not be used by any service that charges any money
  47. whatsoever, without the written permission of the author.
  48. ─────────────────────────────────────────────────────────────────────────────
  49.                               REGISTERING
  50.                               ~~~~~~~~~~~
  51. Scramble will only use the first 100 words from the list of over
  52. 30,000 words until registered.
  53.  
  54. Once registered -- it will unlock all the features of the registered
  55. version including the full 30,000+ word lists!
  56.  
  57. See the enclosed REGISTER.TXT for ordering information. T&J Software
  58. BBS also uses Visa and Mastercard - please call the BBS for details.
  59. ─────────────────────────────────────────────────────────────────────────────
  60.                      INSTALLATION:     IMPORTANT!!!!!!!
  61.                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  62. Run Scramble using the command line UTILITY.
  63.  
  64. Example: SCRAMBLE UTILITY
  65.  
  66. Then, reset the door from scratch. You can also easily setup your
  67. configuration files this way!
  68. ─────────────────────────────────────────────────────────────────────────────
  69.                                 UPGRADING
  70.                                 ~~~~~~~~~
  71. From v4.0 to v4.1:
  72. ~~~~~~~~~~~~~~~~~
  73. Replace the .EXE file(s) and all the SCR0*.* files. Also, delete
  74. lines 2 and 6 from the SYSOP.CFG file or the game will not run!
  75. Worse comes to worse, overwrite the SYSOP.CFG with the one from this
  76. .ZIP file and edit it.
  77.  
  78. From prior to v4.0:
  79. ~~~~~~~~~~~~~~~~~~
  80. Erase everything (except your .KEY <G>) and re-install the door
  81. from scratch!
  82. ─────────────────────────────────────────────────────────────────────────────
  83.                               CONFIGURATION
  84.                               ~~~~~~~~~~~~~
  85. Example configuration file for PCBOARD.SYS
  86. ------------------------------------------
  87. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.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 USERS.SYS
  93. ----------------------------------------
  94. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS 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.  
  99. Example configuration file for DOOR.SYS
  100. ---------------------------------------
  101. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  102. T&J Software        <=-  (Change this to your BBS name)
  103. Tom                 <=-  (The Sysop's first name)
  104. Wildoner            <=-  (The Sysop's last name)
  105.  
  106. Example configuration file for USERINFO.DAT
  107. -------------------------------------------
  108. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  109. T&J Software        <=-  (Change this to your BBS name)
  110. Tom                 <=-  (The Sysop's first name)
  111. Wildoner            <=-  (The Sysop's last name)
  112. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  113.  
  114. Example configuration file for CALLINFO.BBS
  115. -------------------------------------------
  116. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  117. T&J Software        <=-  (Change this to your BBS name)
  118. Tom                 <=-  (The Sysop's first name)
  119. Wildoner            <=-  (The Sysop's last name)
  120.  
  121. Example configuration file for DORINFOx.DEF
  122. -------------------------------------------
  123. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  124.                           where 'x' is the BBS Node number.
  125. T&J Software        <=-  (Change this to your BBS name)
  126. Tom                 <=-  (The Sysop's first name)
  127. Wildoner            <=-  (The Sysop's last name)
  128. ─────────────────────────────────────────────────────────────────────────────
  129.                             Example Batch File
  130.                             ~~~~~~~~~~~~~~~~~~
  131. A sample batch file is included and is similer to the following:
  132.    ECHO OFF
  133.    CD\DOORS\SCRAM           <=- Switch to the door's Directory.
  134.    SCRAMBLE SCRAMBLE.CFG    <=- Execute the door program and pass the
  135.                                 configuration filename to the program.
  136.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  137.    BOARD                    <=- Restart BBS.
  138.  
  139. This Door is multi-node  compatible so you may run more than 1 node from
  140. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  141. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  142. variables, (q.v.)
  143. ─────────────────────────────────────────────────────────────────────────────
  144.                            Environment Variables
  145.                            ~~~~~~~~~~~~~~~~~~~~~
  146. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  147. variables. Non-PCBoard systems may also use these variables by including
  148. the following in either your BBS batch or AUTOEXEC.BAT
  149.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  150.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  151. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  152. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  153. .CFG file for multi-node operation!
  154.  
  155. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  156. command line.  For example:
  157.  
  158.      SCRAMBLE SCRAMBLE.CFG /5
  159. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  160.      SCRAMBLE SCRAMBLE.CFG /%IRQ%
  161.  
  162. NOTE: The .CFG filename is not unique, it can be changed to anything
  163.       you wish!
  164.  
  165. This tells the program to use IRQ 5 instead of the standard IRQ.
  166.  
  167.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  168.  systems. Seems Novell also uses the / character so something went screwy
  169.  somewhere. So I added the * (asterisk) which may be used instead of the /
  170.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  171.  and are interchangeable.
  172.  
  173. When specifying the location of the system file on line 1 of the doors .CFG
  174. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  175. and %wcnodeid%. Some examples:
  176.  PCBoard: 
  177.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  178.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  179.  
  180.  Wildcat!:
  181.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  182.  
  183. Non-PCBoard systems may use the PCB environment variables by setting them
  184. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  185.  SET PCBDRIVE=C:
  186.  SET PCBDIR=\BBSDIR
  187.  SET PCBNODE=1
  188. ─────────────────────────────────────────────────────────────────────────────
  189.                             Fossil Driver Support
  190.                             ~~~~~~~~~~~~~~~~~~~~~
  191. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  192. Fossil driver instead of the standard COM ports, just put /FD on the command
  193. line when running the door. For example:
  194.      MYDOOR MYDOOR.CFG /FD
  195. indicates that a Fossil driver is present and should be used. If no Fossil
  196. driver is detected, DoorFrame will print a message to that effect and exit
  197. the door gracefully.
  198. ─────────────────────────────────────────────────────────────────────────────
  199.                                 Sysop Keys
  200.                                 ~~~~~~~~~~
  201. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  202.          written to DOOR.SYS and USERS.SYS
  203. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  204.          and/or written to DOOR.SYS and USERS.SYS
  205. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  206. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  207.          and/or written to DOOR.SYS and USERS.SYS
  208. F8    -  Returns the caller involuntarily to the BBS.
  209. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  210.          and/or written to DOOR.SYS and USERS.SYS
  211. F10   -  Activates SysOp CHAT mode within the DOOR.
  212. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  213. UP    -  Give the caller extra time while in the DOOR.  
  214. DN    -  Subtract time from the caller while in the DOOR. 
  215. HOME  -  HELP key for Status Line options.
  216. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  217. ALT-X -  PCBoard will exit after current caller logs off. Value is
  218.          passed to PCBoard. Not available on non-PCBoard systems.
  219. ─────────────────────────────────────────────────────────────────────────────
  220.                            YOUR CONFIGURATION FILE
  221.                            ~~~~~~~~~~~~~~~~~~~~~~~
  222. Change the SYSOP.CFG file to meet your needs:
  223.  
  224. 20
  225. N
  226. C:\WILDCAT\BULL\BULL1.SCR
  227. C:\WILDCAT\BULL\BULL1.BBS
  228. 4
  229.  
  230. LINE 1: Number of words/play a user may attempt.
  231. LINE 2: Tournament mode (Y or N)
  232. LINE 3: Path & Filename to your color bulletin.
  233. LINE 4: Path & Filename to your ASCII bulletin.
  234. LINE 5: How many times a player may enter the door per day.
  235.  
  236. Wildcat! 3.x and 4.x and BULLETINS: The color bulletin should end with
  237. the .SCR extension, and the mono bulletin should end with a .BBS
  238. extension - trust me! <G>
  239.  
  240.                            YOUR TIME LIMIT FILE
  241.                            ~~~~~~~~~~~~~~~~~~~~
  242. You may adjust the amount of time a user has to figure out the scrambled
  243. word by editing a file called TIMEUP.DAT. Here's the structure of that
  244. file:
  245.  
  246. 100
  247. 50
  248. 25
  249.  
  250. LINE 1: Increased time (in seconds) for EASY LEVEL.
  251. LINE 2: Increased time (in seconds) for MEDIUM LEVEL.
  252. LINE 3: Increased time (in seconds) for HARD LEVEL.
  253.  
  254. ─────────────────────────────────────────────────────────────────────────────
  255.                               TOURNAMENT MODE
  256.                               ~~~~~~~~~~~~~~~
  257. Turning tournament mode on does the following: The first player of the
  258. day will have to wait a few seconds until the tournament words are
  259. selected. Next, the tournament words will be compiled into a file
  260. called TOURNY.TXT. All users who play today will get the same words
  261. (scrambled differently).
  262. ─────────────────────────────────────────────────────────────────────────────
  263.                                 LOCAL MODE
  264.                                 ~~~~~~~~~~
  265. To run in LOCAL mode simply run SCRAMBLE using the LOCAL command line:
  266.  
  267. Example: SCRAMBLE LOCAL
  268. ─────────────────────────────────────────────────────────────────────────────
  269.                                 RESETTING
  270.                                 ~~~~~~~~~
  271. Scramble will reset at the first of each month -- no maintenance
  272. needed. However, you can reset Scramble any time you wish using the
  273. UTILITY command string and then selecting the appropriate menu
  274. item.
  275. ─────────────────────────────────────────────────────────────────────────────
  276.                                 WORD LISTS
  277.                                 ~~~~~~~~~~
  278. Word lists are now history, we've compiled the words into one large
  279. database of words. This has dramatically increased the speed of the
  280. door!
  281. ─────────────────────────────────────────────────────────────────────────────
  282.                               VERSION HISTORY
  283.                               ~~~~~~~~~~~~~~~
  284. See HISTORY.TXT file.
  285. ─────────────────────────────────────────────────────────────────────────────
  286. That's all there is to it! If you have any problems or questions
  287. please feel free to call the T&J BBS at (717)325-9481.
  288.  
  289. See the REGISTER.TXT file for registering.
  290.  
  291. Your users will get a lot of duplicate words until the game is
  292. registered.
  293.