diff --git a/README.md b/README.md index 550645d..6070a91 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,10 @@ +# Rubik-Cube + #

✨Rubik-Cube✨

+

- - + GitHub issues @@ -18,10 +20,92 @@ Website status

+ + +## 🌐 Link to Game Demo +https://dev-tanay.github.io/Rubik-Cube/ + + + +## 📖 About the Game +This is a simple and elegant game where you can play Rubik's Cube from your own web browser. + +- Each of the six faces of the Rubik's cube is in one of the six colors - red, green, yellow, blue, white, and orange. +- The visible part of the cube is divided into 26 pieces: + - 6 central pieces (one colored side) + - 12 edge pieces (two colored sides) + - 8 corner pieces (three colored sides) +- The 26 pieces are "scrambled" to have different colors on each face. + +## 🕹️ How to Play +The objective of this game is to get each face of the cube to have a single color. + +This can be done in two ways: + +1. **Twisting the Segments** + - This can be done by dragging the cursor over the segment you want to rotate. + + + +2. **Changing the View of the Cube** + - This can be done by dragging the cursor in an arrow around the cube. + + +## 🧩 Installation Guide for Rubik-Cube + +Follow the steps below to install and set up the Rubik-Cube project on your local machine. + +### 📋 Prerequisites +- Ensure you have `git` installed on your system. If not, download and install it from [here](https://git-scm.com/). +- A modern web browser (e.g., Chrome, Firefox, Edge). + +### 🛠️ Steps + +1. **🔗 Clone the Repository** + Open your terminal (or Command Prompt on Windows) and run the following command to clone the repository: + ```sh + git clone https://github.com/Dev-tanay/Rubik-Cube.git + ``` + +2. **📂 Navigate to the Cloned Repository** + Change directory to the cloned repository: + ```sh + cd Rubik-Cube + ``` + +3. **🌐 Open the Index.html File** + Locate the `index.html` file in the repository and open it in your web browser. You can do this by either: + - **Double-clicking the `index.html` file** in your file manager. This will open the file in your default web browser. + - **Running a simple HTTP server** (if you prefer): + + **Using Python (if installed):** + ```sh + python -m http.server + ``` + Open your web browser and go to `http://localhost:8000`. + + **Using Node.js (if installed) with http-server package:** + ```sh + npx http-server + ``` + Open your web browser and go to the provided local server URL (usually `http://127.0.0.1:8080` or similar). + +4. **🎮 Play the Game** + Once the `index.html` file is opened in the web browser, the game screen will be displayed. You can now start playing the Rubik-Cube game. + +### ℹ️ Notes +- Ensure your browser allows running JavaScript, as the game likely depends on it. +- If you encounter any issues, check the browser console for error messages and ensure all assets are properly loaded. + +Enjoy your Rubik-Cube game! 🕹️✨ + +## 🧭 Navigating the Game Screen +- **Home** +

About the Game

This is a simple and elegant game where you can play Rubik's Cube from your own web browser.

Each of the six faces of the Rubik's cube is in one of the six colors - red, green, yellow, blue, white, and orange.

@@ -83,38 +167,38 @@

Navigating the Game Screen

+ - Displays statistics of your Rubik's Cube game, including: + - Total Number of Solves + - Best time + - Average of 5, 12, 25 -

LICENSE

-

This project is licensed under the MIT License - see the LICENSE file for details.

+## 📜 License +This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. \ No newline at end of file