Skip to content

Latest commit

 

History

History
149 lines (106 loc) · 3.89 KB

readme.md

File metadata and controls

149 lines (106 loc) · 3.89 KB
Raw

Dodge the Falling Objects Game 🎮

A simple yet thrilling browser-based game where the player must dodge falling objects to score points. Built with HTML, CSS, and JavaScript, this project demonstrates dynamic DOM manipulation, animations, responsive design, and user input handling.

🚀 Demo

Not available right now!

📖 Table of Contents

  1. Features
  2. Technologies Used
  3. Getting Started
  4. Project Structure
  5. Game Instructions
  6. Key Highlights
  7. Contributing
  8. License

🌟 Features

  • Interactive Gameplay: Players can dodge objects using arrow keys or touch gestures.
  • Cross-Platform Support: Works seamlessly on both desktop and mobile devices.
  • Dynamic Animations: Smooth transitions and responsive animations for engaging user experiences.
  • Accessible Design: ARIA roles and attributes for screen reader compatibility.
  • Pause/Resume Functionality: Option to pause and resume the game.
  • Responsive UI: Adapts to different screen sizes with optimized controls for mobile users.
  • Error Handling: Comprehensive global error and rejection handlers.

🛠️ Technologies Used

  • HTML: Semantic structure and accessibility.
  • CSS: Responsive design and animations.
  • JavaScript: Core game logic and user interaction.

📦 Getting Started

Prerequisites

  • Any modern browser (Chrome, Firefox, Edge, Safari).
  • Basic understanding of HTML, CSS, and JavaScript if you want to contribute.

Installation

  1. Clone the Repository

    git clone https://github.com/yourusername/dodge-the-falling-objects.git

  2. Navigate to the Project Directory

    cd dodge-the-falling-objects

  3. Run the Game Open index.html in your browser.

🗂️ Project Structure

dodge-the-falling-objects/
│
├── index.html        # Main HTML structure
├── style.css         # Stylesheet for the game
├── script.js         # Core game logic
├── assets/           # Assets (e.g., icons, images)
│   ├── icon.png
│   └── thumbnail.webp
└── README.md         # Documentation

🎮 Game Instructions

  1. Objective: Avoid the falling objects to score points.
  2. Controls:
    • Desktop: Use the arrow keys to move left or right.
    • Mobile: Swipe left or right to move.
  3. Rules:
    • The game ends when a falling object hits the player.
    • The score increases as you successfully dodge objects.
  4. Pause/Resume: Use the pause button or the Escape key.

🔑 Key Highlights

  • Modular and Clean Code:

    • Use of variables and constants to enhance maintainability.
    • Clear separation of concerns (game logic, styles, and markup).

  • Responsive and Accessible:

    • ARIA attributes improve usability for assistive technologies.
    • Media queries adapt the game to various screen sizes.

  • Advanced Features:

    • Smooth animations with requestAnimationFrame.
    • Touch gesture support for mobile users.

  • Error Handling:

    • Global handlers for runtime errors and promise rejections.

🤝 Contributing

Contributions are welcome! Here's how you can help:

  1. Fork the repository.
  2. Create a feature branch: 
    git checkout -b feature-name
  3. Commit your changes: 
    git commit -m "Add feature-name"
  4. Push to the branch: 
    git push origin feature-name
  5. Open a pull request.

📄 License

This project is licensed under the MIT License.

🙌 Acknowledgments

  • Game designed and developed by A4RMIN.
  • Inspired by classic arcade-style games.