Git Product home page Git Product logo

mazefiles's Introduction

Please refer to the issues where a proposed file format change is described

mazefiles

A set of micromouse maze files in text format. They have been collected over some years from many sources.

These files are a companion to the maze tool https://github.com/micromouseonline/micromouse_maze_tool.

The format used here is as follows:

  • All posts are represented with the character o.
  • All posts must be present in the grid even if there is no wall attached to them.
  • Horizontal walls are represented with three ---.
  • Vertical walls are represented with a single |.
  • The goal cells are marked with a G in the certer of the cell.
  • The starting cell is marked with an S in the certer of the cell.

Here is an example of a 4x4 maze:

o---o---o---o---o
| G |           |
o   o   o   o---o
|       |       |
o---o---o---o   o
|               |
o   o---o---o   o
| S |           |
o---o---o---o---o

classic mazes are all 16x16. Some of these have smaller active areaswhere the event in which they were used only had a smaller maze available. That may have been 7x8, 8x8, 11x11 or some other size. All these mazes have a legal goal cell in cell 7,7.

halfsize mazes are all 32x32. The goal is not fixed in the same way as it might be in the classic contest. The goal for halfsize mazes is a single cell, marked with a "G" in the center of the cell, which may be part of a larger area.

training mazes are all 16x16 but may not have legal goal areas as the useable area might be only 5x5, 8x8, 10x5 or some other size representing small mazes used for testing a mouse where there is not room for a full sized maze. The filename should indicate the active area.

The files may, or may not, represent actual contest mazes. If there are errors in contest mazes, please let me know. Preferably with a photo of the original maze so that I can make changes.

FAQ

How can I contribute to the repository?

Thanks for your interest! Start by reading GitHub's guide on how to propose changes to someone else's project, then feel free to create a pull request with your changes or new maze files.

Why text files?

  • They are easy to understand by humans.
  • They get along with version control systems (Git).
  • They are easy to read/write with any programming language.
  • They are easy to visualize (just use your browser or favorite text editor).
  • No need for special tools if you want to edit them or create your own. Just a bit of patience is required.

Are there any tools to help me create maze files?

mazefiles's People

Contributors

micromouseonline avatar peque avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.