ゆらもふ v1.5.3

YURAMOFU · USER GUIDE

耳がぴくっと、
尻尾がゆらり。

ゆらもふは、耳・尻尾のボーンから待機モーションやジェスチャー連動のアニメーションを作る Unity Editor 拡張です。プレビューで確かめてから生成し、FX Controller へのレイヤー追加まで自動で行えます。

製品版 v1.5.3 に対応

ゆらもふのメイン画像

★v1.5.3 の新機能

尻尾に 2 本目以降のボーンを追加できるようになりました。ツインテールやエプロンのリボンなど、尻尾以外の揺れものもまとめて動かせます。

エプロンの左右のリボンを 1 組の尻尾として動かした例(そろえる/左右対称/別々)
エプロンの左右のリボンを 1 組の尻尾として動かした例(そろえる/左右対称/別々)
尻尾のボーンを追加

尻尾のボーンを追加

「ボーン・詳細調整」の「+ チェーン追加」で 2 本目以降を追加します。強さ・速さなどの設定はすべてのチェーンで共通です。2 本以上あるときは「複数チェーンの動き」で、そろえる(同じ向きに揺れる)/左右対称(1 本目と鏡写し)/別々(それぞれのタイミング)を選びます。

耳の「聞き耳」

耳の「聞き耳」

たまに耳をすっと立て、少し止まってから戻します。向き変え・ぶるっと振ると同じく、行頭のチェックと「頻度 (%)」で設定します。ON にした動きの合計は 100% までで、残りが「ぴくっ」になります。

  • スタイルを選んだあとに値を手で変えると、スタイルの横に「調整済み」と表示されます。「スタイルに戻す」でスタイルの値に戻せます。別のスタイルを選ぶときは、調整した内容を上書きしてよいか確認します。
  • 各スタイル本来のリズムが常に使われるようになりました。「活発さ」はスタイルのリズムを基準に速く・遅くします。「そわそわ」は、耳を立てて左右交互に外を見る動きになりました。
  • アバターを指定すると、自動でボーンを検出するようになりました。
  • 生成・更新前の確認画面にも、FaceEmo の WriteDefaults についての注意を表示します。
  • アンインストール前に、削除する内容の一覧を確認できるようになりました。尻尾速度のダイヤル(FX パラメーター・メニュー項目)と、ジェスチャー中に待機を止めるための Animation Clip もあわせて削除します。
  • ツール画面(日本語)の「手勢」を「ジェスチャー」に統一しました。

既存の出力に反映するには、ツールを更新したあと「更新」を実行してください。

v1.5.2 の新機能

FaceEmo と併用したときの注意表示と、尻尾の動きの改善を追加しました。

  • FaceEmo を「WriteDefaults オフ(表情優先)」で適用していると、ツール画面に警告が出るようになりました。耳・尻尾が埋まったり、ねじれたりする原因になります。警告が出たら、FaceEmo で「WriteDefaults 統一(ギミック優先)」を選び、「アバターに適用」をやり直してください。
  • FX に WriteDefaults オフのステートがあり、FaceEmo の設定だけでは直らない場合も、その旨を表示します。
  • 尻尾の動きが「たまに」のとき、揺れの終わりでぴたっと止まらず、だんだん小さくなって自然に収まるようになりました。
  • Expressions Menu・Parameters を設定していない(VRChat 標準のままの)アバターに速度ダイヤルを追加すると、VRCEmote や表情用のパラメータが消えてしまう問題を修正しました。

尻尾の動きと速度ダイヤルの修正は、ツールを更新したあと「更新」を実行すると既存の出力に反映されます。

01はじめに

動作環境:Unity 2022.3 LTS 以降(Windows 版 Unity Editor)。FX への自動追加・ジェスチャー連動・尻尾速度のダイヤルには VRChat SDK3 Avatars が必要です。SDK がなくても基本の Animation Clip は生成できます。

  1. インポートして開く

    unitypackage をプロジェクトへインポートし、メニューの 黒猫Dev → YuraMofu (ゆらもふ) → Open Window を開きます。作業前にプロジェクトのバックアップをおすすめします。

  2. アバターを指定して「自動検出」

    Scene 上のアバターを「アバター」欄に入れて「自動検出」。状態欄の耳・尻尾・FX が ✓ になれば準備完了です。検出結果は必ず確認し、違っていれば「ボーン・詳細調整」で指定し直します。

  3. スタイルと強さを選ぶ

    「挙動・揺れ」タブでモーションスタイルと強さを選び、耳・尻尾それぞれを調整します。

  4. プレビューで確認

    「プレビュー」で Scene 上の動きを確認します。プレビュー中の変更は、生成するまでアセットや FX に書き込まれません。

  5. 生成 / 更新

    初回は「生成」、生成済みの動きを変えるときは「更新」。書き出すファイルと追加・置き換えになるレイヤーの一覧を確認してから実行されます。

