Nodes/RES4LYF/SharkOptions Guide Conds
ComfyUI Node Runs on cloud

SharkOptions Guide Conds

Separate conditioning and CFG for masked vs. unmasked regions

By ClownsharkBatwing·Created 2 years ago·Updated 18 days ago· 1,222
SharkOptions Guide Conds
  • positive_masked
  • positive_unmasked
  • negative_masked
  • negative_unmasked
  • options
  • options
cfg_masked1.00
cfg_unmasked1.00

RES4LYF's regional conditioning is built for "unlimited zones" - the README shows workflows with over ten masked regions each carrying their own prompt. Getting that right means the sampler needs to know two separate things for a given guide: what to do inside the mask, and what to do outside it. SharkOptions_GuideConds_Beta is the node that packages exactly that - a masked conditioning pair with its own CFG, and an unmasked conditioning pair with its own CFG, bundled into one OPTIONS object for a guide-aware sampler to consume.

It's the plural, masked/unmasked sibling of SharkOptions_GuideCond_Beta, which only handles a single, undivided guide. Reach for this one specifically when you're doing regional work - different prompts for a zone versus the rest of the frame - rather than a single global guide.

Same caveat as its sibling: this is a "Beta"-tagged node, newer than the pack's older README, so treat the specifics as more likely to shift than RES4LYF's long-stable core samplers.

The inputs and outputs that matter

  • positive_masked / negative_masked (CONDITIONING, optional) - the prompt pair applied inside the masked region.
  • positive_unmasked / negative_unmasked (CONDITIONING, optional) - the prompt pair applied outside it, to the rest of the frame.
  • cfg_masked (default 1) and cfg_unmasked (default 1) - independent CFG values for each side. This is genuinely useful on its own even before you think about the prompts: a masked subject and an unmasked background often want different amounts of guidance strength, and a single shared CFG forces a compromise.
  • options (OPTIONS, optional) - chain in an existing options bundle if you're layering this on top of settings from another options node.

Output: options - wire it into whichever guide input on your sampler (typically ClownsharKSampler, or another RES4LYF guide-consuming node) is set up to read masked/unmasked conditioning for a given zone. You'll also need an actual MASK wired into the guide itself somewhere in your graph - this node carries the conditioning and CFG split, not the mask geometry; that's a separate input elsewhere in a regional-conditioning setup (and if you want to A/B a zone's mask on and off while testing this, MaskToggle is the node for that).

How to install it

Ships with RES4LYF - no separate install. Via ComfyUI Manager: search "RES4LYF", install, restart. Manually:

cd ComfyUI/custom_nodes
git clone https://github.com/ClownsharkBatwing/RES4LYF/
cd RES4LYF
pip install -r requirements.txt

Common issues & troubleshooting

Only one side of the mask seems to be listening. Double-check you actually connected conditioning to both the masked and unmasked slots - leaving one pair unconnected likely falls back to null/default conditioning for that side rather than inheriting your main prompt, which is an easy way to end up with an unintentionally blank background or subject.

The masked region and the background fight each other visually, with a visible seam. This is a known regional-conditioning pain point independent of this specific node - RES4LYF's README notes masks can be drawn freely or kept rigid, and a hard-edged mask with very different CFG or prompt on each side is more likely to show a seam than a softer one. Try feathering the mask before assuming the conditioning values are wrong.

You only need one prompt pair, not a masked/unmasked split. If there's no actual region distinction in what you're doing - you just want independent CFG or conditioning on a single guide - use the simpler SharkOptions_GuideCond_Beta instead; this node's masked/unmasked split is overhead you don't need for that case.

Zones stacking weirdly with more than one masked region. For genuinely "unlimited zones" workflows with many overlapping regions, chain multiple guide setups (each with its own mask and its own SharkOptions_GuideConds_Beta or SharkOptions_GuideCond_Beta) through the options input rather than trying to force every zone through a single masked/unmasked pair - this node handles one mask boundary, not an arbitrary number of them at once.

CategoryRES4LYF/sampler_options

Inputs (7)

NameTypeDefaultDescription
positive_maskedoptCONDITIONING
positive_unmaskedoptCONDITIONING
negative_maskedoptCONDITIONING
negative_unmaskedoptCONDITIONING
cfg_maskedoptFLOAT1.00-10000–10000
cfg_unmaskedoptFLOAT1.00-10000–10000
optionsoptOPTIONS

Outputs (1)

NameTypeDescription
optionsOPTIONS