Project Overview

This project can be used to programmatically convert the following into Fashion Sense packs:

• a hairstyles.png, usually utilized in Content Patcher Packs
• shirts from Json Assets
• hats from Json Assets

Setup

Useful programs to have:

• GIMP, a free open-source image editing software
• Windows Terminal for running console commands, download found here

To run the code, you'll need node.js and npm, instructions found here

Setup Instructions

1. Download node.js
2. Pull down the code from github
3. Open the project directory in the terminal (if you have Windows Terminal installed, all you have to do is be inside the directory and right click, then select Open Terminal here)
4. Run npm install inside the project directory
5. Create two empty folders inside the project directory, one called input and one called output
6. Follow the instructions below, depending on what type of conversion you want to perform.

---

Convert Hairstyles to Fashion Sense mod packs!

Start here if you want to convert a hairstyles.png into a Fashion Sense modpack!

Step 1 : Cut the Sprite Sheet

Use https://ezgif.com/sprite-cutter/ to cut your hairstyles.png into individual hairstyle files. Use the Cutting Method of "By number of columns / rows". For a typical hairstyles.png the number of columns will be eight. You count the number of rows by counting all the front-facing hairstyles going down. Once you're done, click "Download frames as a zip", then extract that to get all your individual files for your hairstyles.

Tips & Tricks!

An easy way to get the number of rows and columns needed is to do the following:

• take the width of the image, and divide it by 16, that's your number of columns
• take the height of the image, and divide it by 96, that's your number of rows

Step 2 - Sort the hairstyles

Now it's time for this code to shine! Note that this step requires human sorting of the files into "colorable" and "non-colorable" hairstyles. Colorable hairstyles are usually in grayscale, whereas non-colorable are usually not in grayscale. If you don't want to do this, you can just have them all not be colorable, which is the code's default.

Step 3 - Run the code!

First, drag all the colorable files into the input directory in this project. Then, run npm start -- -- --conversionType=hair --isColorable --authorName=NAMEOFAUTHOR --hairDescriptor=ADJECTIVE. There are a few customizable parameters that you can alter accordingly. First, you should enter the original name of the author whose hairstyles you are converting. This will enter it in Fashion Sense as AUTHOR's Hairstyle 01. If you specify a hairDescriptor, it will add that after the author's name, resulting in AUTHOR's ADJECTIVE Hairstyle 01, which makes it a lot easier to search for hairstyles you want in the Fashion Sense interface later.

For example, if you enter the command npm start -- -- --conversionType=hair --isColorable --authorName=BikiFae --hairDescriptor=Braided, it will result in hairstyles named as BikiFae's Braided Hairstyle 01 (Dyeable).

After executing the command above with the parameters you want, you will find the Fashion Sense converted hairstyles in the output directory, with the file names corresponding to the tile number that the program from Step 1 gave them.

Move these files to your Fashion Sense pack, to the "Hairs" directory.

Delete the files in the input directory. Move the non-colorable files into the input directory.

Now run npm start -- -- --conversionType=hair --authorName=NAMEOFAUTHOR --hairDescriptor=ADJECTIVE., and your Fashion Sense converted hairstyles will again be found in the output directory. (If you're wondering why --isColorable is no longer there, it's because the code defaults to isColorable:false, and adding --isColorable changes it to true. So when you want it to not be colorable, all you have to do is remove the parameter.)

Move these files from the output directory to your Fashion Sense pack, inside the "Hairs" directory.

You're done!

Extra Steps

Not only can you sort it by colorable/noncolorable, but you can also sort it by hairstyle descriptors, for example, dragging all of the long colorable hairstyles over at once, then running it with npm start -- -- --conversionType=hair --isColorable --authorName=NAMEOFAUTHOR --hairDescriptor=Long which will result in hairstyles with names like AUTHORNAME's Long Hairstyle 01 (Dyeable).

---

Convert Shirts / Hats from Json Assets to Fashion Sense!

New functionality has been added to the project! Now you can convert Json Assets clothing and hat packs into Fashion Sense content packs.

Step 1 - Copy the files over

Inside the JSON assets package, copy the entire contents of the Hats OR Shirts directory inside the JA package over to the input directory. This application can only handle converting ONLY hats OR shirts at one time.

Step 2 - Run the Code!

Run the following command:

for a shirt:

npm start -- -- --conversionType=TYPE --authorName=AUTHOR --prefix=PREFIX --hasSleeves

for a hat:

npm start -- -- --conversionType=TYPE --authorName=AUTHOR --prefix=PREFIX

• where TYPE is either hat or shirt
• where AUTHOR is the name of the original author who created the shirts/hats
• where PREFIX is a descriptor you want to go between the author name and the name of the item for all items in the set, for example, if it's a summer set, and you pass in --prefix=Summer then the items will be called something like AUTHOR's Summer Blouse. This is an OPTIONAL parameter and be removed if you do not want to use it.
• if you don't want any of the shirts to have sleeves in the Fashion Sense framework, remove the --hasSleeves parameter from the command above. This only applies if you are using --conversionType=shirt.

Note: currently all sleeves default to white, since it's difficult to programmatically and accurately determine which color the sleeves should be. You can manually go in and change this later, file by file, if you so choose.

Step 3 - Copy the Files over to your Fashion Sense pack!

You will find the Fashion Sense shirts inside the output directory after running the command mentioned above. Go ahead and drag the contents of the output directory into a directory called Shirts in your Fashion Sense pack.

Step 4 (Optional) - Fix the Sleeve Colors

1. Open the shirt.png file in your image editor of choice, one that specifically can read RGB values. I personally use GIMP for this, since it's free and open-source.
2. Use the eye drop tool to select the color you want the sleeves to be, and find its RGB value.
3. Open the shirt.json
4. The property you'll be editing is SleeveColors and you'll have to edit it to be the same for both FrontShirt, BackShirt, LeftShirt, and RightShirt properties. As stated in the Fashion Sense documentation, "The first color given will replace the vanilla sleeve's darkest color, while the second replaces the medium color and the last will replace the lightest color."
5. Take the RGB values and put them in that order for the SleeveColors property of all four options.
6. Test it in game, and if you don't like the color, tweak it and preview it quickly via fs_reload.