無料・Free お皿やカップがテーブルに沈む・浮くを補正するやつ。KissatenTools Surface Lift v2.0.0|VRChat用 Pickup設置補正ツール
- 無料 中身一緒ダウンロード商品¥ 0
- ありがとう 中身一緒ダウンロード商品¥ 300
- ほんまありがとう 中身一緒ダウンロード商品¥ 500
- めっちゃありがとう 中身一緒ダウンロード商品¥ 1,000



v2.0.0 アップデートのお知らせ Surface Liftをv2.0.0にアップデートしました。 これまでの「テーブルに沈んだアイテムを持ち上げる」機能に加えて、テーブルから浮いてしまうアイテムを下げる補正にも対応しました。 さらに、旧版でうまく補正できなかった一部のギミックへの対応を改善しています。 v2.0.0の主な変更点 ・沈み込みと浮き上がりの双方向補正に対応 ・初期非表示Meshを含む形状校正 ・VRCPickupの自動検索と一括登録 ・v1.0.1-rc1からの一括アップグレードに対応 ・旧版・新版のCorrectorをまとめて解除できる完全Rollback ・日本語の「かんたんセットアップ」を搭載 旧版を利用している方も、既存のギミックを1つずつ手作業で再登録する必要はありません。 ※すべてのギミックに対応するものではありません。特殊な構造や独自の制御を持つギミックでは、正常に補正できない場合があります。 ━━━━━━━━━━━━━━━━━━━━ ■ Surface Liftとは? ━━━━━━━━━━━━━━━━━━━━ VRChatワールド内で、アイテムを置いたときに傾いたり、テーブルに埋まったりする問題を軽減するための設置補正ツールです。 コーヒーカップ、食器、ボトル、小物など、VRCPickupを使用したアイテムを対象に、手を離した際の姿勢や設置位置を補正します。 大量のPickupアイテムを扱うワールドでも、1個ずつ設定する必要はありません。 対象を指定してまとめて導入できる「一括登録機能」を搭載しています。 こんな動きです https://x.com/kissaten/status/2102743900448510428?s=20 https://x.com/kissaten/status/2102793449548427266?s=20 実際の導入方法 https://youtu.be/tlXQSdbg8MM?si=H8Ap5fOTNfTlDkzO ※この動画はv1.0.1-rc1の操作例です。v2.0.0では「Tools → KissatenTools → Surface Lift → かんたんセットアップ」を使用してください。 ココで試せます @kissaten - RELAX TALK STAY - VRChat https://vrchat.com/home/world/wrld_90bdd0bd-9911-456a-90ed-3e50fe5673c4/info
主な機能
〖1. Pickupの自動設置補正〗 VRChatワールド内でアイテムを手放した際に、姿勢と設置面との位置関係を自動的に補正します。 ・傾いたPickupの起き上がり補正 ・テーブルや床への沈み込みを軽減 ・テーブルから浮いたアイテムを下方向に補正(v2.0.0) ・アイテムのMesh形状を基準にした高さ調整 ・Raycastによる設置面の検出 ・複数地点から設置面を判定 ・設置面が見つからない場合は無理に補正しない ・補正量に上限を設け、極端な移動を防止 アイテムを固定座標へ戻すのではなく、現在の位置と設置面を基準に高さを調整します。 初期設定では、最大35cmの持ち上げ、最大10cmの引き下げに対応しています。数値はセットアップ画面から変更できます。 〖2. 一括登録機能(Batch)〗 ワールド内にある複数のVRCPickupを自動検索し、Surface Liftをまとめて導入できます。 ・現在のScene全体を検索 ・指定した親オブジェクトの子階層を検索 ・VRCPickupを持つアイテムを自動抽出 ・未登録アイテムへの一括追加 ・旧版・新版の登録状況を識別 ・重複登録を防止 ・条件に合わないアイテムは安全にスキップ ・登録対象から除外するアイテムを指定可能 大量の食器や小物が置かれたワールドでも、1個ずつコンポーネントを追加する必要はありません。 〖3. 事前診断機能(READ ONLY AUDIT)〗 登録前に、対象アイテムと現在の導入状況を確認できます。 ・VRCPickupの検索 ・旧版Surface Liftの検出 ・新版Surface Liftの検出 ・未登録アイテムの確認 ・Mesh形状の取得可否の確認 ・登録対象外の判定 ・既知の他方式補正との競合検出 ・登録できない理由の表示 「対象を確認」だけでは、Scene内の補正コンポーネントを変更しません。 〖4. お試し導入機能(Pilot)〗 すべてのアイテムに登録する前に、1個だけ試験導入できます。 ・特定のPickupを選択 ・対象未指定なら未登録候補から1個を選択 ・1個だけSurface Liftを登録 ・Build & Testで動作確認 ・問題がなければ残りを一括登録 複雑なギミックへの導入前に、補正との相性を確認できます。 〖5. 設置面と除外対象の設定〗 Surface Liftが補正の基準とする設置面を指定できます。 ・設置面のLayer指定 ・設置面として扱わない親オブジェクトを登録 ・指定した親以下のColliderを判定対象から除外 ・アイテム自身のColliderを除外 ・他のVRCPickupのColliderを設置面として扱わない ・設置面の角度を考慮した判定 ・持ち上げと引き下げの上限を個別に設定 アイテム自身や周辺のギミックを設置面として誤認する問題を軽減します。 ※「登録しない対象」の除外設定は、新規登録時に適用されます。旧版からの一括アップグレードでは、登録済みのCorrectorが更新対象になります。 〖6. 非表示Meshを含む形状校正〗 複数のMeshや表示切替を持つアイテムにも対応できるよう、Editor上で形状データを取得します。 ・MeshFilterとMeshRendererの形状情報を取得 ・SkinnedMeshRendererの形状情報を取得 ・初期非表示Meshを含めた校正 ・Meshの頂点情報を利用した形状計算 ・頂点を読み取れない場合のBoundsによる代替計算 ・実行時には表示中のRendererから現在のBoundsを取得 ・表示中の有効なRendererがない場合は校正値を使用 形状を取得できないアイテムには、無理に補正を追加せずスキップします。 ※すべての表示切替や動的形状変更に対応するものではありません。 〖7. 旧版からの一括アップグレード〗 v1.0.1-rc1を導入しているワールドにも対応します。 ・旧版Correctorを自動検出 ・旧版と新版の登録状況を確認 ・既存Correctorを新版へ置き換え ・新版の形状校正を実施 ・複数の登録済みアイテムを一括再登録 ・元のギミック本体は変更しない ・すでにv2を登録した対象の再登録にも対応 既存のアイテムを1個ずつ手動で設定し直す必要はありません。 ※旧版のセットアップ画面に保存した除外リストなどは自動移行されません。必要な設定は新版のセットアップ画面で再確認してください。 〖8. 完全Rollback機能〗 Surface Liftの補正を解除し、導入前のコンポーネント構成へ戻すための機能です。 ・旧版Correctorを検出して削除 ・新版Correctorを検出して削除 ・旧版・新版が混在していても一括解除 ・Scene全体を対象に解除 ・登録時の除外対象も解除対象に含める ・元のVRCPickup、Rigidbody、Collider、Transformなどは維持 ・変更前にSceneバックアップを自動作成 ・UnityのUndoにも対応 元のギミックのスクリプトを書き換えることなく、Surface Liftの補正を解除できます。 ※RollbackはSurface Liftが追加した補正コンポーネントを解除する機能です。ほかのギミックによる変更や、実行中に発生した状態変化まで復元するものではありません。 〖9. Walkthroughレイヤーへの対応〗 VRChat標準のWalkthroughレイヤー(Layer 17)を設置面として利用できます。 ・プレイヤーが通り抜けられるColliderを設置面として検出 ・Walkthroughに設定されたテーブル天板への設置補正 ・カウンター、テーブル、作業台などへの導入 ・設置面に使用するLayerの変更が可能 プレイヤーの移動を妨げないカウンターテーブルでも、カップなどを置く際の設置位置を補正できます。 ※設置面には適切なColliderとLayerの設定が必要です。
処理負荷について
Surface Liftは、Pickupを手放したタイミングを中心に処理を実行します。 ・待機中に無条件で毎フレームRaycastを実行しない ・ドロップ後に姿勢と設置高さを判定 ・数フレーム後の再確認に対応 ・設置面が見つからない場合は補正を中止 実際の負荷は登録数、Collider構成、操作頻度などによって異なります。
導入方法
Surface Liftは、Unity Editor上でVRCPickupを自動検索し、複数のアイテムへまとめて設置補正を追加するツールです。 UnityやUdonSharpのスクリプトを直接編集する必要はありません。 〖事前準備〗 以下の環境が必要です。 ・VRChat Worlds SDK ・UdonSharp ・Unity 2022.3.22f1(動作確認環境) ・設置面に使用するCollider 作業前にSceneのバックアップを取ることをおすすめします。 〖1. Unitypackageを導入〗 1. ダウンロードしたZIPファイルを展開します。 2. KissatenTools_SurfaceLift_v2.0.0.unitypackage をUnityへImportします。 3. Unityのコンパイルが完了するまで待ちます。 4. Consoleにエラーが発生していないか確認します。 〖2. セットアップ画面を開く〗 Unity上部メニューから次を選択します。 Tools > KissatenTools > Surface Lift > かんたんセットアップ 専用の日本語セットアップ画面が開きます。 〖3. 設置面と対象を設定〗 基本設定は以下を目安にしてください。 ・対象の親:空欄なら現在のScene全体 ・Surface Layer:Walkthrough ・最大持ち上げ:0.35m ・最大引き下げ:0.10m ・Clearance(設置面との隙間):0.002m ・初期非表示Meshの校正:有効 必要に応じて、対象から除外するPickupや、設置面として認識させたくないColliderを設定できます。 〖4. 対象を確認〗 「1. 対象を確認(変更しない)」を押します。 対象となるVRCPickupの数、導入済みの旧版・新版Corrector、登録できないアイテムなどを確認します。 この操作ではCorrectorの追加や削除は行いません。 〖5. Surface Liftを登録〗 新規導入の場合は、 「3. 新規対象をまとめて登録」 を押します。 VRCPickupを自動検索し、対象アイテムにSurface Liftをまとめて追加します。 最初はお試し登録(Pilot)で1個の動作を確認してから、一括登録することをおすすめします。 すでに登録済みの対象には、重複してCorrectorを追加しない設計です。 〖6. Build & Testで確認〗 VRChat SDKからBuild & Testを実行します。 実際にアイテムをPickupして、テーブルや床などに置いてみてください。 ・アイテムが自然に起き上がるか ・テーブルに沈まないか ・テーブルから浮かないか ・既存ギミックの動作に問題がないか 問題がなければ導入完了です。
v1.0.1-rc1からのアップグレード方法
旧版Surface Liftを導入済みのワールドでも、新版へまとめて更新できます。 〖1. 新版をImport〗 v2.0.0のUnitypackageをImportします。 旧版のCorrectorを手動で1個ずつ削除する必要はありません。 〖2. 旧版の登録状況を確認〗 「かんたんセットアップ」を開き、「1. 対象を確認(変更しない)」を押します。 旧版Correctorが正常に検出されることを確認してください。 〖3. 新版へ一括再登録〗 「2. 旧版をまとめて新版へ更新(再登録)」を押します。 旧版のCorrectorを解除し、対象アイテムへ新版Correctorを登録します。 元のVRCPickupや既存ギミックのスクリプトを直接書き換える必要はありません。 ※旧版のセットアップ画面で設定した除外リストなどは、自動的に引き継がれない場合があります。必要な設定は新版側でも確認してください。 〖4. 動作確認〗 Build & Testで、新版の沈み込み・浮き上がり補正が正常に動作するか確認します。 旧版に未登録だったアイテムにも導入したい場合は「3. 新規対象をまとめて登録」を使用できます。
完全Rollback(元に戻す方法)
Surface Liftの補正が不要になった場合や、想定外の動作が発生した場合は、まとめて解除できます。 〖操作方法〗 1. 「かんたんセットアップ」を開きます。 2. 「完全Rollback:旧版+新版を全解除」を押します。 3. 対象を確認して実行します。 この操作では以下の処理を行います。 ・v1.0.1-rc1のCorrectorを解除 ・v2.0.0のCorrectorを解除 ・旧版と新版が混在している場合も一括解除 ・元のVRCPickup、Rigidbody、Colliderなどは維持 ・変更前のSceneバックアップを作成 RollbackはSurface Liftの補正コンポーネントを解除する機能です。 元のギミックの状態を安全に維持する設計ですが、Surface Lift以外による変更をすべて巻き戻すものではありません。
必要な環境
・Unity(VRChat対応バージョン) ・VRChat Worlds SDK ・UdonSharp ・VRCPickupを利用したワールド用ギミック ・設置面判定に使用するCollider ※VRChatワールド制作用ツールです。アバター向けツールではありません。
設置面の設定について
すべてのVRCPickupやギミックへの対応を保証するものではありません。 ・独自の位置・回転制御を持つギミックでは、競合する場合があります。 ・Mesh構成によっては形状を正しく取得できない場合があります。 ・補正に必要な設置面が見つからない場合は、無理に補正しません。 ・補正できない対象は、可能な範囲で安全にスキップします。 ・大量導入前には1個での動作確認をおすすめします。 ・導入前には必ずプロジェクトまたはSceneのバックアップを取ってください。 不具合が発生した場合は、同梱のトラブルシューティングを確認してください。
内容物
・KissatenTools_SurfaceLift_v2.0.0.unitypackage ・README(はじめに) ・新規導入手順・使い方 ・旧版からのアップグレード手順 ・完全Rollback・復元方法 ・設定項目・対応範囲の説明 ・トラブルシューティング ・利用規約 ・更新履歴(CHANGELOG) ・SHA256チェックサム 配布形式:ZIP バージョン:v2.0.0 ※v1.0.1-rc1からのアップグレードに対応しています。新規導入にも旧版からの更新にも利用できます。
注意事項
・すべてのVRCPickupギミックで正常に動作することを保証するものではありません。 ・製品固有の姿勢制御、装着ギミック、Constraint、Animatorなどと競合する場合があります。 ・既存ギミックの機能やネットワーク同期を新たに追加するツールではありません。 ・設置面のLayerやColliderが正しく設定されている必要があります。 ・特殊な形状や複雑なギミックでは、補正設定の個別調整が必要になることがあります。 ・既存の補正スクリプトすべてを自動検出できるわけではありません。 ・大量導入前には、必ずPilotで動作をご確認ください。 ・本バージョンはrc(リリース候補)版です。
こんな方におすすめ
・ワールド内に多数のPickupを配置している方 ・カップや食器がテーブルに埋まるのを改善したい方 ・アイテムが横倒しになる問題を軽減したい方 ・1個ずつ補正コンポーネントを追加するのが大変な方 ・既存ギミックの機能をできるだけ維持して設置補正を追加したい方
生成AIの使用について
・本ツールは、開発工程の一部に生成AIを使用しています。 ・主にプログラムの作成、修正、改善などにAIを活用しています。 ・AIを利用した開発のため、予期しない不具合や環境による動作の違いが発生する可能性があります。 ・すべての環境での正常動作を保証するものではありません。あらかじめご了承ください。
導入時の注意事項
・すべてのVRCPickupやギミックへの対応を保証するものではありません。 ・独自の位置・回転制御を持つギミックでは、競合する場合があります。 ・Mesh構成によっては形状を正しく取得できない場合があります。 ・補正に必要な設置面が見つからない場合は、無理に補正しません。 ・補正できない対象は、可能な範囲で安全にスキップします。 ・大量導入前には1個での動作確認をおすすめします。 ・導入前には必ずプロジェクトまたはSceneのバックアップを取ってください。 不具合が発生した場合は、同梱のトラブルシューティングを確認してください。



