Show My Maps

## Fixed: the wrong map on a proxy network Every backend behind a proxy hands out map ids from its own counter, so map 42 on one is a different picture from map 42 on the next. The cache is keyed by the address you typed, and a proxy is one address for the whole network, so a lookup on the second backend was answered with the first one's art. **Strict previews** was the only defence and it blanks everything, colliding or not. Nothing a client can see says which backend it is on. What it can see is a contradiction: the server sends map 42, and the copy already on disk under that id cannot be the same map. A map's scale and dimension are fixed when it is made, and a locked map's colours never move again, so any of those differing is proof rather than a guess. Colours on an unlocked map prove nothing, since players are still filling it in. A contested id is written beside the maps and the cache stops answering for it, this session and every later one. Ids that never collide are untouched. Blank on the handful that clash beats wrong on all of them. ## Removed: the world exporter Publishing a folder of map files asked a server owner to reach the world folder of every backend on their network, which most cannot. The art source that reads it stays, so a host that does publish its maps still works. ## If your auction house still draws blank That is the server, not this mod, and it is worth being plain about why. A map's colours are sent in exactly two cases: the map is in your own inventory, or it hangs in an item frame near you. A map in an auction or shop GUI has never been sent to anybody, and no packet exists for a client to ask for one. Install the **Paper plugin** from the Versions tab and it fills in. Measured on a real server against a stand-in auction house: without it, zero maps sent and every slot blank; with it, all 108 listings across two pages delivered.

## Fixed: the wrong map on a proxy network Every backend behind a proxy hands out map ids from its own counter, so map 42 on one is a different picture from map 42 on the next. The cache is keyed by the address you typed, and a proxy is one address for the whole network, so a lookup on the second backend was answered with the first one's art. **Strict previews** was the only defence and it blanks everything, colliding or not. Nothing a client can see says which backend it is on. What it can see is a contradiction: the server sends map 42, and the copy already on disk under that id cannot be the same map. A map's scale and dimension are fixed when it is made, and a locked map's colours never move again, so any of those differing is proof rather than a guess. Colours on an unlocked map prove nothing, since players are still filling it in. A contested id is written beside the maps and the cache stops answering for it, this session and every later one. Ids that never collide are untouched. Blank on the handful that clash beats wrong on all of them. ## Removed: the world exporter Publishing a folder of map files asked a server owner to reach the world folder of every backend on their network, which most cannot. The art source that reads it stays, so a host that does publish its maps still works. ## If your auction house still draws blank That is the server, not this mod, and it is worth being plain about why. A map's colours are sent in exactly two cases: the map is in your own inventory, or it hangs in an item frame near you. A map in an auction or shop GUI has never been sent to anybody, and no packet exists for a client to ask for one. Install the **Paper plugin** from the Versions tab and it fills in. Measured on a real server against a stand-in auction house: without it, zero maps sent and every slot blank; with it, all 108 listings across two pages delivered.

## Fixed: the wrong map on a proxy network Every backend behind a proxy hands out map ids from its own counter, so map 42 on one is a different picture from map 42 on the next. The cache is keyed by the address you typed, and a proxy is one address for the whole network, so a lookup on the second backend was answered with the first one's art. **Strict previews** was the only defence and it blanks everything, colliding or not. Nothing a client can see says which backend it is on. What it can see is a contradiction: the server sends map 42, and the copy already on disk under that id cannot be the same map. A map's scale and dimension are fixed when it is made, and a locked map's colours never move again, so any of those differing is proof rather than a guess. Colours on an unlocked map prove nothing, since players are still filling it in. A contested id is written beside the maps and the cache stops answering for it, this session and every later one. Ids that never collide are untouched. Blank on the handful that clash beats wrong on all of them. ## Removed: the world exporter Publishing a folder of map files asked a server owner to reach the world folder of every backend on their network, which most cannot. The art source that reads it stays, so a host that does publish its maps still works. ## If your auction house still draws blank That is the server, not this mod, and it is worth being plain about why. A map's colours are sent in exactly two cases: the map is in your own inventory, or it hangs in an item frame near you. A map in an auction or shop GUI has never been sent to anybody, and no packet exists for a client to ask for one. Install the **Paper plugin** from the Versions tab and it fills in. Measured on a real server against a stand-in auction house: without it, zero maps sent and every slot blank; with it, all 108 listings across two pages delivered.

