https://github.com/ivaaane/hangman
Hangman game for your terminal
https://github.com/ivaaane/hangman
cli cli-app game lua small treminal
Last synced: over 1 year ago
JSON representation
Hangman game for your terminal
- Host: GitHub
- URL: https://github.com/ivaaane/hangman
- Owner: ivaaane
- Created: 2024-06-24T15:30:34.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-09T18:17:31.000Z (almost 2 years ago)
- Last Synced: 2025-01-05T06:42:57.240Z (over 1 year ago)
- Topics: cli, cli-app, game, lua, small, treminal
- Language: Lua
- Homepage:
- Size: 15.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# CLI Hangman
This is a Hangman game for the command line interface.
I created it as an exercise to get more familiarized with Lua, so it's a bit _PLRGFVJK_.
## How to play
You're given a secret word, and your mission is to guess which letters this word contains. If you commit
an error 8 times, you lose. You're given a preview of the word showing its length and the words you've
guessed correctly in their positions.
The interface contains:
* An ASCII picture showing the hanged man. The more mistakes you make, the more the drawing shows.
* The hidden word preview.
* Your number of errors.
* The letters you have already said listed.
* A guide telling the results of the last action.
Write a single character and press `enter` to submit the input.
## Executing
You need Lua installed in your system. Clone this repository
```bash
git clone https://github.com/ivaaane/hangman.git
```
go to the new directory and allow access
```bash
chmod a+rx hangman.lua
```
and then execute.
```bash
./hangman.lua
```
No dependencies are needed. Enjoy your game!
## Credits
* [ASCII art](https://gist.github.com/chrishorton/8510732aa9a80a03c829b09f12e20d9c).
* I don't remember from where I took the words, but if I find it I'll give the proper credit :'D