DonutMaparts

DonutMaparts

Map preview and map tooltip for DonutSMP. Hover any filled map, even in the Auction House (/ah), and see the actual art before you buy it. Plus mapart tracking, and a public wall of every mapart seen on DonutSMP: https://exdede.xyz/maparts

Map preview on hover

Hover a filled map in your inventory, a chest, a shulker box or the DonutSMP Auction House and DonutMaparts shows the picture:

• inside the item tooltip, like a map tooltip should be
• in a bigger side panel next to the open GUI
• or both at once

The preview is drawn from your game’s own copy of the map, the same way an item frame draws it, so it is always the map’s current state. A griefed or changed map shows exactly as it is now, not how it used to look.

Only when your game has no data for a map at all, the mod waits a moment for the server, then falls back to the newest capture of that map from the wall, marked “via exdede.xyz/maparts”. This is DonutSMP only by default and can be switched off.

Everything is customizable in the Map Preview settings tab, see Settings below. One button resets it all back to default, and a Toggle Map Preview keybind turns previews on and off without opening settings.

Hunting a specific mapart?

Put its map ID on the tracking list and let the mod watch for you.

Open Settings > Tracking, then add one ID at a time or paste a whole batch separated by commas or newlines.

From then on, whenever you open any inventory, chest, shulker or ender chest, the mod checks every slot. If a tracked map is in there it:

• plays a sound, one of six you can pick from, or none at all
• posts a toast naming the map and where it turned up
• pulses a gold highlight on that exact slot until you close the screen

Each map alerts once per time you open a container, so a chest full of tracked maps does not turn into a slot machine. Flip on auto remove and an ID drops off the list the moment you find it.

Tracking works on any server and in singleplayer, and keeps working with uploads turned off. It sends nothing anywhere. Your list never leaves your client.

The mapart wall

While you play on DonutSMP, the mod fingerprints the maps that render on your screen and, if one is new, uploads it to the public wall at https://exdede.xyz/maparts. No screenshots, no commands, nothing to click. Duplicates are skipped server-side and the mod never sends anything it should not.

What it does

• Shows a map preview when you hover a filled map, in the tooltip, a side panel, or both.
• Watches the maps that render on your client while you are on DonutSMP.
• Waits until a map has finished drawing, then fingerprints it.
• Uploads only maps that are actually new, in batches rather than one request per map.
• Remembers what this install has already sent, so nothing is uploaded twice.
• Saves anything unsent when you disconnect and retries it on the next launch.
• Alerts you when a map you are tracking shows up in an open inventory.

Install

1. Install Fabric Loader for Minecraft 1.21.11, 26.1 or 26.2, and download the matching build below.
2. Drop these into your mods folder:
   • DonutMaparts
   • Fabric API
   • malilib
   • (optional) Mod Menu, to reach the settings from the mods list
3. Launch. Join DonutSMP. That is it.

Browse the wall any time at https://exdede.xyz/maparts.

Settings

Open the config two ways:

• Mod Menu: click the gear on the DonutMaparts card.
• Keybind: Options > Controls > Key Binds > “DonutMaparts” > “Open Settings”. Unbound by default, bind whatever you like.

General tab

Map Preview tab

Tracking tab

Plus Add ID, Bulk Add and Tracked IDs (N), the last of which opens the list editor for removing entries one by one.

Privacy and takedowns

The mod only uploads on DonutSMP. It sends a per-map fingerprint plus the map pixels for new maps, nothing else. It never transmits a precomputed hash: the server recomputes everything and decides what is actually new. The tracking list is local and is never sent anywhere.

Map previews come from your own game. The only time a preview touches the network is the wall fallback, which asks for one map ID and nothing else, and only when your game has no picture for that map.

Want a mapart of yours off the wall? Contact me at https://exdede.xyz/contact and it comes down, no questions asked.

Links

• Wall: https://exdede.xyz/maparts
• Source: https://github.com/exdede/Donutmaparts
• Issues: https://github.com/exdede/Donutmaparts/issues
• License: MIT