home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_GAME / DODGE101.ZIP / DODGE.DOC < prev    next >
Text File  |  1992-12-16  |  23KB  |  685 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                     ╥─┐ ╓─┐ ╥─┐ ╓─┐ ╥─┐     ╥─┐ ╓─┐ ╖   ╖
  9.                     ║ │ ║ │ ║ │ ║ ┬ ╟─      ╟─┤ ╟─┤ ║   ║
  10.                     ╨─┘ ╙─┘ ╨─┘ ╙─┘ ╨─┘     ╨─┘ ╜ └ ╙─┘ ╙─┘
  11.  
  12.                                  version 1.0
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.                               by Michael Wilson
  43.  
  44.                                  The Village
  45.                                 408-229-0706
  46.                         USR Courier HST Dual Standard
  47.                                2400/9600/16.8K
  48.                               24 hours / 7 days
  49.  
  50.  
  51.  
  52.  
  53.  
  54.                                 CONTENTS
  55.                                 ════════
  56.  
  57.    I.   Introduction
  58.         a. Overview
  59.         b. Background
  60.         c. Tools
  61.         d. Restrictions in the unregistered version
  62.         e. Benefits of registering
  63.         f. Support
  64.  
  65.    II.  Setup
  66.         a. Supported BBS Systems
  67.         b. Configuration File
  68.         c. Local Mode
  69.         d. Multi-Node Support
  70.  
  71.    III. Use
  72.         a. On-Line Sysop Keys
  73.         b. On Line instructions
  74.         c. DB_BULL.EXE
  75.  
  76.    IV.  Compufax Software
  77.  
  78.    V.   Registration Information and Form
  79.  
  80.    VI.  Bug report form
  81.  
  82.    VII. Revision History
  83.  
  84.  
  85.  
  86.  
  87.                               INTRODUCTION
  88.                               ════════════
  89.  
  90. Overview
  91. ────────
  92.  
  93.    DODGE BALL is a  fun interactive door game.   The players try to  avoid the
  94.    moving  balls,  while  picking  up  treasure.   The player with the highest
  95.    score wins!  Because the number of balls increase with each new level, it
  96.    takes more time to move all the balls.  So, you may see a slow down at
  97.    2400.  There does not seem to be any noticeable slowness at 9600 or
  98.    greater.
  99.  
  100.  
  101. Background
  102. ──────────
  103.  
  104.    The Game is the result of several weeks thinking about a NEW and unique
  105.    game that is quick to play, easy to understand, yet not to easy to win.
  106.  
  107.  
  108. Tools
  109. ─────
  110.  
  111.         Language and Compiler:  Borland C 3.1
  112.  
  113.         Editor:                 Multi-Edit 6.10aP
  114.  
  115.         Libraries:              CKit Door Library 2.54
  116.  
  117.         Version Control:        Sage's PVCS
  118.  
  119.         Beta Test:              The Haunted Castle BBS (Spitfire)
  120.                                     408-226-1052
  121.                                 The LaserBoard (Wildcat)
  122.                                     408-268-6323
  123.                                 The Village (Wildcat)
  124.                                     408-229-0706
  125.  
  126.         Tea:                    Earl Grey, Hot (Bigelow)
  127.  
  128.  
  129.  
  130.  
  131. Restrictions in the unregistered version
  132. ────────────────────────────────────────
  133.  
  134.    This door is fully functional in the unregistered version.  However, there
  135.    will be a pause at the beginning and the end in the unregistered mode.
  136.    You may also not change line 5 in the configuration file.
  137.  
  138. Benefits of registering
  139. ───────────────────────
  140.  
  141.    1. All delays and reminders are removed.
  142.  
  143.    2. A 1 year membership in The Village BBS.
  144.  
  145.    3. All future updates FREE, downloaded from The Village BBS.
  146.  
  147.    4. Ability to change lines 5 in the config file.
  148.  
  149. Support
  150. ───────
  151.  
  152.    Snail-Mail:  Compufax Consulting Services
  153.                 7145 Aptos Beach Court
  154.                 San Jose, CA  95139
  155.  
  156.    BBS:   The Village
  157.           408-229-0706
  158.           USR Courier HST Dual Standard 16.8k
  159.           Leave comment for the SYSOP in the Main Conference [000]
  160.  
  161.    Voice Mail:  408-496-9045  (24 hours/day)
  162.  
  163.    CompuServe:  76207,1673
  164.  
  165.  
  166.    Please include all available information including copies of your
  167.    THOUGHT.CFG files.
  168.  
  169.  
  170.    The latest version will always be available on the following boards:
  171.  
  172.         The Village:
  173.                 408-229-0706
  174.                 USR Courier HST Dual Standard 16.8k
  175.                 Michael Wilson, sysop
  176.  
  177.         The Haunted Castle BBS:
  178.                 408-226-1052
  179.                 USR Courier HST Dual Standard 14.4k
  180.                 David Clifford, sysop
  181.  
  182.         CompuServe:  IBM BBS Forum (GO IBMBBS), Doors Library
  183.  
  184.  
  185.  
  186.                                   SETUP
  187.                                   ═════
  188.  
  189. Supported BBS Systems
  190. ─────────────────────
  191.  
  192.    DODGE BALL will support any BBS that creates a DOOR.SYS file when
  193.    chaining to a door.  Also, Wildcat 2.x (CALLINFO.BBS), DORINFOx.DEF
  194.    and PC Board - 12.x through 14.x (PCBOARD.SYS) are supported.
  195.  
  196. Customization of the Game
  197. ─────────────────────────
  198.  
  199.    The following DODGE BALL Features are fully customizable by you so
  200.    that you can make your own distinct page door:
  201.  
  202.    * Numbers of plays per player, per day
  203.  
  204.  
  205.  
  206.  
  207.                              CONFIGURATION FILE
  208.                              ══════════════════
  209.  
  210.    DODGE BALL knows what type of system you are using, and what to do through a
  211.    configuration file.  The configuration file can have any legal DOS
  212.    filename.  It consists of 14 lines as follows:
  213.  
  214.    line 1:     c:\door\door.sys
  215.    line 2:     The Village
  216.    line 3:     Michael Wilson
  217.    line 4:     0000000000
  218.   *line 5:     5
  219.    line 6:     ANSI
  220.    line 7:     BULL99.ANS
  221.    line 8:     BULL99.ASC
  222.    line 9:     NONE
  223.  
  224.    *These items cannot be changed in the UNREGISTERED version.
  225.  
  226.    NOTE: The line numbers are only listed for clarity.  Your configuration
  227.    file will have no line numbers listed
  228.  
  229.    LINE 1: This is the complete drive letter, path and filename of your
  230.            BBS door system file.  This can be either DOOR.SYS,
  231.            CALLINFO.BBS, PCBOARD.SYS and DORINFOx.DEF.
  232.  
  233.    LINE 2: This is the name of your BBS.  It must EXACTLY match the name
  234.            of the BBS you put on the registration form.  Upper and lower
  235.            case make a difference here.  This name will be displayed
  236.            EXACTLY as entered here when the door is registered.
  237.  
  238.    LINE 3: This is the name of the sysop.  This name must EXACTLY match
  239.            the name entered on the registration form.  Upper and lower
  240.            case make a difference.  This name will be displayed as the
  241.            sysop when the door is registered.
  242.  
  243.    LINE 4: The registration number obtained when you register.
  244.  
  245.    LINE 5: This is the number of plays per player, per day.  The maximum here
  246.            is 99.  In the unregistered version, the limit is 5.
  247.  
  248.  
  249.  
  250.    LINE 6: This is the type of bulletins you want to create.  The 2 options
  251.            are WILDCAT3 or ANSI.  WILDCAT3 will create a bulletin using the
  252.            WILDCAT 3.x color code variables.  ANSI will create bulletins
  253.            using the ANSI escape sequence color codes.
  254.  
  255.    LINE 7: This is the complete path and name of your color bulletin.  Any
  256.            legal DOS path and file name are acceptable.
  257.  
  258.    LINE 8: This is the complete path and filename of your monochrome
  259.            bulletin.  If you are using WILDCAT3 in line 6, then this line
  260.            would be blank, as it is ignored.
  261.  
  262.    LINE 9: This line is for  non-standard comm port parameters.  If  you do
  263.            not  use  a  standard  comm  port  setup,  then  the  syntax  is
  264.            PORT:AAAA:X where  AAAA is  the base  address and  X is the IRQ.
  265.            DODGE BALL  will  also  support  the  use  of FOSSIL drivers.  The
  266.            syntax for a FOSSIL driver is: PORT:F:P. The 'F' tells  DODGE BALL
  267.            to  use  a  Fossil  driver  for  it's  communications.   The 'P'
  268.            following  it  tells  it  which  port  to  use  for  the Fossil.
  269.            Example - PORT:F:1,  tells DODGE BALL to  use a fossil  driver for
  270.            port 1.  If you use  a standard port setup, place the  word NONE
  271.            here.
  272.            Digiboard Intelligent Async boards are  supported thru the
  273.            Universal DOS driver for Digiboard.  The syntax is the same as the
  274.            Fossil driver except you replace the F with D and give the channel
  275.            number to use.  Example - PORT:D:6 tells DODGE BALL that it is
  276.            connected to a Digiboard and to use channel 6 on the Digiboard.
  277.  
  278.  
  279.  
  280. Sample Door Batch File
  281. ──────────────────────
  282.  
  283.    The configuration filename is placed on the command line of
  284.    DODGE.EXE.  Here is a sample batch file to give you an idea of
  285.    how the door is called:
  286.  
  287.           C:
  288.           CD\DODGE
  289.           DODGE DODGE.CFG
  290.           DB_BULL DODGE.CFG
  291.           CD\
  292.  
  293.    If the configuration file is missing, or incorrectly made, an error
  294.    will be displayed.
  295.  
  296. Local Mode
  297. ──────────
  298.  
  299.    The door  can be  tested in  Local Mode,  although, you'll  have to talk to
  300.    yourself,  by having the  config file point to a  BBS door file that has  a
  301.    comm port of zero (COM0:).  Included are the following files:
  302.  
  303.         LOCAL.BAT
  304.         LOCAL.CFG
  305.         DOOR.SYS
  306.  
  307.    These will assist you in testing the door in local mode.  If you want  your
  308.    name  displayed  instead  of  "SYSOP",  edit  DOOR.SYS and replace the word
  309.    SYSOP with your name.
  310.  
  311.    Simply  typing  LOCAL  with  the  above  files  in  the  current directory,
  312.    therefore, will put the door in local mode.
  313.  
  314. On-Line Instructions
  315. ────────────────────
  316.  
  317.    When the game first comes up, the caller is offered on-line instructions.
  318.    This is the best way to remind the caller of how to play the game, and the
  319.    special treasures.
  320.  
  321.  
  322.  
  323.                                    DB_BULL
  324.                                    ═══════
  325.  
  326.    DB_BULL is used to create your top ten players bulletins.  It is split  out
  327.    from the  main program  to make  Dodge Ball  smaller and  faster.   It also
  328.    gives  the  sysop  greater  freedom  as  to  when  the  bulletins are to be
  329.    created.
  330.  
  331.    Usage is simple.   Invoke DB_BULL with the  name of your DODGE  BALL config
  332.    file on the command line.  For  example, if your DODGE BALL config file  is
  333.    called DODGE.CFG, then do this:
  334.  
  335.         DB_BULL DODGE.CFG
  336.  
  337.    DB_BULL will  read the  registration information,  bulletin color  type and
  338.    path/name of your color and mono bulletins, and will create them.
  339.  
  340.    DODGE BALL  does not  create any  bulletins during  normal operation.   You
  341.    must run DB_BULL to create the  bulletins.  If you want bulletins  that are
  342.    up to the minute, then have your batch file be something like this:
  343.  
  344.         @ECHO OFF
  345.         CD\DOORS\DODGE
  346.         DODGE DODGE.CFG
  347.         DB_BULL DODGE.CFG
  348.         CD\WC
  349.  
  350.    DB_BULL also purges all players from the previous month.  This means that
  351.    each player has a chance to beat the high score, or be number 1 for any
  352.    month.  The overall high score, however, is kept and displayed at the top
  353.    of the bulletin.  So, all scores are reset each month, but the highest
  354.    score is kept month after month.
  355.  
  356.    The file DB_BULL.DAT contains the name and score of the highest scorer.
  357.    Erase this file to reset the highest score.
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.                              MULTI-NODE SUPPORT
  365.                              ══════════════════
  366.  
  367.    DODGE BALL does not support  true multi-node interactive play between  2 or
  368.    more callers.   However, you can  have 2 people  playing DODGE ball  at the
  369.    same time, on different nodes
  370.  
  371.    The main setup  difference from single  to multi-node is  the configuration
  372.    file.  Since the first line points to your door information file, you  must
  373.    have a  different config  file for  each door  information file.   All  the
  374.    other lines should  remain the same  (unless you want  different page tones
  375.    for each node)
  376.  
  377.    Do whatever you must do to start your multiple nodes, and have a  different
  378.    batch file for each DODGE BALL.
  379.  
  380.  
  381.  
  382.  
  383.  
  384. On-Line Sysop Commands
  385. ──────────────────────
  386.  
  387.    While a caller is on-line, the local sysop has several options.  They are
  388.    as follows:
  389.  
  390.              Function key
  391.              ------------
  392.                 F5              Shell to DOS
  393.                 F8              Return user to system
  394.                 F9              Toggle display on/off
  395.               * F3              Toggle printer on/off
  396.               * F4              Toggle pagebell on/off
  397.               * F7              Toggle caller alarm on/off
  398.  
  399.              Alternate key
  400.              -------------
  401.                ALT-H            Toggle between different status lines
  402.  
  403.              * ALT-N            Toggle sysop on next
  404.              * ALT-X            Toggle exit to dos after call
  405.                                 and help lines
  406.  
  407.         Alternately pressing the ALT-H key will bring up
  408.         the next status line screen.  The 1st screen is a help screen,
  409.         the second screen shows your COM port status.
  410.  
  411.  * The function keys marked with an "*"  will only be of use to systems
  412.    using pcboard.sys.  The rest are functional with any system.
  413.  
  414.  
  415.  
  416.                               COMPUFAX SOFTWARE
  417.                               ═════════════════
  418.  
  419.    Compufax  Software  is  a  division  of  Compufax  Consulting Services.  We
  420.    specialize in getting the right computer and software for your needs.   All
  421.    of our work is custom and created just for you.
  422.  
  423.    We  started  writing  door  software  with  a program called BUY&SELL Door.
  424.    After reviewing dozens of For Sale Doors, we could not find one to meet our
  425.    needs, so we wrote one.  That is what  we do.  We find a need, and write  a
  426.    door to fill that.  You won't  find us writing 30 card game doors  that all
  427.    look  the  same.   Each  door  is  individually  designed  to  meet a need.
  428.    Currently, we have 5 BBS door programs:
  429.  
  430.         Food Fight
  431.         Buy & Sell
  432.         UNIPAGE
  433.         DODGE BALL
  434.         Thought of the Day
  435.  
  436.    We  will  not  cripple   our  doors.   We'll   just  put  in a  few seconds
  437.    reminder that  this copy  is unregistered.    We  will never  write a  door
  438.    that expires.  We have  over 100   doors on  our board,  and sometimes   it
  439.    is month before a door is fully  tested.  We won't force you to  download a
  440.    demo  key  every  few  weeks  either.     Everything  you   need  for  full
  441.    operation   of our  doors   is included  in   the distribution   zip.    No
  442.    runtime  modules, no keys, nothing extra, nothing more to download.
  443.  
  444.    All of our doors have a simple to use Local mode.  You can see the  program
  445.    before you put it online.
  446.  
  447.    Your registrations are  forever.  When  we give you  a registration number,
  448.    you will never need to buy anything ever again.  Each new version will  use
  449.    the same number, and you're registered for life.
  450.  
  451.    You can receive  free technical support  even if you  are not a  registered
  452.    user.  Because  of my schedule,  I cannot be  available for voice  support,
  453.    but I'll answer  every message on  my BBS and  Compuserve.  If  you need to
  454.    talk to me voice, I'll be happy to make an appointment and call you.
  455.  
  456.    We're tired of poorly programmed, boring BBS Doors.  We are here to  change
  457.    all that.
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.                                 REGISTRATION
  474.                                 ════════════
  475.  
  476.      When you register DODGE BALL, your registration number will be posted  on
  477.      The Village BBS (408-229-0706), in a private message to you.  You  should
  478.      allow 1  week from  the time  you send  your check  before the message is
  479.      posted.   Other options  include sending  you the  number and sending you
  480.      the latest  version of  the program  with the  number.   NOTE: The latest
  481.      version may not  be later than  the one you  have, and no  version number
  482.      verification will be performed..
  483.  
  484.  
  485.  
  486.  
  487.  
  488.                         DODGE BALL REGISTRATION FORM
  489.                         ════════════════════════════
  490.  
  491.      Your BBS Number (so I can call and play):________________
  492.  
  493.  
  494.      Name: ___________________________________________________
  495.  
  496.            (Your name here must match EXACTLY with the name entered
  497.             on line 3 of the config file.  Upper and lower case make a
  498.             difference here.  Print or type clearly.)
  499.  
  500.  
  501.      BBS Name: _______________________________________________
  502.  
  503.                (Your BBS name here must match EXACTLY with the BBS name
  504.                entered on line 2 of the config file.  Upper and lower case
  505.                make a difference here.  Print or type clearly.)
  506.  
  507.  
  508.      The name you have used or wish to use to log into The Village BBS:
  509.  
  510.      _________________________________________________________________
  511.  
  512.  
  513.       ╔════════════════════════════════════════════════════════════╗
  514.       ║                                                            ║
  515.       ║ If you do not have a login to my board, and wish me to set ║
  516.       ║ one up for you, supply the following information:          ║
  517.       ║                                                            ║
  518.       ║                                                            ║
  519.       ║ Phone number (with area code): __________________________  ║
  520.       ║                                                            ║
  521.       ║ Birthday: _______________________________________________  ║
  522.       ║                                                            ║
  523.       ║ Password: _______________________________________________  ║
  524.       ║                                                            ║
  525.       ╚════════════════════════════════════════════════════════════╝
  526.  
  527.  
  528.      If you wish me to send you the registration number of the latest
  529.      version of DODGE BALL, fill out the following:
  530.  
  531.  
  532.      Address:____________________________________________________
  533.  
  534.              ____________________________________________________
  535.  
  536.              ____________________________________________________
  537.  
  538.  
  539.  
  540.      Mail To:  Compufax Consulting Services
  541.                7145 Aptos Beach Court
  542.                San Jose, CA  95139
  543.  
  544.      Select which option you would like to register DODGE BALL:
  545.  
  546.  
  547.      Basic Registration.
  548.        Includes lifetime registration number posted
  549.        to The Village BBS in a private message to you....$20.00 _____
  550.  
  551.  
  552.      Mail Number.
  553.        Includes lifetime registration number mailed
  554.        to you at the above address.......................$22.50 _____
  555.  
  556.  
  557.      Mail Diskette.
  558.        Includes lifetime registration number mailed
  559.        to on a diskette, along with the latest version
  560.        of this software..................................$27.00 _____
  561.  
  562.           Type of diskette: *5.25" High Density _____
  563.                              5.25" Low Density  _____
  564.                             *3.5"  High Density _____
  565.                              3.5"  Low Density  _____
  566.  
  567.         *If you choose a High Density diskette, you will get
  568.          sample of other Compufax Software on the same disk
  569.  
  570.                                            Total Enclosed: __________
  571.  
  572.       Payment method:
  573.  
  574.       [  ] Check made payable to Compufax Consulting Services.
  575.  
  576.       [  ] VISA   [  ] Master Card   [  ] Discover   [  ] Carte Blanche
  577.  
  578.       [  ] JCB    [  ] Diner's Club
  579.  
  580.  
  581.     For Credit Card Purchases:
  582.  
  583.       Number:________________________________Ex Date:_________________
  584.  
  585.       Name on card:___________________________________________________
  586.  
  587.       Statement ______________________________________________________
  588.         Mailing
  589.         Address:______________________________________________________
  590.  
  591.                 ______________________________________________________
  592.  
  593.       Home Phone:_____________________ Work Phone:____________________
  594.  
  595.  
  596.       Signature:______________________________________________________
  597.  
  598.  
  599.  
  600.  
  601.  
  602.                         R E G I S T E R   O N L I N E
  603.                         ═════════════════════════════
  604.  
  605.     You can register this software On-Line on the Village BBS.  From the  main
  606.     menu, Choose [Q]uestionnaires,  and choose questionnaire  number 6.   Have
  607.     your charge card ready.
  608.  
  609.     We accept  VISA, Master  Card, Discover,  Diner's Club,  Carte Blanche and
  610.     JCB cards.
  611.  
  612.     Due  to  the  nature  of  your  purchase, your registration number will be
  613.     available within 12 hours of you completing the questionnaire.
  614.  
  615.  
  616.  
  617.                                  BUG REPORT
  618.                                  ══════════
  619.  
  620.     Please report any and all bugs to my.  Include as much information as  you
  621.     can.   If  I  think  I  have  fixed  it,  I  will send you the new version
  622.     for free, for testing.
  623.  
  624.     You may  use the  form below  to report  any bugs,  or use  your own form.
  625.     Please send the form to me, or upload it to my BBS.
  626.  
  627.     Explain the bug:____________________________________________________
  628.  
  629.     ____________________________________________________________________
  630.  
  631.     ____________________________________________________________________
  632.  
  633.     ____________________________________________________________________
  634.  
  635.     ____________________________________________________________________
  636.  
  637.     ____________________________________________________________________
  638.  
  639.     ____________________________________________________________________
  640.  
  641.     ____________________________________________________________________
  642.  
  643.     ____________________________________________________________________
  644.  
  645.     ____________________________________________________________________
  646.  
  647.     ____________________________________________________________________
  648.  
  649.     ____________________________________________________________________
  650.  
  651.     ____________________________________________________________________
  652.  
  653.     (use another sheet of paper if needed)
  654.  
  655.     Your BBS number:____________________________________________________
  656.  
  657.     Version of DODGE BALL:______________________________________________
  658.  
  659.     DOS Date and time of DODGE.EXE:_____________________________________
  660.  
  661.     BBS Software and version:___________________________________________
  662.  
  663.     Describe your machine:______________________________________________
  664.  
  665.     ____________________________________________________________________
  666.  
  667.     Describe your multi-tasking, if any:________________________________
  668.  
  669.     ____________________________________________________________________
  670.  
  671.     Is this multi-node? (how many)______________________________________
  672.  
  673.     Please include copies of your DODGE.CFG.
  674.  
  675.  
  676.  
  677.                               REVISION HISTORY
  678.                               ════════════════
  679.  
  680.    December 16, 1992   Version 1.0
  681.         Initial Release
  682.  
  683.  
  684.  
  685.