Wildcards Matrix(wildcardsPromptMatrix)

Description

Wildcards Matrix (class wildcardsPromptMatrix) is a prompt-builder node in the EasyUse/Prompt category. It expands a prompt template containing wildcard placeholders into one or more concrete prompt strings. The two COMBO inputs act as convenience pickers for inserting LoRA references and wildcard tokens, while offset and output_limit control which combinations are generated.

Inputs

text

• Type: STRING
• Required: Yes
• Default: ""

The main prompt template. Wildcard placeholders and ordinary prompt text belong here. This is the text that gets expanded into the final prompt output.

Select to add LoRA

• Type: COMBO
• Required: Yes

A dropdown of available LoRAs. Selecting an entry inserts a LoRA reference into the prompt being built.

Select to add Wildcard

• Type: COMBO
• Required: Yes

A dropdown of available wildcards. Selecting an entry inserts a wildcard token into the prompt being built.

offset

• Type: INT
• Required: Yes
• Default: 0
• Min: 0
• Step: 1

The starting index into the expanded wildcard matrix. Use this to skip earlier combinations or to resume from a previous batch.

output_limit

• Type: INT
• Required: No
• Default: 1
• Min: -1
• Step: 1
• UI tooltip: "Output All Probilities"

The maximum number of expanded prompt results to generate. With the default value of 1, the node returns only the prompt at the current offset. Raise this value to produce more results, or set it to -1 to output all possibilities — the tooltip in the UI describes this as "Output All Probilities".

Outputs

The node has three positional outputs:

• STRING — The expanded prompt text generated from the current matrix position.
• INT — The current index/offset of the generated result within the matrix.
• INT — The total number of available expansions for the given prompt template.

Usage Notes

• Leave offset at 0 and output_limit at 1 to generate a single prompt starting from the beginning of the matrix.
• Set output_limit to -1 to generate the full set of wildcard combinations.
• To process the matrix in chunks, increase offset and use the first INT output as a progress marker for the next execution.
• The COMBO inputs are editing aids; they are not required for expansion if text already contains the desired wildcard or LoRA syntax.