Skip to content

BlueMap Custom Skin Server

BlueMap addon that allow to use custom skin server

Fabric
Loaders
Fabric
Downloads on Modrinth
7.1K
Followers on Modrinth
25
versions
22
Updated
September 29, 2026Sep 29
Published
in 2022

At a glance

Runs on Fabric
For Minecraft 1.18–26.3
Server only — players don't need to install it
Latest version — 2026.9.2 from September 29, 2026
Requires Fabric API, Fabric Language Kotlin and BlueMap
License MIT — free
Where it's needed
In gamenot neededOn serverrequired

Install on the server only; players don't need it

Game versions1.18–26.3

!Contributors !Forks !Stargazers !Issues !MIT License !LinkedIn !Discord !Modrinth


Logo

Bluemap Custom Skin Server

BlueMap addon that allow to use custom skin server
Support · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Usage
  3. Roadmap
  4. Contributing
  5. License

About The Project

Built With

(back to top)

Usage

Config

{
  "configVersion": 3,
  // Use command /bcss gai to get list of all available integrations 
  "integration": "modid:type",
  // Raw image mean that image not going to be cut or resized.
  // That allow you to use APIs that return player head only
  "rawImage": false,
  // URI only required for MOJANG_LIKE and SKIN_URL
  // It supports both file:// and http(s)://
  "uri": "http://0.0.0.0/%uuid%"
}
Before 2026.6.1
{
  "configVersion": 2,
  // MOJANG_LIKE, SKIN_URL, SKIN_RESTORER, FABRIC_TAILOR
  "integration": "SKIN_URL",
  // Raw image mean that image not going to be cut or resized.
  // That allow you to use APIs that return player head only
  "rawImage": false,
  // URI only required for MOJANG_LIKE and SKIN_URL
  // It supports both file:// and http(s)://
  "uri": "http://0.0.0.0/%uuid%"
}
Before 2026.1.1
{
  // Server type [ MOJANG_LIKE | CUSTOM ]
  "serverType": "CUSTOM",
  // Direct image mean that image not going to be cut or resized.
  // That allow you to use APIs that return player head only
  "directImage": false,
  // URL to remote server. Use %uuid% and/or %username% placeholders where required
  "url": "https://localhost/%uuid%/%username%",
}
Before 2024.5.1
{
  // Debug mode for issue or self error search 
  "debug": false,
  // Server type [ MOJANG_LIKE | CUSTOM ]
  "serverType": "CUSTOM",
  // URL to remote server. Added %uuid% and/or %username% placeholders where required
  "url": "https://localhost/%uuid%/%username%",
}
Before 2023.11.1
{
  // Debug mode for issue or self error search 
  "debug": false,
  // Server type [ MOJANG_LIKE | CUSTOM ]
  "serverType": "MOJANG",
  // Here u must put custom link. Examples u can see below
  "customSkinServerUrl": "https://localhost/",
  // This params supported only by CUSTOM server type
  "custom": {
    // Text after username in request url. As example for https://mcskins.top/ need ".png"
    "suffix": "",
    // Type of search param [ NAME | UUID ]
    "getSkinBy": "NAME",
    // Name case [ LOWER | UPPER | DEFAULT ]. As example for https://mcskins.top/ need LOWER
    "skinByCase": "LOWER"                      
  }
}

(back to top)

Roadmap

  • [x] Change link format

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

FAQ

How to install BlueMap Custom Skin Server?

Install Fabric for your Minecraft version, download BlueMap Custom Skin Server for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does BlueMap Custom Skin Server support?

BlueMap Custom Skin Server has builds for Minecraft 1.18–26.3.

Is BlueMap Custom Skin Server needed on the server?

Server only — players don't need to install it

License and source
MIT Licensefree to use and share with credit to the author
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More