Combines multiple Minecraft skins into one single skin.
Requires the opencv-python package to run. To setup using pip3:
$ git clone https://github.com/PotatoMaster101/skinmash
$ cd skinmash
$ pip3 install -r requirements.txt
Run with python 3:
$ python3 skinmash.py [-h] [-o OUTPUT] [config]
If a config file is specified, then the script will run the lines in the config file. See Config File Format for more information.
If no config file is provided, then the script will run in interactive mode. Interactive mode is exactly the same, but instead of reading from a file the script will read from stdin instead. Use the command exit or quit to exit interactive mode (which will also save the current output image). See Example for examples.
Each line of the config file will specify the part of the body and the skin image to use for that part of the body, using the syntax <body part> <username>. For example, by specifying head PotatoMaster101, the output skin will have the head portion of PotatoMaster101's skin. The <username> part can also be a local file (if it ends with .png). The mostly used body parts are:
all- entire skin for 64x64 skins (maps toall32on 32x64 skin)all32- entire skin for 32x64 skinshead- headhat- hatrleg- right legbody- main bodyrarm- right armrleg2- right leg jacket (not available for 32x64 skins)jacket- main body jacket (not available for 32x64 skins)rarm2- right arm jacket (not available for 32x64 skins)lleg2- left leg jacket (not available for 32x64 skins)lleg- left leg (maps torlegfor 32x64 skins)larm- left arm (maps torarmfor 32x64 skins)larm2- left arm jacket (not available for 32x64 skins)
Below is an example of a config file:
all PotatoMaster101
head skins/Wikbix.png
hat skins/Wikbix.png
lleg Llaqw
lleg2 Llaqw
rleg Llaqw
rleg2 Llaqw
larm skins/_QueenKathleen_.png
larm2 skins/_QueenKathleen_.png
rarm skins/_QueenKathleen_.png
rarm2 skins/_QueenKathleen_.png
Below are some lesser used, but more specific body parts:
head_top- top of the headhead_bottom- bottom of the headhead_right- right of the headhead_front- front of the headhead_left- left of the headhead_back- back of the headhat_top- top of the hathat_bottom- bottom of the hathat_right- right of the hathat_front- front of the hathat_left- left of the hathat_back- back of the hatrleg_top- top of right legrleg_bottom- bottom of right legbody_top- top of main bodybody_bottom- bottom of main bodyrarm_top- top of right armrarm_bottom- bottom of right armrleg_right- right of right legrleg_front- front of right legrleg_left- left of right legrleg_back- back of right legbody_right- right of main bodybody_front- front of main bodybody_back- back of main bodybody_left- left of main bodyrarm_right- right of right armrarm_front- front of right armrarm_left- left of right armrarm_back- back of right armrleg2_top- top of right leg jacket (not available for 32x64 skins)rleg2_bottom- bottom of right let jacket (not available for 32x64 skins)jacket_top- top of main jacket (not available for 32x64 skins)jacket_bottom- bottom of main jacket (not available for 32x64 skins)rarm2_top- top of right arm jacket (not available for 32x64 skins)rarm2_bottom- bottom of right arm jacket (not available for 32x64 skins)rleg2_right- right of right leg jacket (not available for 32x64 skins)rleg2_front- front of right leg jacket (not available for 32x64 skins)rleg2_left- left of right leg jacket (not available for 32x64 skins)rleg2_back- back of right leg jacket (not available for 32x64 skins)jacket_right- right of main jacket (not available for 32x64 skins)jacket_front- front of main jacket (not available for 32x64 skins)jacket_back- back of main jacket (not available for 32x64 skins)jacket_left- left of main jacket (not available for 32x64 skins)rarm2_right- right of right arm jacket (not available for 32x64 skins)rarm2_front- front of right arm jacket (not available for 32x64 skins)rarm2_left- left of right arm jacket (not available for 32x64 skins)rarm2_back- back of right arm jacket (not available for 32x64 skins)lleg2_top- top of left leg jacket (not available for 32x64 skins)lleg2_bottom- bottom of left leg jacket (not available for 32x64 skins)lleg_top- top of left leg (maps torleg_topfor 32x64 skins)lleg_bottom- bottom of left leg (maps torleg_bottomfor 32x64 skins)larm_top- top of left arm (maps torarm_topfor 32x64 skins)larm_bottom- bottom of left arm (maps torarm_bottomfor 32x64 skins)larm2_top- top of left arm jacket (not available for 32x64 skins)larm2_bottom- bottom of left arm jacket (not available for 32x64 skins)lleg2_right- right of left leg jacket (not available for 32x64 skins)lleg2_front- front of left leg jacket (not available for 32x64 skins)lleg2_left- left of left leg jacket (not available for 32x64 skins)lleg2_back- back of left leg jacket (not available for 32x64 skins)lleg_right- right of left leg (maps torleg_rightfor 32x64 skins)lleg_front- front of left leg (maps torleg_frontfor 32x64 skins)lleg_left- left of left leg (maps torleg_leftfor 32x64 skins)lleg_back- back of left leg (maps torleg_backfor 32x64 skins)larm_right- right of left arm (maps torarm_rightfor 32x64 skins)larm_front- front of left arm (maps torarm_frontfor 32x64 skins)larm_left- left of left arm (maps torarm_leftfor 32x64 skins)larm_back- back of left arm (maps torarm_backfor 32x64 skins)larm2_right- right of left arm jacket (not available for 32x64 skins)larm2_front- front of left arm jacket (not available for 32x64 skins)larm2_left- left of left arm jacket (not available for 32x64 skins)larm2_back- back of left arm jacket (not available for 32x64 skins)
Example config files can be found under the examples directory.
$ python3 skinmash.py <example path>/conf.txt
Output file by default will be named output.png but can be changed using the -o flag.
Example for interactive usage:
$ python3 skinmash.py
skinmash> all PotatoMaster101
skinmash> head Destination666
skinmash> hat Destination666
skinmash> exit