View on GitHub

NitroCraft

Minecraft avatars, skins, and renders at Nitro speed.

API calls served 7,030
Server List Builder Server Browser API Docs
Support NitroCraft: Support via GitHub Sponsors

Support tiers: $5 Supporter, $10 Builder, and $20 Sponsor Spotlight (includes homepage + README sponsor placement).

Try it

Enter a Mojang UUID or username, then press Enter to update all previews.

Avatars

avatar
https://nitrocraft.uk/avatars/uuid

Accepted modifiers: size, overlay, default.

Head Renders

head
https://nitrocraft.uk/renders/head/uuid

Accepted modifiers: scale, overlay, default.

Body Renders

body
https://nitrocraft.uk/renders/body/uuid

Accepted modifiers: scale, overlay, default.

Skins

skin
https://nitrocraft.uk/skins/uuid

Accepted modifiers: default.

Capes

cape
https://nitrocraft.uk/capes/uuid

Accepted modifiers: default.

Toolkit Extras

Additional endpoints powered by minecraft-toolkit:

Credit to 26bz for creating minecraft-toolkit.

  • https://nitrocraft.uk/players/{uuid-or-username} - resolved player identity + textures
  • https://nitrocraft.uk/players/{uuid-or-username}/profile - Mojang profile payload
  • https://nitrocraft.uk/players/{uuid-or-username}/history - name history
  • https://nitrocraft.uk/players/{uuid-or-username}/skin-metadata?dominantColor=true&x=8&y=8&width=8&height=8
  • https://nitrocraft.uk/status/java?address=mc.hypixel.net - Java status ping
  • https://nitrocraft.uk/status/bedrock?address=play.example.net&port=19132 - Bedrock status ping
  • https://nitrocraft.uk/status/server?address=mc.hypixel.net&edition=auto - auto status probe
  • https://nitrocraft.uk/status/browser?address=mc.hypixel.net&address=play.cubecraft.net - batch status probe
  • https://nitrocraft.uk/status/browser?source=example-directory - probe from configured source feeds
  • https://nitrocraft.uk/status/icon?address=mc.hypixel.net - Java server icon
  • https://nitrocraft.uk/format/html?text=%C2%A7aWelcome%20%C2%A7lHero - formatting to HTML
  • https://nitrocraft.uk/format/strip?text=%C2%A7aWelcome%20%C2%A7lHero - strip formatting codes
  • https://nitrocraft.uk/format/css - CSS classes for formatting mode
  • https://nitrocraft.uk/tools/server-list - live Minecraft server-list entry simulator
  • https://nitrocraft.uk/tools/server-browser - multi-server browser and status comparison
  • https://nitrocraft.uk/docs - interactive API reference (Scalar)
  • https://nitrocraft.uk/metrics - Prometheus metrics endpoint

SDK Snippet Generator

Pick an endpoint and language to generate a starter request snippet. Interactive docs are available at https://nitrocraft.uk/docs.

https://nitrocraft.uk/avatars/ae795aa86327408e92ab25c8a59f3ba1?size=160&overlay

Meta

You can append .png or any other extension to the URL path if you like, but all image responses are PNG.

Attribution

Attribution is not required, but it is encouraged.
If you want to show support for this service, place a notice like: Thank you to <a href="https://nitrocraft.uk">NitroCraft</a> for providing avatars.

URL Parameters

You can tweak images using query string parameters.
Example: https://nitrocraft.uk/avatars/853c80ef3c3749fdaa49938b674adae6?size=4&default=MHF_Steve&overlay

  • size: Avatar size in pixels. 1 - 512
  • scale: Render scale factor. 1 - 10
  • overlay: Applies the avatar/render overlay. Presence implies true. This option was previously known as helm.
  • default: Fallback when the requested image cannot be served. Accepts a custom URL, any UUID, or MHF_Steve/MHF_Alex. Default is selected from Minecraft's default skin for the requested UUID.

About UUIDs

UUIDs may be any valid Mojang UUID in dashed or undashed format.

Malformed UUIDs are rejected.

About Usernames

Core image endpoints (/avatars, /skins, /capes, /renders) require UUIDs.

The Try It box and /players/{uuid-or-username} can resolve usernames to UUID first.

About Caching

NitroCraft checks for skin updates every 20 minutes.
Images are also cached in your browser for 60 minutes unless you clear your browser cache.
In addition, Cloudflare may cache images as long as your browser would.

After changing your Minecraft skin, you can try clearing your browser cache to see the change faster.

CORS

NitroCraft supports Cross-Origin Resource Sharing, so you can make AJAX requests from other sites.

HTTP Headers

NitroCraft replies with 200 OK when the requested user's skin/cape is found. This is also used in some rare cases when Mojang has issues and NitroCraft serves a stale cached image. 500 Server Error is used when no skin/cape was found because of Mojang or NitroCraft server issues.

Responses include useful debugging headers.
Please note that these headers may be cached by Cloudflare.

  • Warning: Set when cached content is used after an error.
    • 110 NitroCraft "Response is Stale"
    • 111 NitroCraft "Revalidation Failed"
  • X-Storage-Type: Details about cache/storage behavior.
    • none: No external requests; player has no skin (cached)
    • cached: No external requests; skin cached
    • checked: Requested skin details and kept cached skin
    • downloaded: Requested skin details and downloaded fresh skin
    • server error: Mojang or NitroCraft server issue
    • server error;cached: Server issue but cached skin was available
    • user error: Invalid request data (for example malformed UUID)
  • X-Request-ID: Internal ID for your request.
  • Response-Time: Request processing time in milliseconds.