VNCCS Sprite Manager
Pull already-generated sprites back into your graph
- 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 assprites.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.
Inputs (0)
No inputs
Outputs (3)
| Name | Type | Description |
|---|---|---|
| sprites | IMAGE | — |
| file_paths | STRING | — |
| masks | MASK | — |