Update README.md

README.md

@@ -1,10 +1,72 @@
-# Pig Dice Game
+# Pig Dice Game 🎲
 
-A simple Pig Dice game implemented in JavaScript.
+Welcome to the Pig Dice Game! 🎉 This classic dice game brings a fun twist to your browser with engaging animations, adjustable AI difficulty, and a cosmic background. Ready to test your luck? 
 
-## How to Play
+🔗 [Play the Game](https://sandunlb.github.io/PIG-DICE-JS/)
 
-1. Roll the dice by clicking the "Roll Dice" button.
-2. Accumulate points or lose them if a 1 is rolled.
-3. Hold to save points to your total.
-4. First to reach Wining points wins!
+---
+
+## 🌟 Features
+
+- **🎮 Game Modes**: Play against an AI or another player.
+- **🤖 AI Difficulty Levels**: Customize the AI’s difficulty for a greater challenge.
+- **✨ Animations**: Experience smooth and captivating dice roll animations.
+- **🔊 Sound Effects & Music**: Toggle background music and sound effects on or off.
+- **📱 Responsive Design**: Optimized for both desktop and mobile devices.
+
+---
+
+## 🚀 Installation & Setup
+
+1. **Clone the Repository**
+   - Open your terminal or command prompt.
+   - Clone the repository using:
+     ```sh
+     git clone https://github.com/SandunLB/PIG-DICE-JS.git
+     ```
+
+2. **Navigate to the Project Directory**
+   - Change your directory to the project folder:
+     ```sh
+     cd PIG-DICE-JS
+     ```
+
+3. **Open `index.html` in Your Browser**
+   - Open the `index.html` file in your preferred web browser to start playing.
+
+4. **Optional Customization**
+   - Edit the `styles.css` file to customize the game's appearance.
+
+---
+
+## 🎮 Usage Instructions
+
+### Game Modes
+- **Single-Player**: Compete against an AI with adjustable difficulty.
+- **Multiplayer**: Play against another human player.
+
+### Controls
+- **🎲 Roll Dice**: Click the "Roll" button to roll the dice.
+- **✋ Hold**: Click the "Hold" button to end your turn and save your score.
+- **🔄 New Game**: Click the "New Game" button to start a fresh game.
+- **🏆 Set Winning Score**: Enter your desired winning score in the provided input field.
+
+---
+
+## 🤝 Development & Contribution
+
+- **Languages Used**: HTML, CSS, JavaScript
+- **Frameworks & Libraries**: No specific frameworks; custom code.
+- **Contributions**: Feel free to fork the repository, make improvements, and create a pull request.
+
+For any issues or suggestions, please open an issue on the [GitHub repository](https://github.com/SandunLB/PIG-DICE-JS).
+
+---
+
+## 📜 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+Thank you for checking out the Pig Dice Game! 🎉 Have fun rolling the dice! 🎲