Why use Crafthead?
- Blazing fast – no matter where you are, Crafthead is fast, thanks to the power of Cloudflare Workers and Cloudflare's 200+ datacenters worldwide
- Easy to move to – the URL layout is 100% compatible with Minotar's, so it's a quick and easy switch
- Powered by Nodecraft, trusted by NamelessMC and the LuckPerms project
Performance & Caching
Performance tip: Use UUIDs when possible. Using a username requires an extra API call, which may not be cached!
Hytale rendering: Hytale avatars are computationally more expensive to render than Minecraft skins. Crafthead caches rendered Hytale avatars in R2 for 24 hours per view type (avatar, helm, cube, body, bust), significantly reducing rendering costs and improving response times for frequently requested avatars.
Getting started
Crafthead supports lookups by UUID (dashed or not) and usernames and supports rendering avatars, cubes, retrieving skins and profiles. The URL layout is compatible with Minotar, making migration simple.
Fetch an avatar
GET
https://crafthead.net/avatar/ecfc3640f601406c9f9f1f857fc76f9d
Need a different size?
GET
https://crafthead.net/avatar/dcc4c006582b4f798f71654b477807c2/128
Got a dashed UUID? We will remove the dashes for you.
GET
https://crafthead.net/avatar/c6309b6b-8aac-4aab-8fef-a1e6853316ec
We support usernames, too.
GET
https://crafthead.net/avatar/LadyAgnes
Want a helm?
GET
https://crafthead.net/helm/Reply
Cube heads go well with a cube game.
GET
https://crafthead.net/cube/48a0a7e4d5594873a617dc189f76a8a1
Fetch a player's body
GET
https://crafthead.net/body/48a0a7e4d5594873a617dc189f76a8a1
GET
https://crafthead.net/armor/body/Reply
Fetch a player's bust
GET
https://crafthead.net/bust/6a085b2c19fb4986b453231aa942bbec
GET
https://crafthead.net/armor/bust/Reply
Fetch a player's skin
GET
https://crafthead.net/skin/652a2bc4e8cd405db7b698156ee2dc09
GET
https://crafthead.net/skin/Reply
GET
https://crafthead.net/skin/char
Fetch a player's cape
GET
https://crafthead.net/cape/1ccef50bf6ae4542b1a9d434384a5b25
GET
https://crafthead.net/cape/LadyAgnes
Fetch a player's profile
These endpoints are maintained for compatibility, but for profile lookups, we recommend using PlayerDB instead.
GET
https://crafthead.net/profile/652a2bc4e8cd405db7b698156ee2dc09
GET
https://crafthead.net/profile/Reply