Metadata-Version: 2.4
Name: erbsland-maze
Version: 1.4.8
Summary: A fast, modular and customizable generator for rectangular mazes.
Project-URL: Documentation, https://erbsland-dev.github.io/erbsland-maze/
Project-URL: Source, https://github.com/erbsland-dev/erbsland-maze
Project-URL: Issues, https://github.com/erbsland-dev/erbsland-maze/issues
Author-email: Erbsland DEV <info@erbsland.dev>
License-Expression: GPL-3.0-or-later
License-File: LICENSE
License-File: LICENSE.md
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Games/Entertainment :: Puzzle Games
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.12
Requires-Dist: pycairo>=1.26.0
Provides-Extra: docs
Requires-Dist: sphinx-rtd-theme>=3.0; extra == 'docs'
Requires-Dist: sphinx>=8.2; extra == 'docs'
Provides-Extra: test
Requires-Dist: pytest>=8.0; extra == 'test'
Description-Content-Type: text/markdown

# Welcome to Erbsland Maze

Erbsland Maze is a sophisticated, open-source maze generator designed for creating complex, rectangular mazes. It exports mazes as SVG files, making them perfect for graphic design applications or even for 3D modeling. This tool stands out for its customization capabilities; it supports various endpoint configurations, allowing for connected or dead-end designs.

![Example maze](https://raw.githubusercontent.com/erbsland-dev/erbsland-maze/main/docs/images/example_2.png)

## Features

- **Modular and Flexible**: Tailor your maze to fit any project requirement, from simple puzzles to complex labyrinth designs.
- **Customizable Endpoints**: Specify any number of endpoints, deciding whether they're interconnected or serve as individual dead-ends.
- **Design Freedom**: Freely position endpoints, incorporate blank areas for shaping the maze, and merge smaller rooms into larger spaces for aesthetic or functional purposes.
- **Path Customization**: Adjust room connections to guide the maze's pathways or to craft a unique template for your designs.

## Requirements

To use Erbsland Maze, you'll need:

- Python 3.12 or higher.
- The `pycairo` library for rendering SVG files.

## Quickstart Guide

Follow these steps to get started with Erbsland Maze:

1. Install the package from PyPI:

   ```console
   pip install erbsland-maze
   ```

2. Generate your first maze:

   ```console
   elmaze -x 100 -y 100 -o maze.svg
   ```

   This command creates a `maze.svg` file in the current directory with your newly generated maze.

3. Show additional command-line options and configurations:

   ```console
   elmaze --help
   ```

## Documentation

You find all details about the library, its design and file format in the [documentation](https://erbsland-dev.github.io/erbsland-maze/).

## Examples

```console
elmaze -x 300 -y 300 -t 0.5 -e nw -e se -m w/3/1 -m nw/5 -m n/3/1 -m ne/5 -m e/3/1 -m se/5 -m s/3/1 -m sw/5 -b c/5 -b c/3/-6,0 -b c/3/6,0 -b c/3/0,-6 -b c/3/0,6 -f 2 -c ^m/w/3/1 -c ^m/nw/5 -c ^m/n/3/1 -c ^m/ne/5 -c ^m/e/3/1 -c ^m/se/5 -c ^m/s/3/1 -c ^m/sw/5
```

![Square maze example](https://raw.githubusercontent.com/erbsland-dev/erbsland-maze/main/docs/images/example_1.png)

```console
elmaze -x 300 -y 100 -l 4 -t 2.5 -e w/10 -e e/10 -m w/3/10 -m e/3/10 -b nw/5 -b ne/5 -b se/5 -b sw/5
```

![Wide maze example](https://raw.githubusercontent.com/erbsland-dev/erbsland-maze/main/docs/images/example_2.png)

```console
elmaze -x 200 -y 300 --height-parity=none --width-parity=none -l 4 -t 0.5 -e nw -e n/0/x -e ne/0/x -e e/20/x -e se -e s/0/x -e sw/1/x -m sw/2/1 -b w/2x67 -b ne/30x20/-4,12 -b se/30x20/-4,-12 -b e/20x43
```

![Tall maze example](https://raw.githubusercontent.com/erbsland-dev/erbsland-maze/main/docs/images/example_3.png)

```console
elmaze -x 125 -y 255 -l 5.0 -t 2.5 -f 0,0,2,0 -c ^mn/s/3/3 -c ^ms/n/5/3 -e n/8 -m n/5/8 -c ^m/n/5/8 -e s/0/x -m s/3 -e s/-5,0/x -m s/3/-5,0 -e s/-10,0/x -m s/3/-10,0 -e s/5,0 -m s/3/5,0 -e s/10,0/x -m s/3/10,0 -c c/s/3/-10,0 -c c/s/3/-5,0 -c c/s/3 -c c/s/3/5,0 -c c/s/3/10,0
```

![Complex tall maze example](https://raw.githubusercontent.com/erbsland-dev/erbsland-maze/main/docs/images/example_4.png)

## License

Copyright (c) 2003-2026 Tobias Erbsland <https://erbsland.dev/>

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.
