jamiebicknell / Minecraft-Avatar

PHP script (using GD) to generate avatar or skin from a Minecraft username
MIT License
116 stars 34 forks source link
avatar gd minecraft php skin

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

License

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