A blazing fast API for Minecraft faces

jomo 5eb5b6fa5e bump version to 2.1.1		5 жил өмнө
images	47a978df6c add image dir to git	9 жил өмнө
lib	424a4ab93b remove notice from website	5 жил өмнө
test	c975cc793b remove cleaner.js	5 жил өмнө
.buildpacks	2873157e97 Add 3d render support	10 жил өмнө
.editorconfig	16fdf8d1ac add editorconfig for .gitignore	10 жил өмнө
.gitignore	305ed1c65f update sponsor info	8 жил өмнө
.travis.yml	8e08e02272 update .travis.yml, package.json and LICENSE	5 жил өмнө
CONTRIBUTING.md	8750b863a8 contributing: add tests for fixed issues	10 жил өмнө
Dockerfile	cdc8c99a22 add Dockerfile, update README	5 жил өмнө
LICENSE	8e08e02272 update .travis.yml, package.json and LICENSE	5 жил өмнө
Procfile	5f0a3dcb63 use postinstall script instead of Procfile	10 жил өмнө
README.md	e6373002a2 update readme	5 жил өмнө
app.json	fe12901f41 update app.json	9 жил өмнө
config.example.js	305ed1c65f update sponsor info	8 жил өмнө
package-lock.json	168457dfd9 update to node 12	5 жил өмнө
package.json	5eb5b6fa5e bump version to 2.1.1	5 жил өмнө
www.js	c975cc793b remove cleaner.js	5 жил өмнө

Crafatar

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

Contributions welcome!

There are usually a few open issues.
We welcome any opinions or advice in discussions as well as pull requests.
Issues tagged with show where we could especially need your help!

Examples

Usage / Documentation

Please visit the website for details.

Contact

You can follow us on twitter
Open an issue on GitHub

Installation

Manual

Install nodejs 12 (LTS)
Install redis-server
Run npm install
If that fails, it's likely because because of node-canvas dependencies. Follow this guide to install them.
Run npm start

Crafatar is now available at http://0.0.0.0:3000.

Docker

docker pull crafatar/crafatar
docker network create crafatar
docker run --net crafatar -d --name redis redis
docker run --net crafatar -v crafatar-images:/crafatar/images -e REDIS_URL=redis://redis -p 3000:3000 crafatar/crafatar

Environment variables

* Use this to avoid issues when you have a persistent redis database but an ephemeral storage

Operational notes

inodes

Crafatar stores a lot of images on disk. For avatars, these are 8×8 px PNG images with an average file size of ~90 bytes. This can lead to issues on file systems such as ext4, which (by default) has a bytes-per-inode ratio of 16Kb. With thousands of files with an average file size below this ratio, you will run out of available inodes before running out of disk space. (Note that this will still be reported as ENOSPC: no space left on device).

Consider using a different file system, changing the inode ratio, or deleting files before the inode limit is reached.

disk space and memory usage

Eventually you will run out of disk space and/or redis will be out of memory. Make sure to delete image files and/or flush redis before this happens.

Tests

npm test

If you want to debug failing tests:

# show logs during tests
env VERBOSE_TEST=true npm test

It can be helpful to monitor redis commands to debug caching errors:

redis-cli monitor

README.md