<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

Highlights<ul><li>Finer clothing control: All clothing under xianxia/clothing/* with new categories (collars, qipao, shoes, skirt_details, stockings) for precise styling.</li><li>Fully granular decorations: Independent lists for earrings, necklaces, bracelets, anklets, rings, hairpins, hair_combs, hair_ornaments, veils, plus artifacts and props for better mix-and-match.</li><li>Richer behavior cues: New actions list to enhance interaction and expression.</li><li>Clearer color and structure: Use primary_colors for dominant tones; consistent, memorable taxonomy across files.</li><li>More stable results: Curated backgrounds, environments, hairstyles, and textures reduce noise and improve output consistency.</li><li>Friendlier docs: English + zh-TW README now include a single, comprehensive example covering all wildcards.</li></ul>Why It’s Better<ul><li>Precision control: Target specific elements (e.g., a single accessory or garment detail) to match your desired look.</li><li>Faster composition: Unified structure and naming reduce trial-and-error and speed up batch workflows.</li><li>Consistent quality: Leaner, cleaner lists minimize conflicting terms and yield more reliable generations.</li></ul>Quick Example<pre><code>1girl, &lt;lora:hanfu pony:0.6&gt;, 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/decorations/artifacts__, __xianxia/decorations/props__,
__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>Compatibility Note<ul><li>Paths are more intuitive but changed; update any existing prompts to the new structure (clothing under xianxia/clothing/*, decorations use specific lists).</li></ul>Recommended Model<ul><li><a target="_blank" rel="ugc" href="https://civitai.com/models/853112">Hanfu Pony</a> (Pony XL family)</li></ul>

Files with SHA256: bb26b6156e1aa5fb2d8b29ca92275ba82f6428f0fc9f414521669a28997db113