Minimalist thrilling shoot 'em up game https://brutalmaze.rtfd.io
Go to file
Nguyễn Gia Phong 0ba2f33bda Relicense to AGPLv3+ and update copyright notices 2018-02-27 20:43:25 +07:00
brutalmaze Relicense to AGPLv3+ and update copyright notices 2018-02-27 20:43:25 +07:00
wiki@34af1cf8b3 Add sound options and semi-separate front-end from engine 2018-02-19 16:55:55 +07:00
.gitignore Add CLI option to copy default config and link doc to wiki 2018-02-14 22:31:57 +07:00
.gitmodules Add CLI option to copy default config and link doc to wiki 2018-02-14 22:31:57 +07:00
LICENSE Relicense to AGPLv3+ and update copyright notices 2018-02-27 20:43:25 +07:00
MANIFEST.in Add fancy losing screen and keybinding for new game 2017-10-22 20:31:17 +07:00
README.rst Add CLI option to copy default config and link doc to wiki 2018-02-14 22:31:57 +07:00
screenshot.png Enable pausing, fix sticky move bug and clean up 2017-10-22 17:07:05 +07:00
setup.cfg Initial commit 2017-10-12 20:29:55 +07:00
setup.py Relicense to AGPLv3+ and update copyright notices 2018-02-27 20:43:25 +07:00

README.rst

Brutal Maze
===========

Brutal Maze is a hack and slash game with fast-paced action and a minimalist
art style.

.. image:: https://raw.githubusercontent.com/McSinyx/brutalmaze/master/screenshot.png

The game features a trigon trapped in an infinite maze. As our hero tries to
escape, the maze's border turns into aggressive squares trying to stop him.
Your job is to help the trigon fight against those evil squares and find a way
out (if there is any). Be aware that the more get killed, the more will show up
and our hero will get weaker when wounded.

Brutal Maze has a few notable feautures:

* Being highly portable.
* Auto-generated and infinite maze.
* No binary data for drawing.
* Enemies with special abilities: stun, poison, camo, etc.
* Somewhat a realistic physic and logic system.
* Resizable game window in-game.

Installation
------------

Brutal Maze is written in Python and is compatible with both version 2 and 3.
The installation procedure should be as simply as follow:

* Install Python and `pip <https://pip.pypa.io/en/latest/>`_. Make sure the
  directory for `Python scripts <https://docs.python.org/2/install/index.html#alternate-installation-the-user-scheme>`_
  is in your ``$PATH``.
* Open Terminal or Command Prompt and run ``pip install --user brutalmaze``.
  Now you can launch the game by running the command ``brutalmaze``.

For more information, see the `Installation <https://github.com/McSinyx/brutalmaze/wiki/Installation>`_
from Brutal Maze wiki.

Configuration
-------------

Brutal Maze supports both configuration file and command-line options.
Apparently one can change settings for graphics and control in the config file
and set graphics options using in CLI. These settings are read in the following
order:

0. Default configuration [0]_
1. System-wide configuration file [1]_
2. Local configuration file [1]_
3. Manually set configuration file [2]_
4. Command-line arguments

The later-read preferences will overide the previous ones.

.. [0] This can be copied to desired location by ``brutalmaze --write-config
   PATH``. ``brutalmaze --write-config`` alone will print the file to stdout.
.. [1] These will be listed as fallback config in the help message
   (``brutalmaze --help``). See `wiki <https://github.com/McSinyx/brutalmaze/wiki/Configuration>`_
   for more info.
.. [2] If specified by ``brutalmaze --config PATH``.