VNCCS Sprite Generator

Despite the name, this isn't where the actual generating happens - that's the job of Character Creator, Clothes, and Emotions upstream. Sprite Generator is the node you drop in after all that's done, when you want a character's finished sprite set back as ComfyUI outputs instead of just files sitting in a folder.

VNCCS, from AHEKOT, is a pipeline for producing consistent character sprite sheets for visual novels - same character, same style, across dozens of poses, outfits and emotions, which is normally the hardest thing to pull off in this whole space (the character-consistency writeup covers why at length). Work happens in stages - build a base character, dress them, give them emotions - and everything lands in ComfyUI/output/VNCCS/Characters/ as it's produced. Sprite Generator's job is to read that folder back into your graph for one specific character.

What it actually does

The single required input is character, a dropdown populated from whatever you've already built in VNCCS's Control Center. Pick one, run the node, and you get three outputs, all lists:

• images - every generated sprite for that character, as a batch
• file_paths - the on-disk path behind each image
• masks - the matching alpha mask for each sprite

That's the whole node. No prompt, no model, no sampler - it doesn't generate anything, it collects what's already there. That makes it the natural handoff point to whatever comes after VNCCS: a batch save node, your own packaging script keyed off file_paths, or a quick composite of images plus masks onto a game background to sanity-check the set before you ship it.

Where it fits

Don't reach for this node first if you're new to VNCCS. Run a character all the way through Character Creator, Clothes and Emotions (or the all-in-one VNCCS 3.0 workflow) so there's something to collect - then use Sprite Generator to pull it out. Point it at a character with nothing generated yet and you just get empty lists back, which is correct behavior, not a bug.

How to install it

Same install as every other node in the pack - there's no separate step for this one specifically:

• ComfyUI Manager - search VNCCS - Visual Novel Character Creation Suite, install, restart.
• Manual - cd ComfyUI/custom_nodes && git clone https://github.com/AHEKOT/ComfyUI_VNCCS.git, then cd ComfyUI_VNCCS_Utils && pip install -r requirements.txt, restart, and open Comfy Manager once to click "Install missing custom nodes" - VNCCS pulls in a companion utility pack it depends on.
• New to ComfyUI entirely? AHEKOT ships VNCCS Easy-Install, a preconfigured ComfyUI setup with everything already wired.

Common issues

The dropdown shows nothing, or just "None." Not a bug in this node - it means Control Center hasn't got any saved characters yet, or you're on a fresh install pointed away from your existing VNCCS output folder. Create a character first.

Empty output lists even though the character exists. Usually means that character's sprite generation never actually finished. A cancelled or errored Emotions run can leave a character's config saved with no sprites behind it, and that's exactly the kind of half-finished state this node can't recover from - it only reads what's on disk, so check the output folder directly before assuming something's broken.