Noops homepage
Noops challenge home


Hey there! We haven't met yet. Connect your GitHub account to enter the challenge.

👋 Meet Mazebot

For many years, Mazebot spent most of its vacation days and countless lunch breaks mapping the many forgotten cavernous subterranean floors beneath the Noops factory.

Spending all that time getting lost and finding its way took its toll on Mazebot.

These days, Mazebot is excited about only one thing: challenging you to solve mazes.

Are you ready to solve them? Started with the smaller mazes; once you understand the basics, enter the Mazebot 500, a race to solve a series of mazes in a row.

If you can complete them all, you will get a certificate of your achievement.


Each maze in Mazebot's collection has a map that is a an array of rows. Each row is an array of single-length strings representing the contents of each location in the maze.

The possible values are:

  • " " empty - a passable square
  • "X" - wall - not passable
  • "A" - starting position - this is where you start in the maze
  • "B" - goal - this is where you need to navigate to to escape the maze

The rows are in order from north to south, and the entries in each column are in order from west to east.

In these mazes, you may travel in any of the four cardinal directions ("N", "E", "S", "W").

✳️ How to Play

Mazebot offers two ways to play: random mode, and the great maze race.

Read the API documentation for details.

🎲 Random Mode

Mazebot will give you a random selection from its maze collection and see how fast you can solve it.

You can optionally limit the size of maze you would like with the minSize and maxSize parameters.

Get a random maze

GET /mazebot/random
GET /mazebot/random?minSize=20
GET /mazebot/random?minSize=30&mazSize=60

🏎️ Race Mode

In race mode, mazebot will give you a series of mazes and challenge you to solve them all. At the end, if you are successful, Mazebot will award you a certificate that you can use to prove your maze mettle.

Get information about the race

GET /mazebot/race

Start the race

POST /mazebot/race {"login": "yourgithubnamehere" }

Starter Kits

Ruby command line client

Mazebot has included a command-line client written in Ruby to get you started.

The script demonstrates how to access the Mazebot API and work through the Mazebot race.

Can you build a program that can complete the Mazebot 500 on its own?

HTML5 Game

Mazebot has also included an HTML Game that will let you play through random mazes from the Mazebot API.

Mazebot is excited to see what you can do. Can you make the game better? Change the design? Read the source code and make a fork.

✨ A few ideas

Create an automated solver: Humans can be pretty good at solving mazes, but they'll never be as fast as a well-tuned computer. Start from the included Ruby script or start from scratch in another language.

Extend the game: Check out the canvas game README for some ideas on how to get started.

Create your own maze game: Try using a tool like Phaser to create your own game using the Mazebot API.

Create your own maze API: Try making your own API that serves random mazes and connect the canvas maze game to it.

Create a colorful terminal client Do you have a fondness for ASCII graphics? Create a fun client

Generate art with the mazes: Solving these mazes isn't the only thing you can do with them. Maybe you'd rather use these maze patterns to generate art or sound.

Remix: Try mixing in one of the other Noops APIs to make something amazing.

Mazebot can't wait to see what you make!

Connect to GitHub


See who has recently forked this repository...

Other challenges you might like



polybot hero

Polygon crazy

Polybot sends you polygons from 3 sides to 72 sides (a heptacontakaidigon!).

Level 2

Want to hear about new challenges and updates?

Meet the Noops

Sponsored by GitHub