<h1 id="xianxia-beauty-wildcards">Xianxia Beauty Wildcards</h1>Wildcards for ancient Chinese xianxia (cultivation) beauty themes. Optimized for Stable Diffusion (incl. Pony XL models).<h2 id="version-update-notes">Version Update Notes</h2><ul><li>Version 4.0: Adds role preset prompts, so a single role can be rendered quickly with a simple wildcard call.</li><li>Version 3.5: Clarifies prop boundaries by moving handheld/worn props to <code>poses</code> and scene props to <code>backgrounds</code>, and deprecates <code>decorations/artifacts.txt</code> and <code>decorations/props.txt</code>.</li><li>Version 3.0: Restructures wildcard taxonomy into clearer subfolders (clothing/makeup/decorations), while simplifying legacy files and related docs.</li></ul><h2 id="installation">Installation</h2><h3 id="stable-diffusion-webui-(a1111)">Stable Diffusion WebUI (A1111)</h3><ol><li>Install <a target="_blank" rel="ugc" href="https://github.com/AUTOMATIC1111/stable-diffusion-webui-wildcards">Wildcards extension</a>.</li><li>Copy the <code>xianxia</code> folder to: <code>extensions/stable-diffusion-webui-wildcards/wildcards/</code></li></ol><h3 id="comfyui">ComfyUI</h3><ol><li>Install a wildcard-supported node pack (for example <a target="_blank" rel="ugc" href="https://github.com/ltdrdata/ComfyUI-Impact-Pack">ComfyUI-Impact-Pack</a>).</li><li>Copy the <code>xianxia</code> folder to that pack's: <code>custom_wildcards/</code></li></ol><h2 id="usage">Usage</h2>Start with role-based wildcard first.Role list (quick pick):<ul><li><code>orthodox_sword</code> — Righteous orthodox sword cultivator</li><li><code>demonic_blade</code> — Demonic blade cultivator</li><li><code>spirit_healer</code> — Spiritual healer cultivator</li><li><code>talisman_oracle</code> — Talisman and ritual cultivator</li><li><code>fox_spirit</code> — Fox spirit beauty</li><li><code>imperial_phoenix</code> — Imperial phoenix court beauty</li><li><code>moon_priestess</code> — Moonlight priestess</li><li><code>rogue_assassin</code> — Rogue shadow assassin</li><li><code>wandering_musician</code> — Wandering musician</li><li><code>dragon_noble</code> — Dragon-blood noble lady</li><li><code>poison_alchemist</code> — Poison-path alchemist</li><li><code>frost_archer</code> — Frost archer cultivator</li><li><code>drunken_sword_immortal</code> — Drunken sword immortal</li><li><code>array_grandmaster</code> — Grand array strategist</li><li><code>puppet_mechanist</code> — Puppet mechanist</li><li><code>thunder_spear</code> — Thunder spear battle cultivator</li><li><code>lotus_buddhist</code> — Lotus dharma cultivator</li><li><code>star_astrologer</code> — Celestial astrologer</li><li><code>ghost_envoy</code> — Underworld ghost envoy</li><li><code>beast_tamer</code> — Spirit beast tamer</li><li><code>snow_lotus_saint</code> — Snow lotus saint</li><li><code>blood_monk</code> — Blood-vow monastic cultivator</li><li><code>mirror_illusionist</code> — Mirror illusion cultivator</li><li><code>bone_necromancer</code> — Bone necromancer</li></ul>Usage format: <code>__xianxia/characters/&lt;role&gt;__</code> (replace <code>&lt;role&gt;</code> with any ID above).Character-scoped wildcard examples (one role per prompt):Orthodox sword cultivator:<pre><code>__xianxia/characters/orthodox_sword__
</code></pre>If you want external poses wildcards, use the pose-free variant:<pre><code>__xianxia/characters_pose_free/orthodox_sword__, __thirdparty/poses__
</code></pre>Wandering musician:<pre><code>__xianxia/characters/wandering_musician__
</code></pre>Matching pose-free variant:<pre><code>__xianxia/characters_pose_free/wandering_musician__, __thirdparty/poses__
</code></pre>If you want random composition, use this prompt to combine unexpected character details:<pre><code>1girl, hanfu, seductive smile, 
__xianxia/races__, 
__xianxia/poses__,
__xianxia/makeup/eyes__, 
__xianxia/makeup/forehead__, 
__xianxia/makeup/hair__, 
__xianxia/makeup/eyebrows__,
__xianxia/decorations/earrings__, 
__xianxia/decorations/necklaces__, 
__xianxia/decorations/bracelets__, 
__xianxia/decorations/anklets__, 
__xianxia/decorations/rings__,
__xianxia/decorations/hairpins__, 
__xianxia/decorations/hair_combs__, 
__xianxia/decorations/hair_ornaments__, 
__xianxia/decorations/veils__,
__xianxia/primary_colors__, 
__xianxia/clothing/tops__, 
__xianxia/clothing/sleeves__, 
__xianxia/clothing/belts__,
__xianxia/clothing/skirts__, 
__xianxia/clothing/skirt_details__, 
__xianxia/clothing/stockings__, 
__xianxia/clothing/shoes__,
chinese ancient style, 
__xianxia/backgrounds__, 
__xianxia/environments__, 
__xianxia/lighting__
</code></pre>Prop boundary reminder:<ul><li>Handheld or worn items belong to <code>poses</code></li><li>Scene setup items belong to <code>backgrounds</code></li></ul>

Xianxia Beauty Wildcards

<ul><li>New 100-item wildcard sets: advanced accessories, advanced actions, advanced hairstyles, eyebrows, qipao styles, collars, skirt details, stockings, emotions, environments, lighting, seasons, textures, advanced colors, races, plus expanded examples (22 files touched, ~2264 insertions).</li><li>Color control upgrade: <code>primary_colors</code> (clean dominant hues) + <code>colors_advanced</code> (material / ambience accents) to reduce whitening and color drift.</li><li>Prompt examples separated into <code>PROMPT_EXAMPLES*</code>; README streamlined and adds color usage guidance.</li><li>Clothing &amp; styling depth: qipao variants, neckline types, skirt construction details, stockings, layered aesthetic control.</li><li>Atmosphere &amp; narrative: environment, lighting, season, texture, emotion vocab for richer storytelling.</li></ul>

Files with SHA256: da8eb207ab67fa836432d9c0eedeab3cc050685b5bca84e5ad51d8f81d8ddb86