[1.21.4] Map/image data corrupts randomly after clean /stop — onEnable/onDisable doesn't wait for pending async save writes

[eason2141]

On restart, a random image map occasionally comes back corrupted. A subsequent restart usually fixes that specific map, but at some later point a different map corrupts instead. This happens even when the server is stopped cleanly (no crashes, no force-kills).

Environment

• ImageFrame version: 1.8.5.0
• Server software: PaperMC
• Minecraft version: 1.21.4

Looking at the server log during shutdown, ImageFrame's disable sequence returns instantly with no indication it waited for any in-progress I/O:

[ImageFrame] Disabling ImageFrame v1.8.5.0
[ImageFrame] ImageFrame has been Disabled!

Both lines are logged in the same second. By contrast, other plugins that do async saves (e.g. QuickShop-Hikari) explicitly block and log progress while flushing pending writes before completing their disable sequence:

[QuickShop-Hikari] QuickShop is finishing remaining work, this may need a while...
[QuickShop-Hikari] Saving all in-memory changed shops...
[QuickShop-Hikari] Saving shops, please allow up to 30 seconds for flush changes into database...
...
[QuickShop-Hikari/Bootstrap] QuickShop-Hikari - Bootstrap -> All Complete (6ms)

[LOOHP]

It's unlikely that this is due to shutdown corruption, as the plugin writes images only when it is created or refreshed and not during shutdown. Try updating the plugin to the latest version and see if it improves. If it happens again, you can go to the plugin folder and see whether the PNG is indeed corrupted.