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.

If You Will Be Converting Json Assets Shirts Files That Include Unicode:

1. Download this JSON batch translator by Kartoffels and extract it to wherever you want. The sleeve_colorizer script you will be using does NOT like unicode characters such as Chinese, Japanese, or Korean characters, and you'll actually be able to read what your items are.
2. Download and install Python if you have not already.
3. Open the get_json.py script with a text editor in the directory.
4. Delete line 12, print(data). On line 15, n = n + S1, delete the S. If you do not do these two things, the script will not work with the latest version of Python. Then save the script.
5. Create a folder titled "translate" in the directory.
6. Drag the contents of your Shirts folder into the "translate" folder.
7. Open terminal in the directory (right click in it and select "open in terminal") and input python get_json.py translate. There should be two new files in the directory titled translate_descriptionsList.txt and translate_nameList.txt.
8. Open translate_descriptionsList.txt and paste the contents into your preferred translation program. Copy the translated list and replace the contents of translate_descriptionsList.txt with it.
9. Repeat Step 8, but with translate_nameList.txt.
10. Open terminal in the directory (right click in it and select "open in terminal") and input python translate_json.py translate.
11. Open the "translate" folder. The names and descriptions of the Json Assets shirts are now all translated to your preferred language.

---

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 01. If you specify a hairDescriptor, it will add that after the author's name, resulting in AUTHOR's ADJECTIVE 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 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 - Translate!

Translate the JSONs of any Hats OR Shirts folders with this JSON batch translator by Kartoffels if the contents of your JA package are in Chinese, Japanese, or Korean characters. See the section below "Setup Instructions" for a full usage guide.

Step 2 - 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 3 - 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 Shirt. 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.

Step 4 - Almost done!

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 5 - Fix the Sleeves!

Currently all sleeves default to white, but Elizabeth's Sleeve Colorizer script can fix that with a Python script!