comfyui-moonpack
A collection of utility nodes for ComfyUI that enhance workflow efficiency and flexibility.
Nodes (29)
The glue that makes a planner's LoRA picks actually load
Same auto-expanding prompt builder, new prefix
That '(legacy)' bypasser node is the same one you want — here's the rename story
Save images with zero metadata — the privacy switch ComfyUI should have built in
Gate work on real conditions
Read an image's size so the rest of the graph can adapt
Stack unlimited Wan LoRAs without rebuilding the node — made for WanVideoWrapper
Dynamic string concatenation without the counter pain
Bypass half your graph with one toggle, no groups to manage
Loops, ping-pongs, and fades on tap
Your reference images keep getting resized to match each other. This is the fix.
Label your reference photos before they vanish into a grid
LoRAs and their trigger words, kept together so they never drift
The prompt library that lives inside your workflow file
Resize math that doesn't butcher your aspect ratio — and snaps to the divisor your model needs
Feed several identity references to a video model without losing the subject
Contact sheets with actual layout control — not just a crop-everything grid
Pull the numbers out of any text with one pattern — trigger words, sizes, seeds, you name it
Regex find-and-replace with a test mode, so you don't nuke your prompt by accident
Find-and-replace for prompts, with the malformed lines actually reported
Pick a preset, let the math hit the model's sweet spot
A prompt A/B switch that doesn't burn compute on the branches you didn't pick
Prompt fragments as a stack you can toggle and reorder — without the comma hell
Let it compute the fade schedule for you
The old key, same math, one save away from migrating
The v0.1 key that still runs the same regex
Still the same find=>replace node, just under a new key
Same loop math, pre-prefix key
ComfyUI MoonPack
A focused collection of utility nodes for ComfyUI. Strings, dimensions, dynamic inputs, fast bypassers, and a couple of video helpers.
Installation
Via ComfyUI Manager
Search for MoonPack and install.
Manual
cd ComfyUI/custom_nodes
git clone https://github.com/moonwhaler/comfyui-moonpack.git
Then restart ComfyUI.
Compatibility
v0.2 renamed all node registry keys to use a MoonPack_ prefix. Workflows
saved with v0.1 still load — legacy keys are kept as aliases (marked
"(legacy)" in the menu) for one release cycle. Save your workflow once after
loading and it will automatically migrate to the new keys.
Nodes
All nodes are under the MoonPack/ category in the Add Node menu.
MoonPack/image
| Node | Purpose |
|---|---|
| Proportional Dimension | Resize W/H to a target side while preserving aspect; snap to a divisor with nearest/floor/ceil rounding; optional from_image input. Outputs width, height, shortest_side, longest_side, scale. |
| Dimension From Image | Reads width, height, batch_size from an IMAGE tensor. |
| Smart Resolution | Picks a model-friendly resolution near a megapixel budget while preserving aspect ratio. Presets for SD 1.5, SDXL, Flux (1.0/1.4 MP), and Wan 480p/720p. |
| Reference Concat | Concatenates reference images into a strip against a main image (e.g. identity refs for a video first frame). Strip goes on the main image's longest side, capped to that side's length (never stretched beyond it), main image never shrunk. offset slides the strip into the main image (overlap) or away from it (filled gap). If main_image is left unconnected, outputs an auto-sized contact-sheet grid of just the reference images instead, sized to the largest reference (smaller ones are upscaled to match, not the other way around) — for full control over that grid layout, use Reference Grid instead. interpolation picks the resampling filter (nearest/bilinear/bicubic/lanczos). max_ref_side caps each reference's longest side (downscale only) before any sizing math, so one oversized reference can't blow up the output. Accepts a MoonPack Image List (each reference keeps its native resolution) or a plain stacked IMAGE batch. Outputs a MASK marking the reference area. |
| Reference Grid | Arranges reference images into a contact-sheet grid with full layout control: columns (0 = auto square-ish), fit_mode (cover/contain/stretch per cell), cell_size_source (largest/smallest/average, with optional fixed cell_width/cell_height overrides), fill_direction (row-major/column-major), and last_row_align (left/center/right) for an incomplete trailing row or column. Same interpolation, max_ref_side, and Image List support as Reference Concat. Outputs a MASK marking the actual reference pixels (excludes empty cells and any contain padding). |
| Image List | Collects images from auto-expanding slots (➕-style, like Dynamic LoRA Stack) into a native ComfyUI list instead of a stacked batch tensor, so mixed-resolution images keep their own resolution instead of all being resized to match. Feed to Reference Concat, Reference Grid, or any other list-aware node. |
| Load Image (Labeled) | Loads an image, optionally crops it to a crop_x/crop_y/crop_width/crop_height region (0 width/height = no crop on that axis), then bakes an editable caption bar (e.g. "Front View") onto the (possibly cropped) result as extra top/bottom space — the label bar itself never crops or resizes further. A bold arrow in the bar points back at the photo; text and arrow toggle independently. Background/text colors are color-swatch widgets; an optional inset border_width frames the whole result in the background color. The node's Edit Crop button opens a maximized popup to drag out the crop region visually on the original image; the Preview button renders the exact composited (cropped + labeled) result before queuing. |
MoonPack/string
| Node | Purpose |
|---|---|
| Simple String Replace | Sequential find => replace pairs (one per line). Optional whole-word match. Reports malformed lines via ignored_lines instead of silently dropping them. |
| Regex String Replace | Full Python regex with case-insensitive / multiline / dotall flags and a non-destructive test_mode that highlights matches with >>>…<<<. Returns match_count. |
| Regex Extract | Returns the first or all regex matches. If the pattern has a capture group, returns the group; otherwise the whole match. all_matches=True emits each match as a separate OUTPUT_IS_LIST item. |
| Dynamic String Concat | Auto-expanding string concatenator. Has template mode ({1}, {2} placeholders), prefix/suffix, optional whitespace stripping, and an ignore_empty toggle. |
| String Switch | Routes one of up to 8 string inputs based on a 1-based selector. Lazy: only the chosen branch's upstream nodes are evaluated. |
| Text Builder | Joins any number of multiline text blocks typed on the node. Blocks are added, toggled, reordered (▲/▼) and removed on the node. A connected text input is always the first part. |
MoonPack/lora
| Node | Purpose |
|---|---|
| MoonLoRA Loader | Applies any number of LoRAs to MODEL/CLIP and concatenates the trigger text of the enabled ones into a single STRING. |
| Dynamic LoRA Stack | Auto-expanding WANVIDLORA stacker (designed for kijai's WanVideoWrapper). Flattens nested lists; an empty stack returns [], not None. |
| MOSS Regional Layout | MOSS-Image only. Box editor (based on kijai's MOSS-Image Prompt Builder) with LoRAs per box: draw boxes, caption them, pick LoRAs per box. Outputs the MOSS layout prompt and a MODEL whose box LoRAs only act inside their box. |
MoonPack/utils
| Node | Purpose |
|---|---|
| Fast Node Bypasser | Adds a toggle widget per controlled node. Connect nodes to control them, or set the matchTitle regex property to auto-match by title. Sort by position / alphanumeric / custom alphabet. Toggle restrictions: default / max one / always one. Right-click for Bypass All / Enable All / Toggle All / Refresh. |
| Conditional Bypasser | Server-side gate: passes input through when enabled. When disabled, disabled_behavior picks block (returns ExecutionBlocker, downstream nodes don't run — default) or pass_none (downstream nodes run but receive None). Accepts any data type. |
MoonPack/video
| Node | Purpose |
|---|---|
| VACE Looper Frame Mask | Calculates total frames and a kjnodes 'Create Fade Mask Advanced' schedule. Optional images input clamps overlap to half the source length and reports it via was_clamped. |
| Frame Mask Generator | General-purpose schedule generator. Modes: linear_loop, ping_pong, ease_in_out, fade_in, fade_out, custom. |
Notable Details
Fast Node Bypasser — pattern matching
Set the matchTitle property to a regex (e.g. ^KSampler, (upscale|downscale))
and the bypasser auto-discovers matching nodes. Use the Refresh menu item to
re-scan after renaming nodes or changing patterns.
customSortAlphabet accepts either single chars (zyxw…) or comma-delimited
prefixes (sdxl,sd,n,p). Nodes whose titles start with the earliest entry come
first; ties break alphanumerically.
String Switch — lazy evaluation
MoonPack_StringSwitch declares each input as lazy: True and implements
check_lazy_status, so only the upstream graph for the selected branch is
evaluated. Use this for prompt A/B tests where each branch may chain expensive
generation.
Dynamic String Concat — template mode
If the template widget is non-empty, {1}, {2}, … placeholders are
interpolated from input slots and separator is ignored:
template: "{1}, in the style of {2}"
input_1: "a cat"
input_2: "Studio Ghibli"
result: "a cat, in the style of Studio Ghibli"
Missing slots resolve to an empty string.
MoonLoRA Loader — LoRAs and their trigger words in one node
Each row on the node carries a LoRA and the text that belongs with it, so the two can never drift apart. Toggling a row off removes both the LoRA and its trigger words from the output.
⊙ Toggle All Strength
╭──────────────────────────────────────────────╮
│ ⬤ style/pixel_v3.safetensors ◀1.00▶ ✕ │
│ pixel art, 8bit │
╰──────────────────────────────────────────────╯
➕ Add LoRA
- ➕ Add LoRA opens a filterable list of your local LoRA files.
- Click the filename to swap it, the strength to type a value, or drag the strength sideways to scrub it.
- Click the second line to edit that LoRA's trigger text.
- ✕ removes the row; right-click a row to toggle, reorder or edit it.
- Row order is the order the LoRAs are applied and the order their texts are concatenated.
- The
separatorwidget is inserted verbatim between texts (default". "). Empty texts and disabled rows contribute nothing. - Node property Show Strengths switches every row between one strength and separate model/clip strengths.
CLIPis optional — leave it unconnected for a model-only patch.- A LoRA whose file has gone missing is skipped with a warning, and its trigger text is dropped with it.
Everything is local. There is no Civitai lookup and no trigger-word scraping; the text is whatever you type, stored in the workflow.
MOSS Regional Layout — boxes and their LoRAs in one editor
Regular LoRAs bleed into the whole MOSS-Image picture. This node lets you draw
the layout and give each box its own LoRAs. Each LoRA is added in bypass mode
(W·x + m · s · ΔW·x) with its delta multiplied by the box's token mask m,
so a character LoRA only acts inside its box. Base weights stay untouched,
which also works with int8/fp8 checkpoints. One model pass per step.
Load Diffusion Model ─ MODEL ─► MOSS Regional Layout ─┬─ MODEL ─► KSampler
└─ prompt ─► CLIP Text Encode ─► KSampler
The editor is a fork of kijai's MOSS-Image Prompt Builder KJ (ComfyUI-KJNodes) and keeps all of it: drawing, layers, palettes, templates, background image, live preview, guides, fullscreen, docking. Both nodes can be installed side by side. On top of that:
- LoRAs per box. Select a box and press + LoRA. Each row has an on/off toggle, the LoRA (click to pick from a filterable list), a strength (−/+, drag sideways, mouse wheel, or double-click to type), trigger words, a schedule (⋯: active from/to a fraction of sampling) and ✕ to remove. Several LoRAs in one box add up.
- Trigger words of enabled LoRAs are appended to that box's caption
(
caption, trigger), so they reach the model through the layout prompt. - Scene LoRAs (toolbar):
allacts on the whole image like a normal LoRA;outsideacts only outside the LoRA boxes, e.g. for a location or style that must not touch the characters. Their trigger words go into the scene caption. - Names. A box name (e.g. Anna) shows on the canvas and in the preview. It is not sent to the model.
- Hide / solo. A hidden box is left out of the prompt, the masks and the bboxes but stays on the canvas, dimmed. Solo hides every other box until you click it again.
- Masks (toolbar) shows where each box's LoRAs act, on the model's 16-px token grid, including feather, skirt and overlaps.
- Size ▾ offers aspect × megapixel presets in multiples of 16.
- Undo / redo (↶ ↷, Ctrl+Z, Ctrl+Shift+Z / Ctrl+Y) for box and LoRA edits.
- Copy, Paste and Templates keep names, hidden flags and LoRAs in a
moonpackblock inside the JSON. Other tools ignore it, and the node'spromptoutput never contains it.
Masks
- Box 1 is the front-most box, as in the editor's layer list. Where LoRA boxes overlap, the front box owns the overlap.
- Only boxes that carry a LoRA take part. A box without LoRAs does not block a
LoRA box behind it, and
outsidescene LoRAs still act inside it. feathersoftens box edges (fraction of the box's shorter side, max 0.3);skirtgrows every LoRA box by a fraction of the image's shorter side. A tiny box always keeps at least one full-strength token.text_tokens = masked(default) keeps box LoRAs off the text tokens, which gives the least bleed.globallets them act on the text tokens too.mask_previewoutputs one mask per LoRA box (box order), then the background mask if anoutsidescene LoRA is used.
Overlapping characters: ownership = attention
With ownership = box the drawing decides: where two LoRA boxes overlap, the
front box (box 1) owns the overlap, and a character that spills out of its box
loses its LoRA there. ownership = attention lets the model decide instead,
similar to FreeFuse:
- For the first
measure_untilof sampling (default 30 %), the box masks apply while the node measures, in the middle transformer blocks, how much each image area attends to each box's caption (including its trigger words). - Then every token that is contested goes to the box whose caption it attends
to most: tokens in an overlap, or in the
spillring around a box (default 10 % of the image's shorter side; there a LoRA only takes tokens that clearly attend to it). Tokens inside only one box keep the box mask.
The console logs how many tokens each box gained and lost against its drawn box.
Connect the same CLIP you encode the prompt with to the clip input; it is only
used to find each caption's tokens. If the prompt is changed after this node
(e.g. extra text, prompt-weight markup), the token count no longer matches and
the node falls back to the box masks with a warning. measure_until, spill
and the editor's Masks view stay geometric; the attention decision happens
during sampling.
text_tokens = own caption (also needs clip) lets each box LoRA act on its
box's image tokens plus the tokens of its own caption, e.g. its trigger words,
but not on other boxes' captions. For character LoRAs this keeps most of what
global gives without leaking into other characters' captions.
Limits
- Only additive adapters (LoRA, LoHa, LoKr) can be masked. Bias/diff patches and
OFT in a box LoRA are skipped with a warning; scene
allLoRAs apply them as normal weight patches. DoRA magnitude is ignored. - The embedder and the modulation layers have no per-token place to mask, so box
LoRAs skip them. A scene
allLoRA applies there too. - Attention still mixes tokens, so a little style can seep into neighbouring
regions. Layout prompts are experimental in MOSS: a subject drawn outside its
box loses its LoRA. Keep boxes generous, or use
skirt. - On int8/fp8 checkpoints, layers carrying a LoRA leave the fused quantized kernel path, so sampling gets slower.
- One MOSS Regional Layout per model; a second one on the same model is refused.
- A LoRA file that is missing stops the run with the closest file names.
Text Builder — prompt fragments as a stack
Dynamic String Concat joins strings arriving over links. Text Builder owns
its text instead: press ➕ Add Text for a block, and each block is a real
multiline textarea with its own control strip.
- Toggle — a disabled block keeps its text but contributes nothing, so
prompt fragments can be A/B'd without deleting them.
Toggle Allflips every block at once. - Name a block — click its
#1caption (or pick Rename from the block's right-click menu) to label it, e.g.#2 lighting. Names are cosmetic; they never reach the output. - Reorder —
▲/▼on the strip, or Move Up / Move Down in the block's right-click menu. Output order is the order the blocks appear in, not the order they were created. - Right-click a block — Toggle, Move Up, Move Down and Remove, the same actions as the strip's own buttons.
textinput — optional. When connected it is always the first part and cannot be reordered.- Joining — parts are joined with
separatorverbatim (default,, soa,b; use,for a space).strip_whitespacetrims each part andskip_emptydrops the ones that end up empty, including the link input, so no stray separators appear.
Conditional Bypasser
Routes any value through when enabled is true. When false, disabled_behavior
controls what happens: block (default) returns an ExecutionBlocker,
preventing downstream nodes from executing entirely; pass_none lets
downstream nodes run normally but receive None instead of the value. Useful
for graph-driven branching that depends on upstream conditions.
Development
# Python nodes
pytest tests/
# Frontend widgets (MoonLoRA Loader) — needs Node, no dependencies
# Text Builder's frontend has no headless checks; verify it in ComfyUI.
node tests/js/run.mjs
# MOSS Regional Layout: editor mask math vs. the Python node
node tests/js/moss_layout_math.mjs
License
GPL-3.0 — see LICENSE.
Releases up to and including 0.3.0 were published under the MIT License and remain available under it. From 0.4.0 on, the pack is licensed under the GNU General Public License v3, so that it can include code derived from ComfyUI-KJNodes (GPL-3.0).