Merge branch 'main' into feat/penalty-shootout

.github/CONTRIBUTING_GUIDELINE.md

@@ -36,17 +36,21 @@ in case you are stuck:
 <br>
 
 ## **File naming conventions 📁**
-- Give unique name for your game that is not already existed 
+- Give unique name for your game that don't exist already. 
 * Folder naming convention
-    - ```Game_Name```  ex.  ```Tilting_Maze``` (first letter should be capital and if you need space use _ )  
+    - ```Game_Name```  ex.  ```Tilting_Maze```,```Rock_Paper_Scissors``` (first letter should be capital and if you need space use underscore **_** )      
 * files in the folder 
-    - ```index.html``` , ```script.js``` , ```style.css```(not stictly to follow this but you should have separate )
+    - Main html file should be named as **index.html** , not something else like ```Tilting_Maze.html```
+    - Game files - ```index.html``` , ```script.js``` , ```style.css```(not stictly to follow this but you should have separate file for each kind)
+    - It is preferred if the main html file is directly added to the main folder of you game like ```Tilting_Maze/index.html``` along with other files like *style.css*, *script.js*
     - you can have other folders if you are having assets for your game 
-    - ```README.md``` for your folder using template [TEMPLATE](../Games/FOLDER_README_TEMPLATE.md) 
-    - It is not compulsory to follow this README template only you can have your own 
+    - Create```README.md``` for your Game using this [TEMPLATE](../Games/FOLDER_README_TEMPLATE.md).Although, it is not compulsory to follow this README template ,you can use your own *README* template whichever you prefer, to explain your Game
 * naming convention for the screenshot you will add in ```assets/images```
+    - Remember preview image should be in ```assets/images``` and not in main folder of Game itself.
     - name of image should be same as your game name
-    - ex. ```Tilting_Maze.jpeg``` or .jpg or .png any of the image formate
+    - ex. ```Tilting_Maze.jpeg``` or .jpg or .png any of the image format, but don't add image format in the name itself , it is self-assigned to a image,you don't need to add it manually, otherwise it becomes ```Tilting_Maze.jpeg.jpeg```
+    - There should be only one ScreenShot of the game in ```assets/images``` and that too with same name as the Game(Exactly Same).
+* Note:-All Other data except the ScreenShot of your Game, should be in it's main folder , don't add it to other folders of the project.
 
 <br>
 

CONTRIBUTING.md

@@ -87,6 +87,30 @@ If you find this project helpful, please consider giving it a star on GitHub! Yo
 
 <br>
 
+
+## Add Game to assets/js/gamesData.json
+
+* This is to Show your game on the main Website
+   - Go to the end of gamesData.json and add :
+   - **,**
+         " **No.** ":{
+            "gameTitle" : " **Title** ",
+            "gameUrl": " **Main Folder** ",
+            "thumbnailUrl":" **Preview Image** " 
+         }
+   - **No.**: Number for your Game , it should be the next number with respect to the file. eg: it the last no. in file at present is *625* you should put *626* at the place of **No.**
+   - **Title:** this is the title for your game that will be shown on the website, if your game name is ```Super_Mario_Game``` ,put Title as ```Super Mario Game```
+   - **Main Folder :** This is the reference to *index.html* 
+      - if your index.html is directly in main game folder ,put the main folder name eg: ```Super_Mario_Game```
+      - if your index.html is in subfolder , give path to it 
+      eg: ```Super_Mario_Game/public``` (assuming index.html is in public folder of Super_Mario_Game folder)
+      - if your main html file's name is not index.html , you need to specify the main html file also. eg:```Super_Mario_Game/mario.html``` or if in sub folder ```Super_Mario_Game/public/mario.html```
+   - **Preview Image:** This is the image that will be shown as preview for your game , here you provide the name of the image that you added to **assets/images** folder, along with format type. Eg. ```Super_Mario_Game.png``` or ```Super_Mario_Game.jpg``` or with any other format.
+
+**Note:-** 
+
+   -  Do not modify anything else in the rest of the file, you only need to add your game in the end of the file. 
+   - Don't forget to add the comma for new entry (already give in above sample but this is a reminder as one might miss it to see in the sample)
 ## **Pull Request Process 🚀**
 
 1. Ensure that you have self reviewed your code 😀

Games/Angry_Bird/README.md

@@ -0,0 +1,65 @@
+# Angry Birds 
+
+## Overview
+
+The Angry Birds is a user-friendly browser extension designed to enhance your Angry Birds gaming experience. This script allows you to modify in-game resources and unlock features with ease. The functionalities include modifying coins, unlocking all levels, and unlocking all birds, providing you with unlimited access to the game’s content.
+
+## Features
+
+### Modify Coins
+- **Description**: Change your current coin count to a specified amount.
+- **Usage**: Input your current number of coins, and the script will set the coin count to a high value (e.g., 999,999).
+
+### Unlock All Levels
+- **Description**: Instantly unlock all levels in the game.
+- **Usage**: Allows access to play any level without needing to progress sequentially.
+
+### Unlock All Birds
+- **Description**: Unlock all bird characters in the game.
+- **Usage**: Provides access to every bird with unique abilities from the start.
+
+## Installation
+
+1. Clone or download the repository.
+2. Open your browser and navigate to the extensions page.
+3. Enable "Developer mode".
+4. Click "Load unpacked" and select the directory containing the downloaded files.
+
+## Usage
+
+1. Open the extension by clicking on the Angry Birds GG Script icon in your browser.
+2. Choose the desired option:
+   - **Modify Coins**: Enter your current amount of coins when prompted.
+   - **Unlock All Levels**: Click to unlock all levels instantly.
+   - **Unlock All Birds**: Click to unlock all birds instantly.
+3. Follow the prompts and alerts to complete the modifications.
+
+## Files
+
+### `index.html`
+
+The HTML file providing the structure of the user interface.
+
+### `styles.css`
+
+The CSS file for styling the user interface.
+
+### `script.js`
+
+The JavaScript file containing the functionality for modifying the game’s resources.
+
+### `manifest.json`
+
+The manifest file required for the browser extension, specifying metadata and permissions.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a pull request.
+
+## License
+
+This project is for educational purposes only. Use at your own risk.
+
+---
+
+By using this script, you acknowledge that it is for educational purposes only and should not be used to cheat in the game.

