/ballparkGamma

Primary LanguageJavaScript

BallPark

BallPark is an interactive game that challenges players to arrange cards with numerical values on a number line based on their corresponding facts. The game features three modes: Single Player, Multiplayer, and Study Mode. In Single Player mode, players can test their skills individually, while Multiplayer mode allows them to compete with friends using a room code. The Study Mode offers a relaxed environment for practicing card arrangement without any time constraints.

Table of Contents

Installation

To install and run BallPark, please follow these steps:

  1. Clone the repository:

    git clone https://github.com/harsh1245-bit/ballparkGamma.git
    cd ballParkGamma
    npm install
    npm start

The game should now be running locally on your machine. Open your web browser and visit http://localhost:3000 to access the game.

Gameplay

BallPark presents players with a set of cards, each containing a fact and its corresponding numerical value. The goal is to arrange the cards on a number line based on their numerical values. Players must use their logical reasoning and estimation skills to correctly order the cards.

To arrange the cards, follow these steps:

Drag a card from the bottom panel and place it on the number line at the desired position.

Once you are satisfied with your arrangement, release the card to lock it in place and see how close you were to the correct order.

Modes

BallPark offers three different modes to cater to different preferences and requirements:

  1. Single Player: In Single Player mode, you can challenge yourself by solving card arrangement puzzles individually. The game will provide you with a set of cards, and you have to arrange them on the number line. You have three lives, and each time you arrange the cards incorrectly, you lose one life. If you lose all three lives, the game ends. The objective is to achieve the highest score possible by arranging the cards correctly with the fewest mistakes.

  2. Multiplayer: Multiplayer mode allows you to compete with your friends or other online players. Create a room and share the unique room code with others to invite them to join. Each player will receive the same set of cards, and the player who arranges the highest number of cards in the correct order wins the round. In this mode, you also have three lives, and each incorrect arrangement results in the loss of one life.

  3. Study Mode: Study Mode is designed for players who want to practice card arrangement without any time pressure. You can access this mode to refine your skills, experiment with different strategies, or simply enjoy the game at your own pace. This mode does not include lives, so you can freely rearrange the cards until you are satisfied with the result.

Scoring and Lives

In Single Player and Multiplayer modes, you earn points based on your performance. The scoring system takes into account the number of correctly arranged cards. The more number of cards you arrange correctly, the higher your score will be.

Remember, in Single Player and Multiplayer modes, you start with three lives. Each time you arrange the cards incorrectly, you lose one life. If you run out of lives, the game ends. Use your lives wisely and try to minimize mistakes to achieve the highest possible score.

Contributing

Contributions to BallPark are welcome! If you have any ideas, bug fixes, or improvements, feel free to submit a pull request. When contributing, please follow the existing code style and ensure that your changes align with the project's scope and goals.

If you encounter any issues or have suggestions for new features, please open an issue on the GitHub repository.

We hope you enjoy playing BallPark! If you have any questions or need assistance, please don't hesitate to reach out. Happy card arranging!