Wildcard & Preset Prompt Builder

DaSiWa Wildcard & Preset Prompt Builder builds independent positive and negative STRING prompts from an editable library. It is designed to work without a downstream wildcard picker.

Node inputs and controls

positive_input / negative_input: optional connected STRING inputs. When present, each value is prepended to that side's generated result. Blank values are ignored.
Seed: makes wildcard alternatives reproducible.
🎲 New Picks: changes the stored reroll value while retaining the selection, weights, style, and seed.
🎲 Random Select: replaces the current selection with a secure-random set of 1–10 available subjects, drawn from both Presets and Wildcards for the current style. It preserves a prior weight only when that same subject is selected again; new selections use 1.0.
New picks on every queue: opts into a fresh random wildcard choice for every queued execution. It does not change the saved manual reroll state.
Token budget: estimates token count locally and removes complete enabled subjects, lowest weight first, until the generated side fits the limit. Positive and negative prompts have independent limits.
Style: chooses the booru_* or nl_* library fields.

Select a subject independently for the positive or negative side. A weight of 1.0 emits plain text; another value emits ComfyUI emphasis syntax such as (cinematic lighting:1.2).

Selection visibility

Each Presets/Wildcards category header shows a green, right-aligned ✓ N selected badge when it contains enabled subjects, and the category border is highlighted. This stays visible when the category is collapsed, making Random Select results and manual selections easy to find. The badge count applies to that section only: a preset and wildcard with the same subject name are independent selections.

Library file

The bundled starter library is:

data/wildcards_and_presets_dual.json

It is ordinary JSON. You may edit it, replace it, or paste in a compatible custom version. There is no required version field, checksum, sidecar, or hash-generation step. Keep a backup of your custom file when updating the node, because a package update may replace the bundled starter file.

Restart ComfyUI after changing the library so the node reloads it.

JSON structure

The root object must contain wildcard_library.categories. Categories are an object, and their JSON order is the prompt assembly order. Each category contains an array of subject objects.

{
  "wildcard_library": {
    "categories": {
      "Positive Prompts": [
        {
          "subject": "Detail Level",
          "booru_wildcards": ["{high detail|very detailed}"],
          "nl_wildcards": ["{highly detailed|rich in fine detail}"],
          "booru_presets": [],
          "nl_presets": []
        }
      }
    }
  }
}

Subject fields

Field	Meaning
`subject`	Required visible name in the node UI.
`booru_wildcards`	Optional list of Booru/tag-style prompt fragments. One alternative is resolved from every `{option A
`nl_wildcards`	Optional list of natural-language prompt fragments.
`booru_presets`	Optional fixed Booru/tag-style prompt fragments.
`nl_presets`	Optional fixed natural-language prompt fragments.

Use [] for a field with no content. A subject may provide wildcards, presets, or both. The UI only shows a subject in the relevant Wildcards or Presets section when that section has content for the currently selected style.

The shipped file also includes legacy wildcards and presets arrays on its entries for compatibility with older tools. The builder selects from the style-specific booru_* and nl_* fields, so custom library entries should provide those fields.

Character Selection presets

Character Selection is a preset-only category placed after Art Style and before species details. It provides fixed, individually selectable Booru count tags for 1girl through 5girls, 1boy through 5boys, 1man through 5men, and 1woman through 5women, plus solo, group, and crowd. Natural Language emits proper phrases instead: 1girl becomes a girl, 2boys becomes two boys, and 5men becomes five men.

Each count is its own preset subject—not a wildcard—so selecting 3 Girls always emits 3girls; it never randomly changes to another count. Select one count/identity subject and, when useful, one scene-size subject such as Solo, Group, or Crowd. The builder does not automatically prevent contradictory manual selections.

Prompt text rules

{a|b|c} picks exactly one choice every time that subject is resolved.
Plain text outside braces is retained verbatim: soft {blue|red} lighting becomes soft blue lighting or soft red lighting.
Entries within one selected subject are joined with commas.
Enabled subjects are joined in category order.
Positive and negative selections are separate; selecting a subject on one side does not enable it on the other.
Optional connected positive_input and negative_input values are placed before the generated text on their respective sides.

Bundled category order

The bundled file uses an order intended to produce a model-friendly prompt: broad positive quality and style first, then subject/species, character attributes, clothing/body framing, pose/composition, scene, optional adult content, and negative controls last.

Positive Prompts
Art Style
Character Selection
Species - General
Species - Mythical
Species - Botanical
Species - Kemonomimi
Species - Mammals
Species - Aquatic
Species - Reptiles, Amphibians & Birds
Species - Insects & Arachnids
Character - Eyes
Character - Face
Character - Hair
Character - Body
Wardrobe
Body Visibility
Composition & Pose
Scene
NSFW
Negative Prompts

Species - Botanical contains only botanical concepts. Fantasy, undead, and creature concepts belong in Species - Mythical or another relevant species category.

FilesExpand file tree

wildcard_preset_prompt_builder.md

Latest commit

History