The object of the game is to guess the pattern of colors the game has randomly created when you start a game.
You start a game by clicking on the game board somewhere (on the word "Menu" is a good place) and using the menu to select a game based on the maximum number of possible colors that might be used. For example, if you select "2 Colors" you will get a game that has a maximum of 2 colors. Your range of numbers of colors is 2 through 7. Regardless of how many colors you choose, there will always be four balls in the pattern. The game will randomly select from your set of chosen colors for each ball. If you choose an option that starts with an asterisk, then the pattern that you will be guessing will have all different colors, otherwise repeated colors are possible.
In order for the game to not be left indefinitely in an in-game state and thus blocking other people from using it, a timeout is implemented wherein if no guesses are made within the game will reset. The owner is able to disable the timeout using the menu after starting a game. The timeout is then disabled for that one game and will be active again for the next game.
After starting a game, you make guesses for the pattern of colors by clicking the colored balls at the top. Each time you click a ball, that color is filled into the current row of white balls, from left to right. The rows are filled in from top to bottom. When you have guessed a full row (4 balls) the game calculates your guess by determining the number of correct colors you have chosen, which is shown in the first column of numbers under the "C", and the number of balls that are both the right color and in the right position, which is the second column of numbers under the "P". So, for example, if "C" has 3 and "P" has 2, then you have selected 3 correct colors and 2 of them are also in the correct position.
If you have selected a game option that starts with an asterisk, then each time you click a color ball choice that color will vanish and be unavailable for the next color choice on that same row. This is because options with an asterisk do not have repeating colors and not allowing the use of guesses with repeating colors adds some challenge. When the row is filled, the colors will reset to become available again for the next row.
If you guess the correct pattern of colors and positions then you win the game. If you go through all the rows and do not guess the right pattern then you lose the game and the game will chat the pattern that you were trying to guess. Once a game is finished, the board will reset after a certain amount of time, which is much less than the timeout mentioned earlier.
