ousnius / BodySlide-and-Outfit-Studio

BodySlide and Outfit Studio, a tool to convert, create, and customize outfits and bodies for Bethesda games.
GNU General Public License v3.0
290 stars 64 forks source link

Wiki Entry Suggestion: Managing Presets #337

Open GrafPanzer opened 3 years ago

GrafPanzer commented 3 years ago

Issue: Currently, there doesn't seem to be any documentation in the BodySlide and Outfit Studio Wiki on how to create and manage presets, so some presets published at NexusMods include unnecessary groups (e.g., they may cite groups specific to one or more outfit mods as well as the master body group, when they could just cite the master). Or worse, the preset may assign only specific outfit groups and not assign the master group at all. This leads to confusion and frustration amongst users when the preset may not appear for the outfit they're building.

Suggestion: Add the following Wiki topic:

Wiki Topic: Managing Presets

What are presets for?

Presets in BodySlide are saved slider settings that can be applied to a body or outfit from the Preset dropdown menu instead of setting each slider individually. They are used to save the slider settings for favorite body shapes so they can be easily reproduced in later BodySlide sessions. Presets are saved in a Slider Presets .xml file that can be shared with other users by publishing it online.

When created, a preset is assigned one or more existing outfit/body groups. Once assigned, the preset will then appear in the Preset dropdown menu when one of the assigned groups is selected in the Choose Groups dropdown menu. It is not necessary to assign the preset to all of the available groups, but only to the master group for the body that it's based on. For example, if creating a preset for CBBE bodies and outfits, it is only necessary to assign the "CBBE" master group to it.

Creating and editing presets

To create a new preset, first set the individual sliders as desired, then click the Save As button. This will open a dialog box where you can enter the name of your new preset and select the groups to assign to it. Remember, in normal cases you only need to assign master groups, not every group that appears in the list. When ready, click Save. This opens another dialog box where you will be prompted to save the preset .xml to the SliderPresets folder. Once saved, your preset will appear in the Preset dropdown menu the next time you use BodySlide.

For an existing preset, especially one you didn't create yourself, it can be hard to tell what groups are assigned to it. To find out, open the preset .xml file in Notepad or a web browser. You should see one or more group names assigned near the beginning of the text, for example: Group name="CBBE"/. If the list does not include the master group for the body you're using, you may be able to update the preset to add it using the directions below. Keep in mind that different bodies use different sliders, so simply adding the master group will not make the preset work if the sliders are different. When you examine the .xml text, you may find that the file includes more than one preset. It's possible to bundle multiple presets in a single .xml by directly editing the text.

You can use the Save As button to update a preset or the groups assigned to it. Select the preset in the Preset dropdown menu, and click the Save As button. Re-enter the existing name of the preset, or a new name if you wish to change it. Select the groups to assign to the preset. Again, in most cases you only need to assign master groups. Click Save, and in the new window select the existing preset from the file list. This will copy the name to the File Name field. Then click Save, and your old preset file will be overwritten with the updated name and group assignments.

To simply edit the sliders for an existing preset, first select that preset in the Preset dropdown menu. Next, set the individual sliders as desired, then click the Save button. This updates the current .xml file in the SliderPresets folder with the selected slider settings. Note that there is no confirmation step or backup created of the original slider settings, so you might want to back up the .xml file first by making a copy of it in Windows Explorer.