ASCII-Hangman - hangman game for children with ASCII-art rewarding

Jens Getreu


Table of Contents

1. Documentation
2. Source code
3. Distribution
3.1. ASCII-Hangman web application
3.2. ASCII-Hangman desktop version
4. Building and installing
5. About

A little game designed for primary kids to revise vocabulary in classroom. Setting up the vocabulary list is part of the learning process.

Hangman is a paper and pencil guessing game for two or more players. One player thinks of a word, phrase or sentence and the other tries to guess it by suggesting letters or numbers, within a certain number of guesses. In this version for children the computer selects a word, phrase or sentence randomly out of a word-list defined in a configuration file. As a reward, with every guessed letter, some ASCII-art is gradually disclosed. ASCII-Hangman comes with a library containing more than 300 different built-in ASCII-art images.

ASCII-ART HANGMAN FOR KIDS

          ,.
         (_|,.
        ,' /, )_____
     __j o``-'
    (")
     `-j
       `-._(
          |_\  |--^.
         /_]'|_| /_
            /_]'  /

Lifes:  7   Last guess: k

 g o o d   l u _ k

Type a letter, then press [Enter]:

ASCII Hangman is available as a Web-Application and as a Desktop-Terminal-Application for several architectures. Try ASCII-Hangman-Web-App online.

Highlights:

The first versions of ASCII-hangman were published as desktop versions only. With the rising of cyber-crime and the following security related restrictions, it became more and more difficult for teachers to install their own software. This is why from version 5.0 on, ASCII-hangman is also available as web-application.

Read more in ASCII-Hangman’s user manual.

1. Documentation

User documentation:

Developer documentation:

2. Source code

Repository:

3. Distribution

3.1. ASCII-Hangman web application

As the ASCII-Hangman-Web-App is hosted on https://getreu.net, there is nothing to install. Just follow the link and enjoy playing: ASCII-Hangman-Web-App

3.2. ASCII-Hangman desktop version

4. Building and installing

This section describes how to download and build the desktop version of ASCII-Hangman.

  1. Install Rust, e.g.

    curl https://sh.rustup.rs -sSf | sh
    
  2. Download, compile and install:

    cargo install ascii-hangman
    sudo cp ~/.cargo/bin/ascii-hangman /usr/local/bin
    

    See also the user manual for a more detailed installation description.

This project follows Semantic Versioning.

5. About

Author:

  • Jens Getreu

Copyright:

  • Apache 2 licence or MIT licence