VividAvatarFX

クイックスタート Quick Start

インストール Installation

初期セットアップ Initial Setup

概要 Overview

VividAvatarFXは、VRChat想定のアバター用ポストプロセスエフェクトです。

VividAvatarFX is a post-process effect system designed for VRChat avatars.

主要機能 Main Features

制作・動作確認環境 Development & Testing Environment

項目	Item	要件	Requirement
Unity	2022.3.22f1	2022.3.22f1
VRChat SDK	3.7.2	3.7.2
Modular Avatar	1.11.1	1.11.1
プラットフォーム	Platform	PC専用（Quest非対応）	PC Only (Quest not supported)

エフェクト詳細 Effect Details

カラー設定 Color Settings

カラーグレーディング

Color Grading

• 明るさ： 画面全体の明るさを調整
• コントラスト： 明暗の差を調整
• 彩度： 色の鮮やかさを調整
• 色相シフト： 色相を回転
• ガンマ： 中間調の明るさを調整
• 色反転： 色反転
• Brightness: Adjust overall screen brightness
• Contrast: Adjust difference between light and dark
• Saturation: Adjust color vividness
• Hue Shift: Rotate hue
• Gamma: Adjust mid-tone brightness
• Color Invert: Color Invert

トーンカーブ

Tone Curve

RGB各チャンネルのトーンカーブを個別に調整。スケールとパワーを組み合わせて色調整が可能です。

Adjust tone curves for each RGB channel individually. Combine scale and power for precise color adjustments.

• 赤チャンネル（R）：
• Red Channel (R):
• スケール： 赤色の強度を調整
• パワー： 赤色の階調カーブを調整
• Scale: Adjust red color intensity
• Power: Adjust red color tone curve
• 緑チャンネル（G）：
• Green Channel (G):
• スケール： 緑色の強度を調整
• パワー： 緑色の階調カーブを調整
• Scale: Adjust green color intensity
• Power: Adjust green color tone curve
• 青チャンネル（B）：
• Blue Channel (B):
• スケール： 青色の強度を調整
• パワー： 青色の階調カーブを調整
• Scale: Adjust blue color intensity
• Power: Adjust blue color tone curve

Lift / Gamma / Gain

• Lift： 暗部の色調を調整
• Gamma： 中間調の色調を調整
• Gain： 明部の色調を調整
• Lift: Adjust dark areas color tone
• Gamma: Adjust mid-tone color tone
• Gain: Adjust bright areas color tone

各項目でHSV（色相・彩度・明度）を個別に設定できます。

You can set HSV (Hue, Saturation, Value) individually for each.

エフェクト Effects

ブルーム

Bloom

• 強度： ブルーム効果の強さ
• 閾値： どの明るさから光らせるか
• 半径： ブルームの広がり
• 滑らかさ： 境界の滑らかさ
• 拡散： 光の拡散具合
• ぼやけ： ブルームのぼかし度合い
• Intensity: Bloom effect strength
• Threshold: Brightness level to start blooming
• Radius: Bloom spread
• Softness: Border softness
• Diffusion: Light diffusion amount
• Blur: Bloom blur amount

ビネット

Vignette

• 強度： ビネット効果の強さ
• 滑らかさ： 境界のぼかし具合
• 透明度： エフェクトの不透明度
• 色（HSV）： ビネットの色を調整
• Intensity: Vignette effect strength
• Smoothness: Border blur amount
• Alpha: Effect opacity
• Color (HSV): Adjust vignette color

その他のエフェクト

Other Effects

• シネマティックライン： 画面の上下左右に黒帯
• ネオンエッジ： 輪郭を光らせる
• ノイズ/グレイン： フィルムグレイン効果
• ポスタライズ： 色数を減らしてアニメ風に
• ディザリング： ディザパターン追加
• モザイク： ブロック状のモザイク
• Cinematic Lines: Black bars on screen edges
• Neon Edge: Glowing outlines
• Noise/Grain: Film grain effect
• Posterize: Reduce colors for anime style
• Dithering: Add dither pattern
• Mosaic: Block-style mosaic

レンズエフェクト Lens Effects

色収差

Chromatic Aberration

• 強度： 色ズレの量
• 色変更： プリセット切り替え（8パターン）
• Intensity: Color shift amount
• Color Change: Switch preset (8 patterns)

レンズ歪み

Lens Distortion

• 強度： 歪みの強さ
• スケール： 歪みの範囲
• 歪み形状： 歪みの特性
• バレル係数： 画像を外側に引き伸ばす度合い
• 横引き延ばし/潰す： 水平方向の変形
• 縦引き延ばし/潰す： 垂直方向の変形
• Intensity: Distortion strength
• Scale: Distortion range
• Distortion Shape: Distortion characteristics
• Barrel Coefficient: Degree of stretching the image outward
• Horizontal Stretch/Squash: Horizontal deformation
• Vertical Stretch/Squash: Vertical deformation

