BlueMap Banners
A Minecraft Fabric mod that supports displaying Minecraft banners as markers on BlueMap.
This is a continuation of Banners4BM originally by Nincodedo.

Player usage
This mod supports custom-named banners. (Just like the vanilla feature of banners on map items.)
Renamed banners are shown with the customized name on BlueMap as a POI marker.
When using a map item on an existing banner (enabled by default)
- Players can use map items on banners to create the marker on BlueMap.
- Players can use map items on banners to remove the marker.
When using direct placing of banners (disabled by default)
- Players place banners and markers are instantaneously created.
Other interactions (always enabled)
- Players can break the banner by hand to remove the marker.
- External sources can break banners to remove the marker. (TNT, support block broken)
Commands
The main command is /bluemapbanners, but there is also the alias /bb you can use.
/bluemapbanners
/bluemapbanners notifyPlayerOnBannerPlace [true|false]
/bluemapbanners notifyPlayerOnMarkerAdd [true|false]
/bluemapbanners notifyPlayerOnMarkerRemove [true|false]
/bluemapbanners notifyGlobalOnMarkerRemove [true|false]
/bluemapbanners markerAddInstantOnBannerPlace [true|false]
/bluemapbanners markerAddWithOriginalName [true|false]
/bluemapbanners markerMaxViewDistance [<number>]
/bluemapbanners markerSetHideByDefault [true|false]
/bluemapbanners markerSetName [<name>]
/bluemapbanners bluemapUrl [<url>]
Config file
# Wheter players should be notified and introduced how to add markers to BlueMap
notifyPlayerOnBannerPlace=true
# Wheter players should be notified if they add a marker
notifyPlayerOnMarkerAdd=true
# Wheter players should be notified if they remove a marker
notifyPlayerOnMarkerRemove=true
# Wheter all players on the server should be notified a banner has been removed
notifyGlobalOnMarkerRemove=false
# Wheter markers are created instantaneously on banner place
markerAddInstantOnBannerPlace=false
# Wheter instantly created markers with an original unchanged name are added
markerAddWithOriginalName=false
# For how far you want to be able to see these banners on BlueMap
markerMaxViewDistance=10000000
# Your url on which players can click in notifications, to your BlueMap instance
bluemapUrl=https://your-url-to-bluemap.com/
# Wheter the marker set should be hidden by default when accessing BlueMap
# You may need to clear browser cookies and reload the page to apply this setting
markerSetHideByDefault=false
# The name of the marker set used in BlueMap
# You may need to reload the page to apply this setting
markerSetName=BlueMap Banners
# Wheter this mod sends some usage metrics, a metric looks like: (fabric, 1.21.11, 2.2.3)
# These metrics include which server implementation, Minecraft version and mod version you are using
sendMetrics=true How to Install BlueMap Banners (Mod)
BlueMap Banners by MuffinTime is verified for Fabric across Minecraft versions 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6 (latest release: v3.1.0, file size: 111 KB). Follow the steps below to install it safely from ModCraft.tv:
- Click the Download button above and select your Minecraft version (1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6) and platform (Fabric).
- Make sure you have the compatible loader or environment installed for Fabric.
- Move the downloaded BlueMap Banners file into your Minecraft
.minecraft/modsfolder and launch the game.
All Versions
+ Add Version- Allow renaming the marker set name shown in BlueMap GUI [#12](https://github.com/RealMuffinTime/bluemap-banners/issues/12)
- Allow to set the marker set as hidden by default in BlueMap GUI by @PadBro in [#13](https://github.com/RealMuffinTime/bluemap-banners/pull/13)
- Update to Minecraft
26.3by @Traynack in [#15](https://github.com/RealMuffinTime/bluemap-banners/pull/15)
- @PadBro made their first contribution in [#13](https://github.com/RealMuffinTime/bluemap-banners/pull/13)
- @Traynack made their first contribution in [#15](https://github.com/RealMuffinTime/bluemap-banners/pull/15)
- Update to Minecraft
26.2
- Update to Minecraft
26.1.2
- Update to Minecraft
26.1.1
- Banner data storage gets overwhelmed
- Player adding the banner is now saved
- Timestamp when adding the banner is now saved
- Banners are now shown on their placement origin, like in the Minecraft world
- Choose between JSON storage (default) or JDBC (MaSQL, MariaDB, SQLite) storage
- Old banner saves are transferred to the new storage format
maps-imported, but no longer used- Preparing for a future release (dynamic/custom detail text generation, max banner per player limit and detailed banner image)
- On startup print version information in the console
- Simple metric collection is added (collects the version of Minecraft and the version of the mod), equal to BlueMap metrics, can be disabled in the config
- Update to Minecraft
26.1 - Releases are continued if one type of release fails
- A little bit of restructuring classes and code
- Fix compatibility with the Fast Item Frames mod
- Faulty config lines are no longer printed twice in the console
- Update GitHub actions workflow, merge build and release workflows
- Hotfix: use google gson instead of fasterxml jackson
- Add a config option to disable adding markers of unnamed banners (only applicable to instant placement)
- Update to Minecraft
1.21.11 - Migrate to Mojang mappings
- @CreeperHaed made their first contribution in [#10](https://github.com/RealMuffinTime/bluemap-banners/pull/10)
- Update to Minecraft
1.21.10 - Add commands overview to README.md
- Add commands to configure settings
- Add translation support for
en_usandde_de - Add an option to add markers instantly on banner place [#5](https://github.com/RealMuffinTime/bluemap-banners/issues/5)
- Rename marker list labels to "BlueMap Banners" and add a compatibility script to migrate old data
- Update to Minecraft
1.21.9 - Update BlueMap dependency
- Improve README.md and add images
- Fix global notifier using a wrong config identifier
- Fix wrong world reference [#9](https://github.com/RealMuffinTime/bluemap-banners/issues/9)
- Fix GitHub actions artifact not uploading
- Update to Minecraft
1.21.8
- Update to Minecraft
1.21.7
- Update to Minecraft
1.21.6 - Fix external forces not removing banners (e.g. TNT, support block removed)
- Update README.md to represent changes in config file
- Add Vito510 as contributor
- Releases use date given in CHANGELOG.md instead of run time
- Add a marker max view distance config by @Vito510 in [#3](https://github.com/RealMuffinTime/bluemap-banners/pull/3)
- Update to Minecraft
1.21.5by @Vito510 in [#3](https://github.com/RealMuffinTime/bluemap-banners/pull/3) - Fix marker icon anchoring by @Vito510 in [#3](https://github.com/RealMuffinTime/bluemap-banners/pull/3)
- Improve handling of config file
- @Vito510 made their first (forced) contribution in [#3](https://github.com/RealMuffinTime/bluemap-banners/pull/3)
- Update to Minecraft
1.21.4
- Update to Minecraft
1.21.3