[color=#b6b6b6][size=4][b]What Does This Tool Do?
[/b][/size]While there is some grouping functionality packaged with BodySlide ([url=https://github.com/ousnius/BodySlide-and-Outfit-Studio/wiki/Group-Manager]BodySlide Group Manager[/url]), it is hard to use when adding large amounts of ungrouped, or badly labeled outfits.This small script allows you to scan the BodySlide folders for ungrouped outfits and automatically create some basic groupings.
You can go from this [i][b](Note the size of the Scroll Bar)[/b][/i]:
[img]https://github.com/ndaley7/BodySlide-Group-Generator/raw/master/WikiMedia/TooManyUnassigned.png[/img]
To This With no effort at all:
[img]https://github.com/ndaley7/BodySlide-Group-Generator/raw/master/WikiMedia/PerFileGrouping.png[/img]
All files generated are of course useable with the included BodySlide Group Manager:
[img]https://github.com/ndaley7/BodySlide-Group-Generator/raw/master/WikiMedia/MasterListGroupManager.png[/img][b]
[size=4]Installation[/size]/Removal[/b]
Install using mod manager of choice, and uninstall the same way.
Delete any "MasterListX.xml" files in the SliderGroups folder of BodySlide if you want to remove your custom Groupings
[size=4][b]Usage[/b]
[size=3][size=2]Run the BSCG.exe file inside the BSCG folder. If it is your first time running it, select your BodySlide installation.
It is highly recommended that you enable debugging.
I am not responsible for lacking permissions to add .xml files to your C:// drive if you chose to install Skyrim there.
See the Video below for first time run and usage:
[/size][/size][youtube]I6_HytEu1EQ[/youtube]
[/size][/color]
[size=5]High Level Overview[/size]The Bodyslide Custom Grouper goes inside of the SliderSets and SliderGroups folders within the root BodySlide folder. After generating a list of already grouped outfits from the SliderGroups folders, this is compared to list of every installed BodySlide Compatibile outfit in the SliderSets Folder. These remaining outfits are then Semi-Intelligently sorted into groupings by name, manually renamed/split if desired, and written out to a "MasterListX.xml" file.[size=5][url=https://github.com/ndaley7/BodySlide-Group-Generator/wiki/How-it-Works#detailed-order-of-operations][/url]Detailed Program Structure
[/size][list=1]
[*] Check for ConfigBSCG.xml[list=1]
[*] Create ConfigBSCG.xml if non-existant
[*] Enable Debug Logging? [b](y/n)[/b][list=1]
[*] File: [b]logBSCG.txt[/b] in the same directory as the executeable[list=1]
[*][i] Debug Logging keywords can be found on the Wiki and on the NexusMods Page[/i]
[/list]
[/list]
[/list]
[*] Backup both SliderGroups and SliderSets folders in the subfolder BackupBSCG located in each one[list=1]
[*] This is done in case a strange character not inside of the latin-1 encoding type interrupts parsing.
[/list]
[*] Compile List of Grouped Outfits from the SliderGroups Folder
[*] Compile List of Installed Outfits from the SliderSet
[*] Compare difference between the lists to get a list of Ungrouped Outfits
[*] Run size comparison check between backup and original files. If they differ, revert the original[list=1]
[*] This happens when a character out of the current encoding is able to be read but not written in UTF-8.
[*] A 0 KB file will also result from a failed read of an OSP/XML file.
[/list]
[*] Sort Alphabetically
[*] Check for Previous MasterListX.xml files[list=1]
[*] If MasterListX.xml file(s) exist:[list=1]
[*] Create Additional MasterList file ?[b](y/n)[/b][list=1]
[*] Yes: New Groups will be put on MasterListX+1.xml
[*] No: Old MasterList Files will be deleted and a new single file will be started
[/list]
[/list]
[/list]
[*] Customize New Groups? [b](y/n)[/b][list=1]
[*] Yes: Groups are Semi-Intelligently sorted into SuperGroups (Composite Groups made from multiple Groups)
[*] No: Automatically Name based on name of SliderSet file ([b]SKIP TO STEP 11[/b])
[/list]
[*] Would you like to manually confirm each Custom Group?[b](y/n)[/b][list=1]
[*] Yes: Allows customization of Supergroups (Rename or split)
[*] No: Writes out SuperGroups as they are to the MasterList[list=1]
[*][i] See Nexus Mod page for examples of why this may not be desireable[/i]
[/list]
[/list]
[*] Processed Group:Outfit list is written out to a MasterListX.xml file.
[/list][color=#b6b6b6]
[size=4][b]FAQ[/b][/size]
-under Construction-
[size=4][b]Troubleshooting[/b][/size]
[color=#b6b6b6]-under Construction-[/color]
[color=#ff0000][size=4]BUGS WITH CURRENT VERSION[/size][/color]
[/color][list]
[*][color=#b6b6b6]Ensure no .OSP files in SliderSets folder contain "&" or " ' " in the name[/color]
[/list][color=#b6b6b6]
Credits
[url=https://github.com/ndaley7/BodySlide-Group-Generator]SOURCE CODE
[/url]
[/color]
[/b][/size]While there is some grouping functionality packaged with BodySlide ([url=https://github.com/ousnius/BodySlide-and-Outfit-Studio/wiki/Group-Manager]BodySlide Group Manager[/url]), it is hard to use when adding large amounts of ungrouped, or badly labeled outfits.This small script allows you to scan the BodySlide folders for ungrouped outfits and automatically create some basic groupings.
You can go from this [i][b](Note the size of the Scroll Bar)[/b][/i]:
[img]https://github.com/ndaley7/BodySlide-Group-Generator/raw/master/WikiMedia/TooManyUnassigned.png[/img]
To This With no effort at all:
[img]https://github.com/ndaley7/BodySlide-Group-Generator/raw/master/WikiMedia/PerFileGrouping.png[/img]
All files generated are of course useable with the included BodySlide Group Manager:
[img]https://github.com/ndaley7/BodySlide-Group-Generator/raw/master/WikiMedia/MasterListGroupManager.png[/img][b]
[size=4]Installation[/size]/Removal[/b]
Install using mod manager of choice, and uninstall the same way.
Delete any "MasterListX.xml" files in the SliderGroups folder of BodySlide if you want to remove your custom Groupings
[size=4][b]Usage[/b]
[size=3][size=2]Run the BSCG.exe file inside the BSCG folder. If it is your first time running it, select your BodySlide installation.
It is highly recommended that you enable debugging.
I am not responsible for lacking permissions to add .xml files to your C:// drive if you chose to install Skyrim there.
See the Video below for first time run and usage:
[/size][/size][youtube]I6_HytEu1EQ[/youtube]
[/size][/color]
[size=5]High Level Overview[/size]The Bodyslide Custom Grouper goes inside of the SliderSets and SliderGroups folders within the root BodySlide folder. After generating a list of already grouped outfits from the SliderGroups folders, this is compared to list of every installed BodySlide Compatibile outfit in the SliderSets Folder. These remaining outfits are then Semi-Intelligently sorted into groupings by name, manually renamed/split if desired, and written out to a "MasterListX.xml" file.[size=5][url=https://github.com/ndaley7/BodySlide-Group-Generator/wiki/How-it-Works#detailed-order-of-operations][/url]Detailed Program Structure
[/size][list=1]
[*] Check for ConfigBSCG.xml[list=1]
[*] Create ConfigBSCG.xml if non-existant
[*] Enable Debug Logging? [b](y/n)[/b][list=1]
[*] File: [b]logBSCG.txt[/b] in the same directory as the executeable[list=1]
[*][i] Debug Logging keywords can be found on the Wiki and on the NexusMods Page[/i]
[/list]
[/list]
[/list]
[*] Backup both SliderGroups and SliderSets folders in the subfolder BackupBSCG located in each one[list=1]
[*] This is done in case a strange character not inside of the latin-1 encoding type interrupts parsing.
[/list]
[*] Compile List of Grouped Outfits from the SliderGroups Folder
[*] Compile List of Installed Outfits from the SliderSet
[*] Compare difference between the lists to get a list of Ungrouped Outfits
[*] Run size comparison check between backup and original files. If they differ, revert the original[list=1]
[*] This happens when a character out of the current encoding is able to be read but not written in UTF-8.
[*] A 0 KB file will also result from a failed read of an OSP/XML file.
[/list]
[*] Sort Alphabetically
[*] Check for Previous MasterListX.xml files[list=1]
[*] If MasterListX.xml file(s) exist:[list=1]
[*] Create Additional MasterList file ?[b](y/n)[/b][list=1]
[*] Yes: New Groups will be put on MasterListX+1.xml
[*] No: Old MasterList Files will be deleted and a new single file will be started
[/list]
[/list]
[/list]
[*] Customize New Groups? [b](y/n)[/b][list=1]
[*] Yes: Groups are Semi-Intelligently sorted into SuperGroups (Composite Groups made from multiple Groups)
[*] No: Automatically Name based on name of SliderSet file ([b]SKIP TO STEP 11[/b])
[/list]
[*] Would you like to manually confirm each Custom Group?[b](y/n)[/b][list=1]
[*] Yes: Allows customization of Supergroups (Rename or split)
[*] No: Writes out SuperGroups as they are to the MasterList[list=1]
[*][i] See Nexus Mod page for examples of why this may not be desireable[/i]
[/list]
[/list]
[*] Processed Group:Outfit list is written out to a MasterListX.xml file.
[/list][color=#b6b6b6]
[size=4][b]FAQ[/b][/size]
-under Construction-
[size=4][b]Troubleshooting[/b][/size]
[color=#b6b6b6]-under Construction-[/color]
[color=#ff0000][size=4]BUGS WITH CURRENT VERSION[/size][/color]
[/color][list]
[*][color=#b6b6b6]Ensure no .OSP files in SliderSets folder contain "&" or " ' " in the name[/color]
[/list][color=#b6b6b6]
Credits
[url=https://github.com/ndaley7/BodySlide-Group-Generator]SOURCE CODE
[/url]
[/color]