BlueMap Custom Skin Server

<a name="readme-top"></a> ] ] ] ] ] ] ] ] <br /> <div align="center"> <a href="https://github.com/syorito-hatsuki/bluemap-custom-skin-server"> <img src="https://github.com/syorito-hatsuki/bluemap-custom-skin-server/blob/master/src/main/resources/assets/bluemap_custom_skin_server/icon.png?raw=true" alt="Logo" width="80" height="80"> </a> <h3 align="center">Bluemap Custom Skin Server</h3> <p align="center"> BlueMap addon that allow to use custom skin server <br /> <a href="https://discord.com/invite/zmkyJa3">Support</a> · <a href="https://github.com/syorito-hatsuki/bluemap-custom-skin-server/issues">Report Bug</a> · <a href="https://github.com/syorito-hatsuki/bluemap-custom-skin-server/issues">Request Feature</a> </p> </div> <details> <summary>Table of Contents</summary> <ol> <li> <a href="#about-the-project">About The Project</a> <ul> <li><a href="#built-with">Built With</a></li> </ul> </li> <li> <a href="#usage">Usage</a> <ul> <li><a href="#config">Config</a></li> </ul> </li> <li><a href="#roadmap">Roadmap</a></li> <li><a href="#contributing">Contributing</a></li> <li><a href="#license">License</a></li> </ol> </details> ## About The Project ### Built With * ! * ! * ! * ! <p align="right">(<a href="#readme-top">back to top</a>)</p> ## Usage ### Config ```json5 { "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%" } ``` <details> <summary>Before 2026.6.1</summary> ```json5 { "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%" } ``` </details> <details> <summary>Before 2026.1.1</summary> ```json5 { // Server type "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%", } ``` </details> <details> <summary>Before 2024.5.1</summary> ```json5 { // Debug mode for issue or self error search "debug": false, // Server type "serverType": "CUSTOM", // URL to remote server. Added %uuid% and/or %username% placeholders where required "url": "https://localhost/%uuid%/%username%", } ``` </details> <details> <summary>Before 2023.11.1</summary> ```json5 { // Debug mode for issue or self error search "debug": false, // Server type "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 "getSkinBy": "NAME", // Name case . As example for https://mcskins.top/ need LOWER "skinByCase": "LOWER" } } ``` </details> <p align="right">(<a href="#readme-top">back to top</a>)</p> ## Roadmap - Change link format See the (https://github.com/syorito-hatsuki/bluemap-custom-skin-server/issues) for a full list of proposed features (and known issues). <p align="right">(<a href="#readme-top">back to top</a>)</p> ## 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 (`gi

[!] [!] [!] [!] [!] [!] [!] [!]

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
   • Built With
2. Usage
   • Config
3. Roadmap
4. Contributing
5. License

## About The Project

### Built With

! ! ! !

(back to top)

```json5 { "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

```json5 { "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

```json5 { // 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

```json5 { // 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

```json5 { // 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)

- Change link format

See the (https://github.com/syorito-hatsuki/bluemap-custom-skin-server/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 (`gi