Skip to content

Eirbware/mc-skin-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mc-skin-api

Minecraft skin API to add accessories to skins.

Running the API

npm run build
npm start # or PORT=<PORT> npm start, default port is 3000

All accessories should be placed in the accessories/ folder.

Using the API

Check out the following links, where PLAYER is the player's name:

The last one requires the url query parameter to be encoded. You can use the following javascript code to encode it:

encodeURIComponent('http://localhost:3000/skin/PLAYER')

Or in Java:

URLEncoder.encode("http://localhost:3000/skin/PLAYER", StandardCharsets.UTF_8.toString());

This API should work no matter what the player's skin is (64x32 or 64x64, slim or wide arms), as long as it's a valid skin. The accessories adapt to the skin's dimensions, see Python scripts for more details.

Result, if the player has a the default Steve skin, with /skin/PLAYER:

Default Steve skin Steve with a jacket

The skin is made with a first layer and an overlay. When the accessory has pixels on the first layer and the skin has pixels on the overlay, the skin pixels on the overlay will be hidden to show the accessory if hide_overlay is set to true (default behavior).

Be careful when you use a generated skin, make sure to choose the right dimensions on the launcher (slim or wide arms). If you're not sure, use the scripts/is_slim.py script to check the skin type.

Modifying the accessories

See the Python scripts to modify the accessories or get more details on how conversions are made.

See also

Check the following links for some accessories:

Accessories made by:

About

Minecraft skin API to add accessories to skins.

Resources

Stars

Watchers

Forks

Releases

No releases published