Minecraft services down!
One or more of Minecraft's online services appear to be offline, which might affect MCHeads, please be patient while the services come back online.
Extremely simple avatars
For basic usage just provide an identifier - UUID, username or a Minecraft texture ID:
https://mc-heads.net/avatar/identifierFor size control, add the desired size in pixels after specifying the username:
https://mc-heads.net/avatar/identifier/100For avatars without the helm element, add
/nohelmto the end of any URL:
https://mc-heads.net/avatar/identifier/100/nohelmAnd for a URL with a file extension, you can add a
.pngat the very end of any URL:
8px up to 600px
Isometric avatars' facing direction can be changed with a modifier at the end of the URL:
32px up to 600px
8px up to 600px
8px up to 600px
Get a player's skin
Download a player's skin
Switch your skin to a player's skin
Mojang API proxyThis endpoint caches requests to the mojang API letting you request a profiles without a rate limit.
Username history is also sent.
Responses are cached for 15 minutes.
https://mc-heads.net/minecraft/profile/Name | UUIDIf username/UUID is malformed, a
204 No contentstatus code will be returned.
/signedcan be appended to the URL if a texture signature from Mojang is required.
MHF UUIDsMojang has created several accounts with guaranteed static skins to help map makers visualize their creations with said account's heads.
This endpoint attempts to list all of the known and verified MHF UUIDs and their names.
MCHeads caches skins on its servers for 6 hours
Images are also cached client side via cache headers for 2 hours.
Changed skins do not take effect on MCHeads immediately.
MCHeads deletes expired server side cache every 5 minutes.
We strongly advise you to use UUIDs instead of usernames! UUIDs never change while usernames do.
Looking up players by username has officially been deprecated by Mojang ever since UUIDs were introduced.
Malformed usernames are rejected.
UUIDs may be any valid Mojang UUID in the blank or dashed format.
Malformed UUIDs are rejected, and all features on MCHeads support UUIDs
MCHeads supports Cross-Origin Resource Sharing, so you can make AJAX request from other sites!
MCHeads supports HTTP/2, meaning a client can re-use a single underlying TCP connection to make multiple requests instead of opening a new connection for each one, making the whole process up to 50% faster!
If you are using one of the JSON or avatar endpoints of MCHeads, using HTTP/2 could heavily increase performance in your app.
Attribution is not required, but it is encouraged.
If you want to show some support for this (free!) service, place a notice like this somewhere: Thanks to <a href="https://mc-heads.net">MCHeads</a> for providing Minecraft avatars.
To contact us about any issue, please send an E-Mail to [email protected], or ask in our Discord server.
Most requested usernames
Most searched usernames
Who uses MCHeadsDifficult-Knights.de
Are you using MCHeads? Tell us!
ToolsVanillaForums avatars plugin
VanillaForums heads plugin
MCPacks - resource pack hosting CDN