ComfyUI Node

VNCCS Sprite Manager

Pull already-generated sprites back into your graph

By AHEKOT·Created 11 months ago·Updated 24 days ago· 1,446
VNCCS Sprite Manager
    • sprites
    • file_paths
    • masks

    Once VNCCS has generated a character's sprites, they're just files sitting in ComfyUI\output\VNCCS\Characters\ - and eventually you'll want to do something with them that isn't "run the generation workflow again." VNCCS Sprite Manager is the node that reads existing sprites back into a ComfyUI graph, with their masks, so you can build post-processing steps, exports, or checks without re-generating anything.

    What it does

    No inputs at all - it's a browser/loader node. Point it at a character (through its widget, presumably picking from your existing VNCCS characters folder) and it hands back the sprite images, their file paths, and their alpha masks as parallel lists. That's a genuinely useful trio: the images for whatever processing you're doing, the paths if you need to write results back to specific files, and the masks if you're doing anything mask-aware - compositing onto a new background, checking for cutout artifacts, or feeding them into a further edit step.

    It's marked is_output_node: true, meaning it's treated as a workflow endpoint in its own right rather than purely a feeder for other nodes - you can use it as the tail end of a "just show me what's already there" check.

    Inputs and outputs

    • No required or optional inputs - the character/sprite selection lives entirely in the node's own widget.
    • sprites (IMAGE, list) - every sprite image for the selected character.
    • file_paths (STRING, list) - the on-disk path for each sprite, in the same order as sprites.
    • masks (MASK, list) - the alpha mask for each sprite, same ordering again.

    Because everything comes back as parallel lists in matching order, you can zip a sprite with its path and its mask by index - useful if you're building a batch process that needs to write results back to the same filenames it read from.

    Installing it

    Bundled 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. No model downloads required - this node only reads files that a generator node already produced, so it works even before you've touched Control Center.

    Common issues & troubleshooting

    Nothing shows up in the widget. Sprite Manager only knows about characters that have actually been through a generator node and written output - if you haven't run Character Generator, Clothes Generator, or one of their siblings for a given character yet, there's nothing here to load. Check ComfyUI\output\VNCCS\Characters\ directly to confirm the files exist.

    The list order between sprites, file_paths and masks seems misaligned. It shouldn't be - they're built as parallel lists from the same source - but if you've been poking around the output folder manually (renaming, deleting individual files), that's the kind of thing that can desync a file-based loader like this one. Treat the character folder as VNCCS-managed and avoid hand-editing it if you're relying on Sprite Manager downstream.

    You deleted sprites by accident. The README calls this out directly as a real risk: your generated output lives in the standard ComfyUI output folder, which people routinely clean out when tidying disk space. There's no VNCCS-side recovery for that - treat the character folder as something to back up like any other asset you'd be upset to lose.

    CategoryVNCCS

    Inputs (0)

    No inputs

    Outputs (3)

    NameTypeDescription
    spritesIMAGE
    file_pathsSTRING
    masksMASK