Total avatars served: Loading...

MCPacks out now!

MCPacks is now officially out and running, check it out now!

Extremely simple avatars

The examples shown below work with all avatar types.
For basic usage just provide a UUID:
https://mc-heads.net/avatar/UUID
For size control, add the desired size in pixels after specifying the username:
https://mc-heads.net/avatar/UUID/100
For avatars without the helm element, add /nohelm to the end of any URL:
https://mc-heads.net/avatar/UUID/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/UUID/100/nohelm.png

8px up to 600px


Isometric Head

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

8px up to 600px



Isometric Body

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

8px up to 600px



Random avatar

https://mc-heads.net/random

8px up to 600px



Full body

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

8px up to 600px



Combo avatar

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

8px up to 600px



Default skins:

https://mc-heads.net/avatar/Steve
https://mc-heads.net/avatar/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


About Caching

MCHeads caches skins for 6 hours
Images are also cached in your browser for 6 hours until a new request to MCHeads is made.

When you changed your skin you can try clearing your browser cache to see the change faster.
MCHeads deletes expired cache every 30 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!


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.


HTTP Headers

Responses come with some custom HTTP headers, useful for debugging.
Please note that these headers may be cached by CloudFlare.

  • X-Has-Failed: Details about the request status
    • true: The request went well, there were no issues on both sides.
    • false: Either mojang's server are down or the user requested a malfored UUID/username.
  • X-Request-ID: The internal ID assigned to this request.
    If you think something is wrong with your request, please contact us and provide this ID.

Support

To contact us about any issue, please send an E-Mail to support@mc-heads.net.


Donations

Please donate for the continued support of MCHeads

Litecoin: LfiykV9MrYiHsLxak1RTBPNncLZRsmXjyx
Bitcoin: 36P2o3jbrYMAyMJKK7F3RS6PF1BWy8LKyu


Who uses MCHeads

LearnToMod.com
heads.freshcoal.com
Minecraft-Serverliste.com
Librecraft.com
EndlessFun.cz
Ftg.hu
Pikacity.com
FlashCraftMC
tkjk.cz
forum.alsace.work
Are you using MCHeads? Tell us!

Tools

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

Follow us


MCHeads © 2013 - 2017 – All rights reserved

Back to top