Add custom heads - AlonsoAliaga/BetterHeads GitHub Wiki

Add custom heads

[!WARNING] ⚠️ This guide is for BetterHeads 2.0-BETA and newer.

[!IMPORTANT] The ID you use MUST BE greater or equal than 500000 (five hundred thousand).

To add custom heads follow the next format:

Heads: #This is heads category. Do not modify!
  '500000': #This is the ID of the head, this is a default head with ID 1.
    Name: '@ Icon' #Name of the head
    Id: 500000 #The ID again
    UUID: e978ac35-5f37-4f57-833c-5d6983afa18d #Create a random UUID on https://alonsoaliaga.com/RandomUUID
    Category: alphabet #The category identifier. MAKE SURE IT EXISTS and is LOWERCASE
    Texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZGFkNDQ4OTkxMjAxNmYwZjkyOTVmMWYzYTc4MGY2NDFjOGE3MmVkYTExMDMyNjQzZjdkYmQ2MTljMTAxMDczYSJ9fX0=" #The texture
    Tags: #List of tags, if you don't want it to have tags set it to Tags: []
    - Icons (Ironblock)
    - Punctuation Mark

When adding new head remember that:

ID

Must be a number and unique. For custom heads start from id 500000.
This is required to prevent conflicts and help migrations!

UUID

Must be a valid unique id. Create a random one clicking here.

Texture

Must be a valid base64 texture. If you want to use your own skin you have two options:\

Join our Support server and type ?texture in #bot-commands-🤖 channel and follow instructions.
Follow steps below.

Open this site: https://sessionserver.mojang.com/session/minecraft/profile/ADD-YOUR-UUID-HERE <- Don't forget to use your own uuid.
If you don't know what's your UUID open this site and search your premium username.
Click on your player and that's your premium UUID!
Once you use your UUID in the link, something like this will be returned:

{
  "id" : "e1c1a1947e86414f86bb42d82a21cfb8",
  "name" : "AlonsoAliaga",
  "properties" : [ {
    "name" : "textures",
    "value" : "ewogICJ0aW1lc3RhbXAiIDogMTYzNjA3NjY0MTkzMiwKICAicHJvZmlsZUlkIiA6ICJlMWMxYTE5NDdlODY0MTRmODZiYjQyZDgyYTIxY2ZiOCIsCiAgInByb2ZpbGVOYW1lIiA6ICJBbG9uc29BbGlhZ2EiLAogICJ0ZXh0dXJlcyIgOiB7CiAgICAiU0tJTiIgOiB7CiAgICAgICJ1cmwiIDogImh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvODkxZDE1YzFiNzQxMDU5N2EzNDZjMWZmMjljMDk3NmY5OTZkMjRiMTJjOGI5Y2ZlZDFjYjBkMDVmNzMyMjk1OSIKICAgIH0sCiAgICAiQ0FQRSIgOiB7CiAgICAgICJ1cmwiIDogImh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMjM0MGMwZTAzZGQyNGExMWIxNWE4YjMzYzJhN2U5ZTMyYWJiMjA1MWIyNDgxZDBiYTdkZWZkNjM1Y2E3YTkzMyIKICAgIH0KICB9Cn0="
  } ]
}

I'll use the text in "value" field. We'll have to process that the value.
Open this site and paste the content in it. Click on DECODE!
Copy the result, now we have to remove all lines EXCEPT the one that says "texture" and its content.\

{
  "timestamp" : 1636076641932, //Remove this line
  "profileId" : "e1c1a1947e86414f86bb42d82a21cfb8", //Remove this line
  "profileName" : "AlonsoAliaga", //Remove this line
  "textures" : {
    "SKIN" : {
      "url" : "http://textures.minecraft.net/texture/891d15c1b7410597a346c1ff29c0976f996d24b12c8b9cfed1cb0d05f7322959"
    }, //Remove the comma here
    "CAPE" : { //Remove this line
      "url" : "http://textures.minecraft.net/texture/2340c0e03dd24a11b15a8b33c2a7e9e32abb2051b2481d0ba7defd635ca7a933" //Remove this line
    } //Remove this line
  }
}

Final result should look like this:

{
  "textures" : {
    "SKIN" : {
      "url" : "http://textures.minecraft.net/texture/891d15c1b7410597a346c1ff29c0976f996d24b12c8b9cfed1cb0d05f7322959"
    }
  }
}

We now have to delete ALL SPACES like this:

{"textures":{"SKIN":{"url":"http://textures.minecraft.net/texture/891d15c1b7410597a346c1ff29c0976f996d24b12c8b9cfed1cb0d05f7322959"}}}

Now open this site and paste it there. Click ENCODE and copy the result in "Texture" section!

eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvODkxZDE1YzFiNzQxMDU5N2EzNDZjMWZmMjljMDk3NmY5OTZkMjRiMTJjOGI5Y2ZlZDFjYjBkMDVmNzMyMjk1OSJ9fX0=

Tags

This are the tags you want for your head. Tags will be used when players search for heads with /betterheads search command.
In my case I want the following tags: Purple hair, Staff member, Developer, BetterHeads, AlonsoAliaga
So I'll create a list for it like this:

    Tags:
    - Purple hair
    - Staff member
    - Developer
    - BetterHeads
    - AlonsoAliaga

If you DON'T WANT TAGS, simply set it to

    Tags: []

This is an example for a custom head in which I'll add my own head. The result would be:

Heads: #This already exists
  '500000':
    Name: AlonsoAliaga
    Id: 500000
    UUID: 93b0e2d0-fe77-4735-b36c-757c4d9eff7c
    Category: staff-heads
    Texture: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvODkxZDE1YzFiNzQxMDU5N2EzNDZjMWZmMjljMDk3NmY5OTZkMjRiMTJjOGI5Y2ZlZDFjYjBkMDVmNzMyMjk1OSJ9fX0=
    Tags:
    - Purple hair
    - Staff member
    - Developer
    - BetterHeads
    - AlonsoAliaga

Now our head is ready to be used! Players can purchase it and it's located in the category we selected for it!
You can see how it will look like in game for players!
Example of my head