グリッチエフェクト

Glitch Effect

• 横ラインシフト： 走査線の横ズレ（強度・頻度・ブレンド）
• 縦ラインシフト： 走査線の縦ズレ（強度・頻度・ブレンド）
• カラー分離： RGBチャンネルのズレ（強度・ブレンド）
• ブロックノイズ： ブロック状のノイズ（サイズ・頻度・強度・ブレンド）
• Horizontal Line Shift: Horizontal scanline displacement (Intensity, Frequency, Blend)
• Vertical Line Shift: Vertical scanline displacement (Intensity, Frequency, Blend)
• Color Split: RGB channel displacement (Intensity, Blend)
• Block Noise: Block-style noise (Size, Frequency, Intensity, Blend)

プリセット機能 Preset System

現在のマテリアル設定を最大22個のプリセットとして保存・管理できます。

Save and manage current material settings as up to 22 presets.

プリセットの作成 Create Preset

プリセットの適用 Apply Preset

1. マテリアルInspectorの「プリセット」ドロップダウンから選択
2. 「適用」ボタンをクリック
3. マテリアルに設定が反映されます
4. Select from "Preset" dropdown in Material Inspector
5. Click "Apply" button
6. Settings will be applied to material

プリセットの共有 Share Preset

エクスポート

Export

マテリアルInspectorの「エクスポート」ボタンで、現在の設定をJSON形式で保存できます。他のユーザーに設定を共有する際に便利です。

Click "Export" button in Material Inspector to save current settings as JSON format. Useful for sharing settings with other users.

インポート

Import

「インポート」ボタンで外部のプリセットJSONファイルを読み込み、適用してPresetフォルダにコピーできます。

Click "Import" button to load external preset JSON files, apply them, and copy to Preset folder.

視線制御 Eye Control

VividAvatarFXはVRC Aim Constraintを使用した視線制御を統合しています。

VividAvatarFX integrates an eye control using VRC Aim Constraint.

自動セットアップ Automatic Setup

Setup Tool実行時、以下の順序で目のボーンを自動検出します：

When running Setup Tool, eye bones are automatically detected in the following order:

1. AnimatorのHumanoid設定からLeftEye/RightEyeを取得
2. 見つからない場合、Headボーン以下から名前で検索
3. Get LeftEye/RightEye from Animator's Humanoid settings
4. If not found, search by name under Head bone

• 左目： eye.l, eye_l, lefteye, left eye など
• 右目： eye.r, eye_r, righteye, right eye など
• Left eye: eye.l, eye_l, lefteye, left eye, etc.
• Right eye: eye.r, eye_r, righteye, right eye, etc.

手動設定 Manual Setup

自動検出がうまくいかない場合：

If automatic detection doesn't work:

1. Setup Toolで左目ボーン/右目ボーンを手動選択
2. 通常はArmature/Hips/Spine/Chest/Neck/Head/以下にあります
3. 「ベイク時に視線制御も設定する」にチェックを入れてベイク実行
4. Manually select left/right eye bones in Setup Tool
5. Usually located under Armature/Hips/Spine/Chest/Neck/Head/
6. Check "Setup Eye Control on Bake" and execute bake

視線制御の切り替え

Eye Control Toggle

視線制御のON/OFFを切り替えるアニメーションクリップが自動生成されます：

Animation clips for toggling eye control ON/OFF are automatically generated:

• VAFX_Eye_ON.anim ：視線制御を有効化: Enable eye control
• VAFX_Eye_OFF.anim ：視線制御を無効化: Disable eye control
• 保存先： Assets/x2much4u/VividAvatarFX/Animation/Light/
• Save location: Assets/x2much4u/VividAvatarFX/Animation/Light/

ライト機能 Light System

撮影用ライト。掴んで固定できるライトです。

Photography light system. Lights that can be grabbed and fixed in place.

ライトの種類 Light Types

Point Light × 3

• 全方向に光を放射
• 影は落ちません
• Range調整： 光の届く範囲を調整可能
• Emits light in all directions
• No shadows cast
• Range adjustment: Adjustable light reach distance

Spot Light × 4

• 指向性のある光
• 影が落ちます（Soft Shadow）
• Angle調整： 照射角度を調整可能
• Directional light
• Casts shadows (Soft Shadow)
• Angle adjustment: Adjustable light angle

使い方 Usage