「挙動・揺れ」タブ
「挙動・揺れ」タブ

02挙動・揺れ(待機モーション)

モーションスタイルと強さ

  • おとなしい
  • 自然
  • 元気
  • 眠そう
  • そわそわ
  • おちゃめ
  • きまぐれ

強さは「弱め/ふつう/強め」。スタイルを選ぶと、耳・尻尾の細かな設定がそのスタイルの値になります。値を手で変えると「調整済み」と表示され、「スタイルに戻す」で元に戻せます。きまぐれは、長い静止の合間に片耳だけの短いぴくっと、中心が片側に寄った緩急のある尻尾の揺れが入るスタイルです。

耳

耳の左右
おまかせ/同期/非同期。同期のときは「片耳だけ動く割合」で、片方だけぴくっと動く確率を設定できます。
動きの種類
通常はぴくっと動くだけですが、「耳の向き変え」(ゆっくり外へ向けて止まる)、「耳をぶるっと振る」(水を払うように振る)、「聞き耳」(すっと立てて少し止まる)を追加できます。行頭のチェックで ON/OFF、「頻度 (%)」で割合を決めます。ON にした動きの合計は 100% までで、残りが「ぴくっ」になります。

尻尾

ボーン
「+ チェーン追加」で 2 本目以降のボーン(ツインテール・リボンなど)を追加できます。「複数チェーンの動き」で、そろえる/左右対称/別々を選びます。
動き
連続振り子/間欠振り。
振幅・基本速度
1 倍は 1 周期 1.5 秒です。
しなやかさ (%)
上げるほど根元が落ち着き、揺れが波のように先へ伝わります。0 で従来どおり。
振れの中心・揺れの緩急
左右どちらかに寄せて揺らす/1 回ごとの速さにばらつきを付ける(詳細調整)。
尻尾速度のダイヤル
「尻尾速度のダイヤルを生成」を ON にすると、VRChat 内のダイヤルで待機中の尻尾の速さを変えられます。0% にすると尻尾は元の位置に戻って止まります。耳やジェスチャー連動の速さは変わりません。

生成方式

ボーンごと(推奨)
チェーン全体のボーンにキーを書き込みます。PhysBone が入っていない耳・尻尾向け。
物理まかせ(代替)
根元だけを動かし、残りの揺れは PhysBone に任せます。キーが少なく柔らかい動きになります。

動く方向がおかしいときは「ボーン・詳細調整」の方向補正で軸を直します。通常は初期設定のままで問題ありません。

03ジェスチャー連動(Gesture Link・製品版)

手(GestureLeft / GestureRight)→ F2~F8 → リアクションタイプ → 耳・尻尾の順に設定します。

「ジェスチャー連動」タブ(F3 / Open)
「ジェスチャー連動」タブ(F3 / Open)

リアクションタイプ

なし
そのジェスチャーでは耳・尻尾を動かしません。
ポーズ
パッドで決めた向きへ耳・尻尾を倒します。Fist はトリガーの押し具合で 0~100% に変化し、他のジェスチャーは押した瞬間に 100% になります。
連続モーション
そのジェスチャーの間、選んだスタイルの耳・尻尾の動きを繰り返します。
部位別
耳と尻尾それぞれに「なし/ポーズ/モーション」を割り当てます。

パッドで向きを決める

前後ろ 閉開 向き内向き外向き
耳:パッドで倒す向き、ダイヤルで向き(内/外)
上下 左右
尻尾:パッドで倒す向き
  • パッドの中心から離すほど大きく倒れます。左右はアバター本人から見た向きです。
  • パッドやダイヤルはドラッグで調整、ダブルクリックで中央(0)に戻ります。
  • 耳の「同方向」は両耳が左右対称に同じ動き、「反対方向」はもう片方の耳が逆の動きになります。「左耳だけ」「右耳だけ」は片方の耳だけが動き、「左右別々」は耳ごとにパッドで向きを決めます。
  • XYZ で直接入力したいときは「方向の調整」を開きます。XYZ を入力すると、パッドを動かすまでは XYZ の値が使われます。
  • Fist を選択中は「ポーズのプレビュー (%)」で押し具合ごとの見え方を確認できます。

