https://github.com/valmirbp/typescript_arkanoid
https://github.com/valmirbp/typescript_arkanoid
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/valmirbp/typescript_arkanoid
- Owner: ValmirBP
- License: mit
- Created: 2024-05-16T21:33:50.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-05-22T17:03:28.000Z (about 1 year ago)
- Last Synced: 2025-01-19T11:43:35.355Z (4 months ago)
- Language: TypeScript
- Size: 12.1 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Arkanoid Game
[](https://github.com/ValmirBP/Typescript_Arkanoid/blob/main/LICENSE)
A modern implementation of the classic Arkanoid game using TypeScript, HTML5 Canvas, and CSS. This project showcases game development techniques,
including collision detection, sprite handling, and dynamic user interface updates.
## Table of Contents
- [Features](#Features)
- [Prerequisites](#Prerequisites)
- [Usage](#Usage)
- [Game Mechanics](#GameMechanics)
- [Video](#Video)
- [Contributing](#Contributing)
- [Acknowledgements](#Acknowledgements)
## Features
Classic Arkanoid gameplay
Smooth animations and collision detection
Dynamic score display
Game Over and Win states
Responsive and styled user interface
Customizable game settings
Developed with TypeScript for type safety and modern JavaScript features
Getting Started
These instructions will get you a copy of the project up and running on your local machine for development and testing.
## Prerequisites
Make sure you have the following installed:
### Node.js
- Parcel (for bundling)
- Installation
- Clone the repository:
```bash
git clone https://github.com/yourusername/arkanoid-game.git
```
### Navigate to the project directory:
```bash
cd arkanoid-game
```
### Install the dependencies:
```bash
npm install
```
## Usage
To start the development server and play the game locally, run:
```bash
npm start
```
Open your browser and go to http://localhost:1234 to see the game in action.
## GameMechanics
- Ball Movement: The ball moves continuously and bounces off the paddle, bricks, and walls.
- Brick Collision: The ball breaks bricks upon collision. The game tracks remaining bricks and updates the score.
- Paddle Movement: The paddle is controlled by the player to keep the ball in play.
- Win Condition: The game is won when all bricks are broken.
- Game Over: The game ends when the ball falls below the paddle.
## Video
https://github.com/ValmirBP/Typescript_Arkanoid/assets/48802923/8cb713fc-5b0b-4e40-a109-7020533a5fcf
## Contributing
Contributions are welcome! Please fork the repository and create a pull request with your changes.
## License
This project is licensed under the MIT License - see the LICENSE file for details.
## Acknowledgements
Inspired by the classic Arkanoid game.