+
+ A blazing fast API for Minecraft faces!
+| parameter | +type | +default | +description | +
| size | +integer | +<%= config.avatars.default_size %> | +The size of the image in pixels, <%= config.avatars.min_size %> - <%= config.avatars.max_size%>. | +
| default | +string | +The standard value is calculated based on the UUID (even = MHF_Alex, odd = MHF_Steve). + Usernames always default to MHF_Steve. |
+ The image to be served when the userid has no skin. + Valid options are any userid, including MHF_Steve and MHF_Alex, or a custom URL. |
+
| helm | +null | ++ | Apply the "second" layer (hat) to the avatar. | +
Jeb's avatar
+Jeb's avatar with helm
+Jeb's avatar, 128 × 128
+Jeb's avatar by UUID
+Jeb's avatar, or fall back to MHF_Alex (this example assumes jeb_ does not exist)
+Jeb's avatar, or fall back to a custom image (this example assumes jeb_ does not exist)
+Hover over the example URLs above for a preview!
+Crafatar also provides support for 3D renders of Minecraft skins.
+ Please note that this feature is currently beta!
+ Replace
+ userid with a Mojang UUID or username to get a render of the skin. The head render type returns a render of the skin's head.<%= domain %>/renders/head/useridThe body render returns a render of the entire skin.<%= domain %>/renders/body/userid
| parameter | +type | +default | +description | +
| scale | +integer | +<%= config.renders.default_scale %>. The actual size differs between the type of render. | +The scale factor of the image <%= config.renders.min_scale %> - <%= config.renders.max_scale %>. | +
| helm | +null | ++ | Apply the "second" layer (hat) to the avatar. | +
| default | +string | +The standard value is calculated based on the UUID (even = MHF_Alex, odd = MHF_Steve). + Usernames always default to MHF_Steve. |
+ The image to be served when the userid has no skin. + Valid options are any userid, including MHF_Steve and MHF_Alex, or a custom URL. |
+
Jeb's body, with helmet, scale 4
+Jeb's head, by UUID, scale 8
+Hover over the example URLs above for a preview!
+You can also get the full skin file of a player.
+ Replace
+ userid with a Mojang UUID or username to get the related skin.
+ The user's skin is returned, or the default image is served.
+ You can use the default parameter here as well.<%= domain %>/skins/userid
| parameter | +type | +default | +description | +
| default | +string | +The standard value is calculated based on the UUID (even = MHF_Alex, odd = MHF_Steve). + Usernames always default to MHF_Steve. |
+ The image to be served when the userid has no skin. + Valid options are any userid, including MHF_Steve and MHF_Alex, or a custom URL. |
+
Jeb's skin
+Jeb's skin, or fall back to MHF_Alex (this example assumes jeb_ does not exist)
+Hover over the example URLs above for a preview!
+A cape endpoint is also available to get the active cape of a user.
+ Replace
+ userid with a Mojang UUID or username to get the related cape.
+ The user's cape is returned, otherwise a 404 is returned.
+
Dinnerbone's Cape Mojang capes are not transparent...
+md_5's Cape
+Hover over the example URLs above for a preview!
+Crafatar supports CORS so you can make AJAX request from within the browser!
+Responses come with these HTTP headers, useful for debugging.
+ Please note that these headers are cached by CloudFlare (CF-Cache-Status: HIT).
The time, in milliseconds, it took Crafatar to process the request.
+Details about how the requested image was stored on the server
+The internal ID assigned to this request.
+ If you think something is wrong with your request, please contact us and provide this ID.
We strongly advise you to use UUIDs instead of usernames in production.
+ Usernames are deprecated by Mojang and you should only use usernames for testing.
+ You don't have to change anything when using UUIDs and someone changes their Username.
+ Malformed usernames are rejected.
UUIDs may use the blank or dashed format.
+ Malformed UUIDs are rejected.
Crafatar caches skins for <%= config.caching.local / 60 %> minutes before checking for skin changes.
+ Images are cached in your browser for <%= config.caching.browser / 60 %> minutes until a new request to Crafatar is made.
+ When you changed your skin you can try clearing your browser cache to see the change faster.
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+