Map Collector

Save images of maps and store metadata for duplicate-detection.

101 Downloads

fabricutility

Rent Server with this Mod

About this Mod

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.csv are [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 `128`px.
`/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 .jar file into the Minecraft mods folder.
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/

Available Versions

Map Collector v1.0.0release

MC 1.21.5, 1.21.6, 1.21.7, 1.21.8fabric

September 23, 2025

How to Install Map Collector on Your Server

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.8).

Install Mod

Open the mod browser in the dashboard and search for "Map Collector". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabric

Minecraft Versions

1.21.8, 1.21.7, 1.21.6 (+1 more)

Server-side

✗ Unsupported

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Map Collector server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.8). You can switch loaders with one click in the panel.

Is Map Collector compatible with fabric?

Map Collector officially supports fabric for Minecraft 1.21.8, 1.21.7, 1.21.6. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Map Collector – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Map Collector consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.