extends layout block content .container(style= "margin-top: 70px;") .row .col-md-10 a(id="crafatar", class="anchor") a(href="#crafatar") h1 Crafatar hr p Welcome to Crafatar, an API for Minecraft's faces! hr a(id="documentation", class="anchor") a(href="#documentation") h2 Documentation a(id="avatars", class="anchor") a(href="#avatars") h3 Avatars p | Replace mark.green id | with a Mojang UUID or username to get the related head. All images are PNGs. .code | #{domain}/avatars/ mark.green id | a(id="avatar-parameters", class="anchor") a(href="#avatar-parameters") h3 Avatar Parameters h4 size p | The size of the image in pixels, #{config.min_size} - #{config.max_size}.
| Default is #{config.default_size}. h4 default p | The image to be served when the id has no skin (404).
| Valid options are a(href="/avatars/00000000000000000000000000000000?default=steve") steve | , a(href="/avatars/00000000000000000000000000000000?default=alex") alex | , or a custom URL.
| The standard value is calculated based on the UUID (even = alex, odd = steve). Usernames always default to steve. h4 helm p | Apply the "second" (hat) layer to the avatar.
| The content of this parameter is ignored.
| If you want to get the face only, remove the parameter. a(id="skins", class="anchor") a(href="#skins") h3 Skins p | You can also get the full skin file of a player.
| Replace mark.green id | 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. .code | #{domain}/skins/ mark.green id a(id="skin-parameters", class="anchor") a(href="#skin-parameters") h3 Skin Parameters h4 default p | Same as the default for avatars. a(id="renders", class="anchor") a(href="#renders") h3 3D Renders p | Crafatar also provides support for 3D renders of Minecraft skins.
| Please note that this feature is currently beta!
| Replace mark.green id | 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. .code | #{domain}/renders/head/ mark.green id | The body render returns a render of the entire skin. .code | #{domain}/renders/body/ mark.green id a(id="render-parameters", class="anchor") a(href="#render-parameters") h3 Render Parameters h4 scale p | The scale factor of the image #{config.min_scale} - #{config.max_scale}.
| Default is #{config.default_scale}. The actual size differs between the type of render. h4 helm p | Same as the helm for avatars, but it does not stand out (as it does ingame). h4 default p | Same as the default for avatars. a(id="http-headers", class="anchor") a(href="#http-headers") h3 HTTP headers p | Responses come with these HTTP headers, useful for debugging.
| Please note that these headers are cached by CloudFlare (CF-Cache-Status: HIT). a(id="response-time", class="anchor") a(href="#response-time") h4 Response-Time p The time, in milliseconds, it took Crafatar to process the request. a(id="x-storage-type", class="anchor") a(href="#x-storage-type") h4 X-Storage-Type ul li none: No external requests. Cached: User has no skin. li cached: No external requests. Skin cached and stored locally. li | checked: 1 external request. Skin cached, checked for updates, no skin downloaded.
| This happens either when the user removed their skin or when it didn't change. li downloaded: 2 external requests. Skin changed or unknown, downloaded. li | error: This can happen, for example, when Mojang's servers are down.
| If possible, an outdated image is served instead. a(id="about-usernames", class="anchor") a(href="#about-usernames") h3 About usernames p | 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.
| Malformed usernames are rejected. a(id="about-uuids", class="anchor") a(href="#about-uuids") h3 About UUIDs p | UUIDs may use the blank or dashed format.
| Malformed UUIDs are rejected. a(id="about-caching", class="anchor") a(href="#about-caching") h3 About caching p | Crafatar caches skins for #{config.local_cache_time/60} minutes before checking for skin changes.
| Images are cached in your browser for #{config.browser_cache_time/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. a(id="examples", class="anchor") a(href="#examples") h3 Examples h4 Avatars p Jeb's avatar by username, default size .code #{domain}/avatars/jeb_ p Jeb's avatar by UUID, default size .code #{domain}/avatars/853c80ef3c3749fdaa49938b674adae6 p Jeb's avatar, 64 × 64 .code #{domain}/avatars/853c80ef3c3749fdaa49938b674adae6?size=64 p Jeb's avatar, 64 × 64, with helmet .code #{domain}/avatars/853c80ef3c3749fdaa49938b674adae6?size=64&helm p Jeb's avatar, or fall back to steve .code #{domain}/avatars/853c80ef3c3749fdaa49938b674adae6?default=steve p | Jeb's avatar, or fall back to a(href="https://i.imgur.com/ozszMZV.png") a custom image .code #{domain}/avatars/853c80ef3c3749fdaa49938b674adae6?default=https%3A%2F%2Fi.imgur.com%2FozszMZV.png h4 Skins p Jeb's skin .code #{domain}/skins/853c80ef3c3749fdaa49938b674adae6 p Jeb's skin by username .code #{domain}/skins/jeb_ p Render of Jeb's Head h4 Renders .code #{domain}/renders/head/853c80ef3c3749fdaa49938b674adae6 p Render of Jeb's Body, with helmet, by username .code #{domain}/renders/body/jeb_?helm .col-md-2.center .sideface.redstone_sheep(title="redstone_sheep") .sideface.Jake0oo0(title="Jake0oo0") .sideface.Notch(title="Notch") .sideface.sk89q(title="sk89q") .sideface.md_5(title="md_5")