<h1 id="bkwildcards">BKWILDCARDS</h1>A ComfyUI custom node that turns a bundled wildcard library into scoped dropdowns and emits a finished prompt string.No wildcard syntax to learn. No <code>__token__</code> to type. Pick a theme, choose the categories you want, wire one output into your prompt, and generate.Ships with 5,277 hand-written entries across 54 categories and 8 themes — art styles, cybernetics, outfits, Halloween costumes, environments, poses, ancestry, species, hair, eyes, physical features, camera framing and more, all written for natural-language prompting.Includes all current and updated version of my wilcard sets that are part of the <a target="_blank" rel="ugc" href="https://civarchive.com/collections/15989234">BKWILDCARDS collection</a>:<ul><li><a target="_blank" rel="ugc" href="https://civarchive.com/models/2514158/all-the-dresses-dresses-and-gowns-prose">All the Dresses</a></li><li><a target="_blank" rel="ugc" href="https://civarchive.com/models/2503377/all-the-dresses-eastern-prose">All the Dresses, Eastern Edition</a></li><li><a target="_blank" rel="ugc" href="https://civarchive.com/models/2536384/ghostrunner">_ghost.runner</a> (cyberpunk)</li><li><a target="_blank" rel="ugc" href="https://civarchive.com/models/2530671/whimsical-woods">Whimsical Woods</a> (dark fantasy)</li><li><a target="_blank" rel="ugc" href="https://civarchive.com/models/2514184/cozy-sexy-lacy-racy-sleepwear">COZY SEXY LACY RACY Sleepwear</a> (lingerie)</li><li><a target="_blank" rel="ugc" href="https://civarchive.com/models/2511893/autumnal-oxidation">Autumnal Oxidation </a>(goth)</li><li><a target="_blank" rel="ugc" href="https://civarchive.com/models/2810002/cassette-futurism">Cassette Futurism</a> (retro sci-fi)</li><li><a target="_blank" rel="ugc" href="https://civarchive.com/models/2841818/nettie-necket">Nettie Necket</a> (steam punk)</li><li><a rel="ugc" href="https://civarchive.com/models/2905640/haunted-hallows">Haunted Hallows</a> (Halloween) 🆕</li></ul><h2 id="install">Install</h2><h3 id="install-via-comfyui-manager-(recommended)">Install via ComfyUI-Manager (recommended)</h3>The easiest way. BKWILDCARDS is published on the <a target="_blank" rel="ugc" href="https://registry.comfy.org/nodes/bkwildcards">Comfy Registry</a>, so <a target="_blank" rel="ugc" href="https://github.com/Comfy-Org/ComfyUI-Manager">ComfyUI-Manager</a> can install it for you; no git, no manual file copying.<ol><li>Open Manager → Custom Nodes Manager.</li><li>Search for BKWILDCARDS.</li><li>Click Install.</li><li>Restart ComfyUI when prompted.</li></ol>There are no dependencies to install as the node uses only the Python standard library.<h3 id="updating">Updating</h3><ul><li>Via ComfyUI-Manager: open Manager → Custom Nodes Manager, find BKWILDCARDS, and click Update (or use Update All). Restart ComfyUI to load the new version. Manager pulls the latest release from the Comfy Registry.</li><li>Via git (if you installed with <code>git clone</code>): run <code>git pull</code> inside the <code>BKWILDCARDS</code> folder, then restart ComfyUI.</li></ul>The node title shows the build number (e.g. <code>BKWILDCARDS Selector 0.9.8</code>), so you can confirm the update took.<h3 id="manual-install-(git)">Manual install (git)</h3><pre><code>cd ComfyUI/custom_nodes
git clone https://github.com/bkidderz/BKWILDCARDS.git</code></pre>Restart ComfyUI. There are no dependencies to install — the node uses only the Python standard library.<h3 id="manual-install-(zip)">Manual install (ZIP)</h3><ol><li>Download this repository as a ZIP (Code → Download ZIP).</li><li>Extract it into <code>ComfyUI/custom_nodes/</code>.</li><li>Make sure the folder is named <code>BKWILDCARDS</code> and contains <code>__init__.py</code> directly inside it.</li><li>Restart ComfyUI.</li></ol><h3 id="where-is-custom_nodes">Where is custom_nodes?</h3><ul><li>ComfyUI Desktop (Windows)<ul><li><code>%LOCALAPPDATA%\Comfy-Desktop\ComfyUI-Installs\ComfyUI\ComfyUI\custom_nodes</code></li></ul></li><li>Portable / manual<ul><li><code>&lt;your ComfyUI folder&gt;\ComfyUI\custom_nodes</code></li></ul></li></ul><h2 id="how-to-use">How to use</h2>Add BKWILDCARDS Selector to your workflow (right-click → Add Node → BKWILDCARDS).ImportantYou must wire the node's <code>prompt</code> output into a prompt block.The node does not talk to your model on its own — it only produces text. Connect its <code>prompt</code> output to whatever feeds your positive prompt: a <code>CLIPTextEncode</code> node's <code>text</code> input, or a string node (such as <code>StringFunction</code>) that is already feeding your prompt.The node tells you if you forgot: it turns red and displays <code>NOT ready, please wire the node to your prompt block.</code> Once wired, it turns green and reads <code>ready — press Run</code>.<h3 id="basic-workflow">Basic workflow</h3><ol><li>Pick a theme (top of the node) — e.g. <code>_ghost.runner</code>, <code>Whimsical Woods</code>, <code>All the Dresses</code>. Only that theme's categories are shown and can contribute.</li><li>Pick a gender — <code>Female</code>, <code>Male</code>, <code>— random —</code> (rolls per image), <code>Fluid</code> (both sets available), or <code>— off —</code>.</li><li>Choose your categories. Most are dropdowns with three kinds of choice:<ul><li><code>— off —</code> — this category contributes nothing</li><li><code>— random —</code> — draw from the whole file</li><li>a named section (e.g. <code>Netrunner / Decker</code>, <code>Interiors</code>, <code>Cybergoth</code>) — draw only from that section</li></ul></li><li>Wire <code>prompt</code> into your prompt block (see the callout above).</li><li>Press Run. The node draws one line from each active category and joins them into a single prompt.</li></ol><h3 id="getting-a-new-result-each-run">Getting a new result each run</h3>Set the <code>seed</code> widget's control to <code>randomize</code> for a fresh combination every queue, or <code>fixed</code> to lock a result you like. The <code>seed</code> fully determines the output — the same seed always reproduces the same prompt.<h3 id="reading-what-it-produced">Reading what it produced</h3>The output box at the bottom of the node fills in with the exact prompt, updating the moment you press Run — before the image renders. That same text is embedded in generated PNGs, so dragging a finished image back into ComfyUI restores the prompt that made it.<h2 id="features">Features</h2><h3 id="labeled-output">Labeled output</h3>By default the node tags each selection so the renderer reads structured attributes instead of one run-on sentence:<pre><code>gender: a woman,
ancestry: korean, warm-toned East Asian features, monolid eyes, …,
hair: soft black hair, with loose open S-shaped waves, half-up …,
outfit: a sleeveless heavy canvas coverall unzipped low over …,
color palette: muted olive-drab and warm-tan accents …,
scene/background: an exterior landing pad, a boxy retrofuturist craft …,
pose: the subject holds one wrist up close to check a strapped readout …
</code></pre>Flip <code>label_output</code> to <code>plain</code> for a single comma-joined string instead.<h3 id="mayhem-mode">🤪 Mayhem mode</h3>Flip <code>mayhem</code> on in Settings for one-click chaos: the node ignores every selection, the theme and the gender, and composes a fully random cross-theme image, a cyberpunk outfit in a fantasy shrine with a goth pose, and so on. Queue again for a new one. It stays seed-deterministic, so any result you like can be reproduced or recovered from its PNG.<h3 id="live-output-preview">Live output preview</h3>The output box updates at queue time, before generation starts, so you can see exactly what the run will use. The previewed text is guaranteed identical to what the image is generated from.

