home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / GAMES / YNOT / YNOT.TXT < prev   
Encoding:
Text File  |  1993-07-27  |  18.6 KB  |  430 lines

  1.             YNOT Version 1.00 (1st Release) 18th July, 1993
  2.                  - A Dice Game for the Psion Series 3 -
  3.  
  4.                 Copyright 1993 Right Hand Software Ltd.
  5.  
  6.               45, Kenilworth Gardens, London SE18 3JB, UK
  7.                         Phone/Fax : 081-319-8576
  8.  
  9.                                - Email -
  10.                      righthand@cix.compulink.co.uk
  11.                      chennings@cix.compulink.co.uk
  12.                        100010,511@compuserve.com
  13.  
  14.  
  15. 1)  Description
  16.  
  17.     YNOT is a version of the traditional game played with 5 dice. The
  18.     game requires both luck and strategy to score as many points as
  19.     possible from 13 turns in each of which the dice may be rolled up to
  20.     3 times.  Points are awarded for various combinations of dice such
  21.     as 3-of-a-kind, full-house, straights etc.  A full description of
  22.     the rules and game play are provided below.
  23.  
  24.     YNOT can be played as a solitaire in which you aim to get into the
  25.     highscore table or to improve your personal best and average scores.
  26.  
  27.     YNOT also has a 2 player mode in which you might chose to play "first
  28.     to an agreed total score" or "highest total in an agreed number of
  29.     games".
  30.  
  31.     YNOT is called "YNOT" because - why not ?  (Yes I know this is a
  32.     hostage to fortune if the time comes for foreign language versions).
  33.  
  34.     Enjoy!
  35.  
  36. 2)  Shareware & Registration
  37.  
  38.     YNOT is fully functional.  You are granted a limited licence (please
  39.     see the detailed Terms & Conditions set out below) to enjoy and
  40.     evaluate YNOT as follows :-
  41.  
  42.     You may run/launch YNOT up to 25 times for evaluation purposes (of
  43.     course you may play as many games as you like each time YNOT is
  44.     launched).  If you intend to play YNOT once this evaluation period
  45.     has expired you must register your version as described below.  You
  46.     will be able to tell once your evaluation period has expired
  47.     because:-
  48.  
  49.     * For the very first time you run YNOT, the full registration and
  50.       copyright information is displayed.
  51.     * For the next 24 times you run YNOT only a brief welcome screen is
  52.       displayed.
  53.     * For any subsequent run of YNOT the full registration and copyright
  54.       is always displayed.
  55.  
  56.     I hope you will agree that the evaluation period is generous, the
  57.     "nagging" is minimal and of course the "crippling" is nil!
  58.  
  59.     Indeed, the approach here to the expiry of the evaluation period is
  60.     to provide a gentle reminder rather than a heavy handed "lock out"
  61.     and in any case I'm sure many of you will realise the relatively
  62.     trivial steps required to hack the system.
  63.  
  64.     However, it is to be hoped that such concerns will be immaterial as
  65.     long before the expiry of the evaluation period you will want to
  66.     register your copy of YNOT.  This you can do with a nominal payment
  67.     (suggested minimum 7.50 ukp or local equivalent).  Payment should be
  68.     by cheques drawn on UK Banks or Building Societies made payable to
  69.     Right Hand Software Ltd or in cash.  Please contact us if you wish
  70.     to discuss other forms of payment.
  71.  
  72.     On registering you will receive a code which can be entered with your
  73.     name so that your name appears as a registered user in the program
  74.     information display.  This will also suppress any further copyright
  75.     information displays on start up.
  76.  
  77.     Registration also has the major benefit of giving you the warm
  78.     feeling of satisfaction that you are supporting the development of
  79.     software for the Psion Series 3.
  80.  
  81. 3)  Installation & Logistics
  82.  
  83.     a) Setup
  84.  
  85.        Copy the file YNOT.APP to any directory on any drive and use
  86.        PSION-I to install YNOT to the system screen.  YNOT is a type 0
  87.        application and so has no filelist on the system screen.
  88.  
  89.        Alternatively, place YNOT in an \IMG\ directory so that it can be
  90.        launched from the RUNIMG filelist.
  91.  
  92.     b) Free Memory
  93.  
  94.        YNOT needs between about 25k to 30k free memory to load and run.
  95.        We hope to reduce this requirement in future releases through the
  96.        use of overlay or other techniques.
  97.  
  98.     c) Support Files
  99.  
  100.        YNOT uses 2 types of support file.  Firstly, YNOT is resource
  101.        based (English language resources are embedded in the main .app)
  102.        and YNOT will look for foreign language resource files in a \YNOT\
  103.        directory that must be located under the directory from which the
  104.        app is launched.  No foreign language resource files currently
  105.        exist but if anyone is interested in doing the translation work,
  106.        we will be happy to supply them.
  107.  
  108.        Secondly, YNOT saves various items of information to a file called
  109.        YNOT.INI. If the drive from which YNOT was launched can be written
  110.        to and is not a FLASH SSD, the .INI file will be created in a
  111.        \YNOT\ directory under the directory from which the program was
  112.        launched. Alternatively, the .INI file will be created in
  113.        LOC::M:\RHS\
  114.  
  115.     d) General Operation.
  116.  
  117.        YNOT has extensive online help.  Press the HELP key for details of
  118.        how to use the various facilities available.
  119.  
  120. 4)  Terms & Conditions
  121.  
  122.     a) YNOT comprises the files YNOT.APP and this file YNOT.TXT. YNOT is
  123.        copyright material of Right Hand Software Ltd. and all ownership
  124.        rights are retained.
  125.  
  126.     b) You may use and distribute YNOT only in accordance with the terms
  127.        and conditions stated here.
  128.  
  129.     c) You may NOT modify YNOT in any way.
  130.  
  131.     d) You may use YNOT free of charge ONLY for the 1st 25 times you launch
  132.        the program.  For all and any subsequent use of the program, you
  133.        must register your copy as described in section (2) above.  You
  134.        may use YNOT only in a personal and private capacity.  Use within
  135.        commercial, corporate or government institutions requires a
  136.        commercial users licence.
  137.  
  138.     e) You may distribute YNOT only provided that :
  139.  
  140.        i)   All the original files are included (in particular these
  141.             terms and conditions).
  142.  
  143.        ii)  NO charge is made other than to cover the fair and
  144.             reasonable costs of distribution.
  145.  
  146.        Any distribution of YNOT that renders any form of commercial
  147.        advantage (financial or otherwise) to the distributor, requires a
  148.        commercial distributors license.
  149.  
  150.     f) While appropriate care has been taken in the creation of YNOT,
  151.        Right Hand Software Ltd. does not warrant that the software is
  152.        error free.  Indeed, Right Hand Software Ltd. disclaims all and
  153.        any warranties relating to the software.
  154.  
  155.     g) Under no circumstances shall Right Hand Software Ltd. be liable
  156.        for consequential, incidental or indirect damages of any kind
  157.        arising from the use of the YNOT software.
  158.  
  159. 5)  YNOT - The Game
  160.  
  161.     A game of YNOT comprises 13 turns.  Each turn comprises up to 3 rolls
  162.     of the dice.  For the 1st roll of each turn all 5 dice must be
  163.     rolled.  For the optional 2nd and 3rd rolls you may select any or all
  164.     of the dice to be rolled.  You may choose to score the turn after the
  165.     1st or 2nd rolls and the turn must be scored after the 3rd turn.
  166.  
  167.     There are 13 different ways in which points can be awarded to score a
  168.     turn.  Each of these ways must be used once and only once during a
  169.     game.  The objective of the game is to score as many points as
  170.     possible.
  171.  
  172. 6)  YNOT - Scoring
  173.  
  174.     The ways in which a turn can be scored are organised into 2 sections.
  175.  
  176.     The 1st section has 6 ways to score a turn.  These are :-
  177.  
  178.         1s - Score the total of all dice showing 1 (ie 1 5 1 1 2 = 3)
  179.         2s - Score the total of all dice showing 2
  180.         3s - Score the total of all dice showing 3
  181.         4s - Score the total of all dice showing 4
  182.         5s - Score the total of all dice showing 5
  183.         6s - Score the total of all dice showing 6
  184.  
  185.     Additionally, if the total of all points in the 1st section is 63 or
  186.     more you get a bonus of 35 points.
  187.  
  188.     This means that you should aim to have at least 3 of a kind when you
  189.     score a turn in the 1st section to stay on target for the bonus.  If
  190.     you are forced to score an "under par" turn in the 1st section try to
  191.     go for a low way.  For example to recover from scoring only one 2 in
  192.     the 2s, you need only to score four 4s.  Conversely you would need
  193.     five 3s to recover from two 6s.
  194.  
  195.     The 2nd section has 7 ways to score a turn.  These are :-
  196.  
  197.         3 of a kind   - Score the total of ALL dice (ie 4 4 4 6 5 = 23)
  198.         4 of a kind   - Score the total of ALL dice
  199.         Full House    - Score 25 points
  200.         Low Straight  - Score 30 points
  201.         High Straight - Score 40 points
  202.         YNOT!         - Score 50 points
  203.         Chance        - Score the total of ALL dice
  204.  
  205.     Where :-
  206.  
  207.         A Full House  = 3 of a kind PLUS 2 of a kind
  208.         Low Straight  = A sequence of 4 dice
  209.         High Straight = A sequence of 5 dice
  210.         YNOT!         = 5 of a kind
  211.         Chance        = Any combination of dice
  212.  
  213.     YNOT! Bonuses - any subsequent YNOT! gives a bonus of 100 points
  214.     provided that a previous YNOT! has been scored as such.
  215.  
  216.     Roll! Bonuses - If you score 3 or more of a kind in section 1 OR
  217.     score anywhere in section 2 except "Chance" and do so in less than 3
  218.     rolls, you get a "Roll Bonus" worth 10 points if you take just 1
  219.     roll and 5 points if you take 2 rolls.
  220.  
  221.     As well as the luck of the dice you will need strategy as to how to
  222.     score a particular turn at a particular point in the game and indeed
  223.     to decide which dice to hold or roll.  This is because you often have
  224.     a choice as to where to score the turn.  Remember also that scores
  225.     are "downwardly compatible" so a High Straight can be scored as a Low
  226.     Straight, a 4-of-a-kind as a 3-of-a-kind and a YNOT! can score as a 3
  227.     or 4-of-a-kind or a Full House.  For example :-
  228.  
  229.     * Should you score four 6s and a 5 in section 1 and be comfortably on
  230.       the way to the section 1 bonus but only get 24 points or should you
  231.       score a 4-of-a-kind for 29 points?
  232.  
  233.     * You might decide to "throw away" two 2s, two 1s and a 3 in the
  234.       YNOT! slot (betting that you wouldn't get a YNOT! anyway).  You
  235.       then get 2 YNOT!s - that "throw away" just cost you 150 points!
  236.  
  237.     The Series 3 implementation of YNOT has various features to help you
  238.     get the hang of scoring.  Firstly, you can at any time switch to the
  239.     score board and examine what scores are available before committing
  240.     to a particular score.  Secondly, until such time as the section 1
  241.     bonus has been won or lost, a running total of how much you are under
  242.     or over performing on the 1st section is shown.  Lastly, when you
  243.     switch to the score board, YNOT always jumps to the highest score for
  244.     the current dice (unless this means under performing in section 1).
  245.     However, note that the HIGHEST score for a given throw is NOT always
  246.     the BEST score given the overall state of the game - but that's where
  247.     you come in!
  248.  
  249. 7)  YNOT - On the Psion Series 3
  250.  
  251.     On the Series 3 screen, YNOT presents 6 display areas against a
  252.     shaded background.  Looking from left to right / top to bottom :-
  253.  
  254.     * The first 3 areas are the score card.
  255.  
  256.     * The next area shows the dice.
  257.  
  258.     * The next area shows the player names and running totals for the
  259.       current sequence of games.
  260.  
  261.     * The last area shows a push button which indicates the current state
  262.       of the game.
  263.  
  264.     The 3 score card areas each have 6 rows and 2 columns.  The 1st
  265.     column shows icons to represent a type of score.  The second column
  266.     is blank if that score has not been used in the current game or
  267.     alternatively shows the score gained.
  268.  
  269.     The 1st score card area is Section 1 with the slots for scoring 1s
  270.     through to 6s.
  271.  
  272.     The 2nd score card area plus the 1st row of the 3rd score card area
  273.     is Section 2 with slots for the various scores (3-of-a-kind through
  274.     to Chance) as described above.
  275.  
  276.     The remainder of the 3rd score card area shows as follows :-
  277.  
  278.     * The total of Section 1.
  279.  
  280.     * Either the section 1 bonus (indicated by an = sign) or by how much
  281.       you are on/off target for getting the section 1 bonus (indicated by
  282.       a +- sign).  For example scoring two 3s in the 3s slot would show
  283.       -3.  Subsequently scoring four 4s in the 4s slot would change this
  284.       to be +1.  If you then get the section 1 bonus, the +- sign is
  285.       changed to an = sign and the 35 points shown.
  286.  
  287.     * The total of Section 2.
  288.  
  289.     * The value of YNOT! and Roll! bonuses.
  290.  
  291.     * The total score for the current game.
  292.  
  293.  
  294. 8)  YNOT - How to Play
  295.  
  296.     At the start of each players game, his or her name is highlighted and
  297.     the button shows "Start".
  298.  
  299.     Press ENTER to begin the game.  The dice will roll.  When they stop,
  300.     the button shows that the next roll will be roll #2.
  301.  
  302.     At this point we consider the dice and decide whether to score them
  303.     as they stand or to roll some or all of them again.
  304.  
  305.     If you want to roll dice, use the cursor keys to move the box which
  306.     surrounds one of the dice indicating this to be the current dice.
  307.     Then use the space bar to highlight the dice (indicating that this
  308.     dice is to be rolled). You can change your mind - just press the space
  309.     bar again to turn the highlight off.  For the 2nd and 3rd rolls you
  310.     can also use Shift-SPACE to rehighlight the previous set of dice.
  311.     Once all the dice you want to roll are marked in this way, press
  312.     ENTER to roll them.
  313.  
  314.     Alternatively, you may want to score the dice as they stand.  The TAB
  315.     key switches you between the dice and the score card.  Press TAB and a
  316.     cursor will appear in the highest scoring free slot in the score card
  317.     (remember this is just tactics - you need to add the strategy) and
  318.     the results of selecting this score are shown.  The button also
  319.     changes to indicate that the ENTER key is now used to pick a score.
  320.     Use the cursor keys to move between the available score slots.  If
  321.     you decide to score the dice, press the ENTER key.  If you decide not
  322.     to score and want to continue rolling dice, just press TAB again to
  323.     switch back to the dice.  After you score a turn, the 1st roll of
  324.     the next turn is done automatically.
  325.  
  326.     Points to note :
  327.  
  328.     * For the 1st roll of a turn, all dice will be rolled - you don't
  329.       need to mark them using the space bar.  Also you cannot switch to
  330.       the score card until you made the 1st roll.
  331.  
  332.     * After the 3rd roll, you are automatically switched to the score
  333.       card and cannot switch back to the dice until you've made a score.
  334.  
  335.     After a player completes their 13th turn, any high scores or other
  336.     statistics are notified, the running total for the current series of
  337.     games is updated and the next players game begins.
  338.  
  339. 9)  YNOT - Highscores and Statistics
  340.  
  341.     YNOT maintains a high score table which shows the player names and
  342.     scores for the top 5 scores ever made.
  343.  
  344.     YNOT also maintains the names and various statistics for up to 6
  345.     people.  These stats include the players all time best score, the
  346.     number of games played and the overall average score.  The same
  347.     stats are also calculated for the current sequence of games.
  348.  
  349.     When a player completes their turn one of the following events is
  350.     notified :-
  351.  
  352.     * The player gained the highscore table.
  353.     * The player gained an all time personal best score.
  354.     * The player's all time average rose or fell.
  355.  
  356.     At any time, menus or the following hotkeys can be used :-
  357.  
  358.     Psion-H : Displays the high score table.
  359.     Psion-C : Clears/Deletes all entries in the high score table.
  360.     Psion-P : Displays player statistics for the current players.
  361.  
  362.               The player stats shown are the number of games played, the
  363.               best score achieved and the average score.  In each case,
  364.               the "all-time" numbers are shown first, followed by those
  365.               for the current series of games.
  366.  
  367.               Press ENTER in the player stats display to toggle between
  368.               the current players.  Press ESC to return to the game.
  369.  
  370. 10) YNOT - Game Setup, Options and Other facilities.
  371.  
  372.     At any time, menus or the following hotkeys can be used :-
  373.  
  374.  
  375.     Psion-N : Starts a new series of games.  This has the effect of
  376.               resetting to 0 the statistics relating to the current
  377.               series of games for all current players.
  378.  
  379.     Psion-S : This has the same effect as Psion-N above but in addition
  380.               you are presented with dialogs from which you can specify
  381.               the number of current players and who they are.
  382.  
  383.               The Select Player Dialog presents a choice list from which
  384.               you can choose any of the 6 available players.  Press
  385.               ENTER to simply select an existing player.  Alternatively
  386.               to setup a new player OR to reset the overall statistics
  387.               for an existing player, press SPACE and you will be
  388.               presented with a further dialog where you can enter the
  389.               players name.
  390.  
  391.     Psion-O : This presents the game options dialog from which you can
  392.               control the dice animation and sound effects.
  393.  
  394.     Psion-R : This presents the YNOT registration dialog where you can
  395.               enter your registration name and code.
  396.  
  397.     Psion-A : This displays program information and copyright details.
  398.  
  399.     Psion-X : Exits the game.
  400.  
  401.  
  402. === End of YNOT v1.00 Documentation ==================================
  403.  
  404. CREDITS
  405.  
  406. Many thanks are due to the following folk for their help in producing
  407. YNOT :-
  408.  
  409. 1) Psion for producing the Series 3, EPOC and the C-SDK and for helping
  410.    me learn how to use them.
  411.  
  412. 2) PMR (Tonmeister) for the sounds.
  413.  
  414. 3) The brave band of beta testers whose time, effort and ideas resulted
  415.    in the following features :-
  416.  
  417.    * Dice automatically roll after a score except after 13th score.
  418.    * Shift-Space reselects the same set of dice to roll.
  419.    * Psion-X to exit is now on the Special menu and does not have a
  420.      confirm dialog.
  421.    * Sound actually turns off when requested.
  422.    * Error beep (if sound=on) if you try to roll with no dice selected.
  423.    * Clearer help topics (I hope) for folk unfamiliar with the game.
  424.    * Sounds play AFTER dice finish rolling
  425.    * Error beep (if sound=on) on moving dice cursor before 1st roll.
  426.    * Major Sources of OOM errors handled better.
  427.    * Button Titles and animation more consistant.
  428.    * Added Roll<3 Bonus.
  429.    * YNOT can score as a full house.
  430.