A collection of maze generation programs

algorithm graphics mazes procedural-generation

Go to file

Starbeamrainbowlabs c23c912789 Add another blender file: this time for exploding a purple maze I'd like to play around with fluid / smoke simulations, and maybe soft-bodi physics too!		2020-09-13 00:39:21 +01:00
blender	Add another blender file: this time for exploding a purple maze	2020-09-13 00:39:21 +01:00
utils	Pretty up the CLI with ansi escape codes	2020-09-06 01:47:35 +01:00
.gitattributes	Add blender file This was created by going lua → openscad → stl → blender	2020-04-29 22:35:38 +01:00
.gitignore	update .gitignore	2020-08-31 00:16:44 +01:00
LICENSE	Initial commit	2020-04-29 12:36:41 +01:00
README.md	Pretty up the CLI with ansi escape codes	2020-09-06 01:47:35 +01:00
main.lua	main.lua: minor help message layout	2020-09-06 02:10:14 +01:00
maze	Add ./maze wrapper shell script to call the lua script	2020-09-13 00:38:28 +01:00
maze.lua	Comment out a workaround.	2020-05-03 16:49:21 +01:00
maze3d.lua	fix syntax error	2020-08-31 12:18:11 +01:00
openscad.lua	Add additional settings for openscad	2020-04-30 19:10:32 +01:00

README.md

multimaze

A collection of maze generation programs

Ported back in 2015 (and since adapted) from an algorithm of my own design that was originally implemented in Python.

Now has a 3d mode!

Current blog posts about this project:

Language Review: Lua (2D maze generator)
3D mazes with Lua, OpenSCAD, and Blender (coming soon!)

Installation

System Requirements

Required
- Lua
Optional
- OpenSCAD: for creating STL files and viewing generated .scad files
- Blender: a great tool for importing generated STL files and having some fun rendering them

Setup

Clone this repository:

git clone https://git.starbeamrainbowlabs.com/sbrl/multimaze.git
cd multimaze.lua

Usage

See the usage information for the program by calling main.lua like so:

lua main.lua help

Operating modes:

Mode	Description
`help`	Displays the help text
`maze`	Generates 2D mazes and writes them to stdout
`maze3d`	Generates 3D mazes and writes them in layers to stdout
`maze3d_openscad`	Generates 3D mazes and writes an OpenSCAD file to the specified location

To render a 2D maze as ASCII, do this:

lua main.lua maze --width 25 --height 25
# Alternatively, in shorthand:
lua main.lua maze -w 25 -h 25

To render a 3D maze as a .STL file, do this:

# Generate the OpenSCAD file
lua main.lua maze3d_openscad -w 15 -h 15 -d 17 -f 15x15x17.scad
# Convert the OpenSCAD file to an STL
openscad -o 15x15x17.stl 15x15x17.scad

Contributing

Contributions are very welcome - both issues and patches! Please mention in your pull request that you release your work under the MPL-2.0 (see below).

This guide looks good for how to create patch in git: How To Create and Apply Git Patch Files

If you find a bug, there are a number of different ways you can get in touch.

By commenting on any of the blog posts (see links above)
By getting in touch through any of the methods mentioned on my main website
If you know me IRL, that works too

If this becomes a thing that people want to contribute to regularly, I will move it to GitHub to make that an easier process.

If you're feeling that way inclined, I have a Liberapay profile if you'd like to donate to say an extra thank you :-)

License

The contents of this repository is released under the Mozilla Public License 2.0. The full license text is included in the LICENSE file in this repository. Tldr legal have a great summary of the license if you're interested.