command module
v1.0.1 Latest Latest

This package is not in the latest version of its module.

Go to latest
Published: May 22, 2023 License: MIT Imports: 7 Imported by: 0


🚪 amaze 🚪

A program to create, solve and draw mazes in your terminal or in 2D/3D

2D Terminal view 10x10, Recursive Backtracker, Seed 1684354595222685

Amaze in Action

2D Graphical view 20x20, Growing Tree, Mix, Braid 80%, Seed 1684354465956585

Amaze in Action

3D Graphical view 40x40, Hunt and Kill, Braid 50%, Seed 1684354734176462

Amaze in Action


This program uses G3n, so it has the same prerequisites. It is pretty straightforward, since most of the computers nowadays, have an OpenGL driver and a C compiler. I tested both on Linux (manjaro) and mac M1.

Also, note that Amaze uses clap 👏, the Command Line Argument Parser. clap is a non intrusive, lightweight command line parsing library you may want to try out in your own projects. Feel free to give it a try!


git clone
cd amaze
go install

Running the program

You can run the program with several flags, although it has decent defaults. Here are the available flags:

amaze: creates, solves and displays mazes
        --width, -w <width>: set maze's width
        --length, -l <length>: set maze's length
        --algo, -a <name>: choose the algorithm used to create the maze:
              use --choice, -c to chose sub algorithm:
              random, last, or mix
        --seed, -d <seed>: use seed to generate identical maze
        --braid, -b <percent>: braid to remove deadends
        --solve, -s: solve the maze
        --print, -p: print maze in the terminal

Description of the command line parameters

  • width and length allow you to chose the size of your map (defaults to 20).

  • Amaze uses various algorithms to generate mazes, so you can chose the one you prefer (defaults to binarytree).

Please note that Growing Tree requires the choice of a sub-algorithm. You can chose between random, last and mix (defaults to random)

  • seed allows you to replay a maze you liked in the past. The current maze's seed is displayed in the console when the program starts.

  • braid allows you to remove none (0%), some (1-99%) or all (100%) of the deadends in the maze (defaults to 0, keep deadends). Do not include the % sign like in --braid 50.

  • solve allows you to solve the maze, and will display the maze with a color gradient. The entrance (red dot) will be in lighter colors whereas the exit (green dot) will be in darker colors. By default, mazes are unresolved, just in case you want to solve them 😉.

Please note: in the terminal, only the exit path is highlighted in a gradient of color.

  • print allows you to display the maze in the terminal only (no 3D).


Feel free to send feedback, star, etc.


The Go Gopher

There is no documentation for this package.


Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL