BlueMapSkinSupport

Adds support to BlueMap for acquiring skins from custom skin provider plugins, as well as offline-mode servers.

What is this?

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.

Supported custom skin provider plugins

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.

How do I install this on my Minecraft server?

Prerequisites

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

Installation

Completely shut down your Minecraft server using /stop.
Download the latest *.jar file from the GitHub releases page.
Copy the *.jar file to your /plugins/ directory.
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.)
Edit BlueMap's plugin.conf file and disable its built-in skin downloader to prevent it from overwriting BMSS-generated skins.
Start your server and enjoy having the correct player heads appear on BlueMap's web UI!

How do I build/compile this?

Prerequisites

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.

Building (IntelliJ IDEA)

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.
Open the cloned project directory in IntelliJ IDEA.
Click on the Maven panel on the right side and go to "Lifecycle", then double-click on package.
You will find your newly-built JAR in the /target/ folder.

Building (CLI)

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.

License

Licensed under the MIT License.

BlueMapSkinSupport

Adds support to BlueMap for acquiring skins from custom skin provider plugins, as well as offline-mode servers.

Table of Contents

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