SD Character Rotation｜キャラクター・プロンプト自動切替ツール

SD Character Rotation

Stable Diffusion WebUI Forge / reForgeで、登録したキャラクターやプロンプトを

「重複を抑えながらランダムにローテーション」

するための拡張機能です。

━━━━━━━━━━━━━━━━━━━━

■ ランダムだけど、偏りにくい

━━━━━━━━━━━━━━━━━━━━

Dynamic Promptsのワイルドカードは便利ですが、毎回独立したランダム抽選のため、

・同じ候補が何度も続く

・特定の候補がなかなか出ない

・生成回数に偏りが出る

といったことがあります。

SD Character Rotationでは、登録された候補をランダムにシャッフルして1周させます。

A / B / C / D

【1周目】

C → A → D → B

全候補を使い終わると再シャッフル。

【2周目】

B → D → A → C

【ランダム性を保ちながら、1周の中では登録候補を漏れなく使用できます】

━━━━━━━━━━━━━━━━━━━━

■ シンプルな使い方

━━━━━━━━━━━━━━━━━━━━

dataフォルダ内の.txtファイルがカテゴリになります。

例：

data/my_characters.txt

Prompt：

_my_characters_

これだけで登録内容を画像ごとにローテーションします。

━━━━━━━━━━━━━━━━━━━━

■ キャラクター以外にも使用可能

━━━━━━━━━━━━━━━━━━━━

キャラクターだけでなく、

・ポーズ

・衣装

・背景

・表情

・その他のプロンプト

などもカテゴリとして登録できます。

複数カテゴリの同時使用にも対応。

_my_characters_, _pose_, _outfit_

それぞれ独立してローテーションします。

━━━━━━━━━━━━━━━━━━━━

■ Dynamic Promptsと併用可能

━━━━━━━━━━━━━━━━━━━━

Character Rotation：

_category_

Dynamic Prompts：

__category__

Character Rotationは「前後が1個の _ 」だけを認識するため、

_my_characters_, __pose__

のように同じPrompt内で使い分けることができます。

━━━━━━━━━━━━━━━━━━━━

■ 実際に使用されたPromptを記録

━━━━━━━━━━━━━━━━━━━━

生成結果下のPromptには、_category_ のままではなく、実際に選択された内容が反映されます。

例：

入力：

_category_a_, _category_b_, 1girl, solo

生成後：

prompt_entry_a, prompt_entry_b, 1girl, solo

PNG Infoにも置換後のPromptが記録されるため、大量生成後でも各画像で実際に使用された内容を確認できます。

━━━━━━━━━━━━━━━━━━━━

■ その他の機能

━━━━━━━━━━━━━━━━━━━━

・一巡するまで同じ候補を重複選択しない

・一巡後は自動で再シャッフル

・生成途中で停止しても次回は続きから再開

・Batch countを使った大量生成に対応

・複数カテゴリを独立してローテーション

・リスト変更を自動検知

・キャラクターごとのLoRA指定に対応

・キャラクター名に対応するLoRAの自動検出

・存在しないLoRA指定をチェック

・reset_rotation_state.batで進行状態をリセット

リスト内では、

グループ名

===== グループ名 =====

のような見出しや空行を使用できます。

これらはローテーション候補として読み込まれません。

━━━━━━━━━━━━━━━━━━━━

■ こんな場合に

━━━━━━━━━━━━━━━━━━━━

【ランダム感は欲しい。でも候補を偏りなく一通り使いたい】

という場合に向いています。

Dynamic Promptsの通常ランダムとCharacter Rotationを用途に応じて併用することもできます。

※Stable Diffusion WebUI Forge / reForge向け

※大量生成では Batch size = 1 推奨

※詳細な導入方法・使用方法・注意事項は付属READMEをご確認ください。

━━━━━━━━━━━━━━━━━━━━

English — SD Character Rotation

━━━━━━━━━━━━━━━━━━━━

SD Character Rotation is an extension for Stable Diffusion WebUI Forge / reForge that randomly rotates through registered characters or prompt entries while reducing repetition.

Instead of independently selecting a random entry every time, it shuffles all registered entries and uses each one before reshuffling.

Example:

A / B / C / D

Cycle 1:

C → A → D → B

Cycle 2:

B → D → A → C

【Randomness, without leaving registered entries behind.】

■ Simple Syntax

Create:

data/my_characters.txt

Then use:

_my_characters_

The file name becomes the category name.

■ Multiple Categories

Characters, poses, outfits, backgrounds, expressions, and other prompt elements can be rotated independently.

Example:

_my_characters_, _pose_, _outfit_

■ Dynamic Prompts Support

Character Rotation:

_category_

Dynamic Prompts:

__category__

Both can be used in the same prompt:

_my_characters_, __pose__

■ Resolved Prompt / PNG Info

The actual selected entries are shown in the Prompt after generation.

Input:

_category_a_, _category_b_, 1girl, solo

Result:

prompt_entry_a, prompt_entry_b, 1girl, solo

The resolved prompt is also stored in PNG Info.

■ Features

・No duplicate entry until a cycle is completed

・Automatic reshuffling

・Rotation progress is saved

・Supports Batch count

・Multiple independent categories

・Automatic list change detection

・LoRA support / automatic LoRA detection

・Rotation state reset tool

・Blank lines and section headings are ignored

Designed for Stable Diffusion WebUI Forge / reForge.

Batch size = 1 is recommended for large generation jobs.

Please see the included README for detailed instructions and notes.

動作環境

動作確認環境：

・Windows 11

・Stable Diffusion WebUI ReForge

※環境や他の拡張機能との組み合わせによっては正常に動作しない場合があります。

アップデート履歴

2026-08-23　v1.0

・初回リリース