hShip (a.k.a rShip)

A tiny ships game made of ASCII characters

hShip is a small ships game made from simple ASCII characters, for Windows devices. It is worth mentioning that this repository contains the code of the rShip project, which is nothing more than an improved version and rewritten from scratch of the original project (a.k.a a remake). Of course, the source code of the original project and its binaries will be available in the releases section so that a comparison can be made between the two, but I must warn you that the original version is only in Spanish. Also, this game is (like most of my titles) published on the itch.io platform, so you can find this same information as well as download the game binaries more easily on that page.

This is, however, a small project that I carried out quite some time ago, so don't expect high quality as most of the code has remained the same (except for the language change from being written in C /C++ to being in Rust).

Install instructions

Get the already compiled binary

Click on the hShip.Win64.zip file and then unzip it.
Then execute the file with extension .exe contained in the newly extracted folder (hShip.exe).
(Optional) Move the newly extracted directory to a safe location (such as C:\) and add the folder to your PATH variable.

Build the project from source code

Click on the hShip.Source.zip file and then unzip it, or clone the repository via git (run git clone https://github.com/h3nry-d1az/rShip.git in CMD or PowerShell ).
Then compile it using cargo (if you don't have Rust installed go here) using the command cargo build --release if you want to build just the binary or run cargo install --path . to install it.

Easiest method (requires Rust installed )

Just run the command cargo install --git https://github.com/h3nry-d1az/rShip.git and wait for it to finish ( Warning: hShip will be installed in this case under the name rShip ).

Gameplay

Instructions

hShip is an infinite spaceship game in which you will have to destroy asteroids to increase your score, preventing them from hitting you. There are three types of asteroids that have different properties:

Size	Health	Damage	Score	Shape
Small	One shot	One health point	100 points	▓
Medium	Three shots	Two health point	300 points	▒▒ ▒▒
Huge	Five shots	Instant kill	500 points	░░░ ░░░

Also, when you manage to collect 2000 points you will get an extra life, and when you reach 4000 a new asteroid will appear.

Normal controls

Key	Action
`W` / `↑`	Move the ship up
`A` / `←`	Move the ship left
`S` / `↓`	Move the ship down
`D` / `→`	Move the ship right
`Z` / `⎵` / `.`	Fire
`P`	Pause the game