Simple Wildcards (Dir.)
Wildcard files from anywhere on disk
- text
This is the wildcards node the pack author actually wants you using. It does the same __name__ random-line substitution as the older Simple Wildcards node, but instead of locking you to a wildcards folder inside ComfyUI's own root, you give it a directory input and it reads from wherever you point it. That sounds like a small change; in practice it's the difference between "my wildcard library lives wherever ComfyUI happens to be installed" and "my wildcard library is a folder I can put on a shared drive, sync between machines, or organize per-project without touching ComfyUI's install directory at all." The README says it plainly: for new workflows, use this one.
How it works
Write your prompt with __name__ tokens the same as always - double underscore on both sides, matching a .txt filename in your target directory (country.txt for __country__). Point directory at that folder. On each run the node reads the matching file and substitutes a random line. Wildcards nest recursively, so a wildcard file can reference other wildcard files and they'll resolve inside each other. Lines starting with # are treated as comments and ignored, blank lines get filtered out automatically, and if a wildcard doesn't have a matching file, the literal __missing__ text survives into your output and a warning prints to the console - genuinely handy for catching a typo'd filename before it reaches CLIP Text Encode as garbage text, as long as you're actually looking at the console when it happens.
Inputs and output
text- multiline prompt string with your__wildcard__tokens.directory- the folder to read.txtwildcard files from. Any path on disk, doesn't need to be inside ComfyUI's install.seed- reproducibility; same seed picks the same lines across runs.wildcard_depth(default 50, range 2–256) - recursion ceiling for nested wildcards, there purely to stop an accidental circular reference from hanging the run. Leave it alone unless you're doing something unusually deep.
Output: text (STRING), the resolved prompt.
Installing it
ComfyUI Manager: search ComfyUI-GTSuya-Nodes, install, restart. Or by hand: cd ComfyUI/custom_nodes && git clone https://github.com/GTSuya-Studio/ComfyUI-Gtsuya-Nodes.git, restart. No models, no extra dependencies - create a folder of .txt files anywhere you like and point directory at it.
Where people get burned
Directory typos are the most common miss - since the node has no fixed default location to fall back on, a wrong path just means every wildcard in your prompt comes back as __missing__, which reads at a glance like the node is broken rather than misconfigured. Check the path first. Second, remember there's a completely separate wildcards implementation living in Impact Pack, which almost everyone has installed alongside this pack - same __name__ syntax, different backend, different folder. If a wildcard resolves to something you didn't expect, it's worth confirming which node actually processed that part of your prompt before you go debugging the wrong one.
Inputs (4)
| Name | Type | Default | Description |
|---|---|---|---|
| text | STRING | — | |
| directory | STRING | — | |
| seed | INT | 00–18446744073709550000 | — |
| wildcard_depth | INT | 502–256 | — |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| text | STRING | — |