Repository navigation
Releases: pikepikeid/Baballonia
Release list
Modified.9
Caution
このモジュールは、元のリポジトリを独自に改変したものですので、動作保証はありません。自己責任でご利用ください。
This module is an independently modified fork of the original repository. As such, operation is not guaranteed. Please use it at your own risk.
Note
これは主にNARE FACIAL TRACKER(ナレトラ)などでフェイストラッキングを行う場合に、表現力や精度よりも手軽さを重視で使えるように補正を入れたモジュールです。細かな表現が行えない代わりに、破綻しにくい挙動を目指しています。
但し、動作には個人差があります。あくまでも動作補助としてお考えください。
Modified.9 変更点
- 【修正・変更】補正に不要なものを含めて全チェックしていたため、チェック内容を絞るように変更
- 【修正・変更】ウェイトを入れ忘れていたため、恐らく1スレッド相当のCPU時間を消費していたであろう問題を修正
特徴
できること
- 口を小さくすぼめたり、への字形にする動作や、笑顔や悲しい表情を行いやすく調整
- 左右差をなくすことで、口の形が破綻することを軽減
- 左右同時の瞬きやウィンクをしやすくする機能(v1.1.1.1 Expression Testing向け、オン・オフ可能)
- 目を見開いたり細めたりする際の補正(v1.1.1.1 Expression Testing向け、オン・オフ可能)
- 寄り目・反り目を軽減して目線の左右同期補正をする機能(オン・オフ可能)
- 視線の最大値を制限するリミッター
できなくなること
口元を左右対称化してあるので、片側だけニヤついた表情などの高度な表現ができなくなります。
ダウンロードとインストール
本ページの一番下にあるVRCFaceTracking.Baballonia.Modified.zipをダウンロードして、VRCFTのモジュール管理からインストールを行ってください。
Important
モジュールIDの変更を行っているため、別モジュールとしてインストールされます。
既にProject Babbleのモジュールをインストールしている場合は、一度アンインストールとVRCFTの再起動を行ってからインストールを行ってみてください。
アップデートの際は、一度アンインストールしてからインストールし直すか、ZIPファイルの中身で直接上書きを行ってください。
各種パラメーターの調整について
スクリーンショットで掲載しているパラメーターの調整値は人によって大きく異なる場合があります。あくまでも目安としてご利用ください。特に口元カメラの角度や距離、クロッピング設定で挙動が変わる点に十分注意してください。
パラメーター調整については、弊ウェブサイトでも解説を行っています。以下は簡易的な紹介です。
Tip
左端のスライダーを右に動かすと、一定値を超えるまでパラメーターが反応しなくなります。
少ししか反応しないパラメーターは、右端のスライダーを左に動かすと強く動作するようになります。
Note
左右対称化を行ったパラメーターは緑の枠で記してあります。
今回は最大値を採用する方式にしてありますので、右か左のどちらか片方だけが動くように設定しても動作します。
頬の表現
本モジュールでは特に補正を入れていません。CheekPuffが誤動作しない程度に調節しておいてください。
顎の表現
Important
口を閉じているときにJawOpenが反応しないようにしておいてください。
鼻の表現
口を閉じているのに、微妙に開いてしまう原因になりやすいので少しだけ反応しにくいように調整しておいてください。
口の表現
Important
MouthFunnelとMouthPuckerを主体とした補正を行っています。 ここが上手く動かないとおかしな挙動になる可能性があります。
口を開けたときに、MouthFunnelがある程度動作するようにしてください。MouthPuckerは「う」や「お」の口の形や、口をすぼめるときに動くように調節してください。
Note
MouthCloseは鼻の下を伸ばした感じの表情をするのに用いますが、口を閉じた状態で反応してしまうと口が埋もれる原因になります。鼻の下が伸びてしまったり口が埋もれる場合は反応しにくいように調節してください。
その他のパラメーターは笑顔や悲しい表情を作るときに使用します。お好みで強さを調節してください。極端に効きやすくすると制御しやすくなります。
舌の表現
Important
舌はかなり誤動作しやすいです。
フェイストラッキングで舌は出さないという方は、スライダーを右端まで持っていって無効化しても構いません。
目の表現
Tip
2026年8月25日現在、Steam版のBaballoniaでExpression Testing版のv1.1.1.1-3を試すことができます。
Steamライブラリ > Baballoniaのプロパティ > ゲームバージョンとベータ > expressions
目を見開いたり細めたりする動作に対応したバージョンなので、EyeWidenやEyeSquintが追加されています。
但し、片目を閉じることがうまくできないようです。本モジュールではウィンクをしやすくしたり、瞬きの補正を掛けたりしてあります。(Expressions Testing版でEyeLidの効きが悪くなる場合は、極端な調整が必要になるかもしれません。)
左右のEyeLidどちらかの最小値を見て瞬きするように補正を掛けてありますので、瞬きが反応しやすい程度に調節してください。
目のキャリブレーションについて
Tip
Baballoniaのキャリブレーションは、「中央に表示される白い点を注視することが最優先」です。よそ見しないようにしながら頭を動かしましょう。
頭は8方向にゆっくりと動かした後、ある程度回転があれば十分動作するようです。無理の無い範囲で行ってみてください。
キャリブレーションが完了すると、グラフが足元に表示されます。お使いのPC環境により5~10分程度の計算処理が行われますので、終わるまで待ちましょう。学習が終了するまではキャリブレーション結果は反映されません。
キャリブレーション後に上手く動作しない場合は、各種補正機能を調節してみることをおすすめします。
キャリブレーション手順を動画で観る(YouTube)
アルファテスト版のキャリブレーション手順を動画で観る(YouTube)
その他の設定について
VRChat + VRCFaceTracking 設定
Important
「顔のみ」になっている場合があります。
Baballoniaの設定を開いて、 VRCFTモジュールモードを設定で「両方」に設定し直してからVRCFTを再起動してください。
1ユーロフィルタの設定
瞬きが動きにくいはずなので、まずは高めの数値をお試しください。その後、震え具合に応じて調節してください。
設定ファイルでの変更
%AppData%\VRCFaceTracking\CustomLibs\cbb751d2-da77-4763-b631-0e8ab03a5773 に config.ini があります。
エクスプローラーのアドレスバーにコピペするか、ファイル名を指定して実行から開いて、必要に応じてメモ帳などで編集してください。
目に関する機能は実験的なので、十分な動作確認ができていません。今後変更される可能性が大いにあります。
SymmetricMode=0 -> 左右対称化モード(デフォルト0)0:最大値で対象化, 1:平均値で対象化, 2:最小値で対象化
PuckerJawOpenSuppression=0.3 -> Pucker時のJawOpenの開き具合の抑制度合い 0.0-1.0(係数)
JawOpenFunnelThreshold=0.25 -> JawOpen抑制の条件2(MoutuFunnelが設定値以下の時)
JawOpenPuckerThreshold=0.6 -> JawOpen抑制の条件1(MouthPuckerが設定値以上の時)
JawOpenMax=1.0 -> 口を大きく開けすぎないよう最大値を制限する 0.0-1.0
PreventCrossEye=true -> 寄り目・反り目の補正 true/false
CrossEyeStrength=0.8 -> 寄り目・反り目の補正具合 0.0:補正しない, 0.5:半分補正, 1.0:正面に補正
UseCrossEyeSync=true -> 目を開けているときの視線の左右同期と倍率補正を使用する
CrossEyeSyncOpenThreshold=0.2 -> 左右同期補正が動作するEyeLidのしきい値
CrossEyeSyncDiffThreshold=0.1 -> 視線の左右差がしきい値を超えたときに動作
EyeLeftScale=1.0 -> 左目の視線補正倍率(基本的に触らないこと)
EyeRightScale=1.0 -> 右目の視線補正倍率(基本的に触らないこと)
UseLidEyeCenter=true -> まばたきや目を細めたときに上下の視線を中央に補正 true/false
LidEyeCenterThreshold=0.95 -> EyeLidがこの値よりも小さい場合に動作を開始
LidEyeCenterStrength=1.5 -> 視線の上下をどれだけ中央に寄せるかの係数(強い分には問題なし)
EyeInnerLimit=1.0 -> 寄り目方向の視線リミッター
EyeOuterLimit=1.0 -> 外側の視線リミッター
EyeUpLimit=1.0 -> 上方向の視線リミッター
EyeDownLimit=1.0 -> 下方向の視線リミッター
UseEyeWide=true -> 目を見開く(EyeWide)を有効化するかどうか(v1.1.1.1向け)
UseEyeWideCorrection=true -> 目を見開くときの左右対称化を有効化するかどうか true/false(v1.1.1.1向け)
EyeWideLimit=1.0 -> 目を見開くときの最大値(v1.1.1.1向け)
UseLidSync=true -> 目の開き具合の左右同期補正 true/false
SquintStrength=1.0 -> Squint時のまぶたの閉じ具合の係数 0.0-1.0 0.0:影響なし, 1.0:Squint通りに閉じる(v1.1.1.1向け)
UseWinkLock=true -> 瞬き・ウィンクロック機能 true/false(v1.1.1.1向け)
UseEyeWide=true -> 目を見開く(EyeWide)を有効化するかどうか true/false(v1.1.1.1向け)
UseEyeWideCorrection=true -> 目を見開くときの左右対称化を有効化するかどうか true/false(v1.1.1.1向け)
EyeWideLimit=1.0 -> 目を見開くときの最大値 0.0-1.0(v1.1.1.1向け)
UseLidSync=true -> 目の開き具合の左右同期補正 true/false
SquintStrength=1.0 -> Squint時のまぶたの閉じ具合の係数 0.0-1.0(v1.1.1.1向け)
【誤作動するため、設定値は BlinkThresholdFrames < WinkThresholdFrames ≦ WinkReleaseFrames としてください】
BlinkThresholdFrames=1 -> まばたきの検出に必要なフレーム数
WinkThresholdFrames=2 -> ウィンクの検出に必要なフレーム数
WinkReleaseFrames=2 -> ウィンクの解除に必要なフレーム数
WinkJustReleasedIgnoreFrames=1 -> ウィンクが解除されたと判定した後、再ロックされないように無視するフレーム数(あまり影響はないはず)
WinkSquintClosed=0.85 -> ウィンク判定のための閾値
WinkSquintOpen=0.5 -> ウィンク解除判定のための閾値
BothClosedSquint=0.99 -> 両目閉じ判定のための閾値
BothOpenOpenness=0.3 -> 両目開き判定のための閾値
BlinkSquint=0.2 -> 瞬き判定のための閾値
BlinkLidThresholdOffset=0.05 -> 両目開き判定用安全マージン
Q&A
- どういう人向け?
- VRヘッドセットの装着具合をできるだけ気にしたくない人(左右の傾き、口元カメラのズレ)
- Baballonia側でパラメーター調整しても歪んだりする人(口元の左右対称化)
- 目のキャリブレーションが上手く行かない人(寄り目・反り目・視線の補正、瞬き周りのロック)
- できるだけ安定した見た目でアバターを動かしたい人(JawOpenなどの誤作動防止、笑顔や悲しい表情などの補正、視線のリミッター)
- 大胆な動きができなくても構わない人
- それっぽく動いてくれれば構わない人
- NARE FACIAL TRACKER(ナレトラ)以外でも動く?
- Project Babble想定のトラッカーで、Baballoniaを使うものなら大抵動くはず(FocusRayなど)
- このモジュールを入れただけですぐ使える?
- Baballoniaのキャリブレーションとパラメーター調整は必要です
- あくまでもパラメーター調整だけでは難しそうな部分を補っているだけです
- もっと細かな調整をしたい
- 考えておきます
- 今後の注意点は?
- Baballoniaのアップデートで挙動が変わる可能性がありますし、試行錯誤段階なので当面の間は設定値が変わったりする場合があります
更新履歴
Modified.8
- 【新機能】視線のリミッターを追加
- 【新機能】視線の左右同期補正を追加(UseCrossEyeSync)(※寄り目補正/PreventCrossEye使用時のみ機能)
- 【新機能】実験的に視線の左右同期補正時のスケール倍率を追加(EyeLeftScale / EyeRightScale)
- 【新機能】目を細めたときに視線が壊れるのを防止する機能を追加(UseLidEyeCenter)
- 【修正・変更】口をすぼめるときのJawOpen抑制が急激なのをゆるやかになるよう修正
- 【修正・変更】v1.1.1.0使用時にウィンクがやれなくなっていたのを修正(したつもり)
- 【修正・変更】設定ファイルの誤字修正
- 【修正・変更】設定ファイル初期値の変更(寄り目補正を緩めるなど)
Modified.7
- EyeLidの最小値を見て瞬きしやすいように補正(v1.1.1.1暫定対応)
- 両目を開いていると判定するときの規定値を変更(BothOpenOpenness = 0.45 -> 0.3)
- 目を細めるときの規定値を変更(SquintStrength = 0.5 -> 1.0)
- JawOpen抑制の条件を調整できるように
config.iniのパラメーターを追加(JawOpenPuckerThreshold, JawOpenFunnelThreshold)
Modified.6
confit.iniで設定可能な値を追加- いくつかの初期値を変更
- EyeWidenの補正と制限を追加
- EyeSquintに応じたEyeLidの補正を追加
- 無駄な処理を削減
Modified.5
confit.iniで設定可能な値を追加- ウィンク判定のデフォルト値を小さめに変更
- ビルド時のZIP生成を修正
Modified.4
- 寄り目補正の条件が厳しすぎたので調整
Modified.3
- 非公式版であることを明記し、モジュール名を変更
- デフォルトでアイトラッキングを有効状態に
Modified.2
- 寄り目・反り目の補正機能を追加
- モジュールIDの変更
config.iniによるモジュール動作の変更機能を追加
Note
動作確認済みバージョン:Project Babble v1.1.1.0 / v1.1.1.1-3 (Expression Testing)
Caution
これは非公式版のモジュールです。公式への問い合わせやバグ報告などに使用しないでください。
This is an unofficial module. DO NOT use it for official inquiries or bug reports.
Modified.8
Caution
このモジュールは、元のリポジトリを独自に改変したものですので、動作保証はありません。自己責任でご利用ください。
This module is an independently modified fork of the original repository. As such, operation is not guaranteed. Please use it at your own risk.
Caution
これは非公式版のモジュールです。公式への問い合わせやバグ報告などに使用しないでください。
This is an unofficial module. DO NOT use it for official inquiries or bug reports.
Important
新しいバージョンがあります。動作説明などはそちらでご確認ください。
Note
これは主にNARE FACIAL TRACKER(ナレトラ)などでフェイストラッキングを行う場合に、表現力や精度よりも手軽さを重視で使えるように補正を入れたモジュールです。
細かな表現が行えない代わりに、破綻しにくい挙動を目指しています。
但し、動作には個人差があります。あくまでも動作補助としてお考えください。
Note
動作確認済みバージョン:Project Babble v1.1.1.0 / v1.1.1.1-3 (Expression Testing)
更新内容
- 【新機能】視線のリミッターを追加
- 【新機能】視線の左右同期補正を追加(UseCrossEyeSync)(※寄り目補正/PreventCrossEye使用時のみ機能)
- 【新機能】実験的に視線の左右同期補正時のスケール倍率を追加(EyeLeftScale / EyeRightScale)
- 【新機能】目を細めたときに視線が壊れるのを防止する機能を追加(UseLidEyeCenter)
- 【修正・変更】口をすぼめるときのJawOpen抑制が急激なのをゆるやかになるよう修正
- 【修正・変更】v1.1.1.0使用時にウィンクがやれなくなっていたのを修正(したつもり)
- 【修正・変更】設定ファイルの誤字修正
- 【修正・変更】設定ファイル初期値の変更(寄り目補正を緩めるなど)
Modified.7
Caution
このモジュールは、元のリポジトリを独自に改変したものですので、動作保証はありません。自己責任でご利用ください。
This module is an independently modified fork of the original repository. As such, operation is not guaranteed. Please use it at your own risk.
Caution
これは非公式版のモジュールです。公式への問い合わせやバグ報告などに使用しないでください。
This is an unofficial module. DO NOT use it for official inquiries or bug reports.
Important
新しいバージョンがあります。動作説明などはそちらでご確認ください。
Note
これは主にNARE FACIAL TRACKER(ナレトラ)などでフェイストラッキングを行う場合に、表現力や精度よりも手軽さを重視で使えるように補正を入れたモジュールです。
細かな表現が行えない代わりに、破綻しにくい挙動を目指しています。
但し、動作には個人差があります。あくまでも動作補助としてお考えください。
Note
動作確認済みバージョン:Project Babble v1.1.1.0 / v1.1.1.1-3 (Expression Testing)
更新内容
- EyeLidの最小値を見て瞬きしやすいように補正(v1.1.1.1暫定対応)
- 両目を開いていると判定するときの規定値を変更(BothOpenOpenness = 0.45 -> 0.3)
- 目を細めるときの規定値を変更(SquintStrength = 0.5 -> 1.0)
- JawOpen抑制の条件を調整できるように
config.iniのパラメーターを追加(JawOpenPuckerThreshold, JawOpenFunnelThreshold)
Modified.6
Caution
このモジュールは、元のリポジトリを独自に改変したものですので、動作保証はありません。自己責任でご利用ください。
This module is an independently modified fork of the original repository. As such, operation is not guaranteed. Please use it at your own risk.
Caution
これは非公式版のモジュールです。公式への問い合わせやバグ報告などに使用しないでください。
This is an unofficial module. DO NOT use it for official inquiries or bug reports.
Important
新しいバージョンがあります。動作説明などはそちらでご確認ください。
Note
これは主にNARE FACIAL TRACKER(ナレトラ)などでフェイストラッキングを行う場合に、表現力や精度よりも手軽さを重視で使えるように補正を入れたモジュールです。
細かな表現が行えない代わりに、破綻しにくい挙動を目指しています。
但し、動作には個人差があります。あくまでも動作補助としてお考えください。
Note
動作確認済みバージョン:Project Babble v1.1.1.0 / v1.1.1.1-3 (Expression Testing)
更新内容
confit.iniで設定可能な値を追加- いくつかの初期値を変更
- EyeWidenの補正と制限を追加
- EyeSquintに応じたEyeLidの補正を追加
- 無駄な処理を削減
Modified.5
Caution
このモジュールは、元のリポジトリを独自に改変したものですので、動作保証はありません。自己責任でご利用ください。
This module is an independently modified fork of the original repository. As such, operation is not guaranteed. Please use it at your own risk.
Caution
これは非公式版のモジュールです。公式への問い合わせやバグ報告などに使用しないでください。
This is an unofficial module. DO NOT use it for official inquiries or bug reports.
Important
新しいバージョンがあります。動作説明などはそちらでご確認ください。
Note
これは主にNARE FACIAL TRACKER(ナレトラ)などでフェイストラッキングを行う場合に、表現力や精度よりも手軽さを重視で使えるように補正を入れたモジュールです。
細かな表現が行えない代わりに、破綻しにくい挙動を目指しています。
但し、動作には個人差があります。あくまでも動作補助としてお考えください。
Note
動作確認済みバージョン:Project Babble v1.1.1.0 / v1.1.1.1-3 (Expression Testing)
更新内容
confit.iniで設定可能な値を追加- ウィンク判定のデフォルト値を小さめに変更
- ビルド時のZIP生成を修正
Modified.4
Caution
このモジュールは、元のリポジトリを独自に改変したものですので、動作保証はありません。自己責任でご利用ください。
This module is an independently modified fork of the original repository. As such, operation is not guaranteed. Please use it at your own risk.
Caution
これは非公式版のモジュールです。公式への問い合わせやバグ報告などに使用しないでください。
This is an unofficial module. DO NOT use it for official inquiries or bug reports.
Important
新しいバージョンがあります。動作説明などはそちらでご確認ください。
Note
これは主にNARE FACIAL TRACKER(ナレトラ)などでフェイストラッキングを行う場合に、表現力や精度よりも手軽さを重視で使えるように補正を入れたモジュールです。
細かな表現が行えない代わりに、破綻しにくい挙動を目指しています。
但し、動作には個人差があります。あくまでも動作補助としてお考えください。
Note
動作確認済みバージョン:Project Babble v1.1.1.0 / v1.1.1.1-3 (Expression Testing)
更新内容
- 寄り目補正の条件が厳しすぎたので調整
Modified.3
Caution
このモジュールは、元のリポジトリを独自に改変したものですので、動作保証はありません。自己責任でご利用ください。
This module is an independently modified fork of the original repository. As such, operation is not guaranteed. Please use it at your own risk.
Caution
これは非公式版のモジュールです。公式への問い合わせやバグ報告などに使用しないでください。
This is an unofficial module. DO NOT use it for official inquiries or bug reports.
Important
新しいバージョンがあります。動作説明などはそちらでご確認ください。
Note
これは主にNARE FACIAL TRACKER(ナレトラ)などでフェイストラッキングを行う場合に、表現力や精度よりも手軽さを重視で使えるように補正を入れたモジュールです。
細かな表現が行えない代わりに、破綻しにくい挙動を目指しています。
但し、動作には個人差があります。あくまでも動作補助としてお考えください。
Note
動作確認済みバージョン:Project Babble v1.1.1.0 / v1.1.1.1-3 (Expression Testing)
更新内容
- 非公式版であることを明記し、モジュール名を変更
- デフォルトでアイトラッキングを有効状態に
Modified.2
Caution
このモジュールは、元のリポジトリを独自に改変したものですので、動作保証はありません。自己責任でご利用ください。
This module is an independently modified fork of the original repository. As such, operation is not guaranteed. Please use it at your own risk.
Caution
これは非公式版のモジュールです。公式への問い合わせやバグ報告などに使用しないでください。
This is an unofficial module. DO NOT use it for official inquiries or bug reports.
Important
新しいバージョンがあります。動作説明などはそちらでご確認ください。
Note
これは主にNARE FACIAL TRACKER(ナレトラ)などでフェイストラッキングを行う場合に、表現力や精度よりも手軽さを重視で使えるように補正を入れたモジュールです。
細かな表現が行えない代わりに、破綻しにくい挙動を目指しています。
但し、動作には個人差があります。あくまでも動作補助としてお考えください。
更新内容
- 寄り目・反り目の補正機能を追加
- モジュールIDの変更
config.iniによるモジュール動作の変更機能を追加
Modified.1
Caution
このモジュールは、元のリポジトリを独自に改変したものですので、動作保証はありません。自己責任でご利用ください。
This module is an independently modified fork of the original repository. As such, operation is not guaranteed. Please use it at your own risk.
Caution
これは非公式版のモジュールです。公式への問い合わせやバグ報告などに使用しないでください。
This is an unofficial module. DO NOT use it for official inquiries or bug reports.
Important
新しいバージョンがあります。動作説明などはそちらでご確認ください。
Note
これは主にNARE FACIAL TRACKER(ナレトラ)などでフェイストラッキングを行う場合に、表現力や精度よりも手軽さを重視で使えるように補正を入れたモジュールです。
細かな表現が行えない代わりに、破綻しにくい挙動を目指しています。
但し、動作には個人差があります。あくまでも動作補助としてお考えください。