0 of 0
About this mod
Take those Stardew hairstyle PNGs from around the web and generate Fashion Sense compatible mods from them on your own!
- Requirements
- Permissions and credits
- Changelogs
- Donations
Lapplace's Custom Hairstyles Merging Tool
A tool for merging custom hairstyle PNGs for use with Fashion Sense
🧠 What does this do?
Ever find really cute hairstyles on the web, only to discover that they're in PNG form and need manual merging? Or are you a mod author with a hairstyle mod that isn't yet Fashion Sense compatible? With this tool, you'll be able to throw all of those hairstyle sheets into one folder and generate a Fashion Sense compatible mod with all of the hairstyles combined!
✨ Features
- Automatic all-in-one mod generation using hairstyle PNG sprite sheets as input
- Custom random naming of hairstyles
- Automatic grouping of similar hairstyles using agglomerative clustering based on pixel similarity (SSIM)
📦 How to Use
1. Download and unzip the tool.
2. Place your input PNG hairstyle sheets inside the `hairstyle_sheets` folder.
3. Launch the tool by running `Lapplace's Merge Tool.exe`.
4. Adjust the Agglomerative Threshold and Merge Threshold to control grouping behavior.
5. Optionally enable Debug Mode to inspect grouped output.
8. Click "Start Merging" and let the tool perform the merging.
7. The final results are exported into `Lapplace_Custom_Hairs.zip`.
8. Install the mod as you would any other mod, for example using Vortex.
🖼️ Screenshot
🧰 Requirements
There are no requirements to run the executable. Just double-click to use!
To run the exported mod in Stardew Valley, you will need Fashion Sense installed.
🔧 Further customization
Within the zip, there are a few other files. You can edit them directly as they are used in the script.
names.txt - A list of names from which the program picks names for the hairstyles. You can replace this with any list of names.
manifest.json - The details of the mod after the mod zip is generated. Some of these fields are auto-populated by the program, but if you wish you can change the other fields.
hair.json - The necessary details for each hairstyle to be read by Fashion Sense. The "Name" field is auto-populated by the program, but you can change the details like hair position, which will affect all hairstyles extracted by the program.
⚠️ Tips
- Make sure that the hairstyle grid PNGs have a transparent background. Otherwise, your hairs will be encased in white boxes!
- Do not upload the exported zips anywhere, unless you have permission from all the creators of the hairstyle sheets you use. This tool is primarily for personal use.
💬 Credits
Developed by lapplace
ChatGPT for generating some of the code
Guidelines for Merging by Delloti which was used during development
꾼마 on Naver for the example hairstyles in my banners
Orchidart on Freepik for the banner images
Fashion Sense by PeacefulEnd for the hairstyle loading framework
💻 Source Code
🡒 GitHub Source Code