home *** CD-ROM | disk | FTP | other *** search
/ Wildcat Gold - The Optical BBS / Wildcat Gold - The Optical BBS (The Golden ROM Series)(Volume 4 Number 1)(The Digital Publishing Company)(1992).ISO / doors / buck101a.zip / BUCK.DOC < prev    next >
Text File  |  1990-06-25  |  17KB  |  351 lines
  1.  
  2.                                 << Buccaneer >>
  3.  
  4.                             Version 1.01 <FREEWARE>
  5.                            Version 2.01 <REGISTERED>
  6.  
  7.                           +-------------------------+
  8.                           | Cross Connect Software  |
  9.                           |      P.O. Box 131       |
  10.                           | Wheelersburg, OH 45694  |
  11.                           +-------------------------+
  12.                           |   Copyright 1990 by     |
  13.                           |       Alan Graff        |
  14.                           +-------------------------+
  15.  
  16. Versions 1.00 through 1.99 of BUCCANEER are issued as FREEWARE.  Author
  17. retains all benefits of copyright.  Author grants all persons license to
  18. copy and distribute versions 1.00 through 1.99 subject to the following
  19. restrictions and limitations:
  20.  
  21.  1. All original documentation must accompany the program.  The author's
  22.     text may not be altered, but permission is granted to others to append
  23.     minor comments regarding program operation.  Appended comments are not
  24.     to exceed 20 lines and must refer to operation of the program rather than
  25.     personal comments or advertisements.  Appended comments must be signed,
  26.     dated and clearly separated from the author's original text.
  27.  
  28.  2. Removal of author's comments and/or credits from the compiled program
  29.     or support files is prohibited.
  30.  
  31.  3. No charge is to be made for freeware versions of BUCCANEER software over
  32.     and above just and reasonable fees for copying, distribution, postage
  33.     and/or handling costs. In no case shall more than a total of $2.50 (US)
  34.     be charged for the freeware versions of BUCCANEER software.  If you
  35.     are offering BUCCANEER as a downloadable file on data system which
  36.     requires membership fee or charges for online time, said fees are not
  37.     considered to be a part of the aforementioned charges; however in this
  38.     case, no further charge may be levied for access to the data.
  39.  
  40.  4. FREEWARE versions of BUCCANEER will be numbered 1.00 through 1.99.  Any
  41.     version numbered 2.00 or higher is a REGISTERED version and is not to be
  42.     copied by anyone other than the originally registered owner for use on
  43.     their own system.  The registered version of BUCCANEER is only available
  44.     from the author.  Versions obtained from any other source are considered
  45.     to be illegal copies in violation of U.S. copyright law.
  46.  
  47. What BUCCANEER is
  48. -----------------
  49.     BUCCANEER is a game door written for QuickBBS.  It permits users to
  50.     roam about on a 13x13 grid, attacking each other and treasure ships.
  51.     For full details on the rules and how the game is played, read the
  52.     file BUCK.HLP.
  53.  
  54. Running BUCCANEER
  55. -----------------
  56.     The setup and operation of BUCCANEER is pretty straight forward,
  57.     so this documentation file has been kept pretty sparse. If you run
  58.     into problems with the setup of Buccaneer, let me know at one of
  59.     the addresses listed later.  I will endeavor to help you as much as
  60.     is practical, but I think it's fair to warn you that registered owners
  61.     of BUCCANEER will get more assistance than non-registered users.
  62.  
  63.                                 ATTENTION!!!
  64.     =====================================================================
  65.     Records from version 1.00 are not compatible with later versions.
  66.     The files BUCK.CFG and BUCK.USR must be upgraded if you are upgrading
  67.     from version 1.00.   More details on this later....
  68.     =====================================================================
  69.  
  70.     The files needed to run BUCCANEER are:
  71.  
  72.  @  BUCKFREE.EXE  (Main program - Freeware version)
  73.  *  BUCKREG.EXE   (Main program - Registered version)
  74.     BUCK.HLP      (Rules of the game)
  75.     BUCK.CFG      (Configuration file)
  76.     BUCK.ANS      (ANSI welcome screen)
  77.  *  BUCKEDIT.EXE  (User editor)
  78.  @  BUCKDEMO.EXE  (Crippled version of BUCKEDIT.EXE)
  79.     BUCKOUT.EXE   (Manual user remover)
  80.  *  BUCKKILL.EXE  (Automatic user remover)
  81.     BUCKLOC.BAT   (Sample batch file for running the game in local mode)
  82.     BUCKUP.EXE    (Auto upgrade for version 1.00 BUCK.USR file)
  83.  
  84.     Also included in the archive with Buccaneer should be:
  85.  
  86.     BUCK.DOC      (Sysop's manual (This file))
  87.  @  REGISTER.DOC  (Order form for Registered version)
  88.  
  89.     The program will create several support files the first time it is run
  90.     and will update them periodically.  These files are:
  91.  
  92.     BUCK.DAY      (Daily maintenance data)
  93.     BUCK.USR      (User data)
  94.     BUCK.LOG      (Ship's log)
  95.     BUCK.POT      (Current lottery value)
  96.     BUCKKING.SCO  (Last month's high score)
  97.     BUCKHIGH.ASC  (Current high score data file)
  98.     BUCKSHIP.DAT  (Data on ship locations)
  99.  
  100.     (* = Included with registered versions only)
  101.     (@ = Included with freeware versions only)
  102.  
  103.     Most of the files are self-explanatory, for those that are not, here
  104.     are a few comments on them:
  105.  
  106.     BUCKFREE.EXE
  107.     BUCKREG.EXE
  108.     These are the main program.  Run them from QBBS with a type 7 or 15
  109.     command. They may also be run independently.  You must first create a
  110.     dummy exit information file by exiting from your BBS in local mode
  111.     from a type 7 or 15 menu that does not reboot the BBS.  Rename the
  112.     file DORINFO1.DEF to "BUCKLOC.DEF".  Now you may play the game from
  113.     the DOS prompt by typing "BUCKLOC".  Depending on where your game
  114.     program is located, you may have to edit BUCKLOC.BAT to include a
  115.     directory change or something of that nature.
  116.  
  117.     BUCKUP.EXE
  118.     Those of you who ran version 1.00 (sorry about all those bugs) will
  119.     need to run BUCKUP.EXE once in your main game directory to update the
  120.     user records to be compatible with this version.  Once this has been
  121.     done you may delete BUCKUP.EXE.  Your original user records are saved
  122.     as a backup file until you are sure the transfer has been successful.
  123.     Delete the backup file BUCKUSR.BAK when you are satisfied all is going
  124.     as it should.
  125.  
  126.     BUCK.CFG
  127.     Sysops who ran version 1.00 should revise their copy of this file to
  128.     the new format.
  129.     This file tells the main program where things are located and sets some
  130.     of the user configurable variables in the registered version.  You should
  131.     edit BUCK.CFG using an ASCII text editor to reflect your system setup.
  132.     A sample file with comments is included to help understand the correct
  133.     format of this file.   If a BUCK.CFG file does not exist BUCCANEER will
  134.     try to create one using default values.
  135.  
  136.     BUCK.LOG
  137.     This file is straight ASCII text that contains events of interest to
  138.     the players about their opponents recent activity.  This is a
  139.     self-maintaining file that limits itself to 100 lines.  It may be
  140.     altered with any ASCII text editor if needed.
  141.  
  142.     BUCKEDIT.EXE
  143.     Registered users should put BUCKEDIT.EXE in the same directory as
  144.     BUCKREG.EXE so that they may access it from inside the program. More
  145.     about this file later....
  146.  
  147.     BUCKOUT.EXE
  148.     This is a manual user killer which must be run from the DOS prompt
  149.     in the same directory as BUCK.USR.  Simply enter the REAL NAME
  150.     of the user you wish to remove when prompted and their record will
  151.     be purged.
  152.  
  153.     BUCKKILL.EXE
  154.     This utility requires an integer parameter between 1 and 365 to
  155.     determine how many days a player may be inactive before being
  156.     removed.  Run BUCKKILL during your daily maintenance activities
  157.     in the same directory that BUCK.USR resides.
  158.     Example, "BUCKKILL 30" (without the quote marks) will remove all
  159.     players from the records who have not played in the last 30 days.
  160.  
  161. Disclaimer
  162. ----------
  163.     I have tested BUCCANEER on a Laser Turbo XT with 640 KB RAM running
  164.     QuickBBS and have found no serious flaws in the program. If you run
  165.     across one, please contact me so that it may be corrected in the next
  166.     version.  If you have any suggestions on how BUCCANEER could be
  167.     improved, they are also welcome. I will try to incorporate any sug-
  168.     gestions that seem practical in the next version.  Improvements will
  169.     first appear in the registered version.  Depending on their nature,
  170.     they may or may not be filtered down to the freeware versions.
  171.     I have done my best to debug this program.  To my knowledge it should
  172.     not cause undue harm to any system if operated according to these
  173.     instructions.  Alan Graff and/or Cross Connect Software will not be
  174.     held responsible for loss of data or damage to software or hardware
  175.     that might be caused by the operation of this program.
  176.  
  177. About SHAREWARE/FREEWARE/REGISTERED/TRADEWARE designations
  178. ----------------------------------------------------------
  179.     Shareware:
  180.     As a sysop (or prospective sysop) who downloaded this program, I am
  181.     certain that you are by now aware of what SHAREWARE is.  I won't bore
  182.     you with the details.  Anyway, this program is not shareware.
  183.  
  184.     Freeware:
  185.     Versions 1.00 thru 1.99 of this program are FREEWARE.  This means you
  186.     are free to use them with no obligation whatsoever of registration with
  187.     the author.  Enjoy.
  188.  
  189.     Registered:
  190.     The REGISTERED version (available for $10 from the author) is labeled
  191.     Version 2.00 or higher.  The registered version appears almost identical
  192.     to the players, but includes extensive sysop utilities to give you
  193.     better control of the game.  Distribution of the registered version by
  194.     anyone other than the author or his representatives is a violation of
  195.     U.S.Copyright laws.
  196.  
  197.     Tradeware:
  198.     If you are a software author with legitimate shareware or registered
  199.     programs in distribution, you may also apply for a waiver of the cost
  200.     of the REGISTERED version in exchange for a copy of the REGISTERED
  201.     version of one of your programs.  Send a 5.25" DSDD floppy with your
  202.     REGISTERED program along with the registration form included in this
  203.     archive and a registered copy of BUCCANEER will be returned to you
  204.     after your program is reviewed.  Please, no rip-off programs...if
  205.     your program isn't worth registering, don't expect me to send you
  206.     a registered version of BUCCANEER...your disk will be returned.
  207.     QBBS utilities and doors are prefered, but all types of programs will
  208.     be considered.
  209.  
  210. Options available on the REGISTERED version.
  211. --------------------------------------------
  212.     The registered version of this game plays the same as the freeware
  213.     version, but includes the program file BUCKEDIT.EXE, a multi-function
  214.     user editor/creator which may be accessed while online either during
  215.     game play or as a stand-alone door.  Although the freeware version
  216.     also permits you to shell to DOS, it runs BUCKDEMO.EXE instead, a
  217.     demonstration of BUCKEDIT which does NOT save changes to disk.
  218.     The registered version also permits you to set the cost of certain
  219.     items, the number of turns per day and the security level for the
  220.     "cheat" switch.  These items are specified in the file BUCK.CFG.
  221.     Finally, the registered version includes BUCKKILL.EXE, an automatic
  222.     user remover that deletes inactive players after a specified number
  223.     of days.
  224.  
  225.     Registration is $10 or tradeware exchange.  See above for further info
  226.     on the tradeware concept.
  227.  
  228. About BUCKEDIT and BUCKDEMO
  229. ---------------------------
  230.  
  231.     The comments about BUCKEDIT.EXE below also apply to BUCKDEMO.EXE
  232.     except that BUCKDEMO does not save changes to the disk.
  233.  
  234.     BUCKEDIT.EXE should be placed in the same directory as BUCKREG.EXE.
  235.     When you answer "Y" to the cheat option at log-in, you will have an
  236.     extra line on the main menu labeled "*> BUCKEDIT (Sysop Utilities)"
  237.     which will shell out of the game and run BUCKEDIT.  While in BUCKEDIT
  238.     you may change any of the game variables including player data, the
  239.     spanish armada data and treasure ship data.  You may also create new
  240.     players.  BUCKEDIT will currently not permit you to delete players,
  241.     that's scheduled for the next version.  You'll have to use BUCKOUT
  242.     or BUCKKILL for the present time.
  243.     Changes made and saved while in BUCKEDIT will become effective as
  244.     soon as you return to the game in progress.  No changes made with
  245.     BUCKEDIT are mentioned in the "Ship's Log".
  246.  
  247.     The menu of BUCKEDIT is pretty straight-forward, I don't think much
  248.     explanation is needed.  Just play around with it a little bit and I
  249.     think you'll get the hang of it.
  250.  
  251.     If you get the message "DOS ERROR" when you try to use BUCKEDIT while
  252.     online, it may mean you do not have sufficient memory available.  If
  253.     you have been using a type 7 menu exit, you may want to try a type 15.
  254.     If this does not help, you will need to install additional RAM memory.
  255.     This program was tested on an XT compatible with 640K RAM and had
  256.     no problems with a type 7 exit in using BUCKEDIT from inside the game.
  257.  
  258.     BUCKEDIT may also be configured as a stand-alone menu item using a type
  259.     7 or 15 exit. Remember that BUCKEDIT must be located in the same direc-
  260.     tory as BUCK.USR to be able to access player records.
  261.  
  262.     To operate BUCKEDIT from the DOS prompt, type "BUCKEDIT L" (without
  263.     the quotes [of course]) and press enter.
  264.  
  265. Things to come
  266. --------------
  267.  
  268.     Some of the things I hope to be able to add in future versions of
  269.     BUCCANEER:
  270.  
  271.     User info display for sysop while user is online.
  272.     Hotkey menus.
  273.     Online chat.
  274.     Twit switch.
  275.     Sysop definable flags to lock out certain functions.
  276.     On-screen display of user's variables while using BUCKEDIT.
  277.  
  278.     Whether these changes are made or not depends largely on the
  279.     continued popularity of BUCCANEER.  Thanks to everyone who has
  280.     called about it so far!
  281.  
  282. Parting comments & credits
  283. --------------------------
  284.     BUCCANEER was written by Alan Graff, sysop of Cross Connect BBS.
  285.     Cross Connect has been online continuously (more or less) since
  286.     Sept. 1988.  Cross Connect logs over 4000 calls per year.
  287.  
  288.     Thanks to:
  289.     Linda Adams, Paul Adams, Jack Freeland, Don Peart and Al Reed
  290.     for being my early victims during tests on Cross Connect;
  291.     John Parlin for writing JPDOOR, without which the I/O would not
  292.     have been possible; and God for giving me the talent to be able
  293.     to write this program in the first place.
  294.  
  295.     BUCCANEER was written and compiled in Turbo Pascal 5.5. and uses
  296.     JPDoor 2.4 (registered) for fossil and QBBS interface operations.
  297.  
  298.     Buccaneer (c) 1990 by Alan Graff
  299.     Turbo Pascal 5.5 (c) 1983, 1989 by Borland International, Inc.
  300.     JPDoor 2.4 (c) 1989,1990 by John Parlin.
  301.     QuickBBS, QBBS (c) 1990 by QuickBBS Group, Inc. and/or Ultimate
  302.     Software Technologies, Inc.
  303.  
  304. Blatant plug
  305. ------------
  306.  
  307.     CROSS CONNECT BBS (614) 776-7136
  308.     24 hour operation
  309.     Communication parameters: 8-N-1
  310.     Support of 300, 1200 and 2400 baud.
  311.     Minimum of 1200 baud required for downloads.
  312.     Long Distance callers should pre-register by sending a SASE to:
  313.  
  314.          Cross Connect Software
  315.          LD Registration
  316.          P.O. Box 131
  317.          Wheelersburg, OH 45694
  318.  
  319.     I will return a full-access password for you to use.
  320.  
  321.     I may be contacted via GEnie at A.GRAFF1, but don't expect a quick reply,
  322.     since it's a long distance call for me.
  323.  
  324. REGISTERED SYSTEMS
  325. ------------------
  326.   Reg# BBS PHONE          BBS Name & location
  327.   ---- -------------      -------------------
  328.   0001 (614)776-7136  [A] Cross Connect BBS, Wheelersburg, OH
  329.   0002 (612)938-4301  [T] City Terminal BBS, Hopkins, MN
  330.   0003 (414)796-8408  [T] TopSoft Support BBS, Brookfield, WI
  331.   0004 (???)???-????  [?] Your BBS could be here!  Register today!
  332.  
  333. BUCCANEER History
  334. ----------------
  335.  
  336.     <<= FREEWARE VERSIONS =>>
  337.     Beta version  - April ??, 1990 - Not released for distribution.
  338.     Version 1.00  - April 27, 1990 - First freeware release.
  339.     Version 1.01  - June 25, 1990  - Second freeware release.
  340.             1.01a - June 25, 1990  - Buckdemo inability to pick new
  341.                                      user bug fixed.
  342.  
  343.     <<= REGISTERED VERSIONS =>>
  344.     Version 2.01  - June 23, 1990  - First registered release.
  345.             2.01a - June 25, 1990  - Buckedit inability to run from
  346.                                      subdirectory bug fixed.
  347.  
  348.  
  349. End of original documentation
  350. -----------------------------------------------------------------------------
  351.