ComfyUI Node

VNCCS Character Selector

Pull a saved character and costume into prompt form

By AHEKOT·Created 10 months ago·Updated 20 days ago· 1,446
VNCCS Character Selector
    • face_details
    • face_path
    • sheet_path
    • positive_prompt
    • seed
    • negative_prompt
    • character_sheet
    characterNone
    costumeNaked
    face
    head
    top
    bottom
    shoes
    extra_negative_prompt
    new_costume_name

    Once you've built a character library in VNCCS - several characters, each with a few costumes - you need a way to pull one specific combination back out and get usable prompt text and a seed out of it, without re-running the whole creation workflow. VNCCS Character Selector is that lookup node: pick a character, pick a costume, and it hands back everything a downstream sampler or emotion-generation step needs.

    What it does

    Choose a character and a costume from your saved library (default is "Naked", the base undressed layer every character has), and the node assembles the positive prompt, negative prompt, and seed that were used or should be used to reproduce that look - plus the character sheet image itself and paths to the face and sheet files on disk. The optional face, head, top, bottom and shoes fields let you override specific parts of that costume's description without editing the saved costume itself. This maps directly to the split the README describes in Clothes Designer: head and face sections exist specifically so accessories don't get lost later - a hat goes in head, glasses go in face - and this node is where you can adjust those per-generation without permanently changing the costume.

    If you tweak the overrides and want to keep the result, new_costume_name lets you save the combination as a new costume rather than overwriting the original.

    Inputs and outputs that matter

    • character and costume (enum, populated from your library) - the lookup key. Both default to placeholder values until you've actually saved characters and costumes.
    • Optional face, head, top, bottom, shoes (STRING) - per-generation overrides to the saved costume description.
    • Optional extra_negative_prompt (STRING, multiline) - appended to whatever negative prompt the character/costume already carries.
    • Optional new_costume_name (STRING) - save the overridden combo as a new named costume.
    • Outputs: positive_prompt, negative_prompt, seed, face_details, face_path, sheet_path, and character_sheet (IMAGE) - everything downstream needs to either regenerate this exact look or feed it into the next stage of your pipeline.

    This is the tag-field variant of the selector - the plain single-line STRING overrides suit an Illustrious-style, tag-based prompt where you're swapping a handful of Danbooru-style tokens rather than writing a sentence. If you're on VNCCS 3.0's Qwen/Anima pipeline instead, look at CharacterAssetSelectorQWEN, the multiline sibling built for natural-language prompting.

    Installing it

    Ships with the base pack. ComfyUI Manager: search "VNCCS - Visual Novel Character Creation Suite", install latest, restart. Manual: cd ComfyUI/custom_nodes && git clone https://github.com/AHEKOT/ComfyUI_VNCCS.git, restart.

    Common issues & troubleshooting

    Dropdowns show no characters or costumes. This node only lists what already exists in your VNCCS library - run a character through Character Creator (or Clothes Designer for a costume) first.

    Override fields don't seem to change the output. Confirm you're editing the field that actually holds the relevant detail - the README's own guidance is that accessories belong in head and face specifically, not scattered into top/bottom/shoes, so a glasses edit typed into top won't take effect where you expect.

    Seed doesn't reproduce the exact original image. The seed this node returns reflects what was recorded for that character/costume combination - if you've since changed overrides, the underlying generation parameters have moved even though the seed number is the same, and an exact reproduction needs both matched.

    CategoryVNCCS

    Inputs (9)

    NameTypeDefaultDescription
    characterCOMBONone1 options: None
    costumeCOMBONaked1 options: Naked
    faceoptSTRING
    headoptSTRING
    topoptSTRING
    bottomoptSTRING
    shoesoptSTRING
    extra_negative_promptoptSTRING
    new_costume_nameoptSTRING

    Outputs (7)

    NameTypeDescription
    face_detailsSTRING
    face_pathSTRING
    sheet_pathSTRING
    positive_promptSTRING
    seedINT
    negative_promptSTRING
    character_sheetIMAGE