仕組み
ドキュメントバージョン: 0.7.2
Grid と圧縮
Zone は terrain を量子化 signed-distance field として sample します。1 sample は 1 byte で、128 が surface、より小さい値が solid、より大きい値が air です。Grid と paint は run-length compression され、通常は raw size の約 2–5% になります。
VRChat runtime は chunk ごとの compressed data と offset を保持し、edit が届いた chunk だけ (chunkCells + 2)³ sample を decode します。Reset は decoded chunk を捨てて Bake mesh を戻すだけなので即時です。
Edit と mesh
1 edit は position、radius、operation、layer を 1 つの long に pack します。Dig/Add/Paint は idempotent です。DigBrush が sample を変更し、dirty chunk を SurfaceNets が mesh 化します。Chunk は隣接 sample を 1 voxel border として持つため seam が一致します。
Surface がある chunk だけ GameObject、mesh、collider を持ちます。Runtime で surface が新しくできると Chunk Template を複製します。
Shading と lighting
Standard shader は terrain の splat/normal を最大 16 layer、DigTerrain Lite は Quest 向けに最大 8 layer shading します。Paint slot は chunk ごとに最大 4 terrain layer と dug soil です。
Baked Lighting が有効なら chunk は lightmap UV と static flag を持ちます。Runtime で remesh された chunk は light probe に切り替わり、Reset で元の lightmap index と scale/offset を復元します。
木と detail
DigFoliageBaker は terrain hole 内の木を DigZoneData に移し、detail instance を chunk column ごとの mesh にまとめます。各 instance は surface anchor を持ちます。Runtime が anchor 周辺の signed-distance field を調べ、surface が掘られた、または埋められた場合は木を無効化し、RGBA foliage mask 経由で detail を隠します。Reset で Bake 時の mask と object state を復元します。
Network
Smoothing 以外の edit を local prediction し、owner が sequence number を付けて broadcast します。各 client は順序どおり適用し、早く届いた edit を buffer します。Late joiner には owner が full log を Manual sync し、time-sliced replay します。Reset は新しい epoch を開始して log を clear します。
0.7.0 の runtime operation
Tool mode と packed operation code は別です。
| 動作 | Tool mode | DigFormat op | Layer bits |
|---|---|---|---|
| Dig | 0 | OpDig = 0 | — |
| Add | 1 | OpAdd = 1 | Soil paint value |
| Paint | 2 | OpPaint = 3 | Paint value |
| Tree | 3 | OpTree = 4 | Prefab index + 1、0 は削除 |
| Detail | 4 | OpDetail = 5 | Prefab index + 1、0 は削除 |
| Smooth | 5 | OpSmooth = 2 | 1/31 単位の強度 |
Tree/detail の削除は球内の配置 object と同種の Bake 済み foliage を除去します。Bake foliage は remesh 後も非表示で、reset すると戻ります。Dig/add は brush 内の配置 object を除去します。Prefab 配列は全 client で一致させます。maxSpawned は配置数の上限(既定 2048)で、超える配置は無視されます。
Smoothing は 冪等ではありません。Log 順で一度だけ適用してください。DigSync は非 owner の smoothing を local prediction せず、owner から戻った時に表示します。Udon は共有 chunk border の sample を一致させます。Dig/Add/Paint の重複適用特性を smoothing に当てはめないでください。