Minecraft Maps
Desktop software to read coordinate data from Minecraft screenshots with F3 debug screen
Written on C# Windows Forms App (.NET Framework) and optical character recognition with Tesseract.Net SDK.
Special thanks to Hayden Carpenter for MC font training data.
How to use:
Step 0.
Go to settings tab, you will need to fill this in depending on the image data you are going to process.
X and Y are image coordinates of the top left corner of coordinates on your screenshot. H is height of cropped area.
In binarization threshold you will need to choose brightness range of F3 text. It's usually from 224 to 224 but for compressed images can be wider: 175 to 250 for example.
Do not forget to click Save settings button after changes.
Step 1.
By pressing File you can choose to import folder with images into project, one image or batch processing. If you selected last go to step 4.
Step 2.
After it gets loaded you can select an image and press Crop and Binarize button.
As the name states this button will first crop your image to only coordinates and then binaraze image so text becomes solid black and everything else solid white.
This is done using a threshold RGB value you wrote in settings tab.
Make sure that only text is visible, tweak settings and redo previous steps if needed.
Step 3.
Next step you select cropped image and press Get text button, it will read text and output it on your screen.
Step 4.
After you got all the needed coordinates you can choose to go to map tab and import map image yourself and enter its coordinate range.
This is a plug for now, before I make map renderer myself or use some library.
Program will render markers if they exist in a given coordinate region. You can press them to display image taken in that spot.
Step 5.
You can now press Export marker data button and it will generate marker_data.txt file in your project folder with image paths and their coordinates.
Performance
I ran some tests on 1.5k FullHD images on my laptop (PNG sequence of Dugged tour №6)
| Implementation | Time | images/s | Ratio |
|---|---|---|---|
| Single thread | 300026 ms | 5 | 100% |
| Parallel processing | 171276 ms | 8.75 | 57.09% |
Dependencies
Tesseract.Net.SDK by patagames.com
System.Drawing.Common by Microsoft
License
This program is licensed under the MIT License. Please read the License file to know about the usage terms and conditions.