0 Avatars served

Codevision
Codevision is a discord community for programmers, where you can discuss, get help and help other users with all kinds of programming related questions.
Join us now, it's a fun place!

Extremely simple avatars

The examples shown below work with all avatar types.

For basic usage just provide a UUID or a username:
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



Full body

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

8px up to 600px



Combo avatar

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

8px up to 600px



Cape:

https://mc-heads.net/cape/UUID
If the player does not own a cape, an HTTP/1.1 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 option caches requests to the mojang api letting you request a profile without a rate limit. It also displays the account's username history and username change count
Profiles currently cache for 15 minutes.
https://mc-heads.net/minecraft/profile/[username or UUID]
If username/UUID is malformed, an HTTP/1.1 204 No content status code will be returned.




About Caching

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

If you changed your skin you can try clearing your browser cache to see the change faster.
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!


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: couldn't reach mojang's services or the user requested a malfored UUID/name.

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

Litecoin: 32CPTqAfE4UCs7DYDAYFw4a9f2Q286sDx8
Bitcoin: 36P2o3jbrYMAyMJKK7F3RS6PF1BWy8LKyu


Partners

None at the moment.

Most requested usernames

Name Requests
Mister_Fix 569,444
RubbaBoy 256,332
MarkenJodSalz 248,066
Notch 198,263
JiNJaProductionz 175,878
Creeper 164,439

Most searched usernames

Name Searches
Mister_Fix 836
DanTDM 627
Notch 606
RubbaBoy 291
Herobrine 223
crypt3r 178

Who uses MCHeads

AwardCraft survival RPG Minecraft server
LearnToMod.com
ServerMiner.com
BDcraft.net
Litebans Material UI
PigParty.eu
heads.freshcoal.com
IronCreeper.com
tkjk.cz
Are you using MCHeads? Tell us!

Tools

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

MCHeads © 2013 - 2018 – All rights reserved

Back to top