Games/Angry_Bird/index.html

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Angry Birds GG Script</title>
+  <link rel="stylesheet" href="styles.css">
+</head>
+<body>
+  <h1>Angry Birds GG Script</h1>
+  <button id="modify-coins">Modify Coins</button>
+  <button id="unlock-levels">Unlock All Levels</button>
+  <button id="unlock-birds">Unlock All Birds</button>
+  <button id="exit">Exit</button>
+  <script src="script.js"></script>
+</body>
+</html>

Games/Angry_Bird/manifest.json

@@ -0,0 +1,17 @@
+{
+    "manifest_version": 2,
+    "name": "Angry Birds GG Script",
+    "version": "1.0",
+    "description": "A script to modify coins, unlock levels, and unlock birds in Angry Birds for educational purposes.",
+    "icons": {
+      "48": "icon.png"
+    },
+    "browser_action": {
+      "default_popup": "index.html",
+      "default_icon": "icon.png"
+    },
+    "permissions": [
+      "activeTab"
+    ]
+  }
+

Games/Angry_Bird/script.js

@@ -0,0 +1,49 @@
+// Function to modify coins
+function modifyCoins() {
+    let coins = prompt("Enter your current amount of coins:");
+    coins = parseInt(coins);
+    if (isNaN(coins)) {
+      alert("Invalid number. Please try again.");
+      return;
+    }
+    let newCoins = 999999;
+    alert(`Coins modified successfully to ${newCoins}!`);
+  }
+
+  // Function to unlock all levels
+  function unlockAllLevels() {
+    alert("All levels unlocked!");
+  }
+
+  // Function to unlock all birds
+  function unlockAllBirds() {
+    alert("All birds unlocked!");
+  }
+
+  // Function to handle button clicks
+  function handleButtonClick(event) {
+    const buttonId = event.target.id;
+    switch (buttonId) {
+      case "modify-coins":
+        modifyCoins();
+        break;
+      case "unlock-levels":
+        unlockAllLevels();
+        break;
+      case "unlock-birds":
+        unlockAllBirds();
+        break;
+      case "exit":
+        alert("Exiting script...");
+        break;
+      default:
+        break;
+    }
+  }
+
+  // Add event listeners to buttons
+  document.getElementById("modify-coins").addEventListener("click", handleButtonClick);
+  document.getElementById("unlock-levels").addEventListener("click", handleButtonClick);
+  document.getElementById("unlock-birds").addEventListener("click", handleButtonClick);
+  document.getElementById("exit").addEventListener("click", handleButtonClick);
+

Games/Angry_Bird/styles.css

@@ -0,0 +1,21 @@
+body {
+    font-family: Arial, sans-serif;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    height: 100vh;
+    background-color: #f0f0f0;
+  }
+
+  button {
+    margin: 10px;
+    padding: 10px 20px;
+    font-size: 16px;
+    cursor: pointer;
+  }
+
+  h1 {
+    margin-bottom: 20px;
+  }
+

Games/Block_Dodger/README.md

@@ -0,0 +1,43 @@
+# **Block Dodger Game**
+
+
+<br>
+
+## **Description 📃**
+Block Dodger is a simple and addictive browser-based game where players control a character to dodge falling blocks. The goal is to survive as long as possible while accumulating a high score. 
+
+<br>
+
+## **functionalities 🎮**
+
+•Character Movement: The player can move the character left and right using the keyboard arrow keys.
+
+•Falling Blocks: Blocks fall from the top of the game area, and the player must dodge them to stay alive.
+
+•Score Tracking: The game tracks the player's score based on how many blocks they successfully dodge.
+
+•Game Over Display: When the game ends, the player's score is displayed on the screen.
+
+<br>
+
+## **How to play? 🕹️**
+
+• Open index.html in a web browser to start the game.
+
+• Use the left (←) and right (→) arrow keys to move the character.
+
+• Avoid falling blocks and try to stay on screen as long as possible.
+
+• The game ends if the character goes off the top of the screen.
+
+• Your score is displayed when the game ends.
+<br>
+
+## **Screenshots 📸**
+![image](https://github.com/AshishPandey04/GameZone/blob/newBranch/assets/images/Block_Dodger.png) 
+![image](https://github.com/AshishPandey04/GameZone/blob/newBranch/assets/images/Block_Dodger2.png) 
+
+<br>
+
+ ## **Working video 📹**
+ ![vedio](https://github.com/AshishPandey04/GameZone/blob/newBranch/assets/animations/Block_Dodger.mp4)

Games/Block_Dodger/index.html

@@ -0,0 +1,32 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+  <meta charset="UTF-8" />
+  <title>Falling Ball Game</title>
+  <link rel="stylesheet" href="style.css" />
+</head>
+
+<body>
+  <nav>
+    <h1 class="header">
+      Falling Ball Game
+    </h1>
+  </nav>
+
+  <div id="game">
+    <div id="character"></div>
+
+  </div>
+
+  <h3 style="text-align: center;">Use arrows keys to play game</h3>
+  <div id="resultBox"></div>
+
+  <button id="restartButton" onclick="restartGame()">Restart</button>
+  </div>
+
+
+</body>
+<script src="script.js"></script>
+
+</html>