An open API service indexing awesome lists of open source software.

https://github.com/Canop/mazter

Mazes in your terminal
https://github.com/Canop/mazter

Last synced: 7 months ago
JSON representation

Mazes in your terminal

Awesome Lists containing this project

README

          

Mazes in your terminal.

[![MIT][s2]][l2] [![Latest Version][s1]][l1] [![Chat on Miaou][s4]][l4]

[s1]: https://img.shields.io/crates/v/mazter.svg
[l1]: https://crates.io/crates/mazter

[s2]: https://img.shields.io/badge/license-MIT-blue.svg
[l2]: LICENSE

[s4]: https://miaou.dystroy.org/static/shields/room.svg
[l4]: https://miaou.dystroy.org/3490?mazter

Mazter is a maze game and generator, with fluid moves and an adaptative rendering dynamically finding the resolution which best suits your terminal's size.

[![asciicast](https://asciinema.org/a/Ip2uIlWMZhjpEotKK5I9Vll65.svg)](https://asciinema.org/a/Ip2uIlWMZhjpEotKK5I9Vll65?autoplay=true&loop=true)

## Install

Either

* download the precompiled binaries from the [official site](https://dystroy.org/mazter),
* or [install the Rust development environment](https://rustup.rs/) then run `cargo install mazter`

## See options

```bash
mazter --help
```

## Play

Simply run

```bash
mazter
```

Move with the arrow keys to exit the maze.

An encounter with a red monster teleports you a short distance, and removes one life.

You get more lives on green squares.

![screenshot](website/level-40-white.png)

As your accomplishments are saved, you'll start at the first level you didn't already win.

But you may replay a previous level with `mazter --level 3`.

If you're several players on the same account, you should specify who's playing:

```bash
mazter --user gael
```

You can see the Hall of Fame with `mazter --hof`:

![screenshot](website/hof.png)

## Just generate a maze

### build a random maze

```bash
mazter --build
```

![screenshot](website/build.png)

### build a maze for a given level

```bash
mazter --build --level 20
```

## Just gaze

With the screen-saver mode, mazter plays by himself, even taking a place in the hall of fame.

```bash
mazter --screen-saver
```