かおもラボ【無料】CSEmulator V2（ClusterScriptをUnity上で再生できるようにするやつ）
- 無料版(ver2.30)ダウンロード商品¥ 0
- かおもにヨーグルトと牛乳を買ってあげる（内容は無料版と同じ）ダウンロード商品¥ 300
- 旧版ダウンロード商品¥ 0
今(CCK2.11.0)のところ、ClusterScript(https://docs.cluster.mu/script/modules.html) は、Unity上で再生できません。 これを再生できるようにした非公式のUnityアセットです。 CCK2.11.0(いわゆるベータ機能)に対応。 UniVRM v0.61.1必須。 Post Processing 2.3.0必須(以上でもたぶん動く) コンポーネントとか本当にめちゃくちゃ色々いじるので、 導入は自己責任でお願いします…。 旧版(V1)はこちら https://vkao.booth.pm/items/4769516
使い方
・★UniVRM v0.61.1が必要です★(cluster推奨バージョン) https://github.com/vrm-c/UniVRM/releases/tag/v0.61.1 よりunitypackageをダウンロードしてインポートしてください。 ・★PostProcessing 2.3.0が必要です★(cluster推奨バージョン) https://creator.cluster.mu/2020/04/01/howto-postprocessing/ を参考にインストールして下さい。 (2.3.0以上でも動くようです) ・CSEmulator1xx系をお使いの方はまずアンインストールしてください。 方法は商品画像を参照してください。 ・ダウンロードしたzipファイルを展開します。 ・「KaomoLabCSEmulator230.unitypackage」をプロジェクトにインポートします。 ・再生ボタンを押すとClusterScriptが動きます。 CSEmulator1xx系で使用していた「KaomoLabCSEmulator」は不要です。 ・PlayerHandleの.userIdおよび.userDisplayNameの戻り値は、設定画面にて指定が可能です。 ・$.createItemで生成したい場合は、 プレハブの「Item」が付いているGameObjectに、「CSEmulatorPrefabItem」コンポーネントを追加します。 UUIDには$.createItemで指定するIDを指定してください。 （商品画像みたいにしてください） ・PlayerHandle系の動作はシーンビューの方で見てください。(三人称視点がないので)
よくある質問
・PlayerHandle系やプレイヤーの物理挙動系の動作確認は参考程度でお願いします。 ・(2.14より)ClusterScriptErrorの各種フラグが設定されずにthrowされます。対応方法を調査中です。 ・Itemの物理挙動がcluster上のそれと異なる。 詳細調査中です。cluster上の方が抵抗が少ない？ ・$.getOverlapsでプレイヤーが範囲内にいる時に取得できるHandleの数が違う。 よく分からないけどclusterの方が多い。 ・ApiAudioのvolumeを1以上にしても音を大きくできません。 v1より対応できていません。 ・CharacterItemをsetPositionで動かした場合、接地していないと、重力表現の影響で下方向に振動する。 プレビュー再生の時に振動します。cluster上では振動しないようです。 ・LayerをVenueLayer0などにしたら色々動かなくなった。 CCKのプレビューの矢印アバターのレイヤーは「24:Audience」です。「16:OwnAvatar」などとはCollision Matirxの設定が違うので確認してみてください。 ・「You are trying to create a MonoBehaviour using the 'new' keyword.」 っていうWarningが出る。 中で行ってるあれこれの影響です。 動作自体には影響ない（はず）です。 ・onUseとかonInteractが動かなくなった。 追加した覚えのない「UseItemTrigger」や「InteractItemTrigger」があったら削除してください。 上記の処理を拾うために、内部で「UseItemTrigger」や「InteractItemTrigger」を追加しています。 再生終了時にそれらが削除されずに残っていることがあるかもしれません。 残っていた場合は処理が競合し、onUseとonInteractは動かなくなります（これ自体はClusterScriptの仕様です、たぶん）。 バグとか何かありましたら、X(twitter)かclusterの方で連絡ください。
更新履歴
2024.04.23 v2.30 ・トップレベルに記述できない処理に対してwarningを出す機能を追加。 2024.04.19 v2.28 v2.29 ・v2.27に生じていたDefaultレイヤーとの複数衝突とプレイヤーのジャンプ時の問題に対応。 2024.04.18 v2.27 ・ItemHandle.sendのargにundefinedを指定した時、メッセージを送らない挙動に対応。 ・プレビューのプレイヤー関連 ・OwnAvatarレイヤーのコライダーを追加。 ・カプセルコライダーのサイズの変更機能を追加。 2024.04.05 v2.26 ・WorldRuntimeSetting(動く床に追従する挙動)に対応。 2024.03.28 v2.25 ・PlayerHandle.setHumanoidPoseに対応。 2024.03.26 v2.24 ・PlayerHandle.setHumanoidPoseの引数の追加のみに対応。実装は未対応。 2024.03.20 v2.23 ・CCK2.9.0のFogSettingsの挙動変更に対応。 2024.03.19 v2.22 ・$.materialを追加。 2024.03.16 v2.21 ▼PlayerHandle.setPostProcessEffects ・初期状態で主にDepthOfFieldが掛かってしまっていた問題に対応。 ・回数制限と距離制限に対応。 2024.02.29 v2.19 v2.20 ・PlayerHandle.setPostProcessEffectsを追加。 2024.02.06 v2.18 ・PlayerHandle.idfcを追加。 ・$.getPlayersNearで同一プレイヤーが複数含まれないように変更。 2024.01.31 v2.17 ・$.computeSendableSizeを追加。 ・ItemHandle.sendのサイズ制限(ソフトリミット)に対応。 ・$.callExternalの制限で毎秒100回を選べるように変更。 2024.01.16 v2.16 ・$.onStartを追加。 ※クラフトアイテム及びワークラワールドでのonStartの挙動には対応していません…！ 2024.01.12 v2.15 ・$.itemTemplateIdが$.Item…となっていた問題に対応。 ・$とPlayerHandleのJSON.stringifyで欠けていた値を追加。 ・playerがワープした後でも$.getOverlapsに判定が残る問題に対応。 2023.12.24 v2.14 ・callExternalに回数制限(切替可)と文字数制限を追加。 ・PlayerHandleのメタ情報系にデフォルト値を追加。 ・instanceofでClusterScriptErrorを判定できない問題に対応。 ・FPS制限がonUpdateに対して有効でない問題に対応。 2023.12.20 v2.13 ・インポート後にエラーが出て再生できなくなる問題に対応。 2023.12.20 v2.12 ・外部通信機能に対応。 ・各種メタ情報の取得に対応。 ・プレビュー終了時にエラーが出る問題に対応。 ・$.stateから得られる値が浅いコピーだった問題に対応。 2023.12.06 v2.11 ・TextInput系の関数を実装。 ・SubNodeのsetText系の関数を実装。 ※上記関数にある各種制限は未対応です。 2023.10.25 v2.10 ・左Shiftでダッシュ、左Altで歩けるようになりました。 ・$.getItemsNearで自身が取得できてしまう場合がある問題に対応。 2023.10.15 v2.09 ・CSEmulatorPrefabItemにItemTemplateIdを入力していた場合、静的配置でも$.destroyできるように変更。 ・一部クラスをJSON.stringifyした時にエラーが発生する問題に対応。 ・$.createItemが制限されていない問題に対応。 2023.10.12 v2.08 ・RigidbodyのないItemが$.onCollideを検出できていた問題に対応。 ・$.onCollideでプレイヤーが取得できない問題に対応。 ・$.onCollideでSubNodeへの衝突が正しく取れない問題に対応。 ・$.getOverlapsの対象が$.destroyした場合などにエラーが発生する問題に対応。 ・非アクティブなSubNodeが$.getOverlapsの判定に残る問題に対応。 ・$.raycast系でPlayerHandleが取得できない問題に対応。 2023.10.09 v2.07 ・onUpdate中に$.destroyするとエラーが発生する問題に対応。 ・$.destroyされたitemのメッセージをonReceiveで受けるとエラーが発生する問題に対応。 ・ItemHandle.sendが他の操作と回数制限を共有している問題に対応。 ・ClusterScriptErrorでstackを取得できない問題に対応。 ・$.stateに対応していない値を入れた場合の挙動を修正。 2023.10.03 v2.06 ・★v2.04発生★HumanoidPose.centerXxxxが正しく反映されない問題に対応。 ・VRMモデルのn人称視点やGrab時の向きに対応。 ＞これによりPlayerHandle.getRotationが正しくなります。 ＞CSEmulatorのWindowにて視点の切り替えができます（VRMモデルの動きのみに対応。実際の視点には未対応） 2023.10.01 v2.05 ・★v2.04で発生★PlayerHandle.setHumanoidPose(null)が動かなかった問題に対応。 ・Vector3.crossが動かなかった問題に対応。 ・一部のエラーでスタックトレースが出るようになりました。 2023.09.29 v2.04 ・$.getOverlapsのSubNode判定あたりで色々あった問題に対応。 ・VRMモデルが手を上げられるようになりました＆走ります。 ・$.addImpulsiveForceAtを追加。 2023.09.26 v2.03 ・PlayerHandleのsetGravityが正常に動作しない問題に対応。 ＞onInteractでsetGravityをして、そのitemを連打するなどで発生。 ・ItemHandleとPlayerHandleの実行回数を制限する機能に対応。 ・デバッグモード追加。$.logに情報が追加されます。 [シーン上のフルパス][プログラム上の位置(行位置.文字位置)]メッセージ 2023.09.24 v2.02 ・ItemHandleとPlayerHandleにある距離の実行制限に対応。 ・初期ポーズをT-Poseから腕を下におろしたポーズに変更。 2023.09.23 v2.01 ・PlayerHandle.addVelocityに対応（ジャンプ台で使うあれです）。 ・複雑なオブジェクトを単体で$.logした時にいい感じの表示になるように変更。 ・$.getItemsNearで子のみにShapeがある時などに取得できない問題に対応。 ・ItemHandle.sendでItemHandleを送った場合に発生する問題に対応。 2023.09.22 v2.00 ・公開。
やりたいことリスト
・ClusterScript Log Consoleに対応させる。 ・ダミーのプレイヤーをスポーンさせる。 ・三人称視点。 ・両手持ち。 ・ブレークポイント
利用規約
改変可です。 （バグとかあったらできるだけ直したいので、教えてほしいです！） そのものの再配布は禁止です。 特定個人・団体への誹謗中傷や、政治・宗教活動、公序良俗に反する利用は禁止です。
免責事項
本データを使用し発生した損害・損失等につきまして、当方（かおも）は責任を負わないものとします。
連絡先
▼X(Twitter) https://twitter.com/vkaotech ▼cluster https://cluster.mu/u/vkao ▼販売ページ https://vkao.booth.pm/
