chingu-voyages / v44-tier1-team-05 Goto Github PK

• Overview
• Requirements & Specifications
• About Chingu
• Authors
• Acknowledgements

The Array Game is designed to help early learners build and expand on their multiplication skill for the numbers 1-6. Players use a simple grid that visually represents the calculation.

The goal of this game is to help kids supplement what they are learning about multiplication with a fun activity they use for practice.

The objective of the game is for players to shade in as much of the 10x10 grid as possible. Players take turns rolling dice and then shading an array whose dimensions are equal to the numbers on the dice.

For example, if you roll a 2 and a 3 you would shade in a 2x3 array on the grid either vertically or horizontally. In this example, the array could be either 2 rows by 3 columns or it could be 3 rows by 2 columns.

If it turns out that there's no room on the grid for your array, the player can't update the grid and must wait until their next turn to roll again.

The game will end when one of these conditions are reached:

1. A pre-defined period of time is reached. Whoever has the highest score wins.
2. A player forfeits two consecutive turns. In this situation, that player loses the game.
3. A player completely fills in their grid. This will take longer than the first two options. Depending on the luck of the roll, players may end up forfeiting many turns.

-Repository

-Live Site URL

• This is a purely frontend application. No backend is required.
• Useful links and resources: - The Array Game

• User can see the game window with these components

  • Leaderboard showing the number of games the current player has won and lost
  • Game controls
  • A 10x10 grid the game is played on
  • View the optimal layout for the interface depending on their device's screen size
  • See focus and hover states for all interactive elements on the page

• Leaderboard

  • User can see the display of the total number of wins and losses for each
  • User can see the tally of wins for each of the three ways the game can end
  • User can see the tally of losses for each of the three ways the game can end

• Game Controls

  • User can see a button in the game control panel to start a new game, which updates the Leaderboard, clears the grid, and starts a new game.
  • If the user tries to start a new game while one is in progress a modal alert will be displayed to confirm that the current game may be abandoned.
  • When a game is started the user will see a button to roll the dice
  • After rolling the dice a new roll will be blocked until the new array has been marked on the grid by clicking squares in the grid
  • User can see a the value of each dice after they are rolled
  • The user will see a button to allow them to clear the grid and to start refilling it using the values from the current roll. This allows the user to try different options.
  • The user will see a button that allows them to submit their answer after filling in the grid from the current roll of the dice.

• Grid

  • When the dice are rolled the user will be able to click on squares to mark their array.
  • When a square is clicked it's color will change from the color used for unoccupied squares to the color designation for occupied squares.
  • If the total number of squares marked on the grid don't match the numbers on the dice an error message must be issued and the user should be given the option to re-mark the grid to match the dice.

• Add a countdown timer showing time remaining in the game
• Animate the rolling of the dice
• Play a sound to simulate the rolling dice
• Support dark/light mode

• Figma - A cloud-based design tool
• HTML5 - The web framework used
• CSS - The styling language used
• JavaScript - The programming language used

If you aren’t yet a member of Chingu we invite you to join us. Chingu helps members transform what they’ve learned in courses & tutorials into the practical experience employers need and want.

• Chingu Voyages -- Initial work -
• Jim Medlock -- Initial work --
• Angela L -- Team Mentor --
• John Foughty -- Designer --
• Alex Papparotto-Goodman -- Developer --
• Gabriela de Paula -- Developer --
• Nazgul Duisenbay -- Developer --

• A big high-five to the staff at Chingu. We would like to to extend our appreciation to everyone for providing us this wonderful oppurtunity!
• A special mention to our personal Mentor, Angela for helping guide us along the way.
• Thanks to George Whiting for his tutorial on making a grid for players. Tutorial Link
• A special mention to Charlie Britton for the Dice Roller Animation. Step-by-step Guide
• Thanks to Matheus Battisti for his tutorial on creating a countdown timer. Tutorial Link