This mod does exactly what it says. It brings back HD Head / Custom Head / High Resolution Heads (or whatever else you might call it) usage on Minecraft 1.16.5 and above. This "bug" was patched in newer versions of Minecraft where you could use a scaled up version of a skin template to create textures, like a computer for instance.
It is obviously higher quality, bigger than 16 pixels per side.
Get a regular Minecraft skin template, and scale it up to a resolution like 4096x4096 and let your creativity run wild. Here is a sample texture of a Macbook I made: https://i.ibb.co/j3vMt5V/silver.png You can see more examples at...:
Originally you would abuse education.minecraft.net
but they have fixed their site to not allow image uploads, and is blocked on newer versions of Minecraft. This mod comes in, and you use an external image host to allow people to see your heads. Personally, I use imgbb.com
because it's not forcing ads.
To make the head, get the direct image link and run the command /hdheads create <url>
in game.
Type /hdheads
to see options.
Config commands can also be changed using Modmenu / Cloth Config, which is probably easier to use.
Creates a new head using the specified parameters:
<url>
is an image URL. The image should look similar to a Minecraft skin.[<name>]
is the name of the head. Supports color and styling and HEX (&f, &l, &#FFFFFF) through the ampersand character. (rawsay)[<watermark>]
is the "fingerprint" of the head, it must be a unique value, or it may not render.
When you are holding a head, this will show the key NBT of the head including the URL, UUID, and watermark of the head.
Configures the url hosts to blacklist and whitelist with the specified parameters:
<BLACKLIST/WHITELIST>
is only relevant for whitelist, as any domains not detected on whitelist will be ignored. blacklist can be used to block a subdomain. Use an asterisk (*) to allow or deny all sites.<ADD/REMOVE/GET>
decides how you modify the list.[<sites>]
are the sites you want to add or remove, to add multiple, separate using a semicolon (;).
EXAMPLES OF A VALID SITE: .mojang.com
, .minecraft.net
, education.minecraft.net
Toggles the functionality of HD Heads:
CHANGE
toggles by switching out the blacklisted and whitelisted URLs, and disables rendering of HD Heads.GET
shows the status of the mod.
Sets the maximum allowed file size for incoming and already downloaded textures. The default is 50 MB.
CHANGE
will allow you to set a size in KILOBYTES, not BYTES. Put -1 to allow images of any size.GET
shows the maximum size allowed for rendering HD Heads.
Sets the maximum allowed dimensions for incoming and already downloaded textures. The default is 50000 pixels.
CHANGE
will allow you to set a size in PIXELS. Put -1 to allow images of any size. This will be checked against both the image height and width.GET
shows the maximum size allowed for rendering HD Heads.
It is not recommended to use this command unless you know what you are doing.
Configures the allowed url scheme with the specified parameters:
<ADD/REMOVE/GET>
decides how you modify the list. Use an asterisk (*) to allow all schemes.[<schemes>]
are the schemes you want to add or remove, to add multiple, separate using a semicolon (;).
EXAMPLES OF A VALID SCHEME: https
, http
Toggles texture merging of HD Heads. This is off by default (vanilla behavior would be on), works by moving the textures by such a small amount that you will only notice that the textures of the head won't merge into the block it's on, also fixing wall heads. In order for this to work, config TOGGLE must be on.
CHANGE
toggles the modification that prevents player head textures from merging with the block it is placed on.GET
shows the status of texture merging.
It is not recommended to use this command unless you know what you are doing.
Modifies the file naming procedure to allow URLs with the same filename to go to different heads. In order for this to work, config TOGGLE must be on. Toggling between options will download textures you've already downloaded.
CHANGE
toggles what string is used for hashing: the whole URL or just the filename.GET
shows the status of how textures are saved.
Changes how the hat layer on heads are rendered. In order for this to work, config TOGGLE must be on. If enabled, the hat layer will be shrunk to the size of the head layer to allow more immersion with textures like laptop heads. (Reload resources after changing)
CHANGE
toggles how the hat layer on heads are rendered.GET
shows the status of how the hat layer is rendered.
It is not recommended to use this command unless you know what you are doing.
Sets the scale at which player heads are rendered, intended to be a 'fun' command, large values will negatively impact user experience. The default is -1 -1 1, affecting all heads.
CHANGE
sets the scale for x, y, and z respectively.GET
shows the current scale factor
- Builds are provided for 1.17 only, since that is when HD Heads were patched.
- Possible security vulnerabilities if others make heads that link to images with malicious code(?)
- Client-side, not visible to everyone. People must have this mod or something similar to this to see your head
- Lag when initially rendering chunks with heads (Usually brief, but is expected when you load large images into memory)
- This mod contains features that limit the size (both height/width and filesize) of the HD head textures that are downloaded and rendered.
- Minecraft stores heads using the filename encoded as SHA-1, which leads to an issue of downloading heads with different URLs with the same file name, this mod fixes it. However, this will re-download all skins that come from Minecraft's servers. (The hash
skin.png
differs fromhttps://textures.minecraft.net/skins/skin.png
). - Don't make porn heads
Obviously in newer versions of Minecraft, they fixed the bug. HD Heads worked until 1.16, and were patched in 1.17. In 1.17, they blocked skins with URLs to education.minecraft.net
in their authlib
library, and also prevented heads already downloaded to your assets folder from rendering if they were greater than 64x64
or 64x32
pixels.
Using some Mixins, I reversed their fix to allow HD Heads to be rendered, downloaded from sites outside of mojang.com
/*.minecraft.net
AND also added some features like creating/analyzing heads. :)
Look at the computer keyboards to see how axis fighting works.
This will also work if the head is attached to a wall, it is not limited to "floor" heads.
(Photos taken using BSL shaders. Last three images however use Complementary Unbound w/ Euphoria patches and were taken in a world built by Alco_Rs11
)