avain / Rummikub

Project #0: Rummikub

Overview

Rummikub is a tile-based game for 2 to 4 players, combining elements of the card game rummy and mahjong. There are 104 number tiles in the game (valued 1 to 13 in four different colors, two copies of each) and two jokers. Players have 14 tiles initially and take turns putting down tiles from their racks into sets (groups or runs) of at least three, drawing a tile if they cannot play. The first player to use all their tiles scores a positive score based on the total of the other players' hands, while the losers get negative scores. An important feature of the game is that players can work with the tiles that have already been played.

resource: https://en.wikipedia.org/wiki/Rummikub

MVP Pitch

A MVP of Rummikub should deal tile automatically, allow user to draw randomly from the pouch by clicking the "+" button, allow user to rearrange tile with both tile on hand and tile in the playground and at the end validate the result. The winner will be the one who empty the rack first and the score will be calculated by the points remain on the losers rack.

Initial Setting

1. Player can see the slide show for tutorial of the game or click "start" to enter the game.
2. On the screen, there will be two tiles facing down. Player will choose either one and the other one represent computer's choice. Whichever is bigger will go first.
3. System will deal 14 cards from the public pouch for both player and computer.

Contents

106 tiles (2 sets of tiles numbered 1 to 13 in four colors: black, red, blue, orange; 2 Jokers)

---

Basic Rule/ Logic

A valid set must be at least 3 tiles.

A group: same number but different color (3 or maximun of 4 cards)

A run: same color of consecutive number (3 or more)

players will take turn to put tiles in the playground. player can build on the sets in the playground. All the tile sets on the playground must be valid.

The Jokers

joker card can represent any number in any color.

once the joker is in the playground, anyone can use it by replacing it if all the set are still valid before their turn ends. player must use the joker at that turn.

Start the Game

First turn must break the ice. Players must show more than 30 points at their first turn After breaking the ice, player take turns. if no tile is added to the playground, the player must draw one tile from the public pouch.

Every turn If add any tile to the playground, no need to draw new tile and the turn is done. If didn't add any tile to the playgorund, draw one tile.

To win

whoever empty their rack first wins. and the total points of the tiles in the losers rack will be the points winner wins and the points loser loses.

Play 3 rounds and calculate final score.

---

Functions

Monday

HTML structure

make the grid and make sure the grid can render given tile image

Initial playground

2 valid groups and 4 valid runs will be generate automatically

Deal - 14 tiles each for Both

Use random() to the pouch array and distribute to player and computer array

sort the player and computer array

Draw - add tile to user**

random() from pouch and add to player

In player's rack, sort by number(1 ~13) then by color(Black, Blue, Orange, Red)

Count and show the tile for Computer, Player and the pubic pouch

Total count of 104(or 106 with joker)

Tuesday

Done - end of each turn**

1. check if the rack is empty
   1. yes, announce winner
   2. no, check valid
2. check valid
   1. check user tile count
      1. less then previous, next turn
      2. no change, draw a tile

Arrange

"Pick one, Drop one"

For Runs, will check if the tile is at its designed place

For Groups, will check when click the "Done" button( see validation)

Reverse - back to previous stage

use Object to store previous value(when computer click "Done").

reassign value to current

Wednesday

Computer

1. check if any complete Runs or Groups on rack
2. check if can add on tiles in the playground - For Loop
3. If not, draw one tile from the pouch

Score

• sum the value of the tile on the losers rack
• store value for rounds and display

Stretch goals

Thursday

CSS

/animation if any

Stretch goals

1. Timer: each turn have only 2 minutes max.
2. Sorting function: help player rearrange their card by runs or groups
3. Joker logic, validation and rearrange with joker
4. Drag and drop (jquery UI) or animation(or sound) of picking and putting the tile
5. Better and more efficient algorithm for computer(smarter!)
6. Tutorial slideshows

Data Structure

• Computer's rack - []

• Players's rack - []

• playground - Group: [[101,201,301,401],[104,204,304,404],[107,307,407]]

• playground - Run: ["XX234XX789ABCX","123XXXX89AXXXX","123XXXX89AXXXX","123XXXX89AXXXX","123XXXX89AXXXX","123XXXX89AXXXX","123XXXX89AXXXX","123XXXX89AXXXX"]

  • will be fixed 8 strings inside the array and first two will be black-1 and black-2, and following will be blue-1, blue-2, orange-1, orange-2, red-1,red-2.

• for reverse, we are taking a screenshot of the stauts when comupter hit done and store the status in an Object. (deep copy/clone to prevent polluting the screenshot)

• {
  computerRack: [],
  playerRack: [],
  group: [[],[],[],[],[]],
  run: ["","","","",""],
  pouch: [],
  ...
  }