Minimalist thrilling shoot 'em up game
Go to file
Nguyễn Gia Phong 92a41b3cff Fix broken argument parser on Windows 2018-04-04 23:35:43 +07:00
brutalmaze Fix broken argument parser on Windows 2018-04-04 23:35:43 +07:00
client-examples Add C# client example (#9) 2018-03-26 12:20:47 +07:00
wiki@8f40eb7b3d Fix broken argument parser on Windows 2018-04-04 23:35:43 +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 Add fancy losing screen and keybinding for new game 2017-10-22 20:31:17 +07:00
README.rst Fix grammar and typos 2018-03-22 23:01:00 +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 Fix broken argument parser on Windows 2018-04-04 23:35:43 +07:00


Brutal Maze

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

.. image::

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 features:

* 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.
* Easily customizable via INI file format.
* Remote control through TCP/IP socket (can be used in AI researching).


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

* Install Python and `pip <>`_. Make sure the
  directory for `Python scripts <>`_
  is in your ``$PATH``.
* Open Terminal or Command Prompt and run ``pip install --user brutalmaze``.

For more information, see
`Installation <>`_
page from Brutal Maze wiki.

After installation, you can launch the game by running the command
``brutalmaze``. Below are default bindings:

   New game.
   Toggle pause.
   Toggle mute.
   Move left.
   Move right.
   Move up.
   Move down.
Left Mouse
   Long-range attack.
Right Mouse
   Close-range attack, also dodge from bullets.


Brutal Maze supports both configuration file and command-line options.
Apparently, while settings for graphics, sound and socket server can be set
either in the config file or using CLI, keyboard and mouse bindings are limited
to configuration file only.

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

Later-read preferences will override previous ones.

Remote control

If you enable the socket server [3]_, Brutal Maze will no longer accept direct
input from your mouse or keyboard, but wait for a client to connect. Details
about I/O format are explained carefully in
`Remote control <>`_
wiki page.


Brutal Maze's source code and its icon are released under GNU Affero General
Public License version 3 or later. This means if you run a modified program on
a server and let other users communicate with it there, your server must also
allow them to download the source code corresponding to the modified version
running there.

This project also uses Tango color palette and several sound effects, whose
authors and licenses are listed in
`Credits <>`_ wiki page.

.. [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 <>`_
   for more info.
.. [2] If specified by ``brutalmaze --config PATH``.
.. [3] This can be done by either editing option *Enable* in section *Server*
   in the configuration file, or launching Brutal Maze using ``brutalmaze