BlueMapSkinSupport
Adds support to BlueMap for acquiring skins from custom skin provider plugins, as well as offline-mode servers.
- What is this?
- Supported custom skin provider plugins
- How do I install this on my Minecraft server?
- How do I build/compile this?
- 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
- 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 ofconfig.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!
- IntelliJ IDEA (Community Edition is free!)
- If you're experienced enough with the CLI, you can just simply use the Maven CLI directly
- 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.
- 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.
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.
Licensed under the MIT License.
Comments