Scene Queue Distributor

The Scene Queue Distributor is the per-iteration worker of the scene queue system - the half of the pair you almost never place by hand. Drop a Scene Queue Controller and a Distributor is auto-created and wired to it. Then, for every combination the Controller builds, the Distributor loads the assigned preset files and pushes their prompt text straight into your PromptDrafter nodes' text inputs. If the Controller is the grid editor, this is the delivery truck.

How it works

The Controller's scene_combos output is a list (OUTPUT_IS_LIST), so ComfyUI runs the downstream subgraph once per combo - and each of those runs hands the Distributor a single combo object. It parses its hidden sq_groups_config (group order and node type per group), then reads each group's preset JSON from PromptDrafter's saved/ folders and extracts the fields that node type expects:

• Dual_PromptDrafter → positive_prompt, negative_prompt
• DualLora_PromptDrafter → positive_prompt, negative_prompt, lora_string
• Single_PromptDrafter → prompt

The 25 STRING outputs you see in the schema aren't you being handed a wall of sockets to wire: ComfyUI's validator needs RETURN_TYPES to cover the highest wired slot index, so the node declares a fixed max (slot 0 + 8 groups × 3 fields). The JavaScript frontend adds and removes the visible slots to match the groups you actually configured.

The outputs

• combination_tag (STRING) - slot 0, always. A _-separated string built from the scene label and each group's preset label, ready to drop into SaveImage's filename_prefix so every rendered combo gets a distinct filename. This is the one output you'll always use.
• output_1 … output_24 (STRING) - the per-group slots, auto-wired to your PromptDrafter nodes. Don't hand-wire these; add or remove PromptDrafter columns in the Controller's editor instead and they rearrange themselves.

The inputs

• scene_combo (SCENE_COMBO, required) - from the Controller's scene_combos output. The only wire you need to check.
• sq_groups_config (STRING, optional, hidden) - the JSON group config the frontend manages. Ignore it; it's there so the backend knows which node type each output slot belongs to.

Workflow notes and gotchas

This pack expects a different layout than a normal single-image workflow. PromptDrafter nodes take their text from the Distributor's wired inputs, not from their own widgets - the README is explicit about that. For LoRA, DualLora_PromptDrafter's lora_string gets parsed into its LORA_STACK output, which you wire to a LoRA Loader; the upstream push_lora_on_load sync feature isn't used here, presets drive everything.

If a group has no preset assigned in a given combo, the Distributor quietly emits empty strings - the render still runs, just with blank prompt fields. Missing files are the loud failure instead, caught at the Controller before anything queues. And if you need to hand-edit a PromptDrafter text field mid-debug, v1.0.1 added Disconnect Outputs and Reconnect Outputs buttons on the Distributor: unplug everything, edit, reconnect in one click. Genuinely handy for chasing a single bad combo.

Installing

It ships with ComfyUI-PromptDrafter-SceneQueue - one install covers both nodes. The only requirement is that ComfyUI-PromptDrafter is installed first; there are no other dependencies and nothing to download. Fastest path:

cd ComfyUI/custom_nodes
git clone https://github.com/Carasibana/ComfyUI-PromptDrafter-SceneQueue

…then restart ComfyUI, or grab it from ComfyUI Manager by searching the pack title. If the Distributor never appears, you almost certainly skipped the parent PromptDrafter pack - install that, restart, and the node will show up.