0 Avatars served

Minecraft services status checker

MCHeads launched a fork of xPaw's Minecraft services status checker, that can be found here.

Extremely simple avatars

The examples shown below work with all avatar types.

For basic usage just provide an identifier - UUID, username or a Minecraft texture ID: 
https://mc-heads.net/avatar/identifier
 For size control, add the desired size in pixels after specifying the username: 
https://mc-heads.net/avatar/identifier/100
 For avatars without the helm element, add /nohelm to the end of any URL: 
https://mc-heads.net/avatar/identifier/100/nohelm
 And for a URL with a file extension, you can add a .png at the very end of any URL: 
https://mc-heads.net/avatar/identifier/100/nohelm.png

8px up to 600px



Isometric Head

https://mc-heads.net/head/identifier

32px up to 600px



Isometric Body

https://mc-heads.net/body/identifier

32px up to 600px



Full body

https://mc-heads.net/player/identifier

8px up to 600px



Combo avatar

https://mc-heads.net/combo/identifier

8px up to 600px



Cape:

https://mc-heads.net/cape/UUID
 If the player does not own a cape, an 404 Not Found status code will be returned.


Default skins:

https://mc-heads.net/avatar/MHF_Steve
 
https://mc-heads.net/avatar/MHF_Alex


Get skin:

https://mc-heads.net/skin/UUID

Download skin:

https://mc-heads.net/download/UUID

Direct skin switch:

https://mc-heads.net/change/UUID

Mojang API:

This 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 30 minutes.
https://mc-heads.net/minecraft/profile/Name or UUID
 If username/UUID is malformed, a 204 No content status code will be returned.
/signed can be appended to the URL if a texture signature from Mojang is required.


MHF UUIDs:

Mojang 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.
https://mc-heads.net/minecraft/mhf




About Caching

MCHeads caches skins on its servers for 36 hours
Images are also cached client side via cache headers for 36 hours.

Changed skins do not take effect on MCHeads immediately.
MCHeads deletes expired server side cache every 5 minutes.


About Usernames

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.


About UUIDs

UUIDs may be any valid Mojang UUID in the blank or dashed format.
Malformed UUIDs are rejected, and all features on MCHeads support UUIDs


CORS

MCHeads supports Cross-Origin Resource Sharing, so you can make AJAX request from other sites!


HTTP/2

MCHeads supports HTTP/2, meaning a client can re-use a signle underlying TCP connection to download content, making the whole process up to 50% faster!
If you are using one of the JSON endpoints of MCHeads, using HTTP/2 could heavily increase performance in your app.


Attribution

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.



Support

To contact us about any issue, please send an E-Mail to support@mc-heads.net, or ask in our Discord server.


Donations

Please donate for the continued support of MCHeads

Most requested usernames

Name Requests
Mister_Fix 687,904
EinfxchLisa 417,353
avdi 362,860
GelberZauber34 334,677
EinfxchLukas 296,553
RubbaBoy 293,348
ScoutingForSued 284,736
Notch 255,053
DarkEyeDragon 247,478
unlxqitjoma 222,781
JiNJaProductionz 220,447
DasMaexle 203,936
Creeper 202,903
8blockluca 201,055

Who uses MCHeads

LearnToMod.com
ServerMiner.com
BDcraft.net
Litebans Material UI
PigParty.eu
heads.freshcoal.com
IronCreeper.com
tkjk.cz
skins.snowdev.com.br
Are you using MCHeads? Tell us!

Tools

VanillaForums avatars plugin
VanillaForums heads plugin
MCPacks - resource pack hosting CDN

MCHeads © 2013 - 2020 – All rights reserved

Back to top