MCompass Build Guide
The Real-life Minecraft Compass
Welcome to the MCompass build guide. Here you can find all the technical details from material preparation, automated compilation, firmware flashing to daily interactions.
Quick Navigation
BOM & 3D Models
Check the complete parts list, selection advice, and 3D printing models.
Flash & Compilation
Download existing firmware from GitHub or compile manually using PlatformIO.
User Manual
Learn how to operate buttons to switch modes, calibrate sensors, and enter the web dashboard.
Important Disclaimer (Copyright & Safety)
Before using or building MCompass, please be sure to read the following statement:
- Assets Disclaimer: All visual assets related to Minecraft are copyrighted by Microsoft / Mojang. This project only provides open-source designs based on dot matrix distribution and does not distribute any original game resources.
- Commercial Use Restrictions:
- Strictly Prohibited for any commercial profit-making activities.
- The copyright of the Standard Galactic Alphabet font used on the back of the PCB is unclear. If you wish to commercialize, please delete the relevant silkscreen on your own.
- Build Tips: This device involves lithium battery charging and small electronic component soldering. Please proceed with basic knowledge of electronic production.
Q&A
Q: How long does GPS positioning take?
A: The module usually takes more than 30 seconds for the first fix (cold start) in an open area.
Q: What does it mean if the screen shows a green "x4" after startup?
A: This represents an I2C communication failure, usually caused by poor soldering of the QMC5883 sensor or the header pins.
Q: Does it support charging with a dual-head Type-C cable?
A: You need to solder the corresponding CC1/CC2 pull-down resistors on the PCB to recognize C-to-C cables.
Changelog
2025.09.17
- Pointer Overshoot Effect: Perfectly replicates the bouncy feel in the game. The pointer creates physical inertia when turning quickly.
- Startup fault tolerance optimization: Multiple checks for the geomagnetic sensor to improve startup stability.
2024.12.07
- Smart Power Strategy: Dynamically toggles GPS according to distance to extend battery life.
MCompass Build Guide
