https://github.com/robinboers/cutie-tanks
Shoot 'em all arcade game
https://github.com/robinboers/cutie-tanks
electron game gamedevelopment phaser phaser3 tanks
Last synced: 22 days ago
JSON representation
Shoot 'em all arcade game
- Host: GitHub
- URL: https://github.com/robinboers/cutie-tanks
- Owner: RobinBoers
- License: gpl-3.0
- Created: 2021-03-02T12:09:20.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-06-13T20:27:38.000Z (almost 2 years ago)
- Last Synced: 2025-03-26T14:07:34.895Z (about 1 month ago)
- Topics: electron, game, gamedevelopment, phaser, phaser3, tanks
- Language: JavaScript
- Homepage: https://robijntje.itch.io/cutie-tanks
- Size: 20.6 MB
- Stars: 4
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Cutie-Tanks
This is a arcade game where the last one alive wins.
The players play as very cute tanks, and can shoot an unlimited amount of bullets / bombs at eachother.
A player can only take 10 hits before dying. The last one standing wins. Matches are around 1 to 2 minutes and very chaotic. For now there are 3 levels to choose from, but I plan on making some more.
The game had multiple gamemodes:
- **Single Match:**
play one match and return to the skin and level selection screen for another one.
- **Freeplay:**
the same as Single Match, but you can customize all stats for players.
- **Duos/Teams:**
play in teams or duos against others.
Also, there are skins. To join a game press down on the dpad on the player select screen, and then use up and down to select a skin from a lot of cool tanks.
The game is playable online on itch.io and also as a instalable app using Electron.
[Play on itch.io](https://robijntje.itch.io/cutie-tanks)
## Installation
It is possible to run the game locally using Electron. I have prebuilt packages available for Arch Linux and a Lutris install for other distros. If you want to run it on MacOS or Windows, you can build it yourself using for example Electron Forge.
### Lutris
There is a Lutris version available which will install the latest version for a single user.
[Download using Lutris](https://lutris.net/games/cutietanks/)
### AUR
There are two AUR packages available for Arch Linux:
- **cutie-tanks:**
install latest stable tag from GitHub system-wide
- **cutie-tanks-git:**
clones this repo and builds it using parcel
AUR packages can be installed using an AUR helper like `yay` or `paru`:
```bash
yay -S cutie-tanks
```
### Build from source
1. Clone this repo
```bash
git clone https://github.com/RobinBoers/cutie-tanks
```
2. Install npm & parcel bundler
```bash
sudo apt install npm
sudo pacman -S npm
```
```bash
npm install -g parcel-bundler
```
3. Install dependencies
```bash
npm install
```
5. Build
```bash
npm run build
```
## Development
Make sure you have parcel and nodejs installed:
```bash
npm install -g parcel-bundler
```
The game uses Phaser 3 Scenes for the different "states" the game can be in. These are:
- **Loading:**
for loading all the assets
- **Main menu:**
to connect controllers and display the logo
- **Mode select**:
to select a game mode
- **Settings**:
to configure settings for Freeplay Mode
- **Player select:**
to join the game and select a skin
- **In-Game:**
to play the game
- **Winner:**
shows the winner(s): the last one / last team standing
To test the game:
```bash
npm start
```
To package for production:
```bash
npm run build
```
The game will be put in `/dist`.
### Electron
There is a experimental electron version available in `/electron`. It uses `electron-packager` and `electron-installer-flatpak` for building.
To test, run:
```bash
cd electron && npm run dev
```
To build as a flatpak:
```bash
cd electron && npm run build
```
## Controls
The game is designed with a Xbox controller in mind, but any controller should work. To move use the left analog stick. To aim use the right analog stick. To shoot use the analog right trigger. To navigate menus dpad or left analog stick and A/B or start/select.
NOTE: the image above says ABXY to change the level. Since a recent version that has changed and the levels are selected just like any other menu is navigated: using the dpad or left analog stick.