## Fixed: the wrong map on a proxy network Every backend behind a proxy hands out map ids from its own counter, so map 42 on one is a different picture from map 42 on the next. The cache is keyed by the address you typed, and a proxy is one address for the whole network, so a lookup on the second backend was answered with the first one's art. **Strict previews** was the only defence and it blanks everything, colliding or not. Nothing a client can see says which backend it is on. What it can see is a contradiction: the server sends map 42, and the copy already on disk under that id cannot be the same map. A map's scale and dimension are fixed when it is made, and a locked map's colours never move again, so any of those differing is proof rather than a guess. Colours on an unlocked map prove nothing, since players are still filling it in. A contested id is written beside the maps and the cache stops answering for it, this session and every later one. Ids that never collide are untouched. Blank on the handful that clash beats wrong on all of them. ## Removed: the world exporter Publishing a folder of map files asked a server owner to reach the world folder of every backend on their network, which most cannot. The art source that reads it stays, so a host that does publish its maps still works. ## If your auction house still draws blank That is the server, not this mod, and it is worth being plain about why. A map's colours are sent in exactly two cases: the map is in your own inventory, or it hangs in an item frame near you. A map in an auction or shop GUI has never been sent to anybody, and no packet exists for a client to ask for one. Install the **Paper plugin** from the Versions tab and it fills in. Measured on a real server against a stand-in auction house: without it, zero maps sent and every slot blank; with it, all 108 listings across two pages delivered.

**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.

## Art sources: maps from a server that runs nothing A map a server has never sent you has no colours on your client, and there is no packet to ask for them. That is the whole reason a shop or auction page draws blank parchment. Those colours are, however, sitting in the server's own world folder, and an owner who publishes that folder gives every player somewhere to read them from. **No plugin, no restart, no open port.** The new `map-export` tool reads a world folder or a backup zip and writes out every filled map in it. Copy the result to any static host, and players point **Art source** at it in the settings. It is on the [GitHub release](https://github.com/DragonX1901/show-my-maps/releases/tag/v1.1.1), and read access to a world backup is all it needs. Off by default and set per server, since a map id means a different picture on each. Three shapes are read: the mod's own cache files, a bare colour array, and a 128x128 PNG. **Nothing fetched is believed.** Colours off a web host are a stranger's word for what a map looks like, so they are stored marked as a guess and **Strict previews** refuses them outright. If the server later sends that map for real the two are compared, and a source that gets three locked maps wrong is switched off and everything it sent is thrown away. Only https unless the address is your own machine, redirects are refused rather than followed, and an address pointing into your own network is turned down. ## Fixed: maps went blank after a portal Walk through a portal just after opening a shop page and the art came back blank and stayed blank, leaving only maps cached from an earlier visit. Two halves of one bug, and each on its own was enough: - The client throws away every map it knows when its level is rebuilt, which a dimension change and a death both are. The **Paper plugin** kept a record of what it had already sent so as not to resend 16 KB every pass, and that record only cleared when the player quit, so for a whole resend window it deliberately sent nothing to a client that now had nothing. - The cache had the matching hole. Received maps were written in batches off a timer, and a batch held only the ids: by the time it ran, the level it would have read the colours from was gone, so a map that arrived in the seconds before the switch never reached disk either. Both are fixed. **Update the plugin as well** — the server side of this is in `1.1.1+paper`. ## Fixed: maps the plugin was not looking for Item frames, glow frames, armour stands and display entities are how a shop front is usually built, and none of them were read. A merchant's trade offers are not in its inventory at all, so a villager selling map art showed nothing however long you stared at it. Nested containers now recurse, since a bundle of maps inside a shulker box used to stop at the box. A new `debug` toggle names every map sent, and every stack naming a map the server cannot resolve, which separates "not looking there" from "another plugin drew that map straight to packets". ## Thirteen more languages German, Spanish, French, Italian, Japanese, Korean, Dutch, Polish, Brazilian Portuguese, Russian, Ukrainian and both written forms of Chinese, alongside the English and Turkish already there. Corrections from native speakers are welcome. ## Why beta Art sources are new networking code, and the exporter has not yet been run against a production world outside its own tests. Everything else is covered by the usual suite, plus a client gametest that fetches over real HTTP on loopback and checks that a source handing over the wrong bytes is refused.

