https://github.com/gnurtuv/void-clash

A fast-paced 2D web-based action shooter built with HTML, CSS, and vanilla JavaScript. Dodge enemy fire, collect power-ups, and survive waves of alien invaders and challenging bosses!
https://github.com/gnurtuv/void-clash

action arcade html5 javascript sci-fi space-shooter

Last synced: about 1 month ago
JSON representation

A fast-paced 2D web-based action shooter built with HTML, CSS, and vanilla JavaScript. Dodge enemy fire, collect power-ups, and survive waves of alien invaders and challenging bosses!

• Host: GitHub
• URL: https://github.com/gnurtuv/void-clash
• Owner: gnurtuv
• Created: 2025-05-21T22:56:03.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2025-05-21T23:04:31.000Z (5 months ago)
• Last Synced: 2025-06-07T14:05:52.843Z (4 months ago)
• Topics: action, arcade, html5, javascript, sci-fi, space-shooter
• Language: JavaScript
• Homepage: https://gnurtuv.github.io/void-clash/
• Size: 19.7 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Void Clash

A fast-paced 2D web-based action shooter built with HTML, CSS, and vanilla JavaScript. Dodge enemy fire, collect power-ups, and survive waves of alien invaders and challenging bosses!

**Play the game live here:** [https://gnurtuv.github.io/void-clash/]

![Gameplay Screenshot](link_to_your_gameplay_screenshot.gif) 

## Table of Contents

- [About The Game](#about-the-game)

- [Gameplay & Features](#gameplay--features)

- [Controls](#controls)

- [Built With](#built-with)

- [Getting Started (For Developers)](#getting-started-for-developers)

- [Future Ideas](#future-ideas)

## About The Game

Void Clash is an arcade-style space shooter where you control a lone starship against increasingly difficult waves of enemies. The game features various enemy types, power-ups to enhance your ship, and challenging boss battles. This project was developed as an exercise in vanilla JavaScript game development, focusing on modular design and core game mechanics without external libraries or game engines.

## Gameplay & Features

*   **Fast-Paced Action:** Dodge bullets and destroy waves of incoming enemies.

*   **Multiple Enemy Types:**

    *   **Basic Aliens:** Standard falling enemies with animated movement.

    *   **Chasers:** Pursue the player horizontally.

    *   **Shooting Imps:** Hover and fire projectiles at the player.

    *   **Kamikazes:** Rush towards the player and explode on impact.

*   **Challenging Boss Battles:** Face off against powerful "Eye Tyrant" bosses with unique attack patterns.

*   **Power-Ups:** Collect items to gain an edge:

    *   **Rapid Fire:** Increases your firing speed.

    *   **Spread Shot:** Fire three bullets simultaneously.

    *   **Homing Missiles:** Launch missiles that track enemies (Ammo-based, fired with Shift/X).

    *   **Shield:** Temporary invincibility.

    *   **Extra Life:** Gain an additional life or bonus score.

*   **Wave System:** Progress through waves with increasing difficulty.

*   **Scoring System:** Compete for the high score.

*   **Visual Feedback:** Includes particle explosions, screen shake, and player/enemy animations.

*   **Pure JavaScript:** Built with no external game libraries or frameworks.

## Controls

*   **Move Left:** Left Arrow Key / 'A'

*   **Move Right:** Right Arrow Key / 'D'

*   **Shoot Primary Weapon:** Spacebar / Up Arrow Key / 'W'

*   **Fire Homing Missile:** Shift Key / 'X' (when available)

## Built With

*   HTML5

*   CSS3

*   Vanilla JavaScript (ES6+)

## Getting Started (For Developers)

To run the game locally or contribute to its development:

1.  **Clone the repository:**

    ```bash

    git clone https://github.com/gnurtuv/void-clash.git

    ```

2.  **Navigate to the project directory:**

    ```bash

    cd void-clash

    ```

3.  **Open `index.html` in your web browser.**

    No build steps are required as it's a vanilla JS project.

## Future Ideas

*   More enemy types and attack patterns.

*   Additional power-ups (e.g., temporary speed boost, drone companions).

*   More complex boss mechanics and multiple boss types.

*   Sound effects and music.

*   Touch controls for mobile play.

*   Leaderboard system.

*   Persistent high scores (using LocalStorage).

## Acknowledgements

*   Inspired by classic arcade shooters.

---