VRChat ワールド 中文台球俱乐部 Chinese Billiards Club で使われているビリヤード台プレハブです。 友人たちのサポートに感謝します：eijis-pan, RokaOvO, WangQAQ, COCOA GAME キュー：Tempest, catte paling, tarsan, カボ QQ グループ：780855553 元プロジェクト：MS-VRCSA-Billiards ゲームモード モード 説明 チャイニーズエイトボール フルルールとボールリターン付き 15レッドスヌーカー 6レッド / 15レッド選択可 ロシアンビリヤード 大きな球と狭いポケット、任意の球を打て、入れると得点 10ボール 1–10 番、最小番号を先に当て、ポケット指定、WPA ルール選択可 キャロム 0/1/2/3クッションキャロム 9ボール 1–9 番、最小番号を先に当て、9 番を先に入れた方が勝ち ラグ（比球） ブレイク権を決めるショット。双方が 1 球ずつ打ち、反対側のクッションに近い方が勝ち NPC AI 対戦相手 (PracticeManager) ソロ練習モードでは AI 対戦相手と対戦できます。NPC は本格的なビリヤードの意思決定を備えています： ショット戦略（優先度の高い順） 優先度 タイプ 説明 PASS 1 ダイレクトショット 直接ポケットするショット、ポジションプレイ評価付き PASS 2 シングルクッションバンク 的球がクッションに1回当たってポケット PASS 2b ツークッションバンク 的球がクッションに2回当たってポケット PASS 2.5 薄いカット 大きな角度の薄いカット PASS 3 シングルクッションキック 手球がクッションに1回当たって的球にヒット PASS 3b ツークッションキック 手球がクッションに2回当たって的球にヒット — Kボール セーフティ、ポケットルートがないときの守備戦略 技術的特徴 クッション摩擦補正：バンク時にクッション摩擦による跳ね返り角度のずれを考慮し、狙いを自動調整 軌道検証：ショット前に対象球の経路をシミュレートし、ポケットを通過するか検証 経路遮蔽検出：手球→的球、的球→クッション、クッション→ポケットの3区間で球の遮蔽をチェック ファウル予測：インパクト後の手球の軌道を予測し、不意のファウルを回避（手球のポケット、非対象球への接触など） ポジションプレイ評価：ショット後の手球の停止位置を評価し、次のショットに有利な位置を優先 パワー制御：距離と球配置に応じてショットパワーを自動調整、バンク/キック時は最大パワーを制限 繰り返し検出：同じ球・同じポケットが3回以上続くと強制的にセーフティへ ステートマシン IDLE → CALCULATING → CHARGING → DELAYING → SHOOTING → OBSERVING → IDLE 待機 計算中 チャージ中 待機中 ショット中 観察中 テストモード PracticeManager は自動テストモード（testMode）をサポートし、無人で複数ゲームを自動対戦できます： 自動ブレイク、交互ショット、毎ショットの結果を記録 ログは Assets/npc_log.txt に出力 内容：球の位置、狙い方向、カット角、パワー、スピン、軌道検証結果 Editor/NpcLogExporter.cs でログをエクスポート可能 テーブル機能 プレイヤーカスタマイズ (TableHook) キュー外観、球マテリアル、テーブルカラーを選択可能（キューはネットワーク同期、球とテーブルはローカル同期） キューのサイズ、太さ、滑らかさ、色オフセットを調整可能 設定の自動保存・読み込み（VRC PlayerData） Discord / QQ グループ経由で設定のアップロード・ダウンロード スコアシステム (ScoreManagerV4) 対局スコアを自動記録 リーダーボードをバックエンドへアップロード（wangqaq.com、HMAC 認証） 45秒タイマー その他の機能 全自動翻訳システム（VRChat のローカル言語を検出、中/日/英） 専用の名前カラー機能 個人データとリーダーボードの永続化 クッションカラーの切り替え コヨーテ連携対応（敗者が電気ショックを受ける） セットアップ BilliardsModule をレイヤー22に設定し、物理を自分自身とのみ相互作用するように設定（上の MS ボタンで自動設定可） シーン内に TableHook を配置（実行時に自動検出・追加されるので位置調整のみ） image Q84OOB{37Q{XY946MTR$E`F カスタムキュー外観と球マテリアル：TableHook にテクスチャを追加、コード内に予約済みスロットがいくつかあります UdonChips 対応：BilliardsModule 内のボタンをクリック 既製パッケージを使用可；リポジトリをクローンした場合は VRCSDK（>=3.7.5）と UdonSharp を自身で追加してください カスタムキューの設定方法 How to set custom cue VRC Light Volumes (VRCLV) 対応 ビリヤード台には、標準ライティング用と VRC Light Volumes（VRCLV）用の独立したシェーダーが用意されています。そのため、VRCLV パッケージがないプロジェクトでも、LightVolumes.cginc の欠落によって台が真っ白になることなく、標準シェーダーを使用できます。 ワンクリック切り替え: Hierarchy で BilliardsModule コンポーネントを持つ任意の台を選択します。 Inspector の VRC Light Volumes セクションで、パッケージとマテリアルの状態を確認します。 VRCLV のインストール後、Use VRC Light Volumes をクリックして有効化します。VRCLV に依存しないシェーダーへ戻すには Use Standard Lighting をクリックします。 切り替え時には確認ダイアログが表示され、プロジェクト内のすべての BilliardsModule が共有する関連マテリアルがまとめて更新されます。Tools > VRC LV > Enable For Billiards Materials と Tools > VRC LV > Use Standard Billiards Materials からも同じ操作を実行できます。UI、ガイドライン、リーダーボード、リセットボタン、影などの unlit マテリアルは対象外です。 シェーダーの対応関係: 標準ライティング VRC Light Volumes Standard cheese/VRC LV Standard metaphira/TableSurface cheese/TableSurface VRCLV metaphira/TableSurface (Glass) cheese/TableSurface Glass VRCLV metaphira/TableSurface (Quest) cheese/TableSurface Quest VRCLV パッケージ検出と注意事項: エディターは Packages/red.sim.lightvolumes/Shaders/LightVolumes.cginc を使って VRCLV を検出します。シェーダーから利用できるインストール検出マクロはありません。パッケージがない場合、有効化ボタンは無効になりますが、復旧用の Use Standard Lighting は引き続き使用できます。可能であれば、VRCLV を削除する前に標準ライティングへ戻してください。有効化後は VRCLV のドキュメントに従い、シーンに LightVolumeManager と Light Volumes を設定し、必要なベイクを行ってください。パッケージのインストールとマテリアルの切り替えだけでは Light Volume ライティングは生成されません。 Unity 2022.3.22f1 と VRC Light Volumes 3.0.0-dev.14 の環境で、シェーダーのインポートとエディタースクリプトのコンパイルを確認済みです。 将来の可能性機能 テーブルコントロールのさらなる機能 より豊富な名前カラー 球の軌道ライン