Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cliftondavies/retoohs-ecaps
A browser-based shooter game.
https://github.com/cliftondavies/retoohs-ecaps
fetch-api html5 javascript leaderboard-api netlify npm phaser3 webpack
Last synced: 25 days ago
JSON representation
A browser-based shooter game.
- Host: GitHub
- URL: https://github.com/cliftondavies/retoohs-ecaps
- Owner: cliftondavies
- License: mit
- Created: 2021-01-18T21:08:02.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2021-02-18T18:51:27.000Z (almost 4 years ago)
- Last Synced: 2024-11-13T01:38:21.487Z (3 months ago)
- Topics: fetch-api, html5, javascript, leaderboard-api, netlify, npm, phaser3, webpack
- Language: JavaScript
- Homepage: https://retoohs-ecaps.netlify.app/
- Size: 798 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[![MIT license](https://img.shields.io/badge/License-MIT-blue.svg)](https://lbesson.mit-license.org/)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)
[![Open Source Love png1](https://badges.frapsoft.com/os/v1/open-source.png?v=103)](https://github.com/ellerbrock/open-source-badges/)
![Tweeting](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)# Retoohs-Ecaps
## Background
It's the year 3000! The planet **Retoohs Ecaps** is under attack from the **Envoy**, an alien race seeking to colonise your galaxy. You're the last remaining Starship. Can you prevent an all out invasion?
## Aim of the game
Attain a top 10 score to save your planet! **Your score** will be only be displayed on the leaderboard if it falls within the top ten warlord scores.
## Scenes
The game is split into five scenes:
- a Boot scene for initial startup
- a Preload scene for loading game assets
- a Title or start game scene
- a Game scene where the action takes place
- and a Leaderboard scene for displaying the top 10 scores## MVP Features
- Start Game
- Move player in all four directions horizontally and vertically
- Spawn enemies
- Enemy lasers
- Player lasers
- Destroy enemy ships
- End game for player
- Score system## Nice-to-haves for future implementation
- Ship explosion animation on impact with lasers
- Game sounds and music
- Additional scenes for Settings, Credits, etc
- Mobile compatible version## Controls
- `SPACE` = PLAYER LASER
- `LEFT ARROW` = MOVE LEFT
- `RIGHT ARROW` = MOVE RIGHT
- `UP ARROW` = MOVE UP
- `DOWN ARROW` = MOVE DOWN![screenshot](retoohs.png)
## :tv: Media
[Live Demo Link](https://retoohs-ecaps.netlify.app/)
## :toolbox: Tools & Technologies Used
### Built with
- HTML5
- JavaScript ES6
- [Phaser](https://phaser.io/)
- Fetch API
- Leaderboard API
- webpack 5### Tested with
- Jest v26.6
## :rocket: Getting Started
To get a local copy up and running follow these simple example steps.
### Prerequisites
Install [Node.js with npm](https://nodejs.org/en/download/)
Install [webpack](https://webpack.js.org/guides/getting-started/)
### Set up
Clone repo into your local environment:
Clone with SSH
```git
git clone [email protected]:cliftondavies/Retoohs-Ecaps.git
```Clone with HTTPS
```git
git clone https://github.com/cliftondavies/Retoohs-Ecaps.git
```Open project directory
```bash
cd [your-directory-name]
```Install packages:
```javascript
npm install
```### Local Usage
#### In console
Start server:
```javascript
npm run start:dev
```Run tests:
```javascript
npm test
```#### In Browser
Visit `http://localhost:8080/`.
## Author
👤 **Clifton Davies**
- Github: [@githubhandle](https://github.com/cliftondavies)
- Twitter: [@twitterhandle](https://twitter.com/cliftonaedavies)
- Linkedin: [linkedin](https://www.linkedin.com/in/clifton-davies-mbcs/)## 🤝 Contributing
Contributions, issues and feature requests are welcome!
## Show your support
Give a ⭐️ if you like this project!
## Acknowledgements
- [CruzR](https://opengameart.org/content/space-starter-kit)
## 📝 Copyright & License
Copyright (c) 2020 Clifton Davies.
This project is licensed under [MIT](https://opensource.org/licenses/MIT). See LICENSE file for details.