BKWILDCARDS Custom Node for ComfyUI

⚠️ Re-add required. If you have previously installed the node, delete the BKWILDCARDS Selector node and add it again after updating. 0.9.16 inserts new widgets in the middle of the node, which shifts the saved positions of everything below them. One-time step; wiring and other nodes are unaffected. ⚠️ New: Skin Tone control<ul><li>A Skin Tone dropdown in Physical - Body (under the body sliders) rolls a coloration that fits your chosen Metatype and emits it right after the metatype in the prompt.</li><li>Each metatype has its own palette: human skin tones for people, reds/violets/golds for tieflings, colored scales for dragonborn, matte/chrome synthetic skin for androids, coat fur for full beast-forms, a drained pallor across every skin depth for vampires, and a glow color for holograms.</li><li>The dropdown only offers the families that fit the selected metatype (no green tones on a human, no undead tones on an android), and Mayhem keeps the coloration coherent with a selected metatype.</li><li>Note: this adds an input, so it forces a one-time node re-add. Delete and re-add the BKWILDCARDS Selector once after updating.</li></ul>Metatypes reworked for better rendering:<ul><li>Dragonborn restored, with its own scaled-coloration group.</li><li>Android rebuilt from a bulky robot to a life-like synthetic look (smooth plastic-polymer skin with fine etched seam lines, Edgerunners style), plus a <code>synthetic skin</code> coloration anchor.</li><li>Hologram rebuilt as a glowing translucent light-being (crystalline and wireframe variants), with a glow-color-only axis.</li><li>Vampire coloration widened to the full human depth range, each drained to a pallor. A dark-skinned vampire now renders ashen-dark instead of defaulting pale.</li></ul>Ancestry simplified<ul><li>Ancestry lines are now facial structure only (regional features, eyes, cheekbones, nose, lips). Hair and skin tone were removed so ancestry no longer fights the Hair controls or the new Skin Tone control. The demonym still carries default coloring on its own.</li></ul>Other changes<ul><li>Gender wording softened to "a feminine adult," "a masculine adult," "an androgynous adult" for more reliable non-human rendering.</li><li>Shot Angle de-duplicated (20 down to 17) with POV removed; Shot Framing de-duplicated (50 down to 33).</li><li>Minor BKSTYLE art-direction tweak (surface and material textures, so it stops seeding human-skin detail on non-human subjects).</li><li>Internal: skin-tone bank parser hardened.</li></ul>Node now: 54 categories, 8 themes, 30 metatype sections, roughly 5,244 entries, plus a 192-tone coloration bank.

Files with SHA256: fd53d7ee5e367b8aeb91da8b1d3df1b2be7785b32b7e98889050cc519a61f75e