• What is this?
• Supported custom skin provider plugins
• How do I install this on my Minecraft server?
  • Prerequisites
  • Installation
• How do I build/compile this?
  • Prerequisites
  • Building (IntelliJ IDEA)
  • Building (CLI)
• Links
• License

BlueMapSkinSupport is a plugin that allows BlueMap to be able to acquire and display player heads for Minecraft servers (in both online-mode or offline-mode) that are using custom skin provider plugins for custom player-defined skins, as well as offline-mode Minecraft servers that have no custom skin provider plugins installed.

Player heads are generated in the exact same way as BlueMap's native player heads.

• SkinsRestorer / SkinsRestorerX 15.x and higher, or 14.x (※ minimum 14.1) (※ recommended)
• CustomSkinsManager (※ deprecated, project was abandoned — support was added for this plugin only because someone requested it anyway, as I personally have always used SkinsRestorerX)

※ The use of these plugins is not required — BlueMapSkinSupport will work even without them, if you have some reason to want to do so.

• Paper (※ recommended) / Spigot / CraftBukkit for Minecraft 1.8 or higher
  • This should also work with any other Minecraft server software capable of loading Bukkit plugins.
  • If you are using Waterfall / BungeeCord, you will need to install this plugin on each individual backend Minecraft server.
• BlueMap 3.8 or higher (※ BlueMapAPI 2.3.0 or higher)
  • Support technically exists for versions all the way down to BlueMap 2.1 (API 2.0.0) if you have some reason you want to use such an old version of BlueMap. A minor source code modification (documented in the code itself) is required to facilitate this.
• Optionally, one of the supported custom skin provider plugins listed above

1. Completely shut down your Minecraft server using /stop.
2. Download the latest *.jar file from the GitHub releases page.
3. Copy the *.jar file to your /plugins/ directory.
4. If you want, you can change how BlueMapSkinSupport behaves by modifying its configuration file located at /plugins/BlueMapSkinSupport/config.yml. (※ For reference, here are the default contents of config.yml.)
5. Edit BlueMap's plugin.conf file and disable its built-in skin downloader to prevent it from overwriting BMSS-generated skins.
6. Start your server and enjoy having the correct player heads appear on BlueMap's web UI!

• IntelliJ IDEA (Community Edition is free!)
• If you're experienced enough with the CLI, you can just simply use the Maven CLI directly
  • brew install maven on macOS (requires Homebrew to be installed)
  • sudo apt install maven on Debian-based Linux distributions
  • Follow the instructions here if you use Windows. (Honestly, I'd recommend just using IntelliJ IDEA if you're on Windows.)
• Adoptium Temurin 8 LTS OpenJDK + HotSpot JVM (newer JDK versions also work, but I targeted JDK 8 here for compatibility reasons)
  • Adoptium is the new name for AdoptOpenJDK.

1. Clone the Git repository by running git clone https://github.com/akemin-dayo/BlueMapSkinSupport.git in a Terminal instance, or use a Git frontend like SourceTree.
2. Open the cloned project directory in IntelliJ IDEA.
3. Click on the Maven panel on the right side and go to "Lifecycle", then double-click on package.
4. You will find your newly-built JAR in the /target/ folder.

git clone https://github.com/akemin-dayo/BlueMapSkinSupport.git
cd BlueMapSkinSupport
mvn package

You will then find your newly-built JAR in the /target/ folder.

• GitHub Repository
• SpigotMC Resource Page
• BukkitDev Project Page

Licensed under the MIT License.