Marble Disorder – a marble maze simulator with tilt switches using Arduino

marble maze simulator

Marble Disorder is a borderline case of  🙂
It simulates a marble maze by sensing the box’s orientation with 2 tilt switches.

Stop the press: there’s a new and more intuitive version that doesn’t require the spin knob (See video).

I keep documenting the original version below for historical purposes, but don’t watch this – watch that

Bonus game: The Marble Disorder box is compatible with . (the only difference is the tilt switches).
Build once, play twice 🙂

marble maze simulator

Step 1: Hardware and software

Note: the new version is a bit different (and requires less components).
It is advised to build the new version (much more fun to play).

You’ll need:

  • An Arduino
  • A Hitachi HD44780 compatible LCD display (I used 16×2, but 20×4 should work too)
  • 2 tilt switches
  • A pushbutton
  • 3 10K Ohm resistors (pull-up for the tilt switches and the buttons)
  • 2 10k Ohm potentimeters (one for spin control and [an optional] one for LCD contrast)
  • Optional piezo speaker

See breadboard diagram.


The code is here.
The maze generation algorithm is the same as Ariadne’s (See explanation there).

If you connect the piezo speaker, you can mute it by setting MUTESOUND  to 1.
Actually – this is the default 🙂
Why have the speaker and mute it? Glad you asked:
Like I’ve mentioned, you can also run Ariadne’s code on this box.
Ariadne only beeps when you hit a wall (i.e. you’ve made a mistake). This can be avoided.
Marble Disorder beeps whenever there’s a spin (i.e. when both tilt-switches allow the marble to move to 2 different cells, and the spin potentiometer determines which one).
This can’t be avoided – so you end up with a pretty noisy game. It does help play the game – but I’m not sure it’s worth the hassle of all those beeps.
Another option is to put a switch on the piezo speaker (something my Electronic Brick shield doesn’t allow).

Step 2: Constructionmaze simulator circuit 1

I’m the last person to teach anyone how to do stuff in the physical world, and anyway – you’ll most probably need to do it in a different way (I happened to have an Electronic Brick kit and a SeedStudio harness), but cutting a transparent Tupperware clone seems like a nice and easy way to do it.

Let me know (and show some photos) if you make your own box. I’m sure it would look nicer than mine 🙂


Step 3: Playing the game

Note: the new version is a lot easier to play (so easy – it doesn’t even need instructions).

This step is kept here for historical purposes.

Playing the game is almost as intuitive as playing a physical marble maze. The only difference is that tilt-switches don’t have a neutral state: The tilt is always NE/SE/SW/NW and there’s no way to tilt the maze N/E/S/W. Most of the time this doesn’t matter, because if – for example – the tilt is NE, and there’s a northern or eastern wall – the marble only has one way to go.

What happens when the marble can “chose” between 2 options? In that case – the marble’s spin (controlled via the potentiometer) determines whether the marble takes the direction that is more clockwise or the counter-clockwise one. See photo and annotations below.

This doesn’t mean you have to ride the spin-control knob constantly. Usually, if you can’t go where you want with the current spin, it would work fine on the way back. In the rare cases where the spin does matter, you stop at some corner, adjust the spin and continue. Takes some practice – but not too much.

Read more: Marble Disorder – a marble maze simulator with tilt switches using Arduino

Leave a Comment

Your email address will not be published. Required fields are marked *