ジェスチャー中は待機を止める

「FX 設定」にある設定です(初期値 ON)。ジェスチャーで動かしている部位の待機モーションを、その間だけ止めます。OFF にすると、ジェスチャーのポーズ・モーションが待機モーションの上に重なります。待機・ジェスチャー連動のどちらを先に生成しても、FX 内のレイヤーから自動で設定されます。

FX 設定(F2 / Fist)
FX 設定(F2 / Fist)

「他のジェスチャーへコピー」で、選択中のジェスチャーの設定を別のジェスチャー(またはすべてのジェスチャー)へコピーできます。表示名はコピーされません。

042組目の耳・尻尾

各タブ上部の「2組目を使用」を ON にすると、1組目/2組目を切り替えて編集できます。動き・速度は共通で、軸補正だけを組ごとに調整します。生成・更新では有効な両組を出力します。

2組目の耳・尻尾
2組目の耳・尻尾

2組目のボーンは手動で指定してください(自動検出は1組目が対象)。2組をそれぞれ違う動き・速度で動かす機能ではありません。

05生成・更新と FX Controller

プレビュー
Unity Editor 上で動きを確認します。プレビュー中の変更は、生成・更新するまでアセットや FX に反映されません。
生成
Animation Clip と、ゆらもふ用の FX レイヤーを新しく作ります。
更新
生成済みのデータへ今の設定を反映します。
FX に自動追加
アバターの FX Controller に、生成した動きを再生するレイヤーを追加します。待機・ジェスチャー連動のレイヤーは Additive(Write Defaults ON 固定)で、アバター本来の揺れの上に加算されます。
保存先・更新通知
「挙動・揺れ」→「FX・保存先」で設定します。

Unity の Undo では Animator Controller のレイヤーを完全には戻せません。生成前に表示される確認一覧を見てから実行し、必要ならバックアップを取ってください。

アンインストール:黒猫Dev → YuraMofu (ゆらもふ) → Uninstall from Active Avatar を実行すると、削除する内容の一覧が表示されます。確認後、ゆらもふが追加したレイヤー・パラメーター・メニュー項目を削除します。

06よくある質問

PhysBone が入った耳・尻尾でも使えますか?

使えます。状態欄の「互換性を確認」で PhysBone の Is Animated などを確認できます。揺れを PhysBone に任せたいときは生成方式を「物理まかせ」にしてください。

FaceEmo と一緒に使えますか?

FaceEmo → ゆらもふの順で生成してください。FaceEmo を再生成すると FX が作り直されるので、新しい FX を指定してゆらもふも再生成してください。

ツールを更新したあと、何をすればいいですか?

インポート後に「更新」を実行すると、既存の出力に修正が反映されます。必要な出力がない場合は「生成」を実行してください。

動く方向がおかしいです

待機モーションは「ボーン・詳細調整」の方向補正、ジェスチャー連動のポーズはパッドで向きを直してください。

Play Mode や VRChat で、耳が頭に埋まる・尻尾がねじれる・動きが固まります

FX の中で Write Defaults の ON / OFF が混ざっていると起こります。FaceEmo やフェイストラッキングの表情無効化機能(Triturbo の拡張など)が原因になることが多く、ゆらもふの待機モーション(Write Defaults ON が必要)の姿勢が崩れます。ボーンや方向の設定を変えても直りません。原因になっていそうなギミックを一時的に外して Play Mode で確認し、FX の Write Defaults を統一してください。FaceEmo を使う場合は、統一したうえで FaceEmo → ゆらもふの順で生成してください。直らない場合は 黒猫Dev → YuraMofu (ゆらもふ) → Copy Diagnostics の結果を添えて BOOTH のメッセージでご連絡ください。

インターネットに接続しますか?

1 日 1 回、最新バージョンの確認だけを行います。プロジェクトやアバターの情報は送信しません。「FX・保存先」から無効にでき、オフラインでも使えます。

設定はどこに保存されますか?

ウィンドウの設定は、プロジェクトごとに最後の 1 組を保存します。「設定をクリア」で初期値に戻せます(生成済みのアニメーションやレイヤーは削除しません)。

