日本語 | English

Clearwater VRC

VRChatワールドに、歩いて入れる透明な浅瀬と海岸を作るパッケージです。水面の反射、水底に揺れる光の模様（コースティクス）、波音に合わせて寄せては返す波打ち際、潜ったときの水中の見え方までを含みます。元になったWebGLデモはclearwater by Aureliengmz（MIT、© Lumaris、Third Party Notices.md）です。

Clearwater Beach（Build Sceneで作る標準のシーンを公開したワールド）で、VRChatの中で試せます。

浜から見た遠浅の海

遠浅の水と光の模様波打ち際（打ち上げと泡）
浅瀬を上から見た水面と水底の光の模様浜に打ち上げる波と泡
水中水中から見上げた空（丸く切り取られて見える）
水中から浜の方を見た様子水中から水面を見上げた様子

時刻に合わせて、空の色を変えられます。日の出から夕焼け、月夜まで、大気が日光を散らす様子を物理に沿って計算した色です。

上段は日の出・朝・午後（16:30）、下段は日没・薄明・月夜の空と海

時刻は、ワールドの中のパネルからも変えられます。散乱の重い計算はエディターで一度だけ行って表に保存し、実行中は表を引くだけです。そのため、時刻のない空と比べて増える負荷は、VRの片目で0.1〜0.15msに収まります（時刻と空、負荷の目安）。

PC向けです（GPU計算を多用するためQuestでは動きません）。VRChat Worlds SDK 3.10以降が必要で、Unityでワールドを組んでアップロードしたことがある人を想定しています。

初めて使うときは「入れ方」「始める」「海岸を描く」の3章を順に読めば、海岸ができるところまで進めます。それ以降の章は、自分の地形やプールを使いたくなったとき、見た目を調整したいときに引いてください。用語の定義はCONTEXT.mdに、中で何が起きているか（波の計算、水底の描き方、描画順、空と同期など）は、図と一緒にdocs/technical.mdにあります。調整できる数値の初期値とファイルの役割の一覧も、そちらにまとめています。主な仕組みは、動く図解でも見られます。

入れ方

ALCOM / VCCにこのパッケージのリポジトリを追加し、ワールドのプロジェクトに「Clearwater VRC」を追加します。

  1. ALCOM / VCCの設定（パッケージ）で、リポジトリの追加に次のURLを入れます（配布ページのボタンからでも追加できます）

    https://bmbb93.github.io/clearwater-vrc/index.json

  2. プロジェクトの管理画面で「Clearwater VRC」を追加します

リリースのzipを展開してプロジェクトのPackages/に置いても使えます（埋め込みパッケージ）。パッケージ自体を編集しながら使うときは、このリポジトリを手元に置き、プロジェクトのPackages/manifest.jsonのdependenciesにそのフォルダへの参照を書きます（コピーせず、そのフォルダを直接読みます）。パスはPackages/からの相対でも書けます。

"com.vbamboo.clearwater": "file:<このリポジトリのフォルダ>"

始める

新しいシーンから始める

Tools > Clearwater > Build Sceneを実行すると、Assets/Clearwater/Scenes/Clearwater.unityに水・浜・太陽・スポーン地点の入ったシーンができ、ビルド設定のシーン一覧がこのシーン1つになります。2回目以降の実行では素材を作り直しますが、シーンに手で置いた物やワールドIDはそのまま残ります。Assets/Clearwater/Generatedの中の、シーンのフォルダーにあるマテリアルで調整した値（波の高さ・明るさ・雲・トーンマッピングの方式など）も残ります。作り直されるのは、テクスチャの参照などClearwaterが決める値だけです。シーンを初めから作り直すときはRecreate Sceneを使います。トーンマッピングはポストプロセス（PPv2）になります（「トーンマッピング」の章）。

既存のワールドに足す

ワールドのシーンを開いてTools > Clearwater > Add to Current Sceneを実行します。水一式と、まっすぐな海岸の編集用オブジェクト「Coast (editor only)」が追加されます。最初に「Clearwaterの空と太陽も使うか」を聞かれます。

  • 使う：Build Sceneと同じ空と太陽（Sun (Clearwater)）になり、時刻で変わる空（「時刻と空」の章）が付きます。環境光も、その空に合わせて変わります。ワールドのDirectional Lightは、そのLightコンポーネントだけがオフになります（オブジェクトやほかのコンポーネントはそのまま。削除もしません）
  • 使わない：ワールドの太陽をそのまま使います。その太陽の影が無効なら、Clearwaterが有効にします。Directional Lightがなければ「Sun」を作り、空が未設定かUnityの既定の空ならClearwaterの空にします

どちらでも、トーンマッピングはポストプロセス（PPv2）になり（「トーンマッピング」の章）、追加のあとシーンは保存されます。

あとから切り替えるときはTools > Clearwater > Use Clearwater Sky and Sunを使います。水は画面の奥行き情報を使って水底や水中の物を透かすので、影は有効のままにしてください。影を切ると奥行き情報が作られず、水を正しく描けません。ワールドのReference CameraのFar Clipも、海の広さに合わせる必要があります（次章のSea size）。

どちらの始め方でも、次は海岸の形を描いてBakeします。

デモシーンで試す

使い方の例になるシーンを6つ用意しています（VRC Light Volumesがプロジェクトに入っていれば7つ）。Tools > Clearwater > Demo Scenes > Build Demo Scenesを実行すると、Assets/Clearwater/Demoにシーンとその地形・マテリアル・テクスチャが作られます（30秒ほどかかります）。どれもBuild Sceneと同じ新しいシーンで、Beachはそのまま（Clearwaterが作る地面）、ほかはそれに地面を足したものです。開いているシーンは変えません。実行の前に、開いているシーンを保存するかを聞かれます。作り終えるとBeachのデモが開きます。

どのデモでも、空のパネル（「時刻と空」の章）を、VRでは左手のトリガー2回、デスクトップではTabキーを押している間、手元に呼び出せます。どのデモにも、パネルを出す小石は置かず、見た目も当たり判定もない呼び出し役（Sky Panel Caller）だけを置いています。スポーン地点は、どのデモでも海から離れた乾いた地面の上です。どのデモも、トーンマッピングはポストプロセス（PPv2）です。

シーン開くメニュー内容詳しい章
Demo_BeachOpen Beach (Clearwater's own ground)Build Sceneと同じ、Clearwaterが作る地面の浜（まっすぐな海岸線、既定の断面と起伏）。まず試すならこれです海岸を描く
Demo_CoveOpen Cove (a mesh as the ground)メッシュで作った砂の入り江。外側の地面を「Match the user terrain」で同じ砂にしています自分の地形を使う
Demo_HarborOpen Harbor (a quay and a pier)垂直な岸壁、階段護岸、スロープ、杭で立つ桟橋。杭にはObstacleを付けています自分の地形を使う、物を置く
Demo_PoolOpen Pool (still water only)海のない25mプール。深さは0.5mで、ジャンプすればプールサイドに上がれます。Poolを使わず、線をClosedにして囲み、打ち寄せる波をオフにしていますプールを置く（最初の段落）
Demo_ResortOpen Resort (the sea and two pools)海辺の建物に、1階の屋内プールと2階のテラスのプール。テラスへは、海に向かって右手の外壁沿いのスロープで上がれます。どちらのプールも深さ0.7mで、ジャンプすれば縁に上がれますプールを置く
Demo_TerrainOpen Terrain (a Unity Terrain)UnityのTerrainで作った入り江・岬・砂州自分の地形を使う
Demo_LightVolumesOpen Light Volumes (VRC Light Volumes)夜（21時）の浜をPoint Light Volumeで照らしたもの。砂の上・浅瀬の上・水の中（浅い所と水深1.6m）のランプ、浜を照らすスポット、水際を回りながら色と明るさを変えるランプ（ClearwaterDemoLamp）。VRC Light Volumesが入っているときだけ作られ、メニューにも出ますVRC Light Volumes

デモは、メニューのOpen ...からでもProjectウィンドウからでも開けます。ベイクしたデータはシーンごとにあるので（下の「ベイクしたデータはシーンごと」）、デモを開いたり作り直したりしても、自分のシーンは変わりません。

Build Demo Scenesは、どのシーンも使う共有の素材（Assets/Clearwater/Generatedの直下）をBuild Sceneと同じように作り直します。デモが要らなくなったら、Assets/Clearwater/Demoフォルダと、Assets/Clearwater/GeneratedのDemo_で始まるフォルダを消してください。

海岸を描く（Coast (editor only)）

シーンの「Coast (editor only)」を選ぶと、Sceneビューに波打ち際の線が出ます。線と断面（沖へ向かう地面の高さ）の設定は、InspectorのBakeを押すと、水面・水底・波・歩ける地面・波音の位置のデータになります（ベイク）。設定を変えたらBakeし直してください。し直すまでは、水も地面も前の形のままです。

Sceneビューには四角が3つ出ます。黄色は細かくベイクする範囲（Area Size）、緑は歩ける範囲（Ground Half Sizeはその半分の長さ。端に見えない壁が立ちます）、水色は海の範囲（Sea size）です。

線の形は、次の操作と設定で決めます。

  • 点をドラッグして動かす。線の途中の「+」で点を追加、点を選んでDeleteで削除
  • Lineで線の種類を選びます：Straight（点を直線で結ぶ）、Smooth（点を通るなめらかな曲線、初期値）、Handles（Illustratorのパスのように、各点の2本のハンドルで向きと曲がり具合を決める）
  • Handlesでは、選んだ点と両隣の点にハンドル（四角）が出ます。ドラッグで曲がり具合を変え、Altを押しながらドラッグすると角になります。Inspectorの「Smooth point / Corner point / Auto handles」で点ごとに切り替えられます。「+」で点を足しても曲線の形は変わりません
  • 矢印が海の側です（線の進む向きの左側）。逆なら「Reverse direction」
  • 開いた線は両端の先へまっすぐ続きます。Closedにすると輪（島・湖）になります
  • 「Reset line」で線を初期のまっすぐな線（3点、200m）に戻します。断面などの設定はそのままです。すべての設定を初期値に戻すときは、コンポーネントの⋮メニューのResetを使います

断面と波の設定です。

  • 断面：Gentle Beach（遠浅の浜、数値で調整）かCurve（波打ち際からの距離に対する地面の高さを曲線で描く）
  • 断面のプリセット：Presetで選んで「Apply」。遠浅の浜（数値）、急な浜、砂州のある浜、礁湖（広い浅瀬）、湖岸（Shore wavesオフ向け）、磯の急斜面、丘の下の遠浅の浜（遠くからも陸が見える）。遠浅の浜以外はCurveとして入るので、そのまま曲線を手直しできます
  • Shore wavesをオフにすると、波打ち際の波と波音がなくなり、岸の水は静かになります（湖や池向け）。なくなるのは、寄せ波・砕波・泡・濡れた砂と、打ち上げ（砕けた波が浜を駆け上がって引いていく水）です。沖の小さな波と、遠くの海の環境音は残ります

海の広さはSea size（初期値5000m四方、水のオブジェクトが中心）で変えられます。Bakeすると、水面・遠くまで描く地面・水中の表現がこの広さに合わせて変わり、水面の端は遠くのもやに溶け込みます。ワールドのReference CameraのFar Clipは、Sea sizeの0.8倍（初期値なら4000m）が必要です。足りないとInspectorに警告と「Set ○○ m」ボタンが出て、押すとワールドのReference Cameraに設定されます。

ベイクしたデータはシーンごと

ベイクしたデータと、それを読むマテリアル（水・水底・水中・空など）は、シーンごとのフォルダーAssets/Clearwater/Generated/（シーン名）_（英数字 8 文字）にあります。英数字はシーンのGUIDの先頭で、シーンの名前を変えても同じフォルダーが使われます。同じプロジェクトの複数のシーンでClearwaterを使っても、それぞれのBakeは互いに影響しません。マテリアルで調整した値も、シーンごとに別です。

  • シーンを複製すると、最初のBakeのときにマテリアルが新しいシーンのフォルダーへ複製され、調整した値も引き継がれます
  • 前の版でAssets/Clearwater/Generatedの直下に作ったデータは、最初にBakeしたシーンのフォルダーへ移ります。別のシーンが同じデータを使っていたら、そのシーンのBakeのときに複製されて分かれます
  • シーンを消しても、そのフォルダーは残ります。要らなければ手で消してください
  • 波のスペクトル・光の模様・空のLUT・トーンマッピングなど、シーンによらないものはAssets/Clearwater/Generatedの直下で共有します

波が寄せる向き

波は沖から一方向に寄せ、浜ごとに、その向きへ開けている分だけ届きます。湾の奥には湾口から入る分だけが届き、波が沿って走る壁ぎわではほとんど砕けません。この届き方の違いは、波の高さ・打ち上げ・白波・泡・波音の大きさに表れます。

届くタイミングも向きで変わります。湾の奥には遅れて届き、斜めに寄せる波は浜に沿って順に砕けていきます。波は浅い所ほど遅く進むので、届く時刻もそれに合わせて計算しています。波音は、聞こえてくる浜の波に合わせます。

  • Swell direction auto（初期値オン）：このオブジェクトのまわり約200mの海岸が、平均して向いている正面から寄せます
  • Swell from：autoを外したときの向き（ワールドの+Zから時計回りの角度）
  • Swell spread（初期値25°）：広げると、湾の奥や横向きの浜にも波が回り込みます

Sceneビューの「swell」の矢印が、いまの向きです。

歩ける範囲の外まで線を描く

線は歩ける範囲の外まで描けます。遠くに点を置けば、岬・湾・対岸などの形になり、水面・遠景の地面・沖の波がその形に沿います。黄色の四角の外は、海全体（水色の四角）を粗くベイクしたデータで描きます。その間隔はSea size ÷ Outer Resolutionで、初期値では5000m ÷ 1024 ≒ 5mです。海の外では、線はそのまま同じ向きに続きます。

  • 遠くの陸は低いと水平線に埋もれて見えません。見せたいときは断面をCurveにし、陸側（マイナス側）を高くします
  • 線が長くても、歩ける範囲の近くは約1m間隔で細かくベイクします。遠くの区間ほど粗くなります（線全体で最大512点）
  • 波音の音源は、歩ける範囲から100m以内の部分の線だけを使います

底の見た目（Bed look）

水の下から浜までひと続きの地面（Bed）の見た目は、CoastのBed lookで選びます。水の下と浜は同じ見た目になり、変更はBakeなしですぐ反映されます。

SandPebbles
Sandの浜Pebblesの浜
  • 同梱のプリセット：Sand（ベージュ〜茶色の砂浜、初期値）/ Pebbles（小石）。CoastのSand / Pebblesボタンで切り替えられます
  • 自分の見た目：Projectで右クリック > Create > Clearwater > Bed Look。Color（色、必須・タイル状）とHeight（高さ、任意。なければ色の明るさから推定）、1枚が何m四方か（Tile size）を指定します
  • 重ねる効果：隙間の砂（Sand fill）、波紋（Ripple marks。Sand bedをオンにすると底全体に）、藻の色（Weed tint）、色味（Tint・Saturation・Brightness・大きなまだらPatchiness・小石の落ち着いた色調Muted grade）
  • つや：Smoothness（StandardシェーダーのSmoothnessと同じ意味。初期値0 = つやなし）。水より上の乾いた地面に、空の映り込みと太陽のハイライトが付きます。0のときは負荷も増えません
  • 自分の地形に合わせる：次章の「Match the user terrain」を参照

自分の地形を使う（Terrain source: User）

歩ける範囲（緑の四角）の地面を、自分で作ったメッシュやUnityのTerrainにできます。岩場の入り江や、岸壁のある港のように、線と断面では作れない形に使います。

メッシュの入り江岸壁のある港UnityのTerrain
メッシュで作った入り江岸壁と階段護岸Terrainで作った浜の波打ち際
  1. 地形のメッシュ・Terrainを一つの親オブジェクトの下にまとめます。当たり判定も自分で付けます（Mesh Collider・Terrain Colliderなど）
  2. CoastのTerrain sourceをUserにし、User terrainにその親を指定します
  3. Coastの線を、歩ける範囲の端で地形の波打ち際（Waterline：地形が水面の高さ0と交わる所）に合うように描きます
  4. Bake

Bakeすると、次のようになります。

  • 地形の見た目と当たり判定は、自分のマテリアル・コライダーのままです。Clearwaterは地形を上から見た高さをベイクし、水面の色・波・水底の光・Seabed（水底を描くオブジェクト）をそれに合わせます
  • 歩ける範囲の中では、地形が水面と交わる線を見つけて波打ち際にします（描いた線はその外側の部分だけ使われます）。線をClosedにしたときは差し替えないので、線を波打ち際に合わせて描いてください
  • 地形の外側は、線と断面からClearwaterが作る地形（生成地形）のままです。その生成地形が、Seam width（初期値20m）の幅の境目で地形の縁の高さになめらかにつながります
  • 地形の上には、水中の光の模様と、波打ち際の濡れ・泡が重なります。これらは、水の下に作られる2つのProjector（Unityのコンポーネント）「User Terrain Caustics」「User Terrain Beach」が描きます。Projectorは地形と同じレイヤーにかかるので、そのレイヤーの他の物にもかかります
  • 生成地形の当たり判定はオフになります（歩ける範囲の端の見えない壁は残ります）
  • 打ち上げの速さと距離は、地形の波打ち際の傾きから決まります
  • 地形を動かしたり作り替えたりしたらBakeし直します（Inspectorが知らせます）

外側を同じ見た目にするには、Bed lookの「Match the user terrain」を押します。地形の大部分を覆うマテリアル（Terrainなら一番多く塗られたレイヤー）のテクスチャ・色・1枚の大きさ・SmoothnessからBed lookが作られます（Specular HighlightsとReflectionsが両方オフなら、つやなし）。作られたBed lookはシーンと同じフォルダに「（シーン名） Bed Look」として保存され、Coastに設定されます。境目の外側と遠くの水底が地形と同じ見た目になり、明るさなどはそのBed lookで調整できます。

UnityのTerrainでは、高さをTerrainのデータから直接読みます（メッシュと重なる所は高いほう）。水底の平均の色と「Match the user terrain」は、塗られたレイヤーから取ります。標準のTerrainシェーダー（Standard）はテクスチャのアルファをSmoothnessとして使うので、アルファ付きのテクスチャだと地面が鏡のように光ります。つや消しにしたいときは、Nature/Terrain/DiffuseのマテリアルをTerrainに指定してください。

Bakeで見つかった問題は、CoastのInspectorに番号付きの警告として出ます。Sceneビューには同じ番号の赤い印が出て、「Show」でその場所を映せます。

警告何が起きるか直し方
歩ける範囲に、地形で覆われていない所があるそこには立てる地面がなく、落ちる地形で覆うか、Ground Half Sizeを小さくする
地形が、ベイクする範囲（歩ける範囲と境目）からはみ出しているはみ出した所に生成地形が重なって見える地形を小さくするか、Ground Half SizeかSeam widthを大きくする
境目が急（高低差が境目の幅の0.2倍を超える）地形のまわりに土手や溝ができるSeam widthを広げるか、縁の高さが生成地形に近くなる所まで地形を延ばす
Coastの線が、歩ける範囲の端で地形の波打ち際から5m以上離れている波打ち際が端でずれる線の端を地形の波打ち際に合わせる

プールを置く（Clearwater Pool）

海とは別の高さに水面を置けるプールを、いくつでも追加できます。リゾートの建物なら、1階の屋内プールと2階のテラスにあるプールを、海と一緒に置けます。水面・水中・光の模様・触ったときの波紋は海と同じ仕組みで、打ち寄せる波と波音はありません。

1階の屋内プール（部屋が映る）2階のテラスのプールプールの水中
屋内プールと海側の開口部テラスのプールテラスのプールの水中

同じ水面の高さのプールだけで海がないワールドなら、Poolを使わずに前章の「自分の地形」でも作れます。Shore wavesをオフにし、線をClosedにしてプールを囲みます。水は地形が水面より低い所にだけ見えるので、水面の高さが同じなら、プールがいくつあっても使えます。線は全部を囲む輪で構いません（1つだけ囲んでも見た目はほぼ同じです）。

Poolは次の手順で置きます。

  1. Tools > Clearwater > Add Poolで「Pool」を置き、プールの水面の高さに合わせます。オブジェクトの位置が水面です。回転はさせません
  2. 子の「Basin」の下に、プールの水槽（壁と底。まわりのデッキも入れて構いません）のメッシュを入れます。当たり判定も自分で付けます。天井や飛び込み台は入れません。上から見て一番高い面が底としてベイクされるためです
  3. Size（水面の範囲、xとz）を水槽の内側より少し大きめにします。水が見えるのは水槽が水面より低い所だけなので、大きめで構いません
  4. PoolのInspectorのBakeを押します（CoastのBakeでも、すべてのプールがベイクされます）

設定は次のとおりです。

  • Wave Strength：水面の揺れ（海の波を1として。初期値0.35）。光の模様の濃さも同じだけ弱まります
  • Indoor：屋内。太陽の光（光の模様・ギラつき・日の当たる底）がなくなり、空の代わりに部屋が映ります。部屋が映るのはリフレクションプローブからなので、プローブを置かないと何も映りません
    • プローブはBox Projectionをオンにします
    • VRChatではBakedのプローブが軽く、Realtimeは重くなります。【未確認】Bakedのプローブでの見え方は、実ワールドでまだ試していません
  • Fog Distance：水中の見通し（m）

Bakeすると、次のようになります。

  • プールの子に「Pool Water」（水面）、「Pool Underwater」（水中）、「Pool Caustics」（壁と底、プールの中のアバターに落ちる光の模様）ができます。素材はシーンのフォルダーのPools/に保存されます
  • 海はプールの範囲（上から見た四角の中で、底から水面までの空間）に入り込みません。プールの底が海面や生成地形より低くても、海の水面・地面・光の模様は出ず、生成地形の当たり判定もその部分は抜かれます
  • プールを動かしたらCoastもBakeし直してください。し直すまでは、海の当たり判定と穴が前の位置に残ります（Inspectorが知らせます）
  • どの水の中にいるかは、プールの範囲で判定します。頭がプールの中なら、プールの水中の表現と水中の音になります。画面や写真のカメラも、それぞれがいる水の水中の表現になります
  • 波紋は、自分がいる水にだけ付きます。プールの上・中・すぐ横にいれば、そのプールです。【未確認】足や手で触れたとき、タップしたときにプールに波紋が出るかは、実ワールドでまだ試していません
  • 下の階から、上の階のプールを水面の下から見た表現は出ません

Bakeで見つかった問題は、PoolのInspectorに番号付きの警告として出て、Sceneビューに印が出ます。

警告何が起きるか直し方
水がない水面が描かれないPoolの位置を水面の高さにする。Basinから天井やカバーを外す
水槽がSizeの外まで水面下に続いているその部分で水が途切れるSizeを大きくする
ほかのプールと同じ高さで重なっている水中になるのは一度にどちらか一方だけプールの位置か高さをずらす
回転している水面は回転せず、ワールドの軸にそろった四角のままPoolは回転させず、Basinの中身を回す

次のことはできません。

  • 水越しに別の水を見ること（ガラス張りのプール越しの海など）。奥の水は映りません
  • プールの打ち寄せる波
  • 回転したプール（範囲は軸にそろった四角です。斜めのプールはそれを囲む四角で置きます）

物を置く（Clearwater Stamp）

海岸の上に置いた物は、ClearwaterStampを付けてからBakeすると、海岸の一部として扱われます。

杭にObstacleを付けた桟橋

モード使い方効果
Obstacle水中に立つ岩・杭・流木など、実際に見える物に付ける波がその物に当たって砕け、周りに白波ができる。Receive Causticsで水中部分に光の模様が落ちる（ClearwaterPropsレイヤーに移動）
Raise Ground形を作るための見えないブラシ（任意のメッシュ）その上面が地面になる（砂州・岩棚）。水底・歩ける地面・波がすべて追従
Carve Ground同上その上面まで地面が掘られる（潮だまり・水路）

ブラシはBakeのあとは見えなくなり、Sceneビューにはワイヤーフレームで出ます（アップロードには含まれません）。スタンプの周りには30°ほどの斜面が自動で付きます。スタンプを動かしたらBakeし直してください。

波・明るさ・雲を変える

波・明るさ・雲・音量を変える設定の置き場所です。マテリアルはAssets/Clearwater/Generatedの中の、シーンのフォルダーにあります（「ベイクしたデータはシーンごと」）。

  • 波の大きさ：Water・SeabedマテリアルのBreaker height（砕ける波の高さ）/ Run-up（打ち上げが届く高さ。Breaker heightの倍数）

  • 波が沖のどこから現れるか：WaterマテリアルのSwell start depth（初期値2.6m）。水深がこれより浅い所からうねりが現れ、0.8m浅い所で本来の高さになります。深くするほど沖から見えます（沖ほど波は低い）。海岸の断面の最深部より深くすると海全体にうねりが出て、そのぶん重くなります（範囲0.5〜6m）

  • 波打ち際の白波：Whitewater height（打ち上げる波の先端の盛り上がり、初期値3cm）/ Foam relief（泡の凹凸の陰影。近くで見るとき用、初期値0 = なし）

  • 打ち上げの速さと距離は、Bakeのときに浜の傾きから自動で決まります。坂に投げたボールと同じ動きで、緩い浜ほどゆっくり遠くまで上がります。浜の傾きはCoastのBeach Slope（初期値0.1）です

  • 明るさ：水・Seabed・空・水中のマテリアル（Water・Seabed・Sky・Underwater）のSun intensity / Exposure。4つとも同じ値にします

  • 雲：空のマテリアル（Sky）のClouds

    • Cover（0 = なし、初期値）、大きさ、流れる速さと向きを決めます
    • 水面の反射、水中から見上げたときに空が見える丸い範囲、濡れた砂の映り込みにも同じ雲が出ます。Inspectorで変えると、水面・Seabed・浜のマテリアルと、雲のドーム（下）にも自動でコピーされます
    • 雲が流れるのはワールドの実行中です（SceneビューではAlways Refreshをオン）
    • 雲は海と浜に影を落とし、影も雲と一緒に流れます。雲の量を減らすと、まばらな所の雲から消え、残る雲も小さくなります
    • 雲は立体として、日の光と空の光で照らして描きます。シーンごとの雲のドーム（GeneratedのシーンのフォルダーのCloudDome）に少しずつ描き直し（約0.2秒で空を一周）、空と水はそれを読むだけです。描き直しの合間も、雲は風に合わせてなめらかに流れます。ドームはBuild Scene、CoastのBake、シーンを開いたときに作られます
    • As in 1.2をオンにすると、1.2までの雲（空が画素ごとに描く平らな雲）に戻ります。雲の影は出ず、雲のドームも描かないので、負荷も1.2と同じです。1.2で作ったワールドの見た目を変えたくないとき用で、初期値はオフ（新しい雲）です

    1.2までの雲（左）と1.3の雲（右）。上は午後16:30、下は日没後19:18の海の上

    左が1.2までの雲、右が1.3の雲です（どちらも雲30%、同じ時刻・同じ視点）。1.2までは陰影の少ない平らな雲で、筋のようにちぎれた形でした。1.3では雲を立体の積雲として照らすので、日の当たる側が明るく下面に陰ができ、夕暮れは日の色に染まります。水面にもはっきり映り、海と浜には影を落とします。そのぶん負荷は約0.4ms増えます（「負荷の目安」）

  • 遠景の陸：空のマテリアル（Sky）のDistant land。水平線のどれだけを陸（松林の岬）が占めるかを0〜1で決めます（0 = 一周すべて海、1 = 一周すべて陸、初期値0.5）。陸は海と反対側を中心に広がり、端は海面までなだらかに下がります。どちらが海かは、CoastのBakeがうねりの来る向きから決めます（海岸がなければ+Z側）。海岸があれば、陸は2km先まで地面が続く方角にだけ立ち、海岸線が歩ける浜から離れていく所では、海岸と一緒に海面まで下がります（海の上に山が浮きません。CoastのBakeが空のマテリアルにも海岸を渡します）。Land setbackで山を海岸線から内陸へ下げ（m）、Land heightで高さを変えられます（1 = そのまま、0 = 山なし）。雲と同じく、水面とSeabedのマテリアルにもコピーされます

  • 波紋・波音の音量：シーンの「Clearwater Controller」。Sound Volume（0〜1）は3つの波音をまとめて下げる倍率で、ワールドのU#から変えられます（動画の再生中に下げる、スイッチで消す、など）。建物があるときは、Buildingsに建物の箱（Clearwater SkyのSky Light Volumesと同じもの）を入れると、中では波音が遮られてIndoor Level（初期値0.3）倍になり、床下の波打ち際からは鳴らなくなります

  • 水中の見え方：水中のマテリアル（Underwater）のFog density（見通し。1で水面から見た水と同じ濃さ、小さいほど遠くまで見える。初期値0.2）/ Fog saturation（遠くで行き着く水の色の濃さ。初期値0.7）/ Fog brightness（その色の明るさ。初期値1）。水面から見た水の色は変わりません

時刻と空（Clearwater Sky）

空の色は、大気が日光を散らす様子を物理に沿って計算したものです。空気の分子が青い光をよく散らすので昼の空は青く、夕方は赤い光だけが長い距離の空気を抜けて届きます。太陽の周りの白いまぶしさは細かい粒子の散乱、日没後の深い青紫はオゾンの吸収です。この計算はエディターで一度だけ行って表（Assets/Clearwater/Generated/SkyLUT.asset）に保存し、実行中は表を引くだけです。

時刻を変えると、空の色と一緒に、太陽の光の向きと色、アバターやワールドに当たる環境光、空の映り込みも変わります。夜は満月が太陽の反対側から照らし、星と天の川が天の北極の周りを回ります。

使い方

Build Sceneで作ったシーンでは、太陽（Sun）に「Clearwater Sky」コンポーネントが付いています。前からあるシーンには、Tools > Clearwater > Use Clearwater Sky and Sunを一度実行すると付きます。ワールドの太陽をそのまま使うシーン（Add to Current Sceneで「使わない」を選んだとき）には付かず、時刻のない空（太陽31°の午後の空）のままです。

時刻の扱いは2通りです。

  • 時刻を止める（Cycleオフ、初期値）：Time of dayの空のまま変わりません
  • 時刻を進める（Cycleオン）：インスタンスが開いたときにTime of dayから始まり、Day minutes分（初期値24分）で1日が過ぎます。開始の時刻はインスタンスのオーナーが配るので、後から入った人にも同じ時刻の空が見えます

Inspectorで値を動かすと、SceneビューとGameビューにすぐ映ります。初期値（16:30、北緯35°、夏至）では、太陽の位置と光が時刻のない空と同じになります。

項目内容
Time of day時刻。その土地の太陽の時刻で、12時に太陽が一番高くなる
Cycle / Day minutes時刻を進めるか / 1日にかかる実時間（分）
Latitude / Day of year緯度 / 1月1日から数えた日。太陽の高さ、昼と薄明の長さが決まる
Northワールドの中で北がどちらか（+Zから時計回りの角度）。ボタンNorth as the fixed sky'sで初期値に戻る
Moon満月を出す。夜の明かりになる
Night brightness月夜の明るさ（昼に対して。初期値0.05）
Stars星と天の川の明るさ
Underwater Glow日も月も光らない夜に、水中から見て水に残すほのかな青緑の明るさ（初期値1。0で真っ暗、3でかなり明るい）
Update interval / Probe interval時刻を進めるとき、空の光を更新する間隔（初期値0で毎フレーム。間隔を空けても、太陽と月の向きは毎フレーム動く）/映り込みを描き直す間隔（10秒）

夜の明るさには、目が暗さに慣れる分を入れています。光の量は昼から月夜までに100万分の1ほどになりますが、画面は真っ暗にならず、月夜は昼の5%ほどの明るさで、色が褪せて青みがかって見えます。日の出前と日没後は、暗くなった景色に対して地平線の残照が明るく見えます。

ワールドの中で変える

Tools > Clearwater > Add Sky Control Panelを実行すると、空と波のパネルと、スポーン地点の前の砂浜に小石（Sky Stone）が置かれます。パネルの左の「Sky」には、時刻・雲の量・雲の流れる速さ（Cloud drift、0〜60m/s）・1日の長さ（A day in）のスライダーと、時刻を進めるかのトグル（Day goes by）が並びます。右の「Waves」には、岸の波の高さ（Shore waves）・沖のさざ波の強さ（Ripples）・さざ波の速さ（Ripple speed）のスライダーと、全部を初期状態に戻すボタン（Reset all）が並びます。パネルは普段は隠れていて、小石をInteractする（表示はSky & Waves）と、小石の上に、目より少し低い高さでこちらを向いて出ます。小石は好きな場所へ動かしてください。すでに置いてあるときに実行すると、小石を同じ位置に残して作り直します。

  • 誰でも操作でき、変えた空はインスタンスの全員に同じく反映されます。操作した人がClearwater Skyのオーナーになって値を配るので、後から入った人にも今の空が見えます
  • 時刻を進めているときは、時刻のスライダーも時刻に合わせて動きます。途中でスライダーを動かすと、その時刻から進み直します
  • 1日の長さは1分から24時間（実時間と同じ）までの17段階です。変えても時刻は飛ばず、その時刻から新しい速さで進みます
  • 小石のところへ行かなくても、どこでもパネルを呼び出せます。VRでは左手のトリガーを2回すばやく引くと、左手の少し先の上に小さめ（ワールドの0.55倍）のパネルが出て、その場にとどまります（手には追従しないので、右手で操作しやすい）。目から1.5m離れるか、もう一度2回引くと隠れます。デスクトップではTabキーを押している間だけ、画面の真ん中に出ます（パネルが画面の64%を埋める距離。視点を動かしてもついてきます）。Tabを押している間はVRChatがカーソルを自由にするので、そのままクリックで操作できます。三人称視点（F5）ではTabがカメラの回転になってカーソルが自由にならないので、パネルの代わりに「パネルは一人称視点で使えます（F5で切り替え）」という案内を出します（日本語の行はVRChatのフォールバックのフォントで出るので、エディターでは□になります）。出るときは0.18秒、消えるときは0.15秒でフェードし、少し大きくなりながら出ます。小石で出したパネルが出ている間は、Tabでは動かしません。この呼び出しは小石のCall Anywhereでオフにでき、キー（Desktop Key）、2回の間隔（Double Tap Time）、手の上の大きさ（Hand Size）と手からの距離（Hand Reach）、離れると隠れる距離（Hand Close Distance）、デスクトップで画面を埋める割合（Desktop Fill）、フェードの時間（Show Time・Hide Time）も変えられます。1.3.0までに作ったパネルは、Add Sky Control Panelで作り直すと、フェード（パネルのCanvasGroup）と三人称の案内（Sky Panel Hint (Clearwater)）が付きます
  • パネルを出すか隠すかは、見ている人ごとです。小石をもう一度Interactするか、パネルから6m離れると隠れます（小石のClose Distance。0にすると離れても隠れません）。置いた場所のまま出すときは、小石のShow Aboveをオフにします。いつも出しておくときは、パネルを有効にして小石を消してください
  • 雲の速さを変えても雲は飛ばず、今の位置から新しい速さで流れます
  • 岸の波の高さ（Shore waves）は、0から作ったときの2倍（30cm未満なら30cm）までです。砕ける波・打ち上げ・泡・濡れた砂と波音の大きさがまとめて変わります。0にすると、CoastのShore wavesをオフにしたときと同じ静かな水際になります（泡や濡れた砂も消えます）
  • 沖のさざ波（Ripples）は、海の水面の揺れと水底の光の模様の強さです。0%で鏡のような凪になります。プールの水面は変わりません
  • さざ波の速さ（Ripple speed）は0〜200%です。変えても模様は飛ばず、今の形から新しい速さで動きます。水面の波はプールと共通なので、プールの波も同じ速さになります
  • パネルの初期値（ワールドの開始時とReset allで戻る値）は、パネルと一緒に作られる「Sky & Waves Settings (Clearwater)」のInspectorでまとめて変えられます。変えられるのは、時刻・Day goes by・1日の長さ（実体はSunのClearwater Skyの値）、雲の量・雲の流れ・岸の波・さざ波・さざ波の速さです。雲と波は、変えるとその場で関係するマテリアル（空・水面・水底・水中など）にも書き込まれるので、Sceneビューの見た目もすぐ変わります
  • Reset allは、この初期値に全員まとめて戻します（戻す時刻は、シーンを保存したときのClearwater Skyの値です）
  • 時刻の同期はClearwater Skyが、雲と波の同期はSky & Waves Settingsが受け持ちます（同期するオブジェクトが2つなので、ネットワークIDも2つ使います）
  • パネルの見た目（子のFace）と小石の見た目（子のLook）はUIレイヤーに置くので、VRChatのカメラ（写真・配信用）には写りません。カメラの設定でUIを表示したときだけ写ります。操作を受ける親（パネルのVRC Ui Shape、小石の当たり判定）はUIレイヤーにしません。UIレイヤーのものは、VRChatのメニューを開いている間しか触れないためです
  • パネルの親と小石はWalkthroughレイヤーに置くので、アバターはぶつからずに通り抜けます
  • パネルの文字はTextMesh Proで、スライダーなどの図形はVRChatの超解像UIシェーダー（VRChat/Mobile/Worlds/Supersampled UI）で描くので、VRでも縁がにじみにくくなります。プロジェクトにTextMesh ProのEssential Resourcesがないときは、パネルを作るときに取り込みます（Assets/TextMesh Proができます）

自分のUdonから変えるときは、Clearwater SkyのSetHour(時刻)・SetCycle(true/false)・SetDayMinutes(分)・ResetTime()と、Sky & Waves Settings（ClearwaterSettings）のSetClouds(0〜1)・SetCloudDrift(m/s)・SetShoreWaves(m)・SetRipples(0〜1)・SetRippleSpeed(倍率)・ResetAll()を呼びます。どれも全員に同期します。

一緒に変わるもの

  • 太陽のDirectional Light：向き・色・強さ。夜は月の光になります
  • アバターとワールドの環境光：LightingのEnvironment LightingをGradientにして、空・地平線・地面の3色を時刻に合わせて変えます
  • 空の映り込み：太陽の子に置いた、空だけを映すリフレクションプローブ「Sky Reflection (Clearwater)」を描き直します（時刻を進めるときは10秒ごと）

ワールドに自分で置いたリフレクションプローブとライトマップは、ライトベイクしたときの明るさのままです。夜のシーンで明るく浮くときは、それらを外すか、夜向けにライトベイクし直してください。建物の中に空の光を入れるには、次の節の方法を使います。

建物の中の空の光（VRC Light Volumes）

ライトマップに空の光をライトベイクすると、時刻を変えても室内はライトベイクしたときの明るさのままです。VRC Light Volumesを入れたワールドでは、空の光だけをAdditiveのLight Volumeにライトベイクすると、Clearwater Skyがその色と強さを時刻に合わせて変えられます。窓から入る空の光が、昼は白く、夕方は橙に、夜は月明かりになります。

  1. 建物を覆うLight Volumeを置き、Additiveにします。部屋の中だけを覆うものをもう1つ重ねると、室内だけを明るくできます（下のSky Light Gains）
  2. 空の光だけでライトベイクします。BakeryならSkylightを白・強さ1・Hemispherical（上半分だけ）にし、ほかの光源はすべて切ります。地面からの照り返しが欲しいときは、ライトベイクする間だけ砂や海の色の板を置きます
  3. そのLight VolumeのBakeを切り（ライトベイクした空の光が残ります）、ライトマップと残りのLight Volumeを、照明など時刻によらない光だけでライトベイクし直します
  4. SunのClearwater SkyのSky Light Volumesに、そのLight Volume（LightVolumeInstance）を入れます
項目内容
Sky Light Volumes空の光だけでライトベイクしたAdditiveのLight Volume
Sky Light GainsLight Volumeごとの倍率（同じ順。なければ1）。室内では目が屋外よりずっと暗い光に慣れるので、部屋の中だけを覆うLight Volumeを3〜4倍にすると、測った明るさではなく見た目の明るさになります
Sky Light Horizon入る光のうち、地平線の近く（窓・軒の下）から来る割合（初期値0.6）。残りは空の高い所から
Sun Bounce地面や床が返す日差しの割合（水平な地面に当たる日差しに対して。初期値0.15）。日の差し込む部屋が、その照り返しで明るくなります
Sky Reflection Probes / Sky Probe Gain空の光だけでライトベイクしたリフレクションプローブ（Custom）と、その強さの倍率。強さが空の光に合わせて変わります。照明だけでライトベイクした同じ範囲のプローブと対にすると、Unityが2つを半分ずつ混ぜるので、映り込みも光と同じく足し合わされます（そのときは、どちらも強さを2倍に）
Lamp Light Volumes / Lamp Night Gain照明だけでライトベイクしたAdditiveのLight Volumeと、夜に足す量（初期値2）。夜が深まるほど強くなり、昼は0です。夜の室内では目が灯りに慣れるので、ライトマップの照明がその分だけ明るく見えます
  • 日差しそのもの（窓から差し込む光と影）は、太陽のDirectional Lightがリアルタイムで描きます
  • 屋内のライトプローブは使わないでください。ライトベイクしたプローブがあると、屋外のアバターまでそのプローブで照らされ、時刻の環境光が届きません。屋内のアバターはLight Volumeが照らします
  • 建物のマテリアルのシェーダーがAdditiveのLight Volumeをライトマップの上に足せる必要があります（FilamentedはVRC Light Volumesをオン。Mochie Standardは初期設定のままで足します）
  • Sky Light Volumesの箱（最初の4つ）を、浜と水は建物として扱います。箱の中の浜と水にはAdditiveのLight Volumeを足しません（空の光は浜がもう受けているので、二重になって箱の形に明るくなるため）。箱の中にあるPoint Light Volume（室内のダウンライトなど）は、どこの浜と水も照らしません（Light Volumeの光は壁で遮られないので、壁を抜けて外の砂に漏れるため）

できないこと

  • 月はいつも満月で、太陽のちょうど反対側にあります。満ち欠けと月食はありません
  • 雲の量は時刻で変わりません（SkyマテリアルのCloudsのまま）
  • 星座は実際の星空ではありません。数と明るさの分布だけを本物に合わせています

トーンマッピング（ポストプロセス / シェーダー内）

トーンマッピングは、明るすぎる色を画面に出せる範囲へ丸める処理です。Clearwaterには2つの方式があります。

  • ポストプロセス（PPv2、初期値）：画面全体をまとめてPost Processing Stack v2でトーンマップします。シーン全体が同じトーンカーブになり、ブルームで太陽や水面のギラつきがにじみます。水が画面から拾う物（自分の地形、水の中のアバター）も、描かれたままの明るさで使えます。一方で、アバターにもトーンマップがかかり、色が少しくすんで暗めになります。Questではポストプロセスが使えません
  • シェーダー内：水・Seabed・空・水中フォグの各シェーダーが、自分の出力をトーンマップします。ワールドにポストプロセスは要らず、アバターの見た目も変わりません。ただし、水が画面から拾った色は、トーンカーブを逆にたどって元の明るさに戻して使います。そのため、トーンマップされていない物の白に近い色（日の当たるStandardの地面など）は、何倍にも明るくなります。プールのタイルや岸壁のような明るい地形が、水越しに白く飛んで見えます

Build Scene・Add to Current Scene・デモシーンは、ポストプロセスにします（Post Processingパッケージがないプロジェクトではシェーダー内）。Tools > Clearwater > Tone Mapping > In Shadersでシェーダー内に、In Post-processing (PPv2, default)でポストプロセスに切り替えます。ポストプロセスにすると、ClearwaterのマテリアルのTone map in shaderがオフになります。グローバルなPost-process Volumeは「PostProcessing」レイヤーに追加されます。このレイヤーがなければ、空いているユーザーレイヤーを「PostProcessing」にします。ワールドのReference CameraにはPost-process Layerが付きます。

プロファイルはAssets/Clearwater/Generated/ClearwaterPost.assetで、中身はシェーダーと同じトーンカーブを書き込んだLUT（ClearwaterToneLut.asset、Color GradingのExternalモード）と、弱いブルーム（強さ0.15、しきい値2。太陽やそのきらめきのような本当に明るい所だけがうっすらにじみます）です。色は、シェーダー内でトーンマップしたときと比べて平均1/255以下の差に収まります。

  • 明るさはプロファイルのPost-exposureで、ブルームもプロファイルで調整できます。切り替え直してもプロファイルは上書きしません
  • マテリアルのExposureを変えたときは、もう一度In Post-processingを選ぶとLUTが作り直されます

PPv2に内蔵のACESは使っていません。明るい所の丸め方が違い、水中から太陽を見ると白い範囲が大きく広がるためです。

水面すれすれのカメラ

カメラ（頭・画面・写真カメラ）が水面から60cm以内にあるときは、画素ごとに水の上か下かを決めます。レンズが水面をまたぐと、画面の上側は水上、下側は水中（フォグ付き）に分かれて写ります。この間は水面・水中の処理が少し増えます。

水に入ったアバターの半透明な部分

水面は、ほかの半透明の物より先に描かれ、深度を書き込みません。そのため、アバターの半透明の服や髪は、どのレンダーキューでも水に隠れません。服が水中で消えて体が見える、という透けは起きません。

見え方はレンダーキューで変わります。

アバターのマテリアル水中の部分の見え方
2500以下（lilToonの半透明の既定値2460など）水の色を帯び、屈折して見える
2501以上（3000など）水の色を帯びず、水の上にあるように見える

水中から見ると、3050以下は水中のフォグで霞み、3051以上は霞まずに見えます。ワールドに置く半透明の物（泡のパーティクルなど）も同じ扱いです。水面より後に描かれるので、水中にあっても水の上に重なって見えます。

VRC Light Volumes

VRC Light Volumes（RED_SIM）を入れたワールドでは、AdditiveにしたLight VolumeとPoint Light Volumeの光が、浜・水底・泡にも当たります。水面には、その光の照り返しが映ります。アバターを照らすのと同じ光なので、夜の浜に置いたランプや焚き火は、そばのアバターと砂を同じように照らします。

夜の浜。砂の上のランプが砂を、浅瀬の上のランプが水の中の底と水面を照らし、水の中の青いランプと色の変わるランプが光っている

VRChatではClearwater VRCLV demoで試せます。下の「デモで試す」のデモを公開したワールドです。

  • Light Volumesのパッケージがなくても動きます。シェーダーが読む部分（LightVolumes.cginc、MIT）を同梱しているためです。Light Volumeのないワールドでは、見た目も負荷も変わりません
  • Light Volumes 2.xと3.0（3.0.0-dev.20で確認）のどちらでも動きます。3.0でも、Clearwaterは2.xの読み方（3.0も出し続けている）で光を読みます。そのため、3.0で増えた模様を持つ光（クッキーや動画の画面）は、その平均の色で当たります
  • 読むのは、AdditiveのLight VolumeとPoint Light Volumeだけです。AdditiveでないLight Volumeにはライトベイクしたときの時刻の明るさが入っていて、時刻の空と合わないため読みません（夜に、砂だけが昼の明るさで浮きます）。時刻によらない光（ランプ・焚き火・建物の灯り）は、AdditiveかPoint Light Volumeで置いてください
  • 水の中の底に届く光は、空の光と同じだけ水に弱められます。水の中に置いた光も同じ扱いです
  • 自分の地形（Terrain source: User）は、そのマテリアルのシェーダーがLight Volumesに対応していれば照らされます。Clearwaterが重ねる濡れと泡のうち、泡には光が当たります

デモで試す

Light Volumesを入れたプロジェクトでは、Build Demo Scenes（「デモシーンで試す」）が、上の画像のデモ「Demo_LightVolumes」も作ります。Tools > Clearwater > Demo Scenes > Open Light Volumes (VRC Light Volumes)で開けます。夜21時の浜に、Point Light Volumeで次の光を置いています。

光見どころ
砂の上のランプ（暖色）砂と、打ち上げた泡が照らされる
浅瀬の上のランプ（暖色）水の中の底が照らされ、水面に照り返しの道ができる
水の中のランプ2つ（青。浅い所と水深1.6m）水の中から底を照らす。水の上からも、水の中からも見える
浜を照らすスポット上から下に向けたスポットライトの光の輪
動くランプ水際をまたぐ半径4mの円を24秒で回り、色と明るさを変え続ける。砂・泡・水の中の底の光が付いていき、深い所では水面の下に潜る（ClearwaterDemoLamp。速さや範囲はInspectorで変えられます）

どのランプにも、場所が分かるように小さな光る球を付けています。時刻は空のパネル（Tabキーか左手のトリガー2回）で変えられるので、昼と夜で見比べることもできます。

負荷の目安

パッケージ1.0.0をRTX 4070 Ti SUPERで測った値です。Unityエディターで、VRの片目に近い2048×2048・視野90°に同じ視点を繰り返し描き、GPUの完了を待って測りました（Unityのウィンドウは最前面）。シーンはBuild Sceneのもの（16時、雲30%）で、ポストプロセスは含みません。VRの両目では、ほぼこの2倍になります。

視点負荷（片目）
浅瀬で足元を見る約5.7ms
水上から沖を見下ろす（水が画面いっぱい）約4.8ms
浜から沖を見る約2.8ms
水中から水面を見上げる約2.6ms

次の条件では、上の値に加えて負荷が増えます。どれも、その条件だけを入れた場合と切った場合を交互に測った差です。

条件増える負荷（片目）
プールの水が画面の大半を占める（水を描かない場合と比べて。画面に映っていないプールは負荷なし）+1.3〜1.7ms
Foam reliefを2cmにして、波打ち際を近くで見る+0.45〜0.9ms（その時の泡の量による）
トーンマッピングをポストプロセスで（シェーダー内と比べて。ブルーム込み）+0.35〜0.5ms
雲（Coverが0より大きいとき。パッケージ1.3.0で測定。雲のドームを描き直す分で、画面の大きさや両目によらず1フレームに1回）+0.4ms
時刻の空（Clearwater Sky。時刻のない空と比べて）昼に空を見上げて+0.1ms、夜空を見上げて+0.15ms
太陽の影（影を描く分と、浜と水底がそれを読む分。水が奥行き情報を使うので切れません）+0.1〜0.15ms
自分の地形（Projectorの分）+0.15ms以下
スタンプがある+0.05ms以下
VRC Light VolumesのPoint Light Volume 2つの近くを見る（Light Volumeのないワールドでは増えません）+0.1〜0.4ms

波音を作り直す

Tools~/（Unityには読み込まれないフォルダ）に、波音の加工手順があります。ffmpegが必要です。

  • Tools~/make_wave_audio.sh <元の録音.flac>：元録音から3種類のループ（Runtime/Audio/*.ogg）を作る
  • node Tools~/detect_wave_breaks.js：波打ち際の音から波が砕ける瞬間を探し、波の時刻表（Runtime/Audio/WavesShore_breaks.json）を作る。波音を差し替えたら必ず実行する

ライセンス

MIT License（LICENSE、© 2026 bmbb93 (vbamboo)）。水の表現はclearwater by Aureliengmz（MIT、© Lumaris、Third Party Notices.md）を移植したものです。VRC Light Volumesのシェーダーの部品（Runtime/Shaders/ThirdParty/LightVolumes.cginc）はRED_SIMによるもので、MIT Licenseです。

クレジット

  • 水の表現：clearwater by Aureliengmz（MIT、© Lumaris）
  • 波音：Freesound「Stromboli beach」nicola_ariutti（CC0）
  • VRC Light Volumesの光を読む部分：VRC Light Volumes by RED_SIM（MIT）
  • 底のテクスチャ：どちらも計算で作ったもので、写真は使っていません（小石は移植元のtools/make_pebbles.py、砂はTools~/make_sand.py）

パッケージ名

com.vbamboo.clearwater

ドキュメント

https://github.com/bmbb93/clearwater-vrc#readme

リポジトリ

バージョン

1.3.1 (変更履歴)

Unityバージョン

2022.3 以降

依存関係

なし

VPM依存関係

旧パッケージ

なし

ライセンス

MIT

作者

bmbb93 (vbamboo)

リポジトリ内のパッケージJSON

{
  "name": "com.vbamboo.clearwater",
  "displayName": "Clearwater VRC",
  "version": "1.3.1",
  "unity": "2022.3",
  "description": "Photoreal shallow water and coasts for VRChat worlds: draw the waterline, bake, and walk into clear water with caustics, shore waves in time with the surf, and an underwater view. A port of clearwater by Aureliengmz (MIT, (c) Lumaris).",
  "author": {
    "name": "bmbb93 (vbamboo)",
    "url": "https://github.com/bmbb93"
  },
  "documentationUrl": "https://github.com/bmbb93/clearwater-vrc#readme",
  "changelogUrl": "https://github.com/bmbb93/clearwater-vrc/blob/main/CHANGELOG.md",
  "licensesUrl": "https://github.com/bmbb93/clearwater-vrc/blob/main/LICENSE",
  "license": "MIT",
  "vpmDependencies": {
    "com.vrchat.worlds": ">=3.10.0"
  },
  "legacyFolders": {},
  "legacyFiles": {},
  "url": "https://github.com/bmbb93/clearwater-vrc/releases/download/v1.3.1/com.vbamboo.clearwater-1.3.1.zip",
  "zipSHA256": "014bbb36958bb235fd332e89bd26bf8ae9261607113767b6d81d172a0b2773dc"
}