Characters Management

Saving a character preserves all your customizations in a file that can be loaded later. This includes parts selections, slider adjustments, color settings, and custom texture information. Saved characters appear in the Character list and can be loaded with a single click.

Characters are model-specific. A character created for a specific model cannot be applied to other models since it is likely that different models have different parts, sliders, and structures. It is up to the model artist to decide what parts to be included and what design to adapt.

What Gets Saved?

When you save a character, the following information is preserved:

• Parts selections: active parts (which parts you've chosen)
• Slider adjustments:  Sliders with overwrite toggle enabled
• Color settings: Part groups with Render Mode set to Tint or Two-Color Tint
• Custom textures: Whether custom textures are being used and the unpacked texture PNGs

What doesn't get saved:

• Viewport camera position/zoom (these are session-specific)
• Animation playback state (animations start fresh when loaded)
• Sliders with overwrite toggle disabled (default value of the model)
• Part groups with Render Mode set to Default (default tint color of the model)

Although unlikely, the default appearance of the model can change when the model updates.

Saving a Character

Step 1: Customize Your Character

Before saving, customize your character as desired. You can save a character at any point in the customization process. You don't need to complete all customizations before saving.

Step 2: Click Save Character Button

1. Locate the Save Character button: Find it below the Character list on the left side of the interface
2. Click the button to open the save dialog
3. Dialog appears: A popup window will appear asking for a character name

note

If a character is selected in the Character list, the popup will ask you whether you want to overwrite the current selected character first. If you do not overwrite, select Cancel. Another popup window will appear asking for a new name.

Step 3: Enter Character Name

1. Type a name: Enter a name for your character in the text field
2. Follow naming rules: Ensure your name meets the requirements:
   • Maximum length: 50 characters
   • Invalid characters: Cannot contain: < > : " | ? * \ /
   • Not empty: Cannot be empty or only whitespace
3. Click "Confirm" button to save the character

Step 4: Handle Duplicate Names (If Needed)

If a character with that name already exists:

1. Confirmation popup appears: A dialog will ask if you want to overwrite
2. Choose an option:
   • Click "Overwrite": Replace the existing character with the new one
   • Click "Cancel": Return to the name dialog to choose a different name

warning

Overwriting a character means that all the old character files will be replaced and all old customizations are lost. This action cannot be undone, so be certain before overwriting.

Loading Characters

Step 1: Find Your Character

1. Locate the Character list: Find the Character list on the left side of the interface (below the Models list)
2. Browse the list: Scroll through to find your saved character. The Character list shows all saved characters for the currently loaded model. Each character appears as a clickable entry.

Step 2: Select the Character

1. Click on the character: Click the character name in the list
2. Character loads: The character's customizations are automatically applied

What happens when loading

• Parts selections are restored
• Slider values are applied
• Colors are restored
• Custom textures (if applicable) are repacked and loaded. This can be slow!

Saved Character Location

Characters are saved in a structured folder system. The exact location depends on your system:

Windows:

%USERPROFILE%\AppData\LocalLow\GlycoProduction\EmoteLab\Characters\{ModelName}\{CharacterName}/

File Structure

{CharacterFolderPath}/
 └── {ModelName}
     └── {CharacterName}/
         ├── {CharacterName}.json          (character data file)
         └── Regions/                       (custom texture files, if applicable)
             ├── region1.png
             ├── region2.png
             └── ...

Character Files

JSON file: Contains all character customization data

• Parts selections
• Slider values and states
• Color settings
• Custom texture references

Regions folder (if using custom textures): Contains custom texture image files

• PNG files for each individual part
• Organized for maximum compatibility
• Required for loading characters with custom textures

Backup Your Characters

Always keep backups of your character files. To back up your characters:

1. Locate Characters folder: Find the Characters directory %USERPROFILE%\AppData\LocalLow\GlycoProduction\EmoteLab\Characters
2. Copy the folder: Copy the entire Characters folder
3. Store backup: Save to external drive, cloud storage, or another location
4. Restore if needed: Copy back to restore characters

Managing Characters

Deleting a Character

The delete character button deletes the currently selected character.

warning

Deleting a character permanently removes the character file and associated custom textures. This action cannot be undone, so be certain before deleting.

It is also possible to delete the character from its save location using the system's file browser/file explorer. If deleted this way, the character can be recovered from the system recycle bin.

Clearing a Character

The clear character button resets all customizations and makes the model return to its default state.

warning

This action will not delete any saved characters. However, all unsaved progress will be lost. This action cannot be undone, so be certain before clearing.

Sharing Characters

To share characters with others:

1. Locate character folder: Find the character's folder on your system
2. Copy the folder: Copy the entire character folder (including JSON and Regions if present)
3. Share the folder: Send the folder to others
4. Recipient places folder: Recipient places the folder in their Characters directory under the same model name folder
5. Character appears: The character will appear in their Character list

Requirements for sharing:

• Recipient must have the same model (for built-in models, you don't have to worry about this)
• Custom texture files must be included (if character uses custom textures)
• Folder structure must be preserved

tip

You can also share specific texture regions, like a customized notepad, laptop, and more.

Troubleshooting

Character Doesn't Load

• Check for errors: Look for error messages that might indicate the problem
• Check file integrity: Verify the character JSON file isn't corrupted
• Make sure the character matches the current model: Characters are model-specific

Character Missing from List

• Check model: Ensure the correct model is loaded (characters are model-specific)
• Check folder location: Verify the character folder exists in the correct location
• Check file name: Ensure the JSON file is named correctly. The name of the JSON file must match the name of its parent folder.

Custom Textures Not Loading

• Check Regions folder: Verify the Regions folder exists in the character folder
• Check texture files: Ensure PNG files are present in the Regions folder
• Check for errors: Look for error messages that might indicate the problem