Docs
Open Lodol
DocumentationIntegrationsAPI

Crafatar

App · 6 actions

Get Minecraft players' faces, 3D head and body renders, skins and capes from Crafatar, by username or UUID. Every picture comes with a link ready for a chat message, a website or an email, and can be saved as a file to attach. No account or API key required.

Actions

ActionWhat it does
Get a 3D body renderGet a 3D picture of a Minecraft player's whole character, head to feet, from their username or UUID.
Get a 3D head renderGet a 3D picture of a Minecraft player's head, seen from the front at an angle, from their username or UUID.
Get a player's capeCheck whether a Minecraft player has a cape and, if they do, get its texture as a PNG, from their username or UUID.
Get a player's faceGet a Minecraft player's face as a flat, square picture, from their username or UUID, at the size you choose.
Get a player's skinGet a Minecraft player's skin file: the flat texture the game wraps round their character, as a PNG you can download, back up or reuse.
Look up a playerFind a Minecraft player by username or UUID and get their exact name, their permanent UUID, and links to their face, 3D head and body renders, skin and cape.

Get a 3D body render

Get a 3D picture of a Minecraft player's whole character, head to feet, from their username or UUID. Choose how big to draw it, and save it as a file if you want. No API key required.

Inputs

PlayerplayertextRequired
The player's Minecraft username, like jeb_, or their UUID, like 853c80ef-3c37-49fd-aa49-938b674adae6. Usernames aren't case-sensitive.
Scalescalenumber
How big to draw the render, from 1 (smallest) to 10 (largest). 6 by default. Each step up adds the same amount: a head at scale 6 is about 120 pixels wide, at 10 about 200.From 1 to 10. Default: 6.
Show hat and outer layeroverlaytrue/false
On by default, so the player looks the way they do in the game. Turn it off to show the base skin without hats, hair, jackets or other outer-layer details.Default: true.
If the skin can't be loaded, showdefault_skintext
Which default skin to draw when the player's own skin can't be loaded. By default, the one Minecraft itself would give this player.One of: auto (Minecraft's default for this player), steve, alex. Default: auto.
Also save the picture as a filesave_as_filetrue/false
Off by default, because the link is all a chat message, an email or a web page needs. Turn it on when a later step needs the file itself: attaching it to an email, uploading it to storage, or posting it as a file.Default: false.

Outputs

content_typetext
The saved file's type (image/png), or '' when not saved.
document_reftext
The saved file's document reference, or '' when not saved.
documentslist
The saved picture as a document, ready to attach to a later step. Empty when it was not saved.
file_size_bytesnumber
The saved file's size in bytes, or 0 when not saved.
file_urltext
A URL that serves the saved file, or '' when not saved.
heightnumber
The picture's height in pixels.
image_tagtext
The same link as an HTML <img> tag, with alt text and size, for a step that writes an email or a page.
playerobject
The player the picture is of.
saved_as_filetrue/false
True when the picture was also saved as a file (Also save the picture as a file). The file fields below are empty otherwise.
shows_default_skintrue/false
True when Crafatar couldn't load the player's own skin just now and drew the default skin (Steve or Alex) instead. Usually temporary: try again later for the real skin.
urltext
A link to the picture on Crafatar, as a PNG. It can go straight into a chat message, an email or a web page, and always shows the player's current skin.
widthnumber
The picture's width in pixels.
Example output
{
  "content_type": "",
  "document_ref": "",
  "documents": [],
  "file_size_bytes": 0,
  "file_url": "",
  "height": 270,
  "image_tag": "<img src=\"https://crafatar.com/renders/body/853c80ef3c3749fdaa49938b674adae6?scale=6&amp;overlay\" alt=\"3D render of jeb_&#x27;s Minecraft body\" width=\"120\" height=\"270\">",
  "player": {
    "name": "jeb_",
    "uuid": "853c80ef3c3749fdaa49938b674adae6"
  },
  "saved_as_file": false,
  "shows_default_skin": false,
  "url": "https://crafatar.com/renders/body/853c80ef3c3749fdaa49938b674adae6?scale=6&overlay",
  "width": 120
}

Get a 3D head render

Get a 3D picture of a Minecraft player's head, seen from the front at an angle, from their username or UUID. Choose how big to draw it, and save it as a file if you want. No API key required.

Inputs

PlayerplayertextRequired
The player's Minecraft username, like jeb_, or their UUID, like 853c80ef-3c37-49fd-aa49-938b674adae6. Usernames aren't case-sensitive.
Scalescalenumber
How big to draw the render, from 1 (smallest) to 10 (largest). 6 by default. Each step up adds the same amount: a head at scale 6 is about 120 pixels wide, at 10 about 200.From 1 to 10. Default: 6.
Show hat and outer layeroverlaytrue/false
On by default, so the player looks the way they do in the game. Turn it off to show the base skin without hats, hair, jackets or other outer-layer details.Default: true.
If the skin can't be loaded, showdefault_skintext
Which default skin to draw when the player's own skin can't be loaded. By default, the one Minecraft itself would give this player.One of: auto (Minecraft's default for this player), steve, alex. Default: auto.
Also save the picture as a filesave_as_filetrue/false
Off by default, because the link is all a chat message, an email or a web page needs. Turn it on when a later step needs the file itself: attaching it to an email, uploading it to storage, or posting it as a file.Default: false.

Outputs

content_typetext
The saved file's type (image/png), or '' when not saved.
document_reftext
The saved file's document reference, or '' when not saved.
documentslist
The saved picture as a document, ready to attach to a later step. Empty when it was not saved.
file_size_bytesnumber
The saved file's size in bytes, or 0 when not saved.
file_urltext
A URL that serves the saved file, or '' when not saved.
heightnumber
The picture's height in pixels.
image_tagtext
The same link as an HTML <img> tag, with alt text and size, for a step that writes an email or a page.
playerobject
The player the picture is of.
saved_as_filetrue/false
True when the picture was also saved as a file (Also save the picture as a file). The file fields below are empty otherwise.
shows_default_skintrue/false
True when Crafatar couldn't load the player's own skin just now and drew the default skin (Steve or Alex) instead. Usually temporary: try again later for the real skin.
urltext
A link to the picture on Crafatar, as a PNG. It can go straight into a chat message, an email or a web page, and always shows the player's current skin.
widthnumber
The picture's width in pixels.
Example output
{
  "content_type": "",
  "document_ref": "",
  "documents": [],
  "file_size_bytes": 0,
  "file_url": "",
  "height": 111,
  "image_tag": "<img src=\"https://crafatar.com/renders/head/853c80ef3c3749fdaa49938b674adae6?scale=6&amp;overlay\" alt=\"3D render of jeb_&#x27;s Minecraft head\" width=\"120\" height=\"111\">",
  "player": {
    "name": "jeb_",
    "uuid": "853c80ef3c3749fdaa49938b674adae6"
  },
  "saved_as_file": false,
  "shows_default_skin": false,
  "url": "https://crafatar.com/renders/head/853c80ef3c3749fdaa49938b674adae6?scale=6&overlay",
  "width": 120
}

Get a player's cape

Check whether a Minecraft player has a cape and, if they do, get its texture as a PNG, from their username or UUID. Most players have no cape, which is reported rather than treated as an error. No API key required.

Inputs

PlayerplayertextRequired
The player's Minecraft username, like jeb_, or their UUID, like 853c80ef-3c37-49fd-aa49-938b674adae6. Usernames aren't case-sensitive.
Also save the picture as a filesave_as_filetrue/false
Off by default, because the link is all a chat message, an email or a web page needs. Turn it on when a later step needs the file itself: attaching it to an email, uploading it to storage, or posting it as a file.Default: false.

Outputs

content_typetext
The saved file's type (image/png), or '' when not saved.
document_reftext
The saved file's document reference, or '' when not saved.
documentslist
The saved picture as a document, ready to attach to a later step. Empty when it was not saved.
file_size_bytesnumber
The saved file's size in bytes, or 0 when not saved.
file_urltext
A URL that serves the saved file, or '' when not saved.
has_capetrue/false
True when the player has a cape. False when they have none, or Crafatar couldn't load it just now; the other fields are then empty.
heightnumber
The cape texture's height in pixels, or 0 with no cape.
image_tagtext
The same link as an HTML <img> tag, or '' with no cape.
playerobject
The player the picture is of.
saved_as_filetrue/false
True when the picture was also saved as a file (Also save the picture as a file). The file fields below are empty otherwise.
urltext
A link to the cape texture as a PNG, or '' with no cape.
widthnumber
The cape texture's width in pixels, or 0 with no cape.
Example output
{
  "content_type": "",
  "document_ref": "",
  "documents": [],
  "file_size_bytes": 0,
  "file_url": "",
  "has_cape": true,
  "height": 32,
  "image_tag": "<img src=\"https://crafatar.com/capes/853c80ef3c3749fdaa49938b674adae6\" alt=\"jeb_&#x27;s Minecraft cape\" width=\"64\" height=\"32\">",
  "player": {
    "name": "jeb_",
    "uuid": "853c80ef3c3749fdaa49938b674adae6"
  },
  "saved_as_file": false,
  "url": "https://crafatar.com/capes/853c80ef3c3749fdaa49938b674adae6",
  "width": 64
}

Get a player's face

Get a Minecraft player's face as a flat, square picture, from their username or UUID, at the size you choose. Ready to use as a profile picture in chat, on a website or in an email, or to save as a file. No API key required.

Inputs

PlayerplayertextRequired
The player's Minecraft username, like jeb_, or their UUID, like 853c80ef-3c37-49fd-aa49-938b674adae6. Usernames aren't case-sensitive.
Size (pixels)sizenumber
How wide and tall the face is, from 1 to 512 pixels. 160 by default.From 1 to 512. Default: 160.
Show hat and outer layeroverlaytrue/false
On by default, so the player looks the way they do in the game. Turn it off to show the base skin without hats, hair, jackets or other outer-layer details.Default: true.
If the skin can't be loaded, showdefault_skintext
Which default skin to draw when the player's own skin can't be loaded. By default, the one Minecraft itself would give this player.One of: auto (Minecraft's default for this player), steve, alex. Default: auto.
Also save the picture as a filesave_as_filetrue/false
Off by default, because the link is all a chat message, an email or a web page needs. Turn it on when a later step needs the file itself: attaching it to an email, uploading it to storage, or posting it as a file.Default: false.

Outputs

content_typetext
The saved file's type (image/png), or '' when not saved.
document_reftext
The saved file's document reference, or '' when not saved.
documentslist
The saved picture as a document, ready to attach to a later step. Empty when it was not saved.
file_size_bytesnumber
The saved file's size in bytes, or 0 when not saved.
file_urltext
A URL that serves the saved file, or '' when not saved.
heightnumber
The picture's height in pixels.
image_tagtext
The same link as an HTML <img> tag, with alt text and size, for a step that writes an email or a page.
playerobject
The player the picture is of.
saved_as_filetrue/false
True when the picture was also saved as a file (Also save the picture as a file). The file fields below are empty otherwise.
shows_default_skintrue/false
True when Crafatar couldn't load the player's own skin just now and drew the default skin (Steve or Alex) instead. Usually temporary: try again later for the real skin.
urltext
A link to the picture on Crafatar, as a PNG. It can go straight into a chat message, an email or a web page, and always shows the player's current skin.
widthnumber
The picture's width in pixels.
Example output
{
  "content_type": "",
  "document_ref": "",
  "documents": [],
  "file_size_bytes": 0,
  "file_url": "",
  "height": 160,
  "image_tag": "<img src=\"https://crafatar.com/avatars/853c80ef3c3749fdaa49938b674adae6?size=160&amp;overlay\" alt=\"jeb_&#x27;s Minecraft face\" width=\"160\" height=\"160\">",
  "player": {
    "name": "jeb_",
    "uuid": "853c80ef3c3749fdaa49938b674adae6"
  },
  "saved_as_file": false,
  "shows_default_skin": false,
  "url": "https://crafatar.com/avatars/853c80ef3c3749fdaa49938b674adae6?size=160&overlay",
  "width": 160
}

Get a player's skin

Get a Minecraft player's skin file: the flat texture the game wraps round their character, as a PNG you can download, back up or reuse. From their username or UUID. No API key required.

Inputs

PlayerplayertextRequired
The player's Minecraft username, like jeb_, or their UUID, like 853c80ef-3c37-49fd-aa49-938b674adae6. Usernames aren't case-sensitive.
If the skin can't be loaded, showdefault_skintext
Which default skin to draw when the player's own skin can't be loaded. By default, the one Minecraft itself would give this player.One of: auto (Minecraft's default for this player), steve, alex. Default: auto.
Also save the picture as a filesave_as_filetrue/false
Off by default, because the link is all a chat message, an email or a web page needs. Turn it on when a later step needs the file itself: attaching it to an email, uploading it to storage, or posting it as a file.Default: false.

Outputs

content_typetext
The saved file's type (image/png), or '' when not saved.
document_reftext
The saved file's document reference, or '' when not saved.
documentslist
The saved picture as a document, ready to attach to a later step. Empty when it was not saved.
file_size_bytesnumber
The saved file's size in bytes, or 0 when not saved.
file_urltext
A URL that serves the saved file, or '' when not saved.
heightnumber
The picture's height in pixels.
image_tagtext
The same link as an HTML <img> tag, with alt text and size, for a step that writes an email or a page.
playerobject
The player the picture is of.
saved_as_filetrue/false
True when the picture was also saved as a file (Also save the picture as a file). The file fields below are empty otherwise.
shows_default_skintrue/false
True when Crafatar couldn't load the player's own skin just now and drew the default skin (Steve or Alex) instead. Usually temporary: try again later for the real skin.
urltext
A link to the picture on Crafatar, as a PNG. It can go straight into a chat message, an email or a web page, and always shows the player's current skin.
widthnumber
The picture's width in pixels.
Example output
{
  "content_type": "",
  "document_ref": "",
  "documents": [],
  "file_size_bytes": 0,
  "file_url": "",
  "height": 32,
  "image_tag": "<img src=\"https://crafatar.com/skins/853c80ef3c3749fdaa49938b674adae6\" alt=\"jeb_&#x27;s Minecraft skin\" width=\"64\" height=\"32\">",
  "player": {
    "name": "jeb_",
    "uuid": "853c80ef3c3749fdaa49938b674adae6"
  },
  "saved_as_file": false,
  "shows_default_skin": false,
  "url": "https://crafatar.com/skins/853c80ef3c3749fdaa49938b674adae6",
  "width": 64
}

Look up a player

Find a Minecraft player by username or UUID and get their exact name, their permanent UUID, and links to their face, 3D head and body renders, skin and cape. No API key required.

Inputs

PlayerplayertextRequired
The player's Minecraft username, like jeb_, or their UUID, like 853c80ef-3c37-49fd-aa49-938b674adae6. Usernames aren't case-sensitive.

Outputs

body_render_urltext
A link to a 3D render of their body.
cape_urltext
A link to their cape. It shows nothing when they have no cape; use Get a player's cape to check.
face_urltext
A link to the player's face, 160 pixels.
head_render_urltext
A link to a 3D render of their head.
nametext
The player's Minecraft username, spelled the way Minecraft spells it, e.g. 'jeb_'.
skin_urltext
A link to their skin file.
uuidtext
The player's permanent Minecraft id (UUID), 32 characters with no dashes, e.g. '853c80ef3c3749fdaa49938b674adae6'. It stays the same when they change their name.
uuid_dashedtext
The same UUID with dashes, the way most Minecraft tools show it, e.g. '853c80ef-3c37-49fd-aa49-938b674adae6'.
Example output
{
  "body_render_url": "https://crafatar.com/renders/body/853c80ef3c3749fdaa49938b674adae6?overlay",
  "cape_url": "https://crafatar.com/capes/853c80ef3c3749fdaa49938b674adae6",
  "face_url": "https://crafatar.com/avatars/853c80ef3c3749fdaa49938b674adae6?overlay",
  "head_render_url": "https://crafatar.com/renders/head/853c80ef3c3749fdaa49938b674adae6?overlay",
  "name": "jeb_",
  "skin_url": "https://crafatar.com/skins/853c80ef3c3749fdaa49938b674adae6",
  "uuid": "853c80ef3c3749fdaa49938b674adae6",
  "uuid_dashed": "853c80ef-3c37-49fd-aa49-938b674adae6"
}

CourtListener

Previous Page

crates.io

Next Page

On this page

ActionsGet a 3D body renderGet a 3D head renderGet a player's capeGet a player's faceGet a player's skinLook up a player