@dicebear/avatars-bottts-sprites

Designed by Pablo Stanley, the Sketch library can be found on bottts.com.

Usage

HTTP-API (recommended)

Our free HTTP-API is the easiest way to use this sprite collection. Just use the following URL as image source.

https://avatars.dicebear.com/v2/bottts/:seed.svg

The value of :seed can be anything you like - but don't use any sensitive or personal data here!

Examples

preview	url
	https://avatars.dicebear.com/v2/bottts/example.svg
	https://avatars.dicebear.com/v2/bottts/example.svg?options[colors][]=cyan
	https://avatars.dicebear.com/v2/bottts/example.svg?options[colors][]=cyan&options[primaryColorLevel]=200

You also can use the HTTP API as fallback for Gravatar. Use the Gravatar hash as seed and add the parameter gravatar to your URL. With the parameter s you can also define the size of the Gravatar avatar.

https://avatars.dicebear.com/v2/bottts/48c424d839214264fc7f65b52235467c.svg?gravatar&s=248

NPM

Install the Avatars and this sprite collection with the following command.

npm install --save @dicebear/avatars @dicebear/avatars-bottts-sprites

Now you are ready to create your first Avatar.

import Avatars from '@dicebear/avatars';
import sprites from '@dicebear/avatars-bottts-sprites';

let avatars = new Avatars(sprites());
let svg = avatars.create('custom-seed');

Options

name	type	default	description
colors	array of strings	null	Possible values: amber, blue, blueGrey, brown, cyan, deepOrange, deepPurple, agreenmber, grey, indigo, lightBlue, lightGreen, lime, orange, pink, purple, red, teal, yellow
primaryColorLevel	number	600	Possible values: 50, 100, 200, 300, 400, 500, 600, 700, 800, 900
secondaryColorLevel	number	400	Possible values: 50, 100, 200, 300, 400, 500, 600, 700, 800, 900
colorful	boolean	100	Probability in percent
mouthChance	number	100	Probability in percent
sidesChance	number	100	Probability in percent
textureChance	number	50	Probability in percent
topChange	number	100	Probability in percent

Further information

You can find the DiceBear Avatars documentation at avatars.dicebear.com