home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / games / mlshut11.zip / MLSHUT.DOC next >
Text File  |  1989-01-14  |  14KB  |  396 lines

  1.               MicroLink Personal Computer Users' Group
  2.  
  3.                              Presents
  4.  
  5.                            Shut The Box
  6.  
  7.                v1.1, Copyright 1989, Bob Lancaster
  8.  
  9.  
  10. INTRODUCTION
  11.  
  12.    From coins covering numbers scratched into the deck of a fishing
  13.    boat to the high-tech glitz of the TV game show High Rollers, Shut
  14.    The Box in its many guises has been around since the 18th century,
  15.    when it is thought to have been invented by fishermen in the
  16.    Channel Islands.
  17.  
  18.    Its simplicity (very young children easily understand and enjoy
  19.    it), coupled with the fun of trying to "beat the odds" have made it
  20.    an old standard, especially in the British Isles, where it remains
  21.    a popular pub game to this day.
  22.  
  23.  
  24. EQUIPMENT REQUIRED
  25.  
  26.    Shut The Box will run on any IBM PC/AT/XT/PS2 or close clone
  27.    thereof, with at least 64k of memory.
  28.  
  29.    Although the game looks best when played on a color monitor, it
  30.    plays just fine on a monochrome.  (If you are using a monochrome or
  31.    composite monitor with a color graphics card, please see "Black And
  32.    White Mode" in the Games Parameters section below)
  33.  
  34.    A Microsoft-compatible mouse, can be used.  (Remember to load your
  35.    mouse driver before loading Shut The Box).
  36.  
  37.    If you run across a configuration on which the game will not run,
  38.    please let me know (address at end of this file)!
  39.  
  40.  
  41. GAME FEATURES
  42.  
  43.       Microsoft Mouse Support
  44.       Fast Mode
  45.       Monochrome/Composite monitor support
  46.       Demonstration Mode
  47.       Top Ten Scores file
  48.       Statistics on multiple games
  49.       Bosskey
  50.       Computerized opponent
  51.       On-line help
  52.  
  53.    All options which those 18th century fishermen did just fine
  54.    without, but I thought added to the fun!
  55.  
  56.  
  57. THE OBJECT
  58.  
  59.    In this version of Shut The Box, players alternate turns trying to
  60.    get the highest score possible shutting numbered doors matching
  61.    rolled dice.
  62.  
  63.    At the beginning of play, panels ("doors") number 1 through 9 are
  64.    displayed on the screen, in an "up" position (see Figure 1).
  65.  
  66.           |---------------------------------------|
  67.           | |---|---|---|---|---|---|---|---|---| |
  68.           | | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | |
  69.           | |---|---|---|---|---|---|---|---|---| |
  70.           |                                       |
  71.           |                                       |
  72.           |---------------------------------------|
  73.                   Figure 1 (all doors up)
  74.  
  75.    The player then rolls two dice, and closes any combination of doors
  76.    whose numbers total that of the dice.  A player's turn ends when a
  77.    number is rolled which cannot be matched by any total of the
  78.    remaining open doors.
  79.  
  80.    For example: A player's first roll is a six and a one, totaling
  81.    seven. The player may shut either the door numbered seven, or the
  82.    six and one, or the five and two, or the three and four, or the
  83.    one, two, and four.
  84.  
  85.    In our example, the player chooses to shut (pull down) the two and
  86.    the five, leaving the board as you see in Figure 2.
  87.  
  88.           |---------------------------------------|
  89.           | |---|   |---|---|   |---|---|---|---| |
  90.           | | 1 |   | 3 | 4 |   | 6 | 7 | 8 | 9 | |
  91.           | |---|---|---|---|---|---|---|---|---| |
  92.           |     | 2 |       | 5 |                 |
  93.           |     |---|       |---|                 |
  94.           |---------------------------------------|
  95.                  Figure 2 (after first move)
  96.  
  97.    On the next roll, the player rolls an eleven.  The player can now
  98.    shut the eight and three, or seven and four.  The 9-2 is no longer
  99.    valid because the two has already been closed.  (Likewise, the 6-5
  100.    combination cannot be used).
  101.  
  102.    A player's turn ends when all the doors have been shut, or until no
  103.    door (or combination of doors) can be shut which total up to the
  104.    sum of both dice.  At this point the total of the numbers on the
  105.    doors which have been shut are added to the player's score, plus an
  106.    additional bonus of five points if all doors were shut.
  107.  
  108.    All doors are then reopened, and the game passes to the next
  109.    player.
  110.  
  111.    After each player has played five turns, the player with the high
  112.    score is the winner!
  113.  
  114.  
  115. SCORING
  116.  
  117.    At the end of each player's turn, his points from that turn (the
  118.    numbers on the "shut" doors) are added to the display of his/her
  119.    score, in the box toward the bottom of the screen.
  120.  
  121.    This "scorecard" contains the player's name, score, and a graph of
  122.    his/her score.  The graph shows you how well you are doing against
  123.    a perfect score.
  124.  
  125.    A perfect round gives a player 50 points:
  126.  
  127.       (1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 + 5 bonus points = 50)
  128.  
  129.    With 5 rounds to a game, 250 points would be a perfect game. There
  130.    are 50 dots on the scorecard, and one is filled every five points.
  131.  
  132.  
  133. STARTING THE GAME
  134.  
  135.    At this point, you should be able to play the game, and get a feel
  136.    for it.  You can read the rest of this document now at your leisure
  137.    to clarify points, and to explain some of the features you might
  138.    not understand your first few times through the game.
  139.  
  140.    So, make sure you are in DOS, and type "MLSHUT" (without the
  141.    quotes) and press return.  Follow the prompts, and enjoy!
  142.  
  143.  
  144. GAME CONTROLS
  145.  
  146.    Shut The Box can be played either using the keyboard or a
  147.    Microsoft-compatible mouse.
  148.  
  149.    KEYBOARD INPUT
  150.  
  151.       The last line on the screen always contains a list of keys that
  152.       are valid at any point in the game, along with a one-word
  153.       description of their function. (See "COMMANDS" below)
  154.  
  155.       When selecting the doors to shut, you can use either of two
  156.       keyboard methods:
  157.  
  158.          1) Use the cursor left/right keys to point to a door and use
  159.          the cursor up/down keys to open or shut it, or
  160.  
  161.          2) Use the numeric keys to select the number of the door to
  162.          open or shut.
  163.  
  164.    MOUSE INPUT
  165.  
  166.       Most of the keys listed on the bottom line of the screen can be
  167.       entered via the mouse by pointing to the command and clicking
  168.       the left button of the mouse.  (If you are new to mice,
  169.       "clicking" something means to place the mouse cursor on it and
  170.       press the appropriate button, in this case, the left.)
  171.  
  172.       Also, boxes higher on the screen with messages such as "Press
  173.       return for next player" will allow you to click the box itself
  174.       to continue, rather than the command at the bottom of the
  175.       screen.
  176.  
  177.       When selecting the doors to open/shut after rolling the dice,
  178.       clicking an open door will close it, and clicking a closed door
  179.       will open it (provided that the door was closed after the last
  180.       roll of the dice).
  181.  
  182.       So, experiment with the mouse, and see what works.  I think it's
  183.       fairly straightforward, but would appreciate any feedback on
  184.       ways you think it could be improved (address at end of file).
  185.  
  186. COMMANDS AND TOGGLES
  187.  
  188.    A number of commands and toggles are available to enhance play, or
  189.    to allow you to tailor the game a little to suit your taste.
  190.    Alphabetically, these are:
  191.  
  192.    A (AllScores command)
  193.  
  194.       This displays a scorecard of all players, to compare how
  195.       everyone is doing in relation to each other.  The highest
  196.       score(s) are emphasized with a flashing arrow.  Also, the two
  197.       sets of lines jutting into the box from above and below show the
  198.       range of scores currently in the TopTen scores file.  The score
  199.       is "graphed" as in the single-player scorecard.
  200.  
  201.    B (BossKey command)
  202.  
  203.       This displays a phony DOS screen.  I'll explain for you honest
  204.       folks: this key is used when you are playing the game on company
  205.       time, and the boss suddenly appears. To return to the game, key
  206.       OK at the phony DOS prompt.
  207.  
  208.    Esc (Exit command)
  209.  
  210.      Use this key to end MLShut before the game is over.
  211.  
  212.    R (Roll Prompt toggle)
  213.  
  214.       This allows you to get rid of the "Press return to roll"
  215.       message, which some folks find annoying.
  216.  
  217.       Defaults to "Yes", allowing the message to show.
  218.  
  219.    N (Next Prompt toggle)
  220.  
  221.       This allows you to get rid of the "Press return for so-and-so's
  222.       turn" message, which some folks find annoying.
  223.  
  224.       Defaults to "Yes", allowing the message to show.
  225.  
  226.    D (Demo toggle)
  227.  
  228.       This allows you to put MLShut into Demo Mode, in which the
  229.       computer plays for all players.
  230.  
  231.       Defaults to "No", allowing human play.
  232.  
  233.    F (Fast Mode)
  234.  
  235.       If you just want to play the game, and not look at some of the
  236.       "animation" (such as the rolling dice), turning the Fast Mode on
  237.       will do it.
  238.  
  239.       Defaults to "No", showing all animation.
  240.  
  241.    P (Pips Mode)
  242.  
  243.       Allows you to select between dice with pips (dots) on them, or
  244.       with numerals on them.
  245.  
  246.       Defaults to "Yes", showing the dots.
  247.  
  248.    T (TopTen scores command)
  249.  
  250.       Displays the highest ten scores achieved on your machine.  (This
  251.       information is stored in the file MLSHUT.SCR.  To clear the top
  252.       ten, delete the file.)
  253.  
  254.    K (Show "Can't use this roll!" message)
  255.  
  256.       If you want Shut The Box to notify players when they roll a
  257.       combination of dice which they can't use, specify this toggle.
  258.  
  259.       Defaults to "No".
  260.  
  261.  
  262. COMMAND LINE PARAMETERS
  263.  
  264.    In the section above, several options are referred to as "toggles".
  265.  
  266.    This simply means that they can be in a "Yes" or "No" state.  And
  267.    each of them has a "default", which is the state (either yes or no)
  268.    in which they start out when Shut The Box begins.
  269.  
  270.    I set the defaults to the way I felt was best, but you may think
  271.    differently!
  272.  
  273.    If you find yourself always changing one or more of the toggles
  274.    each time you play, you might want to set them on the DOS command
  275.    line instead.
  276.  
  277.    Any toggle can be flipped to the opposite of its default (Fast Mode
  278.    = "Yes", for example) by keying the toggle's letter following the
  279.    program name (MLSHUT) when you start up the game.
  280.  
  281.    So, if you wanted to set "Roll Prompt" to No, and Pips Mode to "No"
  282.    (the opposites of their defaults), at DOS you would key:
  283.  
  284.            "MLSHUT R P"
  285.  
  286.    ...without the quotes, followed by the Return key.  Be careful that
  287.    you leave a space between MLSHUT and the toggle(s), or DOS won't
  288.    recognize what you are trying to do.
  289.  
  290.    This allows you to tailor the game a little to your taste, and if
  291.    you put this statement into a DOS batch file or menu processor, it
  292.    will save you from setting these toggles each time you start the
  293.    game.
  294.  
  295.    Toggles only valid from the command line:
  296.  
  297.    B (Black And White mode)
  298.  
  299.       If you are running a composite monitor on a color graphics card,
  300.       and the colors in MLShut are hard to discern, keying "MLSHUT B"
  301.       at the DOS prompt will make MLShut run in Black And White Mode.
  302.  
  303.       Defaults to "Yes" if Monochrome adapter detected, "No"
  304.       otherwise.
  305.  
  306.    T (Top Ten Scores)
  307.  
  308.       This is different than the "T" command available during game
  309.       play.  It specifies whether a Top Ten Scores file should be
  310.       saved, and is useful if you are running the game from a write-
  311.       protected disk.
  312.  
  313.       Defaults to "Yes".
  314.  
  315.  
  316. DIFFERENCE BETWEEN VERSIONS
  317.  
  318.    VERSION 1.0  -  01/11/89
  319.  
  320.       Initial version, released to a few beta testers.
  321.  
  322.    VERSION 1.1  -  01/14/89
  323.  
  324.       Fixed some incorrect headings.
  325.  
  326.       Modified documentation some.
  327.  
  328.  
  329. ACKNOWLEDGMENTS
  330.  
  331.    Thanks for the dozens and dozens of very nice letters and messages
  332.    I got (and still get) in response to my last game, MLYaht.  The
  333.    positive response encouraged me to turn this one loose on the
  334.    world...
  335.  
  336.    I'd like to thank my wife Cindy and my daughters Rosamund and
  337.    Genevieve for their tireless beta testing, and accurate
  338.    descriptions (such as "ooooh!" and "blech!") of what they liked
  339.    (and didn't like) about it.
  340.  
  341.    Also many thanks to Greg Powers, whose comment "You know, I HATE
  342.    games that do that!" led to a major change in the scoring system
  343.    used.
  344.  
  345.    A tip o' the hat as always to the gang at MicroLink (Bob Rodrigue,
  346.    Jay Graham and David Storrs especially) for the encouragement and
  347.    support they always give my PC endeavors.
  348.  
  349.    Thanks to Eagle Performance Software, whose Shareware product
  350.    "QWIK" allows for some blazingly fast screenwrites in Turbo Pascal.
  351.    (For a demonstration on just HOW fast, start MLShut with both Demo
  352.    and Fast modes set to "Yes", and hold on to your socks...)
  353.    Programmers interested should contact Eagle at:
  354.  
  355.        Eagle Performance Software      Or Call Jim LeMay at:
  356.        TP products                       (817) 735-4833
  357.        P.O. Box 122237
  358.        Fort Worth, TX  76121-2237
  359.  
  360.    And, while I'm at it, thank you Phillipe Kahn!
  361.  
  362.  
  363. FEEDBACK
  364.  
  365.    I would appreciate any comments, complaints, or wish lists of
  366.    features you'd like to see!  And, if you have any favorite old
  367.    games you'd like to see programmed, I'm always looking for another
  368.    which would interest me!
  369.  
  370.    Also, if you like the game enough (and can afford) to send a small
  371.    ($5) donation, I won't argue.  And my wife will understand my long
  372.    nights at the PC a little better!
  373.  
  374.    Either way: Enjoy the game, and give copies of it to all your
  375.    friends.  And enemies.  Strangers on the street...
  376.  
  377.    I can be contacted by mail at:
  378.  
  379.       Bob Lancaster / P.O. Box 5612 / Hacienda Heights, CA  91745
  380.  
  381.    Or by modem at:
  382.  
  383.       MicroLink PCUG BBS (AKA So. Cal Builder's Board)
  384.       818/961-7903
  385.  
  386.    Please include the verion number of Shut The Box in correspondence.
  387.  
  388.    Those interested in finding out more about MicroLink can contact
  389.    the board listed above, or by mail:
  390.  
  391.       MicroLink PCUG Headquarters
  392.       15865-B E. Gale Ave. Box 1003
  393.       Hacienda Heights, CA  91745
  394.  
  395.    Tell them Shut The Box sent you!
  396.