## Art sources: maps from a server that runs nothing A map a server has never sent you has no colours on your client, and there is no packet to ask for them. That is the whole reason a shop or auction page draws blank parchment. Those colours are, however, sitting in the server's own world folder, and an owner who publishes that folder gives every player somewhere to read them from. **No plugin, no restart, no open port.** The new `map-export` tool reads a world folder or a backup zip and writes out every filled map in it. Copy the result to any static host, and players point **Art source** at it in the settings. It is on the [GitHub release](https://github.com/DragonX1901/show-my-maps/releases/tag/v1.1.1), and read access to a world backup is all it needs. Off by default and set per server, since a map id means a different picture on each. Three shapes are read: the mod's own cache files, a bare colour array, and a 128x128 PNG. **Nothing fetched is believed.** Colours off a web host are a stranger's word for what a map looks like, so they are stored marked as a guess and **Strict previews** refuses them outright. If the server later sends that map for real the two are compared, and a source that gets three locked maps wrong is switched off and everything it sent is thrown away. Only https unless the address is your own machine, redirects are refused rather than followed, and an address pointing into your own network is turned down. ## Fixed: maps went blank after a portal Walk through a portal just after opening a shop page and the art came back blank and stayed blank, leaving only maps cached from an earlier visit. Two halves of one bug, and each on its own was enough: - The client throws away every map it knows when its level is rebuilt, which a dimension change and a death both are. The **Paper plugin** kept a record of what it had already sent so as not to resend 16 KB every pass, and that record only cleared when the player quit, so for a whole resend window it deliberately sent nothing to a client that now had nothing. - The cache had the matching hole. Received maps were written in batches off a timer, and a batch held only the ids: by the time it ran, the level it would have read the colours from was gone, so a map that arrived in the seconds before the switch never reached disk either. Both are fixed. **Update the plugin as well** — the server side of this is in `1.1.1+paper`. ## Fixed: maps the plugin was not looking for Item frames, glow frames, armour stands and display entities are how a shop front is usually built, and none of them were read. A merchant's trade offers are not in its inventory at all, so a villager selling map art showed nothing however long you stared at it. Nested containers now recurse, since a bundle of maps inside a shulker box used to stop at the box. A new `debug` toggle names every map sent, and every stack naming a map the server cannot resolve, which separates "not looking there" from "another plugin drew that map straight to packets". ## Thirteen more languages German, Spanish, French, Italian, Japanese, Korean, Dutch, Polish, Brazilian Portuguese, Russian, Ukrainian and both written forms of Chinese, alongside the English and Turkish already there. Corrections from native speakers are welcome. ## Why beta Art sources are new networking code, and the exporter has not yet been run against a production world outside its own tests. Everything else is covered by the usual suite, plus a client gametest that fetches over real HTTP on loopback and checks that a source handing over the wrong bytes is refused.

