Micromouse Workshop

Micromouse

Micromouse is the world's purest robotics competition: a tiny autonomous robot must solve an unknown maze all by itself. See Veritasium's video.

This is a simulator for Micromouse. You can write real C firmware, compile and debug it in the built-in IDE, and watch your mouse race under real competition rules!

Features

• Real C programming — your code is compiled to RISC-V ELF and runs on a sandboxed RISC-V core (with libriscv) with an instruction budget per control tick, just like a real MCU. Built-in IDE with editor, build errors, logs, and an instruction-level debugger.
• Real competition mazes — 12 challenges from 8x8 rookie runs to real All Japan and half-size championship finals (16x16 and 32x32), plus random maze mode in which the maze is generated randomly and hidden until the run starts (this is true for real-world competition).
• Real physics — Although the tutorial is written under a grid model, under the hood every run is a deterministic rigid-body simulation at 1000 Hz (Jolt Physics) with tire forces, wheel encoders, a gyro, and IR distance sensors. The included grid-movement library is ~400 lines of commented C that can be replaced with any custom motion layer for diagonal-running and other advanced motion pattern.
• Deterministic — same code + same maze = exactly the same run. Supports fast-forward at 8x or Max without changing results.
• Examples Included — a hand-driven tutorial (WASD) plus some teaching firmwares that go from a first DFS to the standard flood-fill algorithm.
• Manual included (HTML/PDF). Physics basics and current helpers are documented fully. Although I'm not sure how to write better tutorials so people without coding experiences can get on board easier...

Early development — tell me what to build

This is an early build. The KSP-style mouse building system (custom PCB chassis, sensor placement) fan downforce and a sandbox map for physics calibration is on the roadmap but not in yet. I will appreciate any feature requests or OS platform support request for this project: npa@contextcross.com

Special Thanks

Some of the model parts come from the amazing UKMARS organization's github repo. Please consider join the community if you're intrigued by Micromouse. It's also one of the best place to get started.

Windows 10/11, 64-bit, Vulkan-capable GPU required. The RISC-V toolchain is bundled.