Skip to content

1noro/fastmind

Repository files navigation



Solve mazes and measure your time to complete them as fast as you can.

No habrá nunca una puerta. Estás adentro
y el alcázar abarca el universo
y no tiene ni anverso ni reverso
ni externo muro ni secreto centro.

Fragment of the poem Laberinto of Jorge Luis Borges.

Easy installation 😄

Python >=3.5 pygame 1.8.0

If you use Windows, you must previously install python3.x on your PC.

In some distributions of GNU/Linux PIP for python3 is not installed by default in the system. If you have this problem run: sudo apt-get install python3-pip for Debian/Ubuntu/Mint.

  • Get the latest release.
  • Extract the .zip/.tar.gz in the current folder.
  • Open a terminal and navigate to the folder where the content of the .zip/.tar.gz has been extracted (using the cd command).
  • Execute the following command: sudo python3 setup.py install for GNU/Linux or python setup.py install for Windows.

Manual installation 😰

If the easy installation has not worked for you, you can try this.

Requirements

The program uses the pygame library for its full operation, so it is mandatory to install it on your computer before running the program.

For more questions, go to the official pygame website: https://www.pygame.org/wiki/GettingStarted

Generic Unix pygame installation

python3 -m pip install -U pygame --user

If you do not have pip installed for python3 in Debian/Ubuntu/Mint: sudo apt-get install python3-pip

Another option for Debian/Ubuntu/Mint
sudo apt-get install python3-pygame
Another option for Fedora/Red Hat
sudo yum install python3-pygame

Windows

Make sure you install python3.x with the "Add python 3.x to PATH" option selected. This means that python, and pip will work for you from the command line.

python -m pip install -U pygame --user

Get and run the program 🚀

Currently the project is at a very early stage of its development (alpha), you can install it on your PC, but future versions may delete previous configurations in the program.

At the moment this program has not been tested in Mac OS, so I still can not specify whether it works or how to install it correctly.

Assuming you have git installed

git clone https://github.com/boot1110001/fastmind
cd fastmind
python3 fastmind

Getting a .zip file from GitHub

  • Extract the .zip in the current folder.
  • Open a terminal and navigate to the folder where the content of the .zip has been extracted (using the cd command).
  • Execute the following command: python3 fastmind for GNU/Linux or python fastmind for Windows.

Run options

Usage: fastmind [options]

Options:
  -h, --help            show this help message and exit
  -v, --verbose         print status messages to stdout.
  -l LANG, --lang=LANG  changes the default language.
  -p LEVEL, --play=LEVEL
                        play the LEVEL instantly.
  -s, --show            show the available levels.

Languages avaliable

  • en.EN English (UK).
  • es.ES Spanish (Spain).
  • es.GL Galician.

Things that I would like to add in the future

  • Add more levels.
  • Add a configuration section to the main menu.
  • Improve the gameplay.
  • Rethink the graphics (but keeping the retro style).
  • Save the results locally.
  • Show results table after each level and be able to compare with others.
  • Add teleports.
  • Add original music.
  • Modify the code in order to get the most efficient way.

Credits

Created, programmed and maintained by boot1110001.

Licenses

GPL3 CC BY 4.0

Donations

  • Bitcoin: 37Cx8i8Q4VjJJpMX6oRYVh2FUpXR1yMf54
  • Litecoin: MMUTvmaiZhPHjK68Jy1Z9roVFo7siGCcf8
  • Dogecoin: DSaqBstRo4h6dpzs9n7UDv39cg9wqErZvo