PHP script (using GD) to generate avatar or skin from a Minecraft username
PHP ApacheConf
Switch branches/tags
Latest commit b4a1d83 Jun 6, 2016 @jamiebicknell Updated asset URLs
Permalink
Failed to load latest commit information.
.htaccess Closes #5 by adding ability to specify view Sep 8, 2014
LICENSE.md Updated asset URLs Jun 6, 2016
README.md Updated asset URLs Jun 6, 2016
composer.json Beautified JSON Jun 19, 2014
face.php Updated asset URLs Jun 6, 2016
skin.php Updated asset URLs Jun 6, 2016

README.md

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

Steve Avatar Alex 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

Steve Skin

Alex Skin

<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.