Magical Girl Builder — Wildcards + Standalone HTML

Build a complete magical girl outfit by mixing silhouette, accent color, hairstyle, headwear, chest accessory, gloves, wand, wings, footwear and transformation effect.

Designed for Stable Diffusion — Pony / Illustrious / SDXL.


━━━━━━━━━━━━━━━━━━━━━━━━
INSTALLATION
━━━━━━━━━━━━━━━━━━━━━━━━

Copy the mahou_shoujo_builder/ folder into your wildcards directory.
Open the HTML builders directly in your browser — no installation needed.

Wildcards:
  <your wildcards root>/mahou_shoujo_builder/
    outfit.txt
    accent_color.txt
    hairstyle.txt
    headwear.txt
    chest_accessory.txt
    gloves.txt
    wand.txt
    wings.txt
    footwear.txt
    effect.txt
    all.yaml

HTML Builders (open in browser, no server needed):
  html_builder/builder.html        Japanese
  html_builder/builder_en.html     English
  html_builder/builder_zh.html     Chinese (Simplified)
  html_builder/builder_pt.html     Portuguese


━━━━━━━━━━━━━━━━━━━━━━━━
WILDCARD USAGE (Dynamic Prompts)
━━━━━━━━━━━━━━━━━━━━━━━━

Option A — individual section files:
  1girl, magical girl, __mahou_shoujo_builder/outfit__, __mahou_shoujo_builder/accent_color__, __mahou_shoujo_builder/hairstyle__, __mahou_shoujo_builder/headwear__, __mahou_shoujo_builder/chest_accessory__, __mahou_shoujo_builder/gloves__, __mahou_shoujo_builder/wand__, __mahou_shoujo_builder/wings__, __mahou_shoujo_builder/footwear__, __mahou_shoujo_builder/effect__,

Option B — all-in-one (randomize everything at once):
  1girl, magical girl, __mahou_shoujo_builder/all/combined__

Partial randomization example:
  __mahou_shoujo_builder/outfit__   ← outfit silhouette only

Notes:
- The gloves section includes an empty option, so it may roll to nothing — that is intended.
- Color names follow Danbooru conventions (no lavender, coral, mint, etc.)
- "1girl, magical girl" is not included in the wildcard files — add it yourself


━━━━━━━━━━━━━━━━━━━━━━━━
HTML BUILDER FEATURES
━━━━━━━━━━━━━━━━━━━━━━━━

- Click items to build your prompt section by section
- Random — randomize all unlocked sections at once
- Lock — pin any section to keep it fixed during randomization
- Lock All / Unlock All — bulk toggle
- Reset — restore all sections to default
- Clear — deselect everything
- Copy — copy the assembled prompt to clipboard

Lock state persists in localStorage between sessions.


━━━━━━━━━━━━━━━━━━━━━━━━
ATTRIBUTE COVERAGE
━━━━━━━━━━━━━━━━━━━━━━━━

Outfit silhouette (9): classic, princess, warrior, dark, fairy, maid, school uniform, idol stage, gothic lolita
Accent color (12): red, pink, light pink, orange, yellow, yellow-green, green, light blue, blue, dark blue, purple, white
Hairstyle (8): twin tails, long straight, drill curls, hime cut, high ponytail, braided crown, short bob, twin odango buns
Headwear (7): tiara, twin hair ribbons, butterfly ornament, mini witch hat, ribbon hairband, star clips, circlet
Chest accessory (6): large bow, crescent brooch, star brooch, gem pendant, heart brooch, frilled jabot
Gloves (6): long opera gloves, fingerless gloves, puffy short gloves, lace gloves, arm warmers, none
Wand / weapon (8): star wand, crystal rod, butterfly wand, winged staff, magic sword, heart scepter, ribbon baton, none
Wings (7): butterfly, angel, bat, fairy, crystal, magic circle, none
Footwear (8): knee socks + heels, striped socks + loafers, garter thigh + boots, thigh boots, barefoot + anklet, frilled boots, mary janes + ribbon socks, over-knee + ribbon
Transformation effect (6): swirling ribbons, stardust, petals, moonlight aura, drifting feathers, none

77 options across 10 sections.


━━━━━━━━━━━━━━━━━━━━━━━━
日本語 / Japanese
━━━━━━━━━━━━━━━━━━━━━━━━

魔法少女ビルダー — ワイルドカード + HTML ビルダー

衣装シルエット・アクセント色・髪型・頭の装飾・胸元・グローブ・ステッキ・翼・足元・変身エフェクトを組み合わせて、魔法少女衣装をまるごと構築できます。

【インストール】
mahou_shoujo_builder/ フォルダを wildcard ディレクトリにコピーします。
HTML ビルダーはブラウザで直接開くだけです（サーバー・ネット不要）。

【ワイルドカードの使い方】
  1girl, magical girl, __mahou_shoujo_builder/outfit__, __mahou_shoujo_builder/accent_color__, （…各セクション）

一括ランダムなら:
  1girl, magical girl, __mahou_shoujo_builder/all/combined__

【HTMLビルダーの機能】
ランダム・ロック・全ロック/解除・リセット・クリア・コピー対応。
4言語版（日・英・中・葡）収録。ロック状態は次回起動時も保持。

【属性カバレッジ】
衣装シルエット (9): クラシック・プリンセス・戦士・ダーク・妖精・メイド・制服・アイドル・ゴシック
アクセント色 (12): 基本色＋修飾語のみ
髪型 (8): ツインテール・ロング・ドリル・姫カット・ポニー・編み込み・ボブ・おだんご
頭の装飾 (7): ティアラ・髪リボン・蝶飾り・ミニ帽子・カチューシャ・星クリップ・サークレット
胸元 (6): 大リボン・月/星/ハートブローチ・宝石・ジャボ
グローブ (6): ロング手袋・指なし・パフ・レース・アームウォーマー・なし
ステッキ/武器 (8): 星・クリスタル・蝶・翼・剣・ハート笏・リボンバトン・なし
翼 (7): 蝶・天使・蝙蝠・妖精・クリスタル・魔法陣・なし
足元 (8): ニーソ+ヒール 他8種
変身エフェクト (6): リボン・星屑・花びら・月光・羽根・なし

10セクション・全77通り。色名は Danbooru 準拠（固有名詞色は不使用）。