Show My Maps

This is the server plugin, not the mod. It goes in plugins/. Keep the Fabric mod on your client and update both together. Two ways this plugin could sit on a server doing nothing while looking perfectly healthy. Both are closed.

It no longer goes silent on a fork

Every sweep was scheduled through the per-player scheduler, which is the right one for a region threaded server such as Folia or ShreddedPaper, and which not every fork carries. When that call threw, the plugin stayed loaded, stayed listening, and swept nothing at all. No error to find, no maps to see, and no way to tell that apart from a server that simply has no maps to send. It now falls back to the main scheduler and says so once in the console. If you run ShreddedPaper, this is the release you want.

/showmymaps tells you whether it is working

"Installed it and nothing changed" has three causes, they need three different fixes, and in game they look identical. The report separates them:

SHOW MY MAPS 1.1.2
  sweeps run:      23
  maps sent:       108
  unresolvable:    0
  players tracked: 1
  Maps are being sent. Anything still blank is the client: install the Fabric mod.

- No sweeps and players online: it is not running, so check the console. - Sweeps but no maps sent: it is looking and finding nothing. Check showmymaps.see and disabled-worlds. - Maps sent and still blank: the client half is missing or on a different version. - `unresolvable` above zero: another plugin is showing maps this server holds no data for. Nothing on either side can fix those, and now you can see that rather than guess it. With nobody online it says so instead of reporting a fault, because zeroes then mean nothing is wrong. Needs showmymaps.status, op by default.

Tested

Against a real Paper 1.21.11 server carrying a stand-in auction house: 54 listings in one double chest, filled a tick after the window opens the way a plugin querying a database does, and the page turned in place with no reopen. All 108 listings across both pages reached the client, and only the first page ever drew blank, for about a second.

This is the server plugin, not the mod. It goes in plugins/. Keep using the Fabric mod on your client, and update both together. This release is mostly server side. If players have told you that maps go blank, or that only maps they have seen before ever show up, this is the one to install.

Fixed: maps went blank after a portal or a death

The most reported symptom, and the plugin was half the cause. A client throws away every map it knows when its level is rebuilt, which a dimension change and a death both are. This plugin kept a record of which maps it had already sent each player, so as not to push 16 KB again on every pass, and that record was only cleared when the player quit. So for a whole resend-seconds window after any portal or respawn it deliberately sent nothing to a client that now had nothing, and the player saw blank parchment for art they had been looking at seconds earlier. The record is now forgotten on a world change and on a respawn, and a fresh pass runs a second later. The mod had the matching hole on its side — a map that arrived just before the switch never reached the disk cache either — which is fixed in 1.1.1. Update both halves, or half the bug stays.

Fixed: places maps hide that were never checked

- Item frames and glow frames. An art wall is item frames, and nothing here looked at one. Vanilla only syncs a frame's map as it enters tracking range, so a wall you were already standing at could stay blank. - Armour stands and display entities. Both are ordinary ways to build a shop front, and neither was ever read. - Merchant trades. A merchant's offers are not in its inventory — they are their own list — so a villager or wandering trader selling map art showed nothing however long you stared at it. - Nesting now recurses. A bundle of maps inside a shulker box used to stop at the box. New switches in config.yml: nearby-displays and merchant-trades, both on by default.

Also

- The sent record no longer grows for as long as a player stays connected, which on a shop server was thousands of ids nobody would look at again. - `debug: true` logs every map sent, and every stack naming a map the server cannot resolve. That separates "the plugin is not looking there" from "another plugin drew that map straight to packets and there is no map data behind it" — the one case nothing on either side can fix. Turn it on before reporting a blank preview.

Why beta

The fixes carry regression tests, including one that fails without the dimension-change fix and passes with it. It is marked beta to match the mod it pairs with, whose new art-source feature has had less time in the wild.

Same ender chest and default-meta fixes as 1.0.4, now with regression tests (MockBukkit) and a CI job that actually builds and tests this plugin, which nothing did before.

Fixes two real gaps in what got sent: an open ender chest read as "nothing open" because its Bukkit holder is the owning player, so its contents never synced. And a plain filled map with nothing set beyond the map id reports no meta at all (hasItemMeta() false), even though a real MapMeta with a real view is sitting right there - that map is synced now too.

This is the server plugin, not the mod. It goes in plugins/. Keep using the Fabric mod on your client.

The plugin now announces itself

Until now the mod's presence check only recognised the Fabric server mod, so a Paper server running this plugin still told every player the mod was not installed — the opposite of true. The plugin now introduces itself on join and names its version, so the client stays quiet when the pair is current, and says which version is on the server when it is behind. Update both sides together: a mod on 1.0.3 asks for a plugin on 1.0.3 or newer, because 1.0.3 is the first version able to announce itself at all.

Also here

- Owners decide who sees maps: everyone holds `showmymaps.see` unless you take it away, and `disabled-worlds` turns whole worlds off by name. The gate sits on the send, so a player without it is never sent the colours. - Covers 1.21.1 through 26.2 from one jar, built against the 1.21.1 API. Paper 1.21.1, 1.21.5, 1.21.8, 26.1.2 and 26.2 were each booted with it; 1.21.1 and 1.21.11 were driven end to end with a real client, in the allowed, revoked, current and outdated cases. The versions in between were not individually tried.

This is the server plugin, not the mod. It goes in plugins/. Keep using the Fabric mod on your client. Paper, Spigot and their forks cannot load a Fabric mod at all, so maps in an auction page, a chest or a shulker box are never sent to any player and no client can draw them. This sends them: map colours for maps in whatever inventory a player has open — chests, auction and shop pages, any plugin GUI — plus shulker box and bundle contents, and maps lying on the ground nearby.

Owners decide who sees maps

- Everyone holds `showmymaps.see` unless you take it away. Revoke it from default and grant it to a rank, and only that rank gets previews. - `disabled-worlds` in config.yml turns whole worlds off by name. The gate sits on the send, so a player without permission is never sent the colours and has nothing on their client to reveal. It is not a client setting anyone can flip back.

Now covers 1.21.1 through 26.2

Built against the 1.21.1 API, the oldest of the range, so one jar runs across it. Paper 1.21.1, 1.21.5, 1.21.8, 26.1.2 and 26.2 were each booted with it; 1.21.1 and 1.21.11 were driven end to end with a real client and a stand-in auction GUI, in both the allowed and the revoked case. The versions between those were not individually tried. Other settings in config.yml: scan interval, how long before a map is sent to the same player again, and a switch per source. Work is scheduled per player rather than globally, so it stays on the owning thread under Folia and ShreddedPaper.

This is the server plugin, not the mod. Put it in plugins/, and keep using the Fabric mod on your client. Paper, Spigot and their forks cannot load a Fabric mod at all, so maps in an auction page, a chest or a shulker box are never sent to any player and no client can draw them. This sends them: map colours for maps in whatever inventory a player has open — chests, auction and shop pages, any plugin GUI — plus shulker box and bundle contents, and maps lying on the ground nearby. Settings are in config.yml: scan interval, how long before a map is sent to the same player again, and a switch per source. Work is scheduled per player rather than globally, so it stays on the owning thread under Folia and ShreddedPaper. Built against the Paper 1.21.11 API and tested on Paper 1.21.11. It uses long-stable Bukkit calls and declares api-version: 1.21, so it should run on other 1.21.x builds, but only 1.21.11 has been tried.