## Art sources: maps from a server that runs nothing A map a server has never sent you has no colours on your client, and there is no packet to ask for them. That is the whole reason a shop or auction page draws blank parchment. Those colours are, however, sitting in the server's own world folder, and an owner who publishes that folder gives every player somewhere to read them from. **No plugin, no restart, no open port.** The new `map-export` tool reads a world folder or a backup zip and writes out every filled map in it. Copy the result to any static host, and players point **Art source** at it in the settings. It is on the [GitHub release](https://github.com/DragonX1901/show-my-maps/releases/tag/v1.1.1), and read access to a world backup is all it needs. Off by default and set per server, since a map id means a different picture on each. Three shapes are read: the mod's own cache files, a bare colour array, and a 128x128 PNG. **Nothing fetched is believed.** Colours off a web host are a stranger's word for what a map looks like, so they are stored marked as a guess and **Strict previews** refuses them outright. If the server later sends that map for real the two are compared, and a source that gets three locked maps wrong is switched off and everything it sent is thrown away. Only https unless the address is your own machine, redirects are refused rather than followed, and an address pointing into your own network is turned down. ## Fixed: maps went blank after a portal Walk through a portal just after opening a shop page and the art came back blank and stayed blank, leaving only maps cached from an earlier visit. Two halves of one bug, and each on its own was enough: - The client throws away every map it knows when its level is rebuilt, which a dimension change and a death both are. The **Paper plugin** kept a record of what it had already sent so as not to resend 16 KB every pass, and that record only cleared when the player quit, so for a whole resend window it deliberately sent nothing to a client that now had nothing. - The cache had the matching hole. Received maps were written in batches off a timer, and a batch held only the ids: by the time it ran, the level it would have read the colours from was gone, so a map that arrived in the seconds before the switch never reached disk either. Both are fixed. **Update the plugin as well** — the server side of this is in `1.1.1+paper`. ## Fixed: maps the plugin was not looking for Item frames, glow frames, armour stands and display entities are how a shop front is usually built, and none of them were read. A merchant's trade offers are not in its inventory at all, so a villager selling map art showed nothing however long you stared at it. Nested containers now recurse, since a bundle of maps inside a shulker box used to stop at the box. A new `debug` toggle names every map sent, and every stack naming a map the server cannot resolve, which separates "not looking there" from "another plugin drew that map straight to packets". ## Thirteen more languages German, Spanish, French, Italian, Japanese, Korean, Dutch, Polish, Brazilian Portuguese, Russian, Ukrainian and both written forms of Chinese, alongside the English and Turkish already there. Corrections from native speakers are welcome. ## Why beta Art sources are new networking code, and the exporter has not yet been run against a production world outside its own tests. Everything else is covered by the usual suite, plus a client gametest that fetches over real HTTP on loopback and checks that a source handing over the wrong bytes is refused.

## Art sources: maps from a server that runs nothing A map a server has never sent you has no colours on your client, and there is no packet to ask for them. That is the whole reason a shop or auction page draws blank parchment. Those colours are, however, sitting in the server's own world folder, and an owner who publishes that folder gives every player somewhere to read them from. **No plugin, no restart, no open port.** The new `map-export` tool reads a world folder or a backup zip and writes out every filled map in it. Copy the result to any static host, and players point **Art source** at it in the settings. It is on the [GitHub release](https://github.com/DragonX1901/show-my-maps/releases/tag/v1.1.1), and read access to a world backup is all it needs. Off by default and set per server, since a map id means a different picture on each. Three shapes are read: the mod's own cache files, a bare colour array, and a 128x128 PNG. **Nothing fetched is believed.** Colours off a web host are a stranger's word for what a map looks like, so they are stored marked as a guess and **Strict previews** refuses them outright. If the server later sends that map for real the two are compared, and a source that gets three locked maps wrong is switched off and everything it sent is thrown away. Only https unless the address is your own machine, redirects are refused rather than followed, and an address pointing into your own network is turned down. ## Fixed: maps went blank after a portal Walk through a portal just after opening a shop page and the art came back blank and stayed blank, leaving only maps cached from an earlier visit. Two halves of one bug, and each on its own was enough: - The client throws away every map it knows when its level is rebuilt, which a dimension change and a death both are. The **Paper plugin** kept a record of what it had already sent so as not to resend 16 KB every pass, and that record only cleared when the player quit, so for a whole resend window it deliberately sent nothing to a client that now had nothing. - The cache had the matching hole. Received maps were written in batches off a timer, and a batch held only the ids: by the time it ran, the level it would have read the colours from was gone, so a map that arrived in the seconds before the switch never reached disk either. Both are fixed. **Update the plugin as well** — the server side of this is in `1.1.1+paper`. ## Fixed: maps the plugin was not looking for Item frames, glow frames, armour stands and display entities are how a shop front is usually built, and none of them were read. A merchant's trade offers are not in its inventory at all, so a villager selling map art showed nothing however long you stared at it. Nested containers now recurse, since a bundle of maps inside a shulker box used to stop at the box. A new `debug` toggle names every map sent, and every stack naming a map the server cannot resolve, which separates "not looking there" from "another plugin drew that map straight to packets". ## Thirteen more languages German, Spanish, French, Italian, Japanese, Korean, Dutch, Polish, Brazilian Portuguese, Russian, Ukrainian and both written forms of Chinese, alongside the English and Turkish already there. Corrections from native speakers are welcome. ## Why beta Art sources are new networking code, and the exporter has not yet been run against a production world outside its own tests. Everything else is covered by the usual suite, plus a client gametest that fetches over real HTTP on loopback and checks that a source handing over the wrong bytes is refused.