jsouzaso/minecraft-avatar

PHP script (using GD) to generate avatar or skin from a Minecraft username

Minecraft Avatar

PHP/GD creation of a Minecraft facial avatar or full skin preview based on a given username, constructed from their Minecraft skin.

If username is not found, then it uses the default Steve skin: http://assets.mojang.com/SkinTemplates/steve.png

Facial Avatar

<img src='face.php?u={username}&s={size}&v={view}' />

Query Parameters

Key	Example Value	Default	Description
u	jamiebicknell	steve	Username of Minecraft player
s	8 - 250	48	Desired avatar width and height
v	f, l, r, b front, left, right, back	front	View of facial avatar (optional)

Skin Preview

<img src='skin.php?u={username}&s={size}' />

Query Parameters

Key	Example Value	Default	Description
u	jamiebicknell	steve	Username of Minecraft player
s	40 - 800	250	Desired skin preview width

.Htaccess

If you have mod_rewrite enabled you can view the avatar via cleaner URLs.

Facial Avatar

<img src='http://domain.com/avatar/{username}' />

<img src='http://domain.com/avatar/{username}/{size}' />

<img src='http://domain.com/avatar/{username}/{view}' />

<img src='http://domain.com/avatar/{username}/{size}/{view}' />

Skin Preview

<img src='http://domain.com/skin/{username}' />

<img src='http://domain.com/skin/{username}/{size}' />

Notes

• After changing your skin on Minecraft.net it can take up to 1 hour for the facial avatar or skin preview to show the new skin.
• The skin preview differenciates between the Steve (4 pixel arm width) and Alex skin (3 pixel arm width) by checking the alpha value on the pixel at 54, 20. Therefore, the preview assumes that the skin is well formed and that the unallocated areas are transparent.
• Default skins: Steve and Alex
• Skin templates: Steve and Alex

License

Minecraft Avatar is licensed under the MIT license, see LICENSE.md for details.