うまくいかないときは、BOOTH のメッセージからお問い合わせください。

07更新履歴

v1.5.3 2026-11-11

  • 尻尾に 2 本目以降のボーンを追加(そろえる/左右対称/別々)
  • 耳の動きに「聞き耳」を追加
  • スタイルの「調整済み」表示と「スタイルに戻す」を追加、「そわそわ」の耳の動きを変更
  • アバターを指定したときにボーンを自動検出
  • 生成・更新前の確認画面に FaceEmo の注意を表示
  • アンインストール前に削除内容を確認し、速度ダイヤルの項目も削除

v1.5.2 2026-11-09

  • FaceEmo を「WriteDefaults オフ(表情優先)」で適用しているときに警告を表示
  • 尻尾の動き「たまに」で、揺れが小さくなりながら自然に収まるように
  • 速度ダイヤルの追加で VRCEmote などの標準パラメータが消える問題を修正

v1.5.1 2026-11-06

  • ジェスチャー連動のポーズで、左右の耳を別々に設定できる「左右別々」を追加
  • 「左耳だけ」「右耳だけ」を追加
  • 尻尾速度のダイヤルが 0% のとき、尻尾が元の位置に戻って止まるように
  • ツール画面の韓国語(한국어)に対応

v1.5.0

  • ジェスチャー連動のポーズを XYZ からパッド操作に変更(耳は「向き」ダイヤル付き)
  • 「ジェスチャー中は待機を止める」を追加(初期値 ON)
  • ジェスチャー連動レイヤーを Additive に変更し、アバター本来の揺れ・AFK モーションを止めないように
  • 押し具合(GestureWeight)で変化するのを Fist だけに変更

v1.4.0 2026-11-02

  • 尻尾に「しなやかさ (%)」を追加
  • 間欠振りの尻尾が片側に一度振るだけで戻りきらなかった問題を修正

v1.3.1 2026-10-28

  • 表情無効化機能(Triturbo など)との併用時に、耳・尻尾の位置が固定される問題を修正
  • ジェスチャー連動の耳「同方向/反対方向」が一部のアバターで逆になっていた問題を修正
  • 軸・方向の選択肢に、アバターでの実際の動きを表示

v1.3.0 2026-10-22

  • 新スタイル「きまぐれ」を追加
  • 左右同期時に、片耳だけ動く割合を設定可能に
  • 尻尾の「振れの中心」と「揺れの緩急」を追加
  • 耳の向き変え・ぶるっと振るの頻度を調整可能に

v1.2.2 2026-10-22

  • 2組目の切り替えを各タブの上部に移動
  • F2〜F8 のボタンに各スロットの反応を表示
  • 状態欄をタブごとの表示に整理

v1.2.1 2026-10-01

  • プレビューの負荷を軽減
  • 任意の2組目の耳・尻尾に対応

v1.2.0 2026-09-27

  • 待機/ジェスチャー連動の UI を整理
  • 待機尻尾の速度ダイヤルを追加

v1.1.4

  • プレビューが動かないとき、その理由を表示
  • 診断情報をクリップボードへコピーする機能を追加
  • 更新のお知らせ機能を追加(1 日 1 回、最新バージョン番号のみ確認)

v1.1.3

  • 生成方式に「物理まかせ」を追加
  • 耳の「向き変え」「ぶるっと振る」を追加
  • ジェスチャー連動に「他のジェスチャーへコピー」を追加
  • 生成前に書き出すファイルと FX レイヤーを一覧で確認
  • パラメータの型違い・PhysBone 制御下の警告を追加

v1.1.2

  • 画面構成を整理し、詳細設定と出力設定を折りたたみ式に
  • 生成状態や設定不足を確認できるステータス表示を追加
  • Gesture Link の「Mix」を「部位別」に変更

v1.1.1

  • 生成済みデータを更新する「更新」ボタンを追加
  • 0~100% ポーズのプレビュー操作を改善
  • 耳の左右設定に「同期 / ミラー」を追加

v1.1.0

  • 表情連動 UI を F2~F8 スロット形式に整理
  • アンインストール時に生成 Animation Clip の削除確認を追加

v1.0.x

  • 耳・尻尾の Idle Animation 生成
  • リアルタイムプレビュー
  • FX Controller への自動追加
  • VRC Gesture 連動
  • Uninstall from Active Avatar