1. VRChatメニューから使用したいライトを選択
2. ライトを掴んで任意の位置に配置
3. 固定ボタンでその場に固定
4. 強度・色・Range/Angleを調整
5. Select desired light from VRChat menu
6. Grab and place light at desired position
7. Fix in place with fix button
8. Adjust intensity, color, Range/Angle

技術仕様 Technical Specifications

Expression Parameters使用量

Expression Parameters Usage

0ビットEffectively 0 bits

すべてのパラメーターはSynced: falseに設定されているため、Expression Parametersの容量を消費しません。
そのため、容量を気にすることなく使用できます。

All parameters are set to Synced: false, so they don't consume Expression Parameters capacity. Can be used without conflicting with other gimmicks.

シェーダー仕様

Shader Specifications

• シェーダー名：Shader name: x2much4u/VividAvatarFX
• レンダーキュー：Render queue: 4100 （デフォルト、変更可能）(Default, changeable)

トラブルシューティング Troubleshooting

エフェクトが表示されない

Effects Not Showing

影響範囲について

About Effect Range

VividAvatarFXはCubeが視界に入っていないとエフェクトが適用されません。

VividAvatarFX effects won't apply unless the Cube is in view.

プリセットが適用されない

Preset Not Applying

• プリセットJSONファイルがAssets/x2much4u/VividAvatarFX/Preset/にありますか？
• ファイル名がVAFX_で始まっていますか？
• 適用後にSetup Toolで再度ベイクを実行しましたか？
• Is the preset JSON file in Assets/x2much4u/VividAvatarFX/Preset/?
• Does the filename start with VAFX_?
• Did you re-bake with Setup Tool after applying?

視線制御が動作しない

Eye Control Not Working

• Setup Toolで「ベイク時に視線制御も設定する」にチェックが入っていましたか？
• 目のボーンが正しく設定されていますか？
• VRChat内で視線制御のトグルをONにしていますか？
• 他の視線制御ギミックと干渉していませんか？
• Was "Setup Eye Control on Bake" checked in Setup Tool?
• Are eye bones correctly set?
• Is eye control toggle ON in VRChat?
• Is it interfering with other eye control systems?

マテリアルを調整したのにVRCで反映されない

Material Changes Not Reflected in VRC

原因：Cause: ベイクを実行していないBaking not executed

解決方法：Solution: Setup Toolで再度ベイクを実行してください。マテリアルの値を変更した場合は必ずベイクが必要です。Re-bake with Setup Tool. Always bake after changing material values.

よくある質問 FAQ

Q: Quest対応していますか？Q: Is Quest supported?

A: VividAvatarFXはPC専用です。Quest版では動作しません。VividAvatarFX is PC only. It does not work on Quest.

Q: 操作できる項目が多いので、パラメーター数が心配Q: I'm worried about too many parameters

A: すべてのパラメーターはSynced: falseのため、Expression Parametersの容量を消費しません。使用容量は0ビットです。All parameters are Synced: false, so they don't consume Expression Parameters capacity. Effectively uses 0 bits.

Q: 他のカメラギミックと併用できますか？Q: Can I use it with other Camera Gimmick?

A: このギミックでは現在描画されている画面に対してエフェクトをかけるので基本的には可能ですが、画面を歪ませるギミックに関しては相性が悪いです。切れ目が発生したり、エフェクトがかかりきらない箇所が出る場合があります。
また、描画順を変えたい場合はレンダーキュー値を調整してください。Since this gimmick applies effects to the currently rendered screen, it's generally possible to use with other camera gimmicks. However, it may not work well with gimmicks that distort the screen. You might experience visual breaks or areas where effects are not fully applied.
If you need to change the rendering order, please adjust the render queue values.

Q: アップデート時の手順は？Q: What's the update procedure?

A: 新しいバージョンをインポート後、Setup Toolで再度ベイクを実行してください。プリセットやカスタム設定は保持されます。After importing new version, re-bake with Setup Tool. Presets and custom settings will be preserved.

Q: 設定を元に戻したいQ: I want to reset settings

A: マテリアルInspector右上の⁝からResetを押すと、シェーダーの初期値に戻ります。Click ⁝ at top-right of Material Inspector and select Reset to return to shader default values.

Q: VR視点でレンズ歪みが表示されないのはなぜ？Q: Why doesn't lens distortion show in VR view?

A: VR酔いを防ぐため、VR視点では意図的に非表示になっています。カメラやデスクトップ視点では引き続き表示されます。It's intentionally hidden in VR view to prevent motion sickness. It continues to display in camera and desktop views.

ライセンス License

VividAvatarFX本体

VividAvatarFX Main Product

VividAvatarFXはVN3 Licenseのもとで配布されています。

VividAvatarFX is distributed under VN3 License.

更新履歴 Changelog