A Minotar is a global avatar that pulls your head off your Minecraft.net skin, and allows it for use on several thousand sites - anywhere you can embed an image. See some uses below.
Unlike the PayPal API, we keep things nice and simple. For basic usage just provide a username:
You can also set a size. We use pixels and we only need the width. Just add it to the end.
And since some services require an extension we've added simple support for it. Just add .png to the end.
Sometimes you want to display a helm too, that's fine with this endpoint.
You can even use Minotar's API to get a users skin. We're adding more soon!
You can also set the browser to download the image by using:
Need Steve? Use "char" as the username:
Installation is simple - however it requires an installation of Go. Follow the instructions below for a comprehensive, step by step installation.
$ git clone https://github.com/minotar/minotar $ cd minotar $ export GOPATH=`pwd` $ go get $ go build
After you run
go build, golang should automatically generate you an executable file (named
minotar). Executing the file is simple: simply run:
There you have it! Go visit your installation at your-ip:9999 to view it in action.
We use a couple of headers to help in understanding how something is served, here they are:
- returns: processed
- explain: if Minotar processed your avatar
- returns: ok,failed
- explain: ok on successful GET from s3, failed on failed GET from s3
- returns: fetch time, process time, resize time, whole process
- example: 48+0+4=52
Big thanks to lukegb for porting the old version of this script from PHP to Go.