Skip to content

README.md

Latest commit

 

History

History
97 lines (71 loc) · 3.65 KB

README.md

File metadata and controls

97 lines (71 loc) · 3.65 KB

Dodge Object Game

HTML5 CSS3 JavaScript GDGoC IIEST Shibpur CodeIIEST Winter of Open Source

Project Description

Dodge Object Game is a web-based browser game built from scratch using vanilla JavaScript (no external game frameworks).

This project is part of IIEST, Shibpur's Winter of Open Source, where contributors will:

  • Implement game mechanics using vanilla JavaScript
  • Understand game loops, collision detection, and DOM manipulation
  • Build a fully functional game without using any prebuilt game frameworks

What You'll Build

Component Current Status What Needs To Be Done
Gameplay 🟢 Core mechanics working Add power-ups, different obstacle types, difficulty levels
UI/UX 🟡 Basic interface Improve animations, add sound effects, better visual feedback

Web Interface

Dodge Object Game Interface

Contribution Workflow

1. Fork the repository
2. Clone your fork: git clone https://github.com/YOUR_NAME/dodge-objects.git
3. Create a new branch: git checkout -b fix/issue-number-description
4. Make changes and test thoroughly
5. Commit with proper message: git commit -m "Fixes #<issue-number>: description"
6. Push & create PR: git push origin fix/issue-number-description

See CONTRIBUTING.md for detailed setup instructions and guidelines.

Communication

Installation

git clone https://github.com/saral-gupta7/dodge-objects.git
cd dodge-objects

# Open directly in browser
open index.html

# Or use a local server (recommended)
python -m http.server 8000
# Then visit http://localhost:8000

Project Structure

dodge-object-game/
│
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug_report.md
│   │   ├── feature_request.md
│   │   └── documentation.md
│   └── pull_request_template.md
│
├── assets/           # Images, logos, screenshots
├── CSS/
│   └── index.css     # Styles for the game UI
├── JS/
│   └── index.js      # Game logic and mechanics
│
├── index.html        # Main HTML file
├── CONTRIBUTING.md   # Contribution guidelines
├── CODE_OF_CONDUCT.md
├── LICENSE
└── README.md

Code of Conduct

Please follow CODE_OF_CONDUCT.md to ensure a welcoming and productive environment for all contributors.

Made with ❤️ by saral-gupta7