ComfyUI Node: VNCCS Character Selector

VNCCS Character Selector:

The CharacterAssetSelector node is designed to facilitate the selection and configuration of character assets within the VNCCS framework. This node allows you to choose a character and customize their appearance by selecting various costume elements such as face, head, top, bottom, and shoes. It is particularly useful for AI artists who want to create and manage character designs efficiently. The node ensures that the selected character and costume configurations are valid and provides default options if certain elements are not specified. By leveraging this node, you can streamline the process of character asset management, ensuring consistency and quality in your character designs.

VNCCS Character Selector Input Parameters:

character

The character parameter allows you to select the character you wish to configure. It provides a list of available characters, with a default option set to the first character in the list or "None" if no characters are available. This parameter is crucial as it determines the base character for which the assets will be configured.

costume

The costume parameter lets you choose the costume for the selected character. It includes a dynamic list of all available costumes across characters, with "Naked" as the default option. This parameter impacts the visual appearance of the character and is essential for defining the character's attire.

face

The face parameter is an optional string input that allows you to specify details about the character's face. It supports multiline input, enabling you to provide detailed descriptions or attributes for the character's facial features.

head

The head parameter is an optional string input for specifying details about the character's head. Like the face parameter, it supports multiline input, allowing for comprehensive descriptions of head-related attributes.

top

The top parameter is an optional string input for defining the character's top clothing. It supports multiline input, enabling detailed descriptions of the top attire, which can influence the character's overall look.

bottom

The bottom parameter is an optional string input for specifying the character's bottom clothing. It supports multiline input, allowing for detailed descriptions of the bottom attire, contributing to the character's appearance.

shoes

The shoes parameter is an optional string input for detailing the character's footwear. It supports multiline input, providing flexibility in describing the shoes, which are part of the character's costume.

extra_negative_prompt

The extra_negative_prompt parameter is an optional string input that allows you to add additional negative prompts. This can be used to refine the character's appearance by specifying elements to avoid or minimize in the design.

new_costume_name

The new_costume_name parameter is an optional string input for naming a new costume configuration. This allows you to save and reference custom costume setups for future use, enhancing the node's flexibility and utility.

VNCCS Character Selector Output Parameters:

face_details

The face_details output provides a description of the character's facial expression or features. It is typically set to "expressionless" by default, indicating a neutral expression unless specified otherwise.

face_path

The face_path output gives the file path to the character's face image, which is used in rendering or further processing. This path is essential for accessing and utilizing the character's facial assets.

sheet_path

The sheet_path output provides the file path to the character's full costume sheet, which includes all selected costume elements. This path is crucial for accessing the complete visual representation of the character.

positive_prompt

The positive_prompt output contains a string of positive prompts or attributes that define the character's aesthetics and background. This prompt is used to guide the character's visual style and context.

seed

The seed output is an integer value used for generating random elements or variations in the character's design. It ensures consistency in random processes, allowing for reproducible results.

negative_prompt

The negative_prompt output provides a string of negative prompts that specify elements to avoid in the character's design. This helps in refining the character's appearance by excluding undesirable features.

character_sheet

The character_sheet output is an image file representing the character's complete visual design, including all selected costume elements. This output is essential for visualizing and utilizing the character in various applications.

costume_prompt

The costume_prompt output is a string that describes the selected costume configuration. It provides a textual representation of the costume setup, useful for documentation and reference.

VNCCS Character Selector Usage Tips:

• Ensure that the character and costume selections are valid by checking the available options in the input parameters to avoid errors.
• Utilize the extra_negative_prompt parameter to refine the character's appearance by specifying elements to exclude, enhancing the final design quality.
• Save custom costume configurations using the new_costume_name parameter for easy retrieval and reuse in future projects.

VNCCS Character Selector Common Errors and Solutions:

Character 'character_name' not found

• Explanation: This error occurs when the specified character is not available in the system.
• Solution: Verify that the character name is correct and exists in the list of available characters. If not, select a different character from the provided options.

Costume 'costume_name' not found

• Explanation: This error indicates that the specified costume is not available for the selected character.
• Solution: Check the list of available costumes for the character and select a valid option. If necessary, use the default "Naked" costume.

Character mask and image must be the same size

• Explanation: This error arises when the character mask and image dimensions do not match.
• Solution: Ensure that the character mask and image are of the same size before processing. Resize the mask or image as needed to align their dimensions.