A blazing fast API for Minecraft faces

jomo 7520957b93 Use path.join() instead of + to create paths преди 10 години
images 3def0910bc Network rewrite/major cleanup, major caching changes, etc преди 10 години
lib 48c2a55995 cache_err wouldn't be defined преди 10 години
logs abeb6116e4 Use forever.js преди 10 години
public a294a7c57f add 128px logo, polish README преди 10 години
routes d4b0a335c4 return 200 for default avatars/renders/skins, fixes #111 преди 10 години
test d4b0a335c4 return 200 for default avatars/renders/skins, fixes #111 преди 10 години
views d4b0a335c4 return 200 for default avatars/renders/skins, fixes #111 преди 10 години
.buildpacks 2873157e97 Add 3d render support преди 10 години
.editorconfig 16fdf8d1ac add editorconfig for .gitignore преди 10 години
.gitignore f984b20344 mv modules/ lib/ преди 10 години
.travis.yml 0326000b42 iojs v1.6 преди 10 години
CONTRIBUTING.md 8750b863a8 contributing: add tests for fixed issues преди 10 години
LICENSE e8727a0d0d Happy New Year! :tada: :tada: преди 10 години
Procfile 5f0a3dcb63 use postinstall script instead of Procfile преди 10 години
README.md a294a7c57f add 128px logo, polish README преди 10 години
app.json 27aa12a76b more crafatar/crafatar changes преди 10 години
package.json 2780ae05d3 move www.js to lib преди 10 години
server.js 7520957b93 Use path.join() instead of + to create paths преди 10 години

README.md

Crafatar travis Coverage Status Code Climate

dependency status devDependency status docs status

Crafatar serves Minecraft avatars based on the skin for use in external applications. Inspired by Gravatar (hence the name) and Minotar.

Image manipulation is done by lwip. 3D renders are created with node-canvas, based on math by confuser.

Examples

jomo's avatar Jake_0's avatar Notch's avatar sk89q's avatar
jomo's 3d head Jake_0's 3d head Notch's 3d head sk89q's 3d head
jomo's 3d body Jake_0's 3d body Notch's 3d body sk89q's 3d body
jomo's skin Jake_0's skin Notch's skin sk89q's skin

Usage / Documentation

Please visit the website for details.

Contact

Installation

Heroku

Deploy

Dokku

  1. Install the dokku-redis plugin
  2. dokku redis:start
  3. You also might want to use docker-options for persistent storage:

    -v /var/lib/crafatar/images:/app/images
    -v /var/log/crafatar:/app/logs
    
  4. Deploy with ENV config:

    PORT=5000
    BIND=0.0.0.0
    

Local

Tests

npm test

If you want to debug failing tests, you can set the env

VERBOSE_TEST=true

To debug caching, it can be helpful to monitor redis commands while tests are running:

redis-cli monitor