home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Java / Java.zip / ccj02b.zip / README.txt < prev   
Text File  |  1996-11-01  |  8KB  |  228 lines
  1. *****************************************************************************
  2.        CHINESE CHECKERS vers0.2beta (FREEWARE) FOR JAVA 1.0.2
  3.            Copyright (C) by Miltiadis Mitrakas 1996
  4.           email:  mmitraka@cs.strath.ac.uk
  5.  
  6.  
  7. REGISTERATION: by just sending e-mail to the above e-address. If you could 
  8. provide some useful comments and machine specifications as well, I would be 
  9. very happy :-)
  10.  
  11. NOTE: This is not an applet,it is a Java application.
  12.  
  13. *****************************************************************************
  14.  
  15. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  16. !THIS IS A FREEWARE PROGRAM AND AS SUCH YOU ARE PERMITTED TO DISTRIBUTE IT   !
  17. !WITHOUT CHARGE PROVIDED THAT ALL FILES ARE DISTRIBUTED TOGETHER, AND DUE    ! 
  18. !COPYRIGHT IS OBSERVED. THIS PROGRAM IS PROVIDED AS IS WITHOUT ANY WARRANTY, ! 
  19. !EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO FITNESS FOR A PARTICULAR ! 
  20. !PURPOSE.                                                                    !
  21. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  22. _____________________________________________________________________________
  23. THE AUTHOR:
  24.  
  25.   Miltiadis Mitrakas
  26.   4th year Student [Computer Science at Strathclyde university in Glasgow]
  27.   email: mmitraka@cs.strath.ac.uk
  28.  
  29.  
  30. _____________________________________________________________________________
  31. CONTENTS:
  32.  
  33.     0.  INSTALATION
  34.     1.  WHAT YOU NEED TO RUN THIS GAME
  35.     2.  THE RULES OF THE GAME
  36.     3.  THE INTERFACE
  37.     4.  PROGRAM HISTORY
  38.     5.  TROUBLESHOOTING
  39.     6.  WEB-PAGE
  40.     7.  THANKS TO
  41.     8.  FIXES
  42.  
  43.  
  44. ______________________________________________________________________________
  45.  
  46. 0. INSTALATION
  47.  
  48. Make sure that you are using Java version 1.0.2 (just run> java -version)
  49.  
  50. Unzip CCJ.ZIP in a directory that you created, use a program that preserves
  51. long file names. Remember Java uses long file names and it is 'case-sensitive'.
  52.  
  53. Run the program using>  java CCJ
  54.  
  55. Note: It takes a couple of seconds to load all the graphics....
  56.  
  57.  
  58.  
  59. ______________________________________________________________________________
  60. 1.  WHAT YOU NEED TO RUN THIS GAME
  61.  
  62. _This is NOT an applet, it is a Java application.
  63.  
  64. _To run this program you need JAVA version 1.0.2 (NOT earlier!!!)
  65.  
  66. _Preferably more than 256 colors SVGA graphics although it will run "happily" 
  67. on 256 colors (actually this is the color depth that I use, 256). 
  68. IF YOU USE ONLY 256 COLORS AVOID USING OTHER PROGRAMS THAT ALTER THE PALETTE
  69. OF THE SYSTEM, THIS WILL PREVEND THE PAWNS FROM SHOWING TRANSPARENT AND THE
  70. COLORS OF THE GAME LOOK STRANGE !!!
  71.  
  72. _Preferably more than 640x480 resolution.
  73.  
  74. _A mouse (not a real one).
  75.  
  76. _Finally you need a windows environment like:
  77.  
  78.     OS/2 (Merlin)
  79.     Windows 95
  80.     Windows NT
  81.     UNIX (X windows)
  82.  
  83. which supports JAVA version 1.0.2 (NOT earlier!!!)
  84.  
  85.  
  86. _This program has been tested on Windows 95 and Windows NT 4.0, although
  87. I would prefer to tested on OS/2 Merlin as well before I release the 
  88. first beta, OS/2 was not available at UK during this time. If you test 
  89. it on OS/2 please let me know !
  90.  
  91. _If you try this game please send me your comments and some specifications
  92. of the system you are using. It will be very useful to me, for farther 
  93. developing and supporting this product.
  94.  
  95.  
  96.  
  97. ______________________________________________________________________________
  98. 2. THE RULES OF THE GAME:
  99.  
  100. CCJ (Chinese Checkers for JAVA) is the Java implementation of a traditional 
  101. Chinese game for two to six players.
  102.  
  103.  Each player has ten pegs of one color at one starting point of the star.
  104. The objective of the game is to occupy the star point directly opposite. 
  105. The first player to accomplish this is a winner. Of course if in the same 
  106. round more than one players reach the end point all of them are winners.
  107.  
  108. Each player moves in turn, (in this implementation clockwise). A move consists
  109. of placing a peg into one of the adjacent holes or jumping over any other one 
  110. peg into a hole beyond. The direction of the move has to be one of the 
  111. following: left/right, forward left/right, backward left/right in respect with 
  112. players position on the board. 
  113. Only one move is made at a time, except when jumping. Then the player can make
  114. any number of jumps in any direction as long as all the moves are consist of 
  115. jumps. A player can jump their own or their opponents pegs.
  116. No pegs are removed from the board during play.
  117.  
  118.  
  119.  
  120. _____________________________________________________________________________
  121. 3. THE INTERFACE:
  122.  
  123. The whole game is split into two  main panels, the "Game Setup" panel and the
  124. "Game Board" panel. Using the "Game Setup" window you can choose the number 
  125. of players you want in the game, positions and colors. 
  126.  
  127. _Using the red button you can choose the number of players.
  128.  
  129. _Using the green button you can change the order of the players on the board.
  130.  
  131. _Using the blue button you can choose the color of the players.
  132.  
  133. All the changes you make affect the order, the color and the number of the
  134. dragons on the middle of the panel. By clicking the dragons you can choose
  135. between computer or human player.
  136.  
  137.  Finally (for this panel) you can press the "Play" button to start a game,
  138. and "Quit" button to quit the program.
  139.  
  140. When you choose the "Play" button the "Game Board" Panel appears and 
  141. the game starts immediately. On the top left of the screen you see the 
  142. color of the player the is currently making a move. On the bottom left
  143. you see the "Stop" button which stops the game and brings you back to the
  144. "Game Setup" panel. The most of this panel is covered by the board of the
  145. game. This is were you see your pawns and you make your moves. 
  146.  
  147. When is your turn to play you can choose your move by following these steps:
  148.  
  149. _Choose the ball that you want to move by clicking on it.
  150.  
  151. _Choose the first move by clicking on a free position, for near moves only 
  152. one selection will be allowed, for far moves (jumps) you can choose as many 
  153. as you can (according to the rules).
  154.  
  155. _When you have "drawn" your path you double-click on the last position of
  156. your move and the computer moves the pawn.
  157.  
  158. _If you want to cancel a move you just click on the selected pawn and the
  159. computer will erase the move path.
  160.  
  161.   
  162.  
  163.  
  164.  
  165. ______________________________________________________________________________
  166. 4. PROGRAM HISTORY:
  167.  
  168.   CCJ is a port of the successful CC2 version, a 32Bit, multithreaded 
  169. Presentation Manager program for OS/2. The only thing that is missing
  170. from this version is the sounds (sorry).
  171.  
  172. _Version 0.1b released on 31/10/96
  173.  
  174.  
  175.  
  176. ______________________________________________________________________________
  177. 5. TROUBLESHOOTING:
  178.  
  179. This program does not work on previous versions of Java, 
  180. it needs version 1.0.2
  181.  
  182. If the pawns do not look transparent although you are using 256 colors then a 
  183. program altered you system palette. I get this problem when I load a painting
  184. program for example. A way around this is to increase the color depth, or 
  185. re-log-in, or reboot the machine.
  186.  
  187.  
  188. ______________________________________________________________________________
  189. 6.  WEB-PAGE
  190.  
  191. Is not available yet, but I had to release the game now. I will include 
  192. the address in the next CCJ release (soon).
  193.  
  194.  
  195.  
  196. ____________________________________________________________________________
  197. 7. THANKS TO:
  198.  
  199. _Chinese people for creating such an interesting game.
  200.  
  201. _All the OS/2 users who supported me during the implementation of CC2, the
  202. list of names is too big to be included here. 
  203.  
  204. _Sun for giving me such a hard time with Java's Panels and Canvases. 
  205.  
  206. _You for suggestions and comments you will provide in the future.
  207.  
  208.  
  209. -----------------------------------------------------------------------------
  210.   Fill free to contact me for any comments (good/bad) about the program !!!
  211. ------------------------------------------------------------------------------
  212.  
  213. ____________________________________________________________________________
  214. 8. FIXES
  215.  
  216.     In version 0.1b, if you press "Play" button and "Stop" button 
  217. immediately the program halts because the game thread is not initiated within
  218. this short period of time. (IMP: 4/5 - Found: 1/11/96 -> Corrected: 1/11/06).
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.