Compatibility
Minecraft: Java Edition
1.21.5–1.21.8
Platforms
Supported environments
Client-side
Links
Tags
Creators
Details
Licensed MIT
Published 9 months ago
Map Collector
Generates images of maps and stores metadata for duplicate-detection.
Intended to aid in collecting map art on multiplayer servers.
- The generated images and metadata can be found in
.minecraft/map-collector/. - Manually modifying any of the files within this folder can cause unhandled issues.
- The fields in
maps.csvare [File_ID, Map_Name, Map_ID, Image_Hash].
Commands
| Command | Description |
|---|---|
/map save [name] |
Saves an image and metadata of the current held map. If no name is specified, it will use the item's name. |
/map check |
Checks if the current held map exists in your saved collection. (Visual match) |
/map imageSize <128|256|512|1024> |
Configures the image size to generate. Default is 128px. |
/map duplicateBehaviour <allow|warn|deny> |
Configures the behaviour when attempting to save a duplicate map. Default is warn. |
/map confirm |
Confirms the save attempt when using defaultBehaviour warn |
Installation
- Install Fabric Loader and Fabric API.
- Download Map Collector from GitHub or Modrinth.
- Place the
.jarfile into the Minecraftmodsfolder. - Launch Minecraft with Fabric Loader.
Compiling
Clone the repository to a local directory:
git clone https://github.com/Laztec/MapCollector.git
Compile using Gradle in the project's root directory:
gradlew build
The jar file will be located in ./build/libs/


