home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / wbgames / pookah / pookah.doc < prev    next >
Text File  |  1977-12-31  |  8KB  |  246 lines
  1. Pookah Dice - v2.
  2. -----------------
  3.  
  4.     A Silicon Implants Production - 1996.
  5.  
  6.  
  7. Warning.
  8. --------
  9.  
  10.     I've never written a doc before, so this is probably gonna be well
  11. dodgy, hopelessly inaccurate, and missing half the info. Ain't life a bitch!
  12.  
  13.     (Actually, that last bit was a lie, since this is version 2 of Pookah,
  14. this is now version 2 of the document also. However, I haven't learnt
  15. anything since then, so the bits that I've added to this doc are probably
  16. indistinguishable from the original bits. Hopeless maybe, but consistently
  17. hopeless at least!)
  18.  
  19. Copyright stuff.
  20. ----------------
  21.  
  22.     It`s public domain, and freely distributable, and copyright Mark
  23. Neesam 1996. If you like it then that's cool (I'm not averse to complimentary
  24. Emails!). If you don't, then I'm very sorry, and I'll try harder next time.
  25. I think that covers everything.
  26.  
  27.     
  28.     
  29. Introduction.
  30. -------------
  31.  
  32.     I wrote this game because I needed to write something easy whilst
  33. I learnt to program in Blitz Basic. Simple as that really. I kinda like
  34. it though.
  35.  
  36.  
  37. Stuff what you should now have.
  38. -------------------------------
  39.  
  40.     Included in Pookah Dice are the following files:-
  41.  
  42.         Pookah_Dice      - the game itself
  43.         Pookah.prefs      - a small prefs file
  44.         Pookah.scores      - the hi-score tables
  45.         Pookah.doc      - what you're now reading!
  46.         mwb_dice.bsh      - some nice dice gfx
  47.         dodgy_dice.bsh      - ditto
  48.         click.snd      - the click sound
  49.         roll8.snd      - the dice roll sound
  50.         cash2.snd      - the win sound
  51.         dice_template.iff - piccy template of gfx layout
  52.     also:-
  53.         The Pookah.font files
  54.  
  55.     If the .snd files, font and prefs file aren't there Pookah Dice will
  56. fail. Also, having the gfx file named in the prefs file would probably be a
  57. good idea. 
  58.  
  59.  
  60. Requirements.
  61. -------------
  62.  
  63.     An Amiga.
  64.  
  65.     I've tested it on an A1200, and an A4000/40. It'll run from either
  66. floppy or hard drive on both these. Anything else and you're on your own
  67. really. I suppose you could get in touch with me at the address at the end
  68. of this file if you're really desperate. Likewise, for any bug reports.
  69.  
  70.  
  71. Installation + running Pookah Dice.
  72. -----------------------------------
  73.  
  74.     Firstly, copy the font stuff to your font directory. If you're 
  75. installing Pookah Dice to a hard drive, simply copy all the files listed
  76. above (except the font stuff) to wherever you want it. Then double-click the
  77. Pookah_Dice icon.
  78.  
  79.  
  80. Screen stuff.
  81. -------------
  82.     
  83.     It really needs a Magic workbench type screen to run properly.
  84.         i.e. 8 colours and kinda squarish (e.g. 640 * 512). 
  85.     The 8 colour thing is a necessity -although a MWB type palette isn't.
  86.     As long as colour five is different from colour 1 it should be fine.
  87.  
  88.     The screen size needs to be at least 640 pixels wide. Since v2 it should
  89.     now work on NTSC non-interlaced displays.
  90.     
  91.  
  92. How to play Pookah dice.
  93. ------------------------
  94.     Pookah dice is a gambling game based on poker, but played with dice.
  95. The object of the game is to get filthy stinking rich by rolling, decent
  96. poker-style scores using ordinary household dice. You get five dice to
  97. throw, and two rolls if needed, and can keep as few or as many dice from the
  98. first roll as you wish. Before the first roll you may alter the stake using
  99. the gadgets provided (or the handy menu options), so that you can play safe
  100. or go for the big win, or even stake it all on one throw. The choice is
  101. yours.
  102.  
  103.  
  104. Scoring.
  105. --------
  106.  
  107.     The following scores will win money in Pookah dice:-
  108.  
  109.               Two pairs ... 1 * stake.
  110.         Three of a kind ... 1.5 * stake.
  111.              Full house ... 2 * stake.
  112.          Four of a kind ... 3 * stake.
  113.                Straight ... 4 * stake.
  114.          Five of a kind ... 5 * stake.
  115.  
  116.  
  117.     For those unfamiliar with poker:-
  118.         
  119.         A full house is three of one score + a pair of another.
  120.         A straight is an unbroken run of numbers
  121.             in Pookah dice either 1,2,3,4,5 or 2,3,4,5,6
  122.             (in any order!)
  123.  
  124.     For those unfamiliar with common sense:-
  125.     
  126.         A pair is two of the same score.
  127.         Three of a kind is three of the same score.
  128.         Four of a kind is ... oh, figure it out!
  129.  
  130.  
  131. Limits.
  132. -------
  133.     The game will end should your score go over $300,000,000. See the
  134. history section for the sketchy reasoning behind this.
  135.  
  136. Hi-scoring.
  137. -----------
  138.  
  139.     There are two high score tables in Pookah dice - one main table, and
  140. a secondary one, just for good measure.
  141.     The main hi-score table    records highest finishing scores - that is
  142. the money you have left at the end of the game (hence the retire option in
  143. the project menu). Just as in real life, it`s what you leave with that
  144. counts here.
  145.     The second table records the highest scores ever achieved. I put
  146. this here so that we might all learn from past mistakes, and get out whilst
  147. ahead. Fat chance. This table is not nearly as valid as the first one
  148. though, even if you have got 14 squillion quid as a hi-score here. As a kid
  149. I once won £50 in an amusement arcade, and I only went home with a tenner - 
  150. oh yes, I've learnt the hard way!
  151.  
  152.     Hi-scores are saved after any new hi-score is achieved.
  153.  
  154.  
  155. New dice please.
  156. ----------------
  157.  
  158.     You can draw new dice for Pookah dice if you want. All you have to
  159. do is load up the template screen included and draw the relevant items in
  160. the spaces provided. Next save the indicated section as a normal IFF brush.
  161. Then, run the game and choose "Pick new dice" from the options menu. Choose
  162. your new file in the file requester and hey presto, Pookah now sports your
  163. own groovy graphics. Spanking! This will automatically change your .prefs
  164. file to match the new dice too. Bonus!
  165.  
  166.     Included with Pookah Dice should be two sets of dice anyway. The
  167. default set (mwb_dice.bsh) are quite nice, wheras the other set
  168. (dodgy_dice.bsh) are stylishly shoddy. Take your pick.
  169.  
  170.  
  171. History.
  172. --------
  173.  
  174.     Version 1.
  175.         Not actually named as version 1, but I guess it must have been, coz
  176. it was the first anyone except me saw of it. It probably wasn't officially
  177. version 1 coz I had no intention whatsoever of ever updating it. However...
  178.  
  179.     Version 2.
  180.         Not for me the timid little .1 increments in version number, oh no!
  181. This is version 2 goddammit! (despite the fact that it is little more than a
  182. couple of bug fixes, a couple of ideas more fully implemented and a slight
  183. tweaking here and there). Version 1.014a this most certainly isn't!
  184.  
  185.  
  186.         Bugs fixed:-
  187.  
  188.             The "Raise by" menu bug, whereby the checkmark next to the 
  189. selected stake increment in the menu was not reset to 5 at the start of a new
  190. game, even though the stake increment was.
  191.  
  192.             The rather dim floating point money bug, which meant that at a
  193. certain score the display and hi-score tables started printing complete
  194. hogwash (technical term!).
  195.  
  196.  
  197.         Ideas more fully implemented:-
  198.             You can now change dice whilst playing the game. Version 1
  199. needed the .prefs file to be manually altered.
  200.  
  201.             Maximum score incorporated. Inspired by the rather dim
  202. floating point money bug, a score ceiling has been implemented, bringing
  203. about the end of the game when a score of $300,000,000 is reached. Some
  204. people might not like this, but that's tough. Beyond this ceiling things just
  205. get silly. In fact, a fairly long time before the ceiling it starts getting
  206. silly, when it gets past it, it's bloody ridiculous. However, this also adds
  207. a new challemge. The game ends only when a win takes your score over
  208. $300,000,000. Therefore, a maximum score of $1.8billion is possible (that's
  209. $0.3bn stake + (5 * $0.3bn) winnings). See how high you can score!
  210.  
  211.  
  212.         Things that were slightly tweaked:-
  213.             Alternate Roll gadget image incorporated. I don't know why
  214. this wasn't done before. There was a convenient hole in the bitmap anyway.
  215.             Gadget disabling/enabling done at nicer times.
  216.             Text flickering reduced. (Note - reduced, not removed. Am I
  217. hopeless or what?)
  218.             Window height shrunk to 200 pixels so that awkward NTSC
  219. people (only kidding) can run it now. (Pookah dice - the transatlantic dice
  220. game!)             
  221.  
  222.  
  223.  
  224. The end (of a thoroughly professional doc file).
  225. ------------------------------------------------
  226.  
  227.     That`s about it really.
  228.     Pookah dice is copyright Mark Neesam 1996.
  229.     It`s also public domain and freely distributable and all that kind
  230.     of malarkey. So there.
  231.  
  232.         Ta to Gez for the sound.
  233.  
  234.  
  235.  
  236.  Mark Neesam,
  237.  5 Marlborough Drive,
  238.  Sydenham,
  239.  Leamington Spa,
  240.  CV31 1XY.
  241.  
  242.  Email:    mark@big-red.com
  243.     
  244.  
  245.     A Silicon Implants Production